Spyglass API - Spyglass

The Spyglass API gives you the same brand, creative, and landing-page data the app runs on. Seven endpoints, one bearer key, JSON in and out.

Get a key

Open Settings → API in the dashboard.
Click Create key and give it a name you’ll recognize later.
Copy the key. It starts with sg_live_ and is shown once — we store only a hash, so if you lose it you’ll need to create another.

Keys are private to the person who created them, and scoped to the team they were created for. If you leave that team, the key stops working.

Your first call

Every endpoint is brand-scoped except search, so start by resolving a brand.

curl -X POST https://app.spyglass.so/api/v1/brands/search \
  -H "Authorization: Bearer $SPYGLASS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"mode": "brand_name", "brandNames": ["Nike"], "type": "BRAND", "count": 1}'

{
  "brands": [
    {
      "id": "1234567890",
      "name": "Nike",
      "verified": true,
      "igFollowers": 302000000,
      "igEngagementRate": 0.0142
    }
  ],
  "count": 1
}

If we don’t have the brand yet, send its website (or an Instagram / TikTok profile URL) and poll until it’s ready:

curl -X POST https://app.spyglass.so/api/v1/brands/index \
  -H "Authorization: Bearer $SPYGLASS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"websiteUrl": "https://www.nike.com"}'

{ "brandId": "1234567890", "status": "indexing" }

curl https://app.spyglass.so/api/v1/brands/1234567890/index-status \
  -H "Authorization: Bearer $SPYGLASS_API_KEY"

{ "status": "ready" }

already_exists means we already had it — use that brandId immediately. indexing means sync is queued; poll /index-status until ready. Take the id and ask what that brand is running:

curl -X POST https://app.spyglass.so/api/v1/brands/1234567890/media \
  -H "Authorization: Bearer $SPYGLASS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"mode": "smart", "userRequest": "video ads about comfort", "limit": 20}'

What you can ask for

Endpoint	Answers
`POST /brands/search`	Which brand is this? Who else is in this space?
`POST /brands/index`	Index a brand we don’t have yet, by website or social URL.
`GET /brands/{id}/index-status`	Has that brand finished indexing?
`GET /brands/{id}`	What do we know about this brand I already have an id for?
`POST /brands/{id}/media`	What creatives is this brand running?
`GET /brands/{id}/insights`	What hooks, USPs, personas and formats does it lean on?
`GET /brands/{id}/landing-pages`	Where does its ad traffic go?

Full parameters and response schemas are in the API reference.

Before you build

Three things worth knowing up front, because they shape how you write the client:

Calls cost credits, per row returned. Bound every call with limit or count. See Billing.
Nothing is paginated. count is the number of rows in this response, not a total. See Conventions.
It’s server-to-server. There’s no CORS, so calls must come from your backend, not a browser.

​Get a key

​Your first call

​What you can ask for

​Before you build

Get a key

Your first call

What you can ask for

Before you build