{"openapi":"3.1.0","info":{"title":"Brand Intelligence API","version":"1.0.0","description":"Brand intelligence, audience conversations, category trends, and creative deltas in a single API. Track brand activity, monitor what audiences are saying, and get ready-to-use briefs, digests, and alerts.\n\nThe Brand Intelligence API provides programmatic access to brand intelligence across three data domains. Data is collected and scanned daily, normalized, and served through a consistent REST interface.\n\n## Three Data Domains\n\n- **Brand Data** — Owned media, paid media/ads, and brand mentions sourced from all the major social platforms and news organizations. All data scanned daily.\n- **Category Data** — Industry news and trending topics sourced from X, Google, TikTok, Reddit, and more. Scanned daily.\n- **Audience Data** — Top-level audience segments with subreddit activity, influencer accounts, and podcast monitoring. Audiences are derived from analysis of tracked brand followings and can be linked to one or many brands. Scanned daily.\n\n## Authentication\n\nAll requests require a Bearer token in the `Authorization` header:\n\n```\nAuthorization: Bearer waldo_your_key_here\n```\n\nAPI keys are scoped to a specific user and team. Manage them with the [API Keys endpoints](#tag/api-keys) (`POST /v1/api-keys`, `GET /v1/api-keys`, `DELETE /v1/api-keys/{keyId}`), from the Waldo app under Settings → API Keys, or with the `api_key_*` tools on the Waldo MCP server.\n\n## MCP Server\n\nEverything in this API is also available over the [Model Context Protocol](https://modelcontextprotocol.io) — use it from Claude Desktop, Claude Code, Cursor, VS Code, ChatGPT, or any MCP-compatible client. Add the server URL to your client:\n\n```\nhttps://mcp.waldo.fyi\n```\n\n**Authentication** — most MCP clients (Claude Desktop, Cursor, etc.) handle OAuth automatically: add the server URL and authorize when prompted. For clients without OAuth support, pass an API key as a Bearer token instead — the same keys this API uses.\n\n**Tools** — the REST surface maps to MCP tools one-to-one: `brand_search`, `brand_get`, `brand_mentions_list`, `brand_mentions_summary`, `brand_owned_media_summary`, `brand_paid_media_ads_list`, `audience_insights`, `category_landscape`, `api_key_create`, and so on. Anything you can do here, your AI assistant can do over MCP.\n\n**Troubleshooting** — authentication failures usually mean an expired or revoked key: list yours with `GET /v1/api-keys` and mint a fresh one. For OAuth, disconnect and re-authorize.\n\n## Rate Limits\n\nRate limits are applied per team — all keys and users on the same team share a single quota of **1,000 requests/minute**. A small number of **live data** endpoints — those that fetch fresh, on-demand results — have a tighter per-team cap: **60 requests/minute** on the free tier and **600 requests/minute** for paid teams.\n\nRate limit status is returned in response headers:\n- `X-RateLimit-Limit` — Maximum requests per window\n- `X-RateLimit-Remaining` — Requests remaining in current window\n- `X-RateLimit-Reset` — Unix timestamp when the window resets\n\n## Pagination\n\nList endpoints use cursor-based pagination:\n\n```\nGET /v1/brands/{brand_id}/mentions?limit=20&cursor=eyJpZCI6Ij...\n```\n\nList responses carry a `meta` envelope with `total`, `total_pages`, and `next_cursor` (pass as `cursor` for the next page; `null` on the last page).\n\n## Errors\n\nErrors return JSON with an `error` object:\n\n```json\n{ \"error\": { \"code\": \"not_found\", \"message\": \"Brand not found\" } }\n```\n\nStandard HTTP status codes: 400 (bad request), 401 (unauthorized), 404 (not found), 429 (rate limited), 502 (upstream platform error), 500 (internal error).","contact":{"name":"Waldo Support","url":"https://waldo.fyi","email":"support@waldo.fyi"}},"servers":[{"url":"https://rest.waldo.fyi"}],"tags":[{"name":"Discover","description":"Query-first discovery search across live platforms — posts, ads, trends, creators, companies, jobs, and communities"},{"name":"Enrichment","description":"Platform passthrough — look up posts, profiles, comments, and companies in real time"},{"name":"Account","description":"Account info, credit balance, spend controls, and usage tracking"},{"name":"API Keys","description":"Create, list, and revoke API keys"}],"components":{"securitySchemes":{"API-Key":{"type":"http","scheme":"bearer","bearerFormat":"API Key","description":"Your Waldo API key. Generate one with the **Generate key** button above."}},"schemas":{"AccountUsage":{"type":"object","properties":{"period":{"type":"object","properties":{"start":{"type":"string","example":"2026-04-01"},"end":{"type":"string","example":"2026-04-30"}},"required":["start","end"]},"total_calls":{"type":"integer","example":0},"by_domain":{"type":"array","items":{"type":"object","properties":{"domain":{"type":"string","example":"brands"},"calls":{"type":"integer","example":0}},"required":["domain","calls"]}}},"required":["period","total_calls","by_domain"]},"AccountBalance":{"type":"object","properties":{"balance":{"type":"number","example":4200,"description":"Credits remaining in the current period."},"used":{"type":"number","example":800},"limit":{"type":"number","example":5000},"plan":{"type":["string","null"],"example":"pro"},"status":{"type":["string","null"],"example":"active"},"period":{"type":"object","properties":{"start":{"type":["string","null"],"example":"2026-06-01T00:00:00Z"},"end":{"type":["string","null"],"example":"2026-06-30T23:59:59Z"},"days_remaining":{"type":["number","null"],"example":21}},"required":["start","end","days_remaining"]}},"required":["balance","used","limit","plan","status","period"]},"AccountProfile":{"type":"object","properties":{"account_id":{"type":"string","example":"1080"},"email":{"type":["string","null"],"example":"team@example.com"},"entities":{"type":"object","properties":{"brands":{"type":"integer","example":12},"categories":{"type":"integer","example":5},"audiences":{"type":"integer","example":3}},"required":["brands","categories","audiences"]},"requests_this_month":{"type":"integer","example":0}},"required":["account_id","email","entities","requests_this_month"]},"Meta":{"type":"object","properties":{"request_id":{"type":"string","example":"req_abc123"},"total":{"type":"integer","description":"Total number of items matching the request, across all pages. Omitted when no total is available for the endpoint — absence means unknown, not zero.","example":142},"total_pages":{"type":"integer","description":"ceil(total / limit). Present exactly when total is; paginate via next_cursor regardless.","example":6},"next_cursor":{"type":["string","null"],"example":"eyJpZCI6Ij..."}},"required":["request_id"]},"ApiKeyCreated":{"type":"object","properties":{"apiKey":{"type":"string","description":"The raw key. Returned in plaintext exactly once — store it securely; it cannot be retrieved later."},"keyId":{"type":"string","format":"uuid"},"expiresAt":{"type":["string","null"],"format":"date-time"}},"required":["apiKey","keyId","expiresAt"]},"Error":{"type":"object","properties":{"error":{"type":"string","example":"Resource not found"}},"required":["error"]},"ApiKeyMetadata":{"type":"object","properties":{"apiKeyId":{"type":"string","format":"uuid"},"userId":{"type":"integer","description":"User who minted the key (keys are team-scoped; this is provenance)","example":42},"name":{"type":"string","example":"CI pipeline key"},"type":{"type":"string","example":"REST","description":"Minting provenance (MCP, REST, or OAUTH) — all key types authenticate identically."},"createdAt":{"type":"string","format":"date-time"},"expiresAt":{"type":["string","null"],"format":"date-time"},"lastUsedAt":{"type":["string","null"],"format":"date-time"},"revokedAt":{"type":["string","null"],"format":"date-time"},"status":{"type":"string","enum":["ACTIVE","REVOKED","EXPIRED"]}},"required":["apiKeyId","userId","name","type","createdAt","expiresAt","lastUsedAt","revokedAt","status"]}},"parameters":{}},"paths":{"/v1/api-keys":{"get":{"tags":["API Keys"],"summary":"List API keys","description":"List the current workspace's API keys — metadata only with derived status. Raw key material is never returned; it is only shown once at creation.","parameters":[{"schema":{"type":"string","enum":["MCP","REST","OAUTH"],"description":"Filter by minting provenance"},"required":false,"description":"Filter by minting provenance","name":"type","in":"query"}],"responses":{"200":{"description":"API keys for the current workspace","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/ApiKeyMetadata"}}},"required":["data"]}}}},"400":{"description":"No workspace selected","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"post":{"tags":["API Keys"],"summary":"Create an API key","description":"Create an API key for the current workspace, usable against both the REST API and the MCP server. The raw key is returned ONCE in this response and cannot be retrieved later — store it securely.","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1,"description":"Human-readable label for the key","example":"CI pipeline key"},"expiresInDays":{"type":"integer","exclusiveMinimum":0,"maximum":36500,"description":"Optional TTL in days (max 36500); omit for a non-expiring key","example":90}},"required":["name"]}}}},"responses":{"200":{"description":"Key created — the raw key appears only in this response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/ApiKeyCreated"}},"required":["data"]}}}},"400":{"description":"No workspace selected or invalid input","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/api-keys/{keyId}":{"delete":{"tags":["API Keys"],"summary":"Revoke an API key","description":"Revoke an API key in the current workspace. The key stops authenticating immediately and cannot be reactivated. Revoking an already-revoked key succeeds (idempotent); keys outside the current workspace report not-found.","parameters":[{"schema":{"type":"string","format":"uuid","description":"The apiKeyId to revoke (from the list endpoint)"},"required":true,"description":"The apiKeyId to revoke (from the list endpoint)","name":"keyId","in":"path"}],"responses":{"200":{"description":"Key revoked","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/ApiKeyMetadata"}},"required":["data"]}}}},"400":{"description":"No workspace selected","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Key not found in the current workspace","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/v1/discover/posts":{"get":{"tags":["Discover"],"summary":"Search posts","deprecated":true,"description":"Search social media posts across a specified platform. **Deprecated** — use `GET /v1/discover/{platform}/posts`, which exposes each platform's sort and time-window filters. This generic form only accepts q/cursor.","parameters":[{"schema":{"type":"string","enum":["x","instagram","tiktok","linkedin","facebook","youtube","reddit"],"description":"Social platform to search"},"required":true,"description":"Social platform to search","name":"platform","in":"query"},{"schema":{"type":"string","minLength":1,"description":"Search query"},"required":true,"description":"Search query","name":"q","in":"query"},{"schema":{"type":"string","description":"Pagination cursor for next page"},"required":false,"description":"Pagination cursor for next page","name":"cursor","in":"query"}],"responses":{"200":{"description":"Search results","content":{"application/json":{"schema":{"type":"object","properties":{"data":{},"meta":{"$ref":"#/components/schemas/Meta"}},"required":["meta"]},"examples":{"sample":{"summary":"Sample response","value":{"data":{"items":[{"type":"post","platform":{"source":"instagram","name":"Instagram","id":"3681494817335928025","url":"https://www.instagram.com/reel/DMXTAftv-TZ/"},"publishedAt":"2025-07-21T09:00:00.000Z","content":{"text":"The only sound i want to hear in 2025 #shopify #dropshipping","author":{"id":"54026738","username":"danielzamre","name":"Daniel","profileUrl":"https://instagram.com/danielzamre"},"media":[{"type":"video","url":"https://instagram.flhr13-1.fna.fbcdn.net/o1/v/t2/f2/m367/AQPsLrZE3xrYokVC2NkKOxXRk8XXZDVdub4wbCrwq94gNBe6bPrLGth5im8238auTqFd2MCdyynvw4hOVDaAPE_9aQE30CYMeEglVzs.mp4?_nc_cat=105&_nc_oc=AdpYUboeh_M9p50dJU2m6QWKHrBszCfR5HC63LIwmVR_YXpYfXbqtM23dVHRGumq86o&_nc_sid=9ca052&_nc_ht=instagram.flhr13-1.fna.fbcdn.net&_nc_ohc=a6W5Vv_mq3MQ7kNvwGUxCBE&efg=eyJ2ZW5jb2RlX3RhZyI6ImlnLXhwdmRzLmNsaXBzLmMyLUMzLmRhc2hfcjJldmV2cDktcjFnZW4ydnA5X3E4MCIsInZpZGVvX2lkIjpudWxsLCJvaWxfdXJsZ2VuX2FwcF9pZCI6NTY3MDY3MzQzMzUyNDI3LCJjbGllbnRfbmFtZSI6ImlnIiwieHB2X2Fzc2V0X2lkIjoyMTM2MzgwMTkwMTYxNzQyLCJhc3NldF9hZ2VfZGF5cyI6MzUxLCJ2aV91c2VjYXNlX2lkIjoxMDA5OSwiZHVyYXRpb25fcyI6NiwiYml0cmF0ZSI6OTgwMjkxLCJ1cmxnZW5fc291cmNlIjoid3d3In0%3D&ccb=17-1&_nc_gid=ZcgPQTuI7Tay0WlCBvYvHQ&_nc_ss=7a3ba&_nc_zt=28&oh=00_AQCsHy2Hk2WvctBq4wpc6WU-57woJ-wzz3IX7OYf7reQ_A&oe=6A4A26F2"}],"metrics":{"likes":663,"comments":53,"shares":40}},"post_id":"pid_eyJwIjoiaW5zdGFncmFtIiwiayI6Imh0dHBzOi8vd3d3Lmluc3RhZ3JhbS5jb20vcmVlbC9ETVhUQWZ0di1UWi8iLCJpIjoiMzY4MTQ5NDgxNzMzNTkyODAyNSJ9"},{"type":"post","platform":{"source":"instagram","name":"Instagram","id":"3739517395162390626","url":"https://www.instagram.com/reel/DPlb0ISDGBi/"},"publishedAt":"2025-10-09T10:21:15.000Z","content":{"text":"If you want to build a real ecom brand that actually works… this is for you 🚀\n\n✅ How to find a real winning product\n✅ How to build a professional Shopify store\n✅ How to get traffic (organic + paid ads)\n✅ And how to scale it to 7 figures 💰\n\nClick the link in my bio to watch a free video where I break down everything step by step. 🤝\n\n#ecomtips #shopifydropshipping #ecommercebusiness #dropshippingtips #ecomsuccess #shopifytraining #startyourownbusiness #onlinestore #winningproducts #makemoneyonline2025 #ecomsecrets #digitalbusiness","author":{"id":"37541965162","username":"ecomwithgeorge","name":"George Cordon | Ecom Business Mentor","profileUrl":"https://instagram.com/ecomwithgeorge"},"media":[{"type":"video","url":"https://instagram.flhr13-1.fna.fbcdn.net/o1/v/t2/f2/m367/AQO1HQ1qDaRhDzKj6VkhduhsOqXIQoOONmzN3FYY5U_FcG7YlMakGgtE5UTBKBuNCJAeKvPAWDtgjHaFkCIWsQVVSR4FiEgU1QCgFJcMSt26WA.mp4?_nc_cat=108&_nc_oc=AdqyuWhd-kAqgnouzlETA2CbTEzQgEQuDuj43C94jSuFgPxPSvC4K8U_8f60R_fU_9E&_nc_sid=9ca052&_nc_ht=instagram.flhr13-1.fna.fbcdn.net&_nc_ohc=nFaFYW67VkIQ7kNvwHpwRdv&efg=eyJ2ZW5jb2RlX3RhZyI6ImlnLXhwdmRzLmNsaXBzLmMyLUMzLmRhc2hfdnA5LWJhc2ljLWdlbjJfNzIwcCIsInZpZGVvX2lkIjpudWxsLCJvaWxfdXJsZ2VuX2FwcF9pZCI6NTY3MDY3MzQzMzUyNDI3LCJjbGllbnRfbmFtZSI6ImlnIiwieHB2X2Fzc2V0X2lkIjoyMTc3NTY1NDUyNjUzMzgyLCJhc3NldF9hZ2VfZGF5cyI6MjY0LCJ2aV91c2VjYXNlX2lkIjoxMDA5OSwiZHVyYXRpb25fcyI6MTIsImJpdHJhdGUiOjgxMjI1NCwidXJsZ2VuX3NvdXJjZSI6Ind3dyJ9&ccb=17-1&_nc_gid=ZcgPQTuI7Tay0WlCBvYvHQ&_nc_ss=7a3ba&_nc_zt=28&oh=00_AQA5Ng3LSlA_t5X8ahc07vPQiLaW-b4Hf888yCBqsHSXiQ&oe=6A4A34A4"}],"metrics":{"likes":988,"comments":190,"shares":27}},"post_id":"pid_eyJwIjoiaW5zdGFncmFtIiwiayI6Imh0dHBzOi8vd3d3Lmluc3RhZ3JhbS5jb20vcmVlbC9EUGxiMElTREdCaS8iLCJpIjoiMzczOTUxNzM5NTE2MjM5MDYyNiJ9"},{"type":"post","platform":{"source":"instagram","name":"Instagram","id":"3825292045171391775","url":"https://www.instagram.com/reel/DUWKtkKkX0f/"},"publishedAt":"2026-02-04T18:39:36.000Z","content":{"text":"Ai dropshipping 101\n#dropshipping #ecom #shopify #aidropshipping #ecommerce","author":{"id":"78344523038","username":"quinnhustles","name":"Quinn","profileUrl":"https://instagram.com/quinnhustles"},"media":[{"type":"video","url":"https://instagram.flhr13-1.fna.fbcdn.net/o1/v/t2/f2/m367/AQPcfPqGzZDL4uPOirp8R5SJmrVGpPW_jauqvHmy14e_QI72KGgZwvTaicQpD5uy12W80v6dB_kRQbFaTxVL3R0inHRGbN2EzM3VaXw.mp4?_nc_cat=103&_nc_oc=AdoNFdslDkKeXCt29wfLe4eh-rJZq73tsYT0fV-_TkIJCZFBF-x2i7_NBFiqnhmsLFw&_nc_sid=9ca052&_nc_ht=instagram.flhr13-1.fna.fbcdn.net&_nc_ohc=H1oa1npDbcsQ7kNvwE0pZHh&efg=eyJ2ZW5jb2RlX3RhZyI6ImlnLXhwdmRzLmNsaXBzLmMyLUMzLmRhc2hfcjJldmV2cDktcjFnZW4ydnA5X3E4MCIsInZpZGVvX2lkIjpudWxsLCJvaWxfdXJsZ2VuX2FwcF9pZCI6NTY3MDY3MzQzMzUyNDI3LCJjbGllbnRfbmFtZSI6ImlnIiwieHB2X2Fzc2V0X2lkIjoxNzg1NjI0NTE2MzYxMTAzOSwiYXNzZXRfYWdlX2RheXMiOjE0NiwidmlfdXNlY2FzZV9pZCI6MTAwOTksImR1cmF0aW9uX3MiOjE0LCJiaXRyYXRlIjoxNTAwNjM1LCJ1cmxnZW5fc291cmNlIjoid3d3In0%3D&ccb=17-1&_nc_gid=ZcgPQTuI7Tay0WlCBvYvHQ&_nc_ss=7a3ba&_nc_zt=28&oh=00_AQC42Ae6tooaGyieBLBSoMiyrJ6UER2s6zlryYhHvDbIsw&oe=6A4A231C"}],"metrics":{"likes":19824,"comments":495,"shares":702}},"post_id":"pid_eyJwIjoiaW5zdGFncmFtIiwiayI6Imh0dHBzOi8vd3d3Lmluc3RhZ3JhbS5jb20vcmVlbC9EVVdLdGtLa1gwZi8iLCJpIjoiMzgyNTI5MjA0NTE3MTM5MTc3NSJ9"}]},"meta":{"request_id":"req_example","next_cursor":"eyJpIjoiZUp3Qmt3QnMveHNCWEFBYXRyNzBpNm1odHBXV2FzU0I0NkRDMExmbFo4VDQrTkRabHB6ZGJJYXQrK2pZODl5VmFaS0E3SWplMDRpamFkakd1dE8wbVpDR2JMREw2S0R5N3FXSGF1amVpcUdPclpYS2EvQzE4T2oxNTVpWmE3S1QvOXY5Z2FhWFpyRFF0YUxLeEkrM2JCZ2tPV1EyTWpnMFpqVXROMll6WkMwME4yRXdMV0UzTldNdE1EaGpZbU14TmpkallUZGhBQlFBQUl2cFVJVT0iLCJyIjoiOWQ2Mjg0ZjUtN2YzZC00N2EwLWE3NWMtMDhjYmMxNjdjYTdhIiwic2VycF9zZXNzaW9uX2lkIjoiNWE0NTJhY2QtM2I0Ny00YWE0LTk1YmItODFhZDkyZDQyYzdmIiwic2VhcmNoX3Nlc3Npb25faWQiOiIxNTFmYWZlMS03MmEzLTQ4NTEtYmRhYy00MTY0NTdkOGVlNWYiLCJqb3VybmV5X3Nlc3Npb25faWQiOiJlZjRlZGI2MS0yNDg1LTRhMDctOTA1ZC1hNjMyYWFjYTUxMjQifQ==::sid::7761e29e-da57-46f9-95c7-ee2478b936b9"}}}}}}}}}},"/v1/discover/x/posts":{"get":{"tags":["Discover"],"summary":"Search X/Twitter posts","description":"Search X (Twitter) posts. Supports `sort` (top/latest). No time-window filter upstream.","parameters":[{"schema":{"type":"string","minLength":1,"description":"Search query"},"required":true,"description":"Search query","name":"q","in":"query"},{"schema":{"type":"string","description":"Pagination cursor for next page"},"required":false,"description":"Pagination cursor for next page","name":"cursor","in":"query"},{"schema":{"type":"string","enum":["top","latest"],"description":"Sort order: `top` (most relevant) or `latest` (most recent)."},"required":false,"description":"Sort order: `top` (most relevant) or `latest` (most recent).","name":"sort","in":"query"}],"responses":{"200":{"description":"Search results","content":{"application/json":{"schema":{"type":"object","properties":{"data":{},"meta":{"$ref":"#/components/schemas/Meta"}},"required":["meta"]}}}}}}},"/v1/discover/tiktok/posts":{"get":{"tags":["Discover"],"summary":"Search TikTok posts","description":"Search TikTok posts. Supports `sort` (relevance/likes/date), `since` (day/week/month/year), and `country` (ISO-2 region).","parameters":[{"schema":{"type":"string","minLength":1,"description":"Search query"},"required":true,"description":"Search query","name":"q","in":"query"},{"schema":{"type":"string","description":"Pagination cursor for next page"},"required":false,"description":"Pagination cursor for next page","name":"cursor","in":"query"},{"schema":{"type":"string","enum":["relevance","likes","date"],"description":"Sort order: `relevance`, `likes` (most liked), or `date` (most recent)."},"required":false,"description":"Sort order: `relevance`, `likes` (most liked), or `date` (most recent).","name":"sort","in":"query"},{"schema":{"type":"string","enum":["day","week","month","year"],"description":"Time window — posts from the last day, week, month, or year."},"required":false,"description":"Time window — posts from the last day, week, month, or year.","name":"since","in":"query"},{"schema":{"type":"string","pattern":"^[A-Za-z]{2}$","description":"ISO-2 country code to adjust results by region (e.g. `US`)."},"required":false,"description":"ISO-2 country code to adjust results by region (e.g. `US`).","name":"country","in":"query"}],"responses":{"200":{"description":"Search results","content":{"application/json":{"schema":{"type":"object","properties":{"data":{},"meta":{"$ref":"#/components/schemas/Meta"}},"required":["meta"]}}}}}}},"/v1/discover/reddit/posts":{"get":{"tags":["Discover"],"summary":"Search Reddit posts","description":"Search Reddit posts. Supports `sort` (relevance/hot/top/new/comments) and `since` (hour/today/week/month/year/all).","parameters":[{"schema":{"type":"string","minLength":1,"description":"Search query"},"required":true,"description":"Search query","name":"q","in":"query"},{"schema":{"type":"string","description":"Pagination cursor for next page"},"required":false,"description":"Pagination cursor for next page","name":"cursor","in":"query"},{"schema":{"type":"string","enum":["relevance","hot","top","new","comments"],"description":"Sort order: relevance, hot, top, new, or comments."},"required":false,"description":"Sort order: relevance, hot, top, new, or comments.","name":"sort","in":"query"},{"schema":{"type":"string","enum":["hour","today","week","month","year","all"],"description":"Time window: hour, today, week, month, year, or all. Reddit requires it when `sort` is top, comments, or relevance."},"required":false,"description":"Time window: hour, today, week, month, year, or all. Reddit requires it when `sort` is top, comments, or relevance.","name":"since","in":"query"}],"responses":{"200":{"description":"Search results","content":{"application/json":{"schema":{"type":"object","properties":{"data":{},"meta":{"$ref":"#/components/schemas/Meta"}},"required":["meta"]}}}}}}},"/v1/discover/linkedin/posts":{"get":{"tags":["Discover"],"summary":"Search LinkedIn posts","description":"Search LinkedIn posts. Supports `sort` (top/latest, defaults to top — LinkedIn requires a sort) and `since` (day/week/month).","parameters":[{"schema":{"type":"string","minLength":1,"description":"Search query"},"required":true,"description":"Search query","name":"q","in":"query"},{"schema":{"type":"string","description":"Pagination cursor for next page"},"required":false,"description":"Pagination cursor for next page","name":"cursor","in":"query"},{"schema":{"type":"string","enum":["top","latest"],"default":"top","description":"Sort order: `top` (most relevant, default) or `latest` (most recent)."},"required":false,"description":"Sort order: `top` (most relevant, default) or `latest` (most recent).","name":"sort","in":"query"},{"schema":{"type":"string","enum":["day","week","month"],"description":"Time window: day, week, or month."},"required":false,"description":"Time window: day, week, or month.","name":"since","in":"query"}],"responses":{"200":{"description":"Search results","content":{"application/json":{"schema":{"type":"object","properties":{"data":{},"meta":{"$ref":"#/components/schemas/Meta"}},"required":["meta"]}}}}}}},"/v1/discover/youtube/posts":{"get":{"tags":["Discover"],"summary":"Search YouTube videos","description":"Search YouTube videos. Supports `sort` (relevance/popularity) and `since` (day/week/month/year; omit for all-time).","parameters":[{"schema":{"type":"string","minLength":1,"description":"Search query"},"required":true,"description":"Search query","name":"q","in":"query"},{"schema":{"type":"string","description":"Pagination cursor for next page"},"required":false,"description":"Pagination cursor for next page","name":"cursor","in":"query"},{"schema":{"type":"string","enum":["relevance","popularity"],"description":"Sort order: `relevance` or `popularity` (by view count)."},"required":false,"description":"Sort order: `relevance` or `popularity` (by view count).","name":"sort","in":"query"},{"schema":{"type":"string","enum":["day","week","month","year"],"description":"Time window — videos from the last day, week, month, or year. Omit for all-time."},"required":false,"description":"Time window — videos from the last day, week, month, or year. Omit for all-time.","name":"since","in":"query"}],"responses":{"200":{"description":"Search results","content":{"application/json":{"schema":{"type":"object","properties":{"data":{},"meta":{"$ref":"#/components/schemas/Meta"}},"required":["meta"]}}}}}}},"/v1/discover/instagram/posts":{"get":{"tags":["Discover"],"summary":"Search Instagram posts","description":"Search Instagram posts. No sort or time-window filter is available upstream.","parameters":[{"schema":{"type":"string","minLength":1,"description":"Search query"},"required":true,"description":"Search query","name":"q","in":"query"},{"schema":{"type":"string","description":"Pagination cursor for next page"},"required":false,"description":"Pagination cursor for next page","name":"cursor","in":"query"}],"responses":{"200":{"description":"Search results","content":{"application/json":{"schema":{"type":"object","properties":{"data":{},"meta":{"$ref":"#/components/schemas/Meta"}},"required":["meta"]}}}}}}},"/v1/discover/facebook/posts":{"get":{"tags":["Discover"],"summary":"Search Facebook posts","description":"Search Facebook posts. No sort or time-window filter is available upstream.","parameters":[{"schema":{"type":"string","minLength":1,"description":"Search query"},"required":true,"description":"Search query","name":"q","in":"query"},{"schema":{"type":"string","description":"Pagination cursor for next page"},"required":false,"description":"Pagination cursor for next page","name":"cursor","in":"query"}],"responses":{"200":{"description":"Search results","content":{"application/json":{"schema":{"type":"object","properties":{"data":{},"meta":{"$ref":"#/components/schemas/Meta"}},"required":["meta"]}}}}}}},"/v1/discover/ads":{"get":{"tags":["Discover"],"summary":"Search ads","description":"Search ad libraries across Meta, Google, or LinkedIn.","parameters":[{"schema":{"type":"string","enum":["meta","google","linkedin"],"description":"Ad platform to search (meta, google, or linkedin)"},"required":true,"description":"Ad platform to search (meta, google, or linkedin)","name":"platform","in":"query"},{"schema":{"type":"string","minLength":1,"description":"Search query or advertiser name. For platform=google this is an advertiser domain (e.g. 'shopify.com') — the Google Ads Transparency Center has no free-text search."},"required":true,"description":"Search query or advertiser name. For platform=google this is an advertiser domain (e.g. 'shopify.com') — the Google Ads Transparency Center has no free-text search.","name":"q","in":"query"},{"schema":{"type":"string","description":"Pagination cursor for next page"},"required":false,"description":"Pagination cursor for next page","name":"cursor","in":"query"}],"responses":{"200":{"description":"Ad search results","content":{"application/json":{"schema":{"type":"object","properties":{"data":{},"meta":{"$ref":"#/components/schemas/Meta"}},"required":["meta"]},"examples":{"sample":{"summary":"Sample response","value":{"data":{"items":[{"type":"ad","id":"f4a58cb0-adbc-52da-818d-05380973dd65","platform":{"source":"meta","name":"Meta Ads","id":"1238141341576372","url":"https://www.facebook.com/ads/library/?id=1238141341576372"},"publishedAt":"2026-01-13T08:00:00.000Z","content":{"text":"When it’s time to start your business, it’s time for Shopify.","title":"Get going and keep growing","author":{"id":"20409006880","username":"Shopify","name":"Shopify","profileUrl":"https://facebook.com/shopify"},"media":[{"type":"image","url":"https://scontent.fdub6-1.fna.fbcdn.net/v/t39.35426-6/615325376_2402221716878741_6494965361874846906_n.jpg?_nc_cat=100&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=xRLTxKoRR50Q7kNvwGTmPoK&_nc_oc=AdqSwNTYy92KcH1dH2bhzfTlhBmtvrMtY4zigHWIkT5D2y3tyOQFGwWdAMMbjr4qyMA&_nc_zt=14&_nc_ht=scontent.fdub6-1.fna&_nc_gid=4vIQG0pDJF6L6gFEPdfUjQ&_nc_ss=72289&oh=00_AQBSDph0o5embkVMltCBLvrcdmUa2ogiRq9HyttOYOCOXA&oe=6A4CB43D","thumbnail":"https://scontent.fdub6-1.fna.fbcdn.net/v/t39.35426-6/615797664_1638157254218623_1246053090190189326_n.jpg?stp=dst-jpg_s600x600_tt6&_nc_cat=102&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=CQt3GbjCzzsQ7kNvwGnQrmM&_nc_oc=AdpbD1_TWbXl0tzIHhFLEkwazI7fWME06HHUELkOFzM8KE-b2Iln3NqxAQs7Vi0nCmE&_nc_zt=14&_nc_ht=scontent.fdub6-1.fna&_nc_gid=4vIQG0pDJF6L6gFEPdfUjQ&_nc_ss=72289&oh=00_AQCReOMAayG3ulFEcPWzSc0lz7187G4OREx12iJ_Kceuhw&oe=6A4CB55C"},{"type":"image","url":"https://scontent.fdub6-1.fna.fbcdn.net/v/t39.35426-6/614563162_1915587812405562_5670271360897830175_n.jpg?_nc_cat=106&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=YPww2k2ntPkQ7kNvwG9E26n&_nc_oc=AdrvhKtlU42MTm8wLn-45PvrHFdN5SxiTNqdB2AWVhmJcXnj2ITD3iI42Z739VcQoTc&_nc_zt=14&_nc_ht=scontent.fdub6-1.fna&_nc_gid=4vIQG0pDJF6L6gFEPdfUjQ&_nc_ss=72289&oh=00_AQD8N1WYBu4JJRkj_6KUjH_omaC309RqykA1l_TrVl_ZEA&oe=6A4C9BAE","thumbnail":"https://scontent.fdub6-1.fna.fbcdn.net/v/t39.35426-6/615362635_862852430052730_5700211561787815962_n.jpg?stp=dst-jpg_s600x600_tt6&_nc_cat=105&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=aO0iCDRTCrEQ7kNvwF1WK8z&_nc_oc=AdpdMIFAT9EGqSzq9dH2iYcj8ICxT9inOvlg_kDXg5WwDmZ6ZqLf4MtxDUV7iS-Tudg&_nc_zt=14&_nc_ht=scontent.fdub6-1.fna&_nc_gid=4vIQG0pDJF6L6gFEPdfUjQ&_nc_ss=72289&oh=00_AQDCBvOUdGvlam3WWWAbHMhaZ9D796PLLs5WocaEF5h5Iw&oe=6A4CA7FB"}],"cta":{"text":"Sign up","type":"SIGN_UP","url":"https://www.shopify.com/free-trial"},"adType":"DCO"},"targeting":{"platforms":["FACEBOOK","INSTAGRAM","MESSENGER"]},"campaignDates":{"firstShown":"2026-01-13T08:00:00.000Z","lastShown":"2026-07-02T07:00:00.000Z"},"metadata":{"collationId":"777407455176430","collationCount":null,"isActive":true,"pageCategories":["Software"],"pageLikes":4533317,"profilePictureUrl":"https://scontent.fdub6-1.fna.fbcdn.net/v/t39.35426-6/613645693_1917525535850663_6652853507872922010_n.jpg?stp=dst-jpg_s60x60_tt6&_nc_cat=102&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=W2uR4MNzZkkQ7kNvwFe05MS&_nc_oc=AdqlxKky6Ng29-NumDqgIZZlokKkaNIp6X0CVX0h0Z2-CJ2k7ewVfWOoRi3rsUtbHgI&_nc_zt=14&_nc_ht=scontent.fdub6-1.fna&_nc_gid=4vIQG0pDJF6L6gFEPdfUjQ&_nc_ss=72289&oh=00_AQAmxBIEAUNLt9PvIVre40h01NWJBWKgZGWN9Lw3nk3iYA&oe=6A4C9FAB"}},{"type":"ad","id":"9cc5bbfc-c830-51ec-8ec2-09d6ea945210","platform":{"source":"meta","name":"Meta Ads","id":"729027516861709","url":"https://www.facebook.com/ads/library/?id=729027516861709"},"publishedAt":"2026-03-25T07:00:00.000Z","content":{"text":"Vende en todas partes: online, en redes sociales y en persona","title":"Vende en todas partes","author":{"id":"20409006880","username":"Shopify","name":"Shopify","profileUrl":"https://facebook.com/shopify"},"media":[{"type":"image","url":"https://scontent.fdub6-1.fna.fbcdn.net/v/t39.35426-6/657518376_1607675230352520_5776008142405971415_n.jpg?_nc_cat=107&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=g06LksF5j7kQ7kNvwGgik7H&_nc_oc=Adp10SJWgPm-SAR9mFlHQbBHqu5vzZsSoZgqTSdNftJ1SWrJxnGqrLpY08gsY1w9Z34&_nc_zt=14&_nc_ht=scontent.fdub6-1.fna&_nc_gid=4vIQG0pDJF6L6gFEPdfUjQ&_nc_ss=72289&oh=00_AQBo-QvmIBK3p-20GQ2IUNH-zefusN9g_W-kK8dY311bug&oe=6A4C86C6","thumbnail":"https://scontent.fdub6-1.fna.fbcdn.net/v/t39.35426-6/658152128_1559745395123319_2996484981910270235_n.jpg?stp=dst-jpg_s600x600_tt6&_nc_cat=109&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=bTqw96z4gCwQ7kNvwHxeAhd&_nc_oc=AdqsNWwSC079MyeNB8HZq8eUqWf9P5zV2wVDcrlTqA7rAouuB_-LvP95JXSpi9XTg5o&_nc_zt=14&_nc_ht=scontent.fdub6-1.fna&_nc_gid=4vIQG0pDJF6L6gFEPdfUjQ&_nc_ss=72289&oh=00_AQBXNoK5wY70Dot7VsOZMVRp1I_oZT6IATjdpJPblozxaA&oe=6A4C9A42"},{"type":"image","url":"https://scontent.fdub6-1.fna.fbcdn.net/v/t39.35426-6/655934997_3892025097758497_8817241645872516066_n.jpg?_nc_cat=106&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=U3ZeL2iVp8UQ7kNvwFo1vyn&_nc_oc=AdpLOoi2hUg6ATXqrljt0G4sL7ajOyNY0Cg4eNQSnqoAVV7Ixp5syzQv6Zp3YlX92kg&_nc_zt=14&_nc_ht=scontent.fdub6-1.fna&_nc_gid=4vIQG0pDJF6L6gFEPdfUjQ&_nc_ss=72289&oh=00_AQDxzQO9ebREXuBZ0RnrsOmqW_JZjFmukg2PCOxKOBpDwQ&oe=6A4CAFF9","thumbnail":"https://scontent.fdub6-1.fna.fbcdn.net/v/t39.35426-6/655669732_1478367527064467_5141307821897095296_n.jpg?stp=dst-jpg_s600x600_tt6&_nc_cat=103&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=e-N9R3rwtMAQ7kNvwHlzQ3W&_nc_oc=AdoKesL7Pm7StEbdrRiPFsV_fByV7ShCLvcOiwJRUhMtiDF3CP1WivChXTIHhWtC4yI&_nc_zt=14&_nc_ht=scontent.fdub6-1.fna&_nc_gid=4vIQG0pDJF6L6gFEPdfUjQ&_nc_ss=72289&oh=00_AQC3Nzr2d0ExQHsHDs6goNZUk9hF4uEi00bVuEZ1gHWyAw&oe=6A4CAB01"}],"cta":{"text":"Sign up","type":"SIGN_UP","url":"https://www.shopify.com/es?country=es&lang=es"},"adType":"DCO"},"targeting":{"platforms":["FACEBOOK","INSTAGRAM","MESSENGER"]},"campaignDates":{"firstShown":"2026-03-25T07:00:00.000Z","lastShown":"2026-07-02T07:00:00.000Z"},"metadata":{"collationId":"3413031455503965","collationCount":null,"isActive":true,"pageCategories":["Software"],"pageLikes":4533317,"profilePictureUrl":"https://scontent.fdub6-1.fna.fbcdn.net/v/t39.35426-6/657221570_1262140099381136_367854587498301946_n.jpg?stp=dst-jpg_s60x60_tt6&_nc_cat=108&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=7o4M6wfXOh4Q7kNvwE82buQ&_nc_oc=AdpE6vQfuWtjYNBVbj3xpHBRZ8_zHAgsEHrth2w-RAA6aA1g9e5Yi8QUMTxuiR6UwLM&_nc_zt=14&_nc_ht=scontent.fdub6-1.fna&_nc_gid=4vIQG0pDJF6L6gFEPdfUjQ&_nc_ss=72289&oh=00_AQApkKU4nDRbhHtDrfhXqRBxxcQggOGNIP3avvwkViFbQw&oe=6A4C85F9"}},{"type":"ad","id":"38669f2c-df5e-5520-b0e7-ef10608e6bc4","platform":{"source":"meta","name":"Meta Ads","id":"814122985077781","url":"https://www.facebook.com/ads/library/?id=814122985077781"},"publishedAt":"2026-04-15T07:00:00.000Z","content":{"text":"When it’s time to start your business, it’s time for Shopify.","title":"Go from launch to legendary","author":{"id":"20409006880","username":"Shopify","name":"Shopify","profileUrl":"https://facebook.com/shopify"},"media":[{"type":"image","url":"https://scontent.fdub6-1.fna.fbcdn.net/v/t39.35426-6/655899338_946886937889380_7318978175622276723_n.jpg?_nc_cat=109&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=cu8SH5VON5cQ7kNvwE-7YJh&_nc_oc=AdrQZ6LnMEddu47RPjJqJx-nLHzNd1b7FP-D5eATHx0J7H8JT56nKQPBDInM0nRtfBk&_nc_zt=14&_nc_ht=scontent.fdub6-1.fna&_nc_gid=4vIQG0pDJF6L6gFEPdfUjQ&_nc_ss=72289&oh=00_AQDhwcglmNdIXafKzpyPDfRybTqg6Jlle-7hHhdfK8n8fA&oe=6A4CB05C","thumbnail":"https://scontent.fdub6-1.fna.fbcdn.net/v/t39.35426-6/659119294_1143725757812552_4366261739016112964_n.jpg?stp=dst-jpg_s600x600_tt6&_nc_cat=110&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=h79WkngN3scQ7kNvwGOsUHP&_nc_oc=AdqCjbNky6HGH5YT8NnkMLQyudbtoImL4isSce5-KfnVySjG1USZhWLEZpcGPfU6UWs&_nc_zt=14&_nc_ht=scontent.fdub6-1.fna&_nc_gid=4vIQG0pDJF6L6gFEPdfUjQ&_nc_ss=72289&oh=00_AQAUTkH_KQk-NdSPZvXtGbrY9oEjniTEoY87pc644ZFuyA&oe=6A4CB267"},{"type":"image","url":"https://scontent.fdub6-1.fna.fbcdn.net/v/t39.35426-6/656442628_3541583292647677_4830189244934257949_n.jpg?_nc_cat=103&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=CYo12s-Sv9wQ7kNvwEJ42Rs&_nc_oc=AdqqHchLAlwKc4V1li35nJtleo0WY1940bNgT4AbCAevAhnxOnkHeXcaFsVI8WmQcbw&_nc_zt=14&_nc_ht=scontent.fdub6-1.fna&_nc_gid=4vIQG0pDJF6L6gFEPdfUjQ&_nc_ss=72289&oh=00_AQB3YnpIBnYd54F7wdOudhbEJY5paBNnOg-UbLi4D5r1Lw&oe=6A4C98C1","thumbnail":"https://scontent.fdub6-1.fna.fbcdn.net/v/t39.35426-6/659119294_2423603261493958_1174259808037691468_n.jpg?stp=dst-jpg_s600x600_tt6&_nc_cat=103&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=EnGMHCJAS-QQ7kNvwEN71nc&_nc_oc=AdpRgTcIfLQo2ADF_HcDxoW8viEiJG54wtpWHTAtpxktgVJQncmZk2K_aQIcnhh03T4&_nc_zt=14&_nc_ht=scontent.fdub6-1.fna&_nc_gid=4vIQG0pDJF6L6gFEPdfUjQ&_nc_ss=72289&oh=00_AQAiZhZGu7wC6uphJkjknXoeGe3R_bc6F1umA5PXyEfFuw&oe=6A4CB2C3"}],"cta":{"text":"Sign up","type":"SIGN_UP","url":"https://www.shopify.com/?country=us&lang=en"},"adType":"DCO"},"targeting":{"platforms":["FACEBOOK","INSTAGRAM","MESSENGER"]},"campaignDates":{"firstShown":"2026-04-15T07:00:00.000Z","lastShown":"2026-07-02T07:00:00.000Z"},"metadata":{"collationId":"2609851269392805","collationCount":null,"isActive":true,"pageCategories":["Software"],"pageLikes":4533317,"profilePictureUrl":"https://scontent.fdub6-1.fna.fbcdn.net/v/t39.35426-6/653805542_1250856763366623_1733387331309884466_n.jpg?stp=dst-jpg_s60x60_tt6&_nc_cat=111&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=hYAJXnEy47IQ7kNvwHcN0w0&_nc_oc=Adrh51h37245IEHAZnc9RcbkQiabOmqqRanmZiQJDyazdZT8Iootj-1Lg_6z5LvsCw8&_nc_zt=14&_nc_ht=scontent.fdub6-1.fna&_nc_gid=4vIQG0pDJF6L6gFEPdfUjQ&_nc_ss=72289&oh=00_AQDqr9n3offCNMV9YKROwoOBTYznO7Fuu0RFLMwc3vdqhA&oe=6A4CA502"}}]},"meta":{"request_id":"req_example","next_cursor":"AQHS5pFUsJdkb4JkcMrtlHYDeHLPGskcYNVrJGzIEvIK8x3fuL_blhrO5nMxDak8-wVk"}}}}}}}}}},"/v1/discover/trends":{"get":{"tags":["Discover"],"summary":"Get trending topics","description":"Retrieve trending topics from Twitter or Google Trends.","parameters":[{"schema":{"type":"string","enum":["x","google_trends","tiktok"],"description":"Trends platform (x or google_trends)"},"required":true,"description":"Trends platform (x or google_trends)","name":"platform","in":"query"},{"schema":{"type":"string","minLength":1,"description":"Search query (required for google_trends; ignored for x, which lists trends rather than searches them)"},"required":false,"description":"Search query (required for google_trends; ignored for x, which lists trends rather than searches them)","name":"q","in":"query"},{"schema":{"type":"string","description":"Country filter (ISO 2-letter code)"},"required":false,"description":"Country filter (ISO 2-letter code)","name":"country","in":"query"}],"responses":{"200":{"description":"Trending topics","content":{"application/json":{"schema":{"type":"object","properties":{"data":{},"meta":{"$ref":"#/components/schemas/Meta"}},"required":["meta"]},"examples":{"sample":{"summary":"Sample response","value":{"data":{"success":true,"query":"shopify","location":"US","timeframe":"today 1-m","platform":"web","dataType":"related_queries","search_metadata":{"id":"search_XJELrMkzrOFj9WXNEk2PNQw7","status":"Success","created_at":"2026-06-14T15:58:07Z","request_time_taken":5.03,"parsing_time_taken":0,"total_time_taken":5.04,"request_url":"https://trends.google.com/trends/explore?q=shopify&geo=&tz=420&date=today 1-m&cat=0","html_url":"https://www.searchapi.io/api/v1/searches/search_XJELrMkzrOFj9WXNEk2PNQw7.html","json_url":"https://www.searchapi.io/api/v1/searches/search_XJELrMkzrOFj9WXNEk2PNQw7"},"results":{"rising":[{"position":1,"query":"shopify theme dev","values":"+600%","extracted_value":600,"link":"https://trends.google.com/trends/explore?q=shopify+theme+dev&date=today+1-m"},{"position":2,"query":"shopify down?","values":"+170%","extracted_value":170,"link":"https://trends.google.com/trends/explore?q=shopify+down?&date=today+1-m"},{"position":3,"query":"shopify rebellion r6","values":"+130%","extracted_value":130,"link":"https://trends.google.com/trends/explore?q=shopify+rebellion+r6&date=today+1-m"}],"top":[{"position":1,"query":"shopify app","values":"100","extracted_value":100,"link":"https://trends.google.com/trends/explore?q=shopify+app&date=today+1-m"},{"position":2,"query":"shopify store","values":"88","extracted_value":88,"link":"https://trends.google.com/trends/explore?q=shopify+store&date=today+1-m"},{"position":3,"query":"shopify price","values":"76","extracted_value":76,"link":"https://trends.google.com/trends/explore?q=shopify+price&date=today+1-m"}]},"count":18,"numResults":20,"items":[{"type":"trend","id":"ce9430fa-38a3-5792-a2cd-3c391c8f8ab8","platform":{"source":"google_trends","name":"Google Trends","id":"shopify theme dev","url":"https://trends.google.com/trends/explore?q=shopify+theme+dev&date=today+1-m"},"publishedAt":"2026-06-14T15:58:12.841Z","content":{"title":"shopify theme dev","query":"shopify theme dev"},"metrics":{"searches":600,"position":1},"metadata":{"type":"related_query"}},{"type":"trend","id":"6ce6e54b-aaee-50b8-a57a-dd31c0620a56","platform":{"source":"google_trends","name":"Google Trends","id":"shopify down?","url":"https://trends.google.com/trends/explore?q=shopify+down?&date=today+1-m"},"publishedAt":"2026-06-14T15:58:12.841Z","content":{"title":"shopify down?","query":"shopify down?"},"metrics":{"searches":170,"position":2},"metadata":{"type":"related_query"}},{"type":"trend","id":"31862d05-ad4e-5466-9d5b-1cc4f92f50d7","platform":{"source":"google_trends","name":"Google Trends","id":"shopify rebellion r6","url":"https://trends.google.com/trends/explore?q=shopify+rebellion+r6&date=today+1-m"},"publishedAt":"2026-06-14T15:58:12.841Z","content":{"title":"shopify rebellion r6","query":"shopify rebellion r6"},"metrics":{"searches":130,"position":3},"metadata":{"type":"related_query"}}]},"meta":{"request_id":"req_example"}}}}}}}}}},"/v1/discover/users":{"get":{"tags":["Discover"],"summary":"Find creators","description":"Search for creators or users across a specified social platform.","parameters":[{"schema":{"type":"string","enum":["x","instagram","tiktok","linkedin","facebook","youtube"],"description":"Social platform to search"},"required":true,"description":"Social platform to search","name":"platform","in":"query"},{"schema":{"type":"string","minLength":1,"description":"Search query"},"required":true,"description":"Search query","name":"q","in":"query"},{"schema":{"type":"string","description":"Pagination cursor for next page"},"required":false,"description":"Pagination cursor for next page","name":"cursor","in":"query"}],"responses":{"200":{"description":"Creator search results","content":{"application/json":{"schema":{"type":"object","properties":{"data":{},"meta":{"$ref":"#/components/schemas/Meta"}},"required":["meta"]},"examples":{"sample":{"summary":"Sample response","value":{"data":{"items":[{"platform":"instagram","id":"207642893","handle":"shopify","name":"Shopify","url":"https://www.instagram.com/shopify","profilePicture":"https://scontent-ord5-1.cdninstagram.com/v/t51.2885-19/491519127_1000421255126957_7784885216218058818_n.jpg?stp=dst-jpg_e0_s150x150_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby44MDAuYzIifQ&_nc_ht=scontent-ord5-1.cdninstagram.com&_nc_cat=1&_nc_oc=Q6cZ2gG2Ng3rhxiBZLZFWZrRj17bwHQeQzDuXP_4cw5uN3qdI3a_X8K7_x-b0h8ATohw3V4&_nc_ohc=rlbJkLW8KKEQ7kNvwELXZIS&_nc_gid=o7Ek7sWR1ENvRVsewkuROQ&edm=AM7KJZYBAAAA&ccb=7-5&ig_cache_key=GJf8Sx2tn4m54I0DAEIQ3qnbdwlsbkULAAAB1501500j-ccb7-5&oh=00_AQDjFPPrhxyAx2J3dudHh5lAipbFIhJaFW_yJelTYUkN-Q&oe=6A4A2E17&_nc_sid=8ec269","isVerified":true},{"platform":"instagram","id":"44584868709","handle":"shopifyrebellion","name":"Shopify Rebellion","url":"https://www.instagram.com/shopifyrebellion","profilePicture":"https://scontent-ord5-2.cdninstagram.com/v/t51.82787-19/649152825_18100139753484710_7823543392210057479_n.jpg?stp=dst-jpg_e0_s150x150_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby45OTkuYzIifQ&_nc_ht=scontent-ord5-2.cdninstagram.com&_nc_cat=102&_nc_oc=Q6cZ2gG2Ng3rhxiBZLZFWZrRj17bwHQeQzDuXP_4cw5uN3qdI3a_X8K7_x-b0h8ATohw3V4&_nc_ohc=97I8OiGX6S4Q7kNvwF5xLhM&_nc_gid=o7Ek7sWR1ENvRVsewkuROQ&edm=AM7KJZYBAAAA&ccb=7-5&ig_cache_key=GDlJsSamMWQw_01AAAf5iKlDz5JsbmNDAQAB1501500j-ccb7-5&oh=00_AQAVJVH_UEv4ipj4-Os_-pUqVw9SN8UKkblCudi8aedQRg&oe=6A4A3A43&_nc_sid=8ec269","isVerified":false},{"platform":"instagram","id":"52265308276","handle":"dashotimiza","name":"DASH Otimiza | Shopify | Merchant","url":"https://www.instagram.com/dashotimiza","profilePicture":"https://scontent-ord5-2.cdninstagram.com/v/t51.82787-19/522681871_18018900485740277_4022177566052653770_n.jpg?stp=dst-jpg_e0_s150x150_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby4xMDgwLmMyIn0&_nc_ht=scontent-ord5-2.cdninstagram.com&_nc_cat=105&_nc_oc=Q6cZ2gG2Ng3rhxiBZLZFWZrRj17bwHQeQzDuXP_4cw5uN3qdI3a_X8K7_x-b0h8ATohw3V4&_nc_ohc=-xSkRWUA3ZAQ7kNvwFy46OS&_nc_gid=o7Ek7sWR1ENvRVsewkuROQ&edm=AM7KJZYBAAAA&ccb=7-5&ig_cache_key=GA9_Jx-1FrIyGARAAMoaHZgvpdE3bmNDAQAB1501500j-ccb7-5&oh=00_AQAHsw-ICebb7EJhKU_YMBuJW9jHpzbIsGgpnyEUidpoyQ&oe=6A4A3620&_nc_sid=8ec269","isVerified":false}]},"meta":{"request_id":"req_example","next_cursor":null}}}}}}}}}},"/v1/discover/companies":{"get":{"tags":["Discover"],"summary":"Search companies","description":"Search for companies on LinkedIn.","parameters":[{"schema":{"type":"string","minLength":1,"description":"Company name or keyword"},"required":true,"description":"Company name or keyword","name":"q","in":"query"},{"schema":{"type":"string","description":"Pagination cursor for next page"},"required":false,"description":"Pagination cursor for next page","name":"cursor","in":"query"}],"responses":{"200":{"description":"Company search results","content":{"application/json":{"schema":{"type":"object","properties":{"data":{},"meta":{"$ref":"#/components/schemas/Meta"}},"required":["meta"]},"examples":{"sample":{"summary":"Sample response","value":{"data":{"items":[{"urn":"urn:li:fsd_company:784652","name":"Shopify","specializes_in":"Software Development","description":"Shopify is a leading global commerce company, providing trusted tools to start, grow, market, and manage a retail business of any size. Shopify makes commerce better for everyone with a platform and services that are engineered...","headquarters":"Ottawa, ON","followers":1000000,"company_logo":"https://media.licdn.com/dms/image/v2/D560BAQG_KjTcNcrLVw/company-logo_400_400/B56ZZolTV.HUAk-/0/1745511331439/shopify_logo?e=1784764800&v=beta&t=8Z7CABG68PNAJW9L0sh-uOgeUQ8VBM05eUGG43tgxcc","jobs":127,"page_by":null,"public_identifier":"shopify","url":"https://www.linkedin.com/company/shopify/"},{"urn":"urn:li:fsd_company:14375763","name":"ShopTrade (Shopify Premier Agency)","specializes_in":"Software Development","description":"ShopTrade is a full-service, Shopify-only eCommerce agency. We deliver end-to-end solutions that connect brand strategy...","headquarters":"Tampa, Florida","followers":28000,"company_logo":"https://media.licdn.com/dms/image/v2/D560BAQE4WMmd1CxCcQ/company-logo_400_400/B56ZnIY1lIIAAY-/0/1760003578674/shoptrade_logo?e=1784764800&v=beta&t=AsOgT6XsYh9o4biIrgLdUiCAgc9Gy5HlNoq-HTbXCwI","jobs":null,"page_by":null,"public_identifier":"shoptrade","url":"https://www.linkedin.com/company/shoptrade/"},{"urn":"urn:li:fsd_company:7021278","name":"Anatta - Shopify Platinum Partner","specializes_in":"Software Development","description":"Precision-engineered Shopify solutions for enterprise","headquarters":"Charleston, South Carolina","followers":26000,"company_logo":"https://media.licdn.com/dms/image/v2/D560BAQGOXVx5k5teBg/company-logo_400_400/B56Z5A2inYGsAU-/0/1779204500125/anatta_design_logo?e=1784764800&v=beta&t=eGSGJ8sO8EDqX18AGZnuodA_tH2IQvtA1jY1ydWQMBI","jobs":8,"page_by":null,"public_identifier":"anatta-shopify-platinum-partner","url":"https://www.linkedin.com/company/anatta-shopify-platinum-partner/"}]},"meta":{"request_id":"req_example","next_cursor":"eyJzdGFydCI6MTAsImNvdW50IjoxMCwicGFnaW5hdGlvblRva2VuIjpudWxsfQ=="}}}}}}}}}},"/v1/discover/jobs":{"get":{"tags":["Discover"],"summary":"Search jobs","description":"Search for job listings on LinkedIn.","parameters":[{"schema":{"type":"string","minLength":1,"description":"Job title or keyword"},"required":true,"description":"Job title or keyword","name":"q","in":"query"},{"schema":{"type":"string","description":"Pagination cursor for next page"},"required":false,"description":"Pagination cursor for next page","name":"cursor","in":"query"}],"responses":{"200":{"description":"Job search results","content":{"application/json":{"schema":{"type":"object","properties":{"data":{},"meta":{"$ref":"#/components/schemas/Meta"}},"required":["meta"]},"examples":{"sample":{"summary":"Sample response","value":{"data":{"items":[{"title":"Overnight Merchant Support Advisor, Canada (Canada )","subtitle":null,"urn":"urn:li:fs_normalized_jobPosting:4434133864","company":"Shopify","location":"Canada (Remote)","url":"https://www.linkedin.com/jobs/view/4434133864","listing_date":"2026-06-29T17:37:34.000Z"},{"title":"Freelance Shopify Developer – Remote","subtitle":null,"urn":"urn:li:fs_normalized_jobPosting:4432783264","company":"Twine","location":"New Zealand (Remote)","url":"https://www.linkedin.com/jobs/view/4432783264","listing_date":"2026-07-02T11:10:09.000Z"},{"title":"Shopify Consultant - Fully Remote | Upto $70/hr","subtitle":null,"urn":"urn:li:fs_normalized_jobPosting:4431926331","company":"Mercor","location":"Toronto, ON (Remote)","url":"https://www.linkedin.com/jobs/view/4431926331","listing_date":"2026-06-30T11:56:05.000Z"}]},"meta":{"request_id":"req_example","next_cursor":"eyJjb3VudCI6MTAwLCJzdGFydCI6MTAwLCJ0b3RhbCI6ODcyLCJwYWdpbmF0aW9uVG9rZW4iOm51bGx9"}}}}}}}}}},"/v1/discover/communities":{"get":{"tags":["Discover"],"summary":"Search communities","description":"Search for subreddits and communities on Reddit.","parameters":[{"schema":{"type":"string","minLength":1,"description":"Community name or topic"},"required":true,"description":"Community name or topic","name":"q","in":"query"}],"responses":{"200":{"description":"Community search results","content":{"application/json":{"schema":{"type":"object","properties":{"data":{},"meta":{"$ref":"#/components/schemas/Meta"}},"required":["meta"]},"examples":{"sample":{"summary":"Sample response","value":{"data":{"items":[{"name":"r/shopify","href":"https://reddit.com/r/shopify/","description":"This subreddit is a forum to ask or seek any information regarding Shopify.   Store owners can discuss any Shopify-specific issues.  Note that this is a promotion-free sub and the rules (please read them) are very strictly enforced.  Your post must be specific and unique to the Shopify platform.  "},{"name":"r/shopifyDev","href":"https://reddit.com/r/shopifyDev/","description":"A place for Shopify Apps and Store developers. Do not share what are you working on. Surveys are not allowed. "},{"name":"r/shopify_geeks","href":"https://reddit.com/r/shopify_geeks/","description":"Discuss startups, Shopify content, small businesses, side hustles, and everything in between. Share your wins, learn from your failures, and connect with fellow founders.\n\nFor Shopify and ECOM help: www.scrowp.com"}]},"meta":{"request_id":"req_example"}}}}}}}}}},"/v1/posts/lookup":{"get":{"tags":["Enrichment"],"summary":"Look up a post by URL","description":"Resolve a raw post URL to its enriched data. The response carries a minted opaque `post_id` (`pid_…` token) downstream `/v1/posts/{post_id}` and `/comments` lookups consume directly — this is the entry point into the post-id system for URLs sourced outside our API. Platform is sniffed from the URL host; pass `platform` explicitly when the host is ambiguous (e.g. a shortened link).","parameters":[{"schema":{"type":"string","format":"uri","description":"Full post URL (LinkedIn, Twitter/X, Instagram, TikTok, Facebook, YouTube, Reddit)"},"required":true,"description":"Full post URL (LinkedIn, Twitter/X, Instagram, TikTok, Facebook, YouTube, Reddit)","name":"url","in":"query"},{"schema":{"type":"string","enum":["x","instagram","tiktok","linkedin","facebook","youtube","reddit"],"description":"Optional override when the URL host doesn't disambiguate the platform."},"required":false,"description":"Optional override when the URL host doesn't disambiguate the platform.","name":"platform","in":"query"}],"responses":{"200":{"description":"Enriched post data with minted post_id","content":{"application/json":{"schema":{"type":"object","properties":{"data":{},"meta":{"$ref":"#/components/schemas/Meta"}},"required":["meta"]}}}}}}},"/v1/posts/{post_id}":{"get":{"tags":["Enrichment"],"summary":"Get enriched post","description":"Retrieve an enriched post by `post_id` — either the opaque `pid_…` token returned in discover/search/profile-posts items and `/v1/posts/lookup` responses, OR a bare platform ID (e.g. tweet id) paired with the `platform` query. Both forms are first-class. A raw URL in the path param is unsupported: encoded slashes die at the API gateway with a bare 404 before the handler runs. Use `/v1/posts/lookup?url=…` instead.","parameters":[{"schema":{"type":"string","description":"Opaque pid_… token (returned in discover/search/profile-posts items and /v1/posts/lookup responses) OR a bare platform ID paired with the `platform` query — both forms are first-class. Do NOT pass a raw post URL: encoded slashes die at the API gateway and return a bare 404 before the handler runs. Use /v1/posts/lookup?url=… when you only have a URL."},"required":true,"description":"Opaque pid_… token (returned in discover/search/profile-posts items and /v1/posts/lookup responses) OR a bare platform ID paired with the `platform` query — both forms are first-class. Do NOT pass a raw post URL: encoded slashes die at the API gateway and return a bare 404 before the handler runs. Use /v1/posts/lookup?url=… when you only have a URL.","name":"post_id","in":"path"},{"schema":{"type":"string","enum":["x","instagram","tiktok","linkedin","facebook","youtube","reddit"],"description":"Required only when `post_id` is a bare platform ID; ignored when a synthetic pid_ token is supplied."},"required":false,"description":"Required only when `post_id` is a bare platform ID; ignored when a synthetic pid_ token is supplied.","name":"platform","in":"query"}],"responses":{"200":{"description":"Enriched post data","content":{"application/json":{"schema":{"type":"object","properties":{"data":{},"meta":{"$ref":"#/components/schemas/Meta"}},"required":["meta"]},"examples":{"sample":{"summary":"Sample response","value":{"data":{"success":false,"error":"Failed to get Instagram post: Resource not found"},"meta":{"request_id":"req_example"}}}}}}}}}},"/v1/posts/{post_id}/comments":{"get":{"tags":["Enrichment"],"summary":"Get post comments","description":"Retrieve comments or replies on a post. Same `post_id` semantics as `/v1/posts/{post_id}`. `cursor` is honored on x / instagram / tiktok / linkedin / facebook / youtube; reddit's scan_reddit_post_page tool has no pagination, so `cursor` is ignored on reddit (the response carries every retrievable comment in one call).","parameters":[{"schema":{"type":"string","description":"Opaque pid_… token (returned in discover/search/profile-posts items and /v1/posts/lookup responses) OR a bare platform ID paired with the `platform` query — both forms are first-class. Do NOT pass a raw post URL: encoded slashes die at the API gateway and return a bare 404 before the handler runs. Use /v1/posts/lookup?url=… when you only have a URL."},"required":true,"description":"Opaque pid_… token (returned in discover/search/profile-posts items and /v1/posts/lookup responses) OR a bare platform ID paired with the `platform` query — both forms are first-class. Do NOT pass a raw post URL: encoded slashes die at the API gateway and return a bare 404 before the handler runs. Use /v1/posts/lookup?url=… when you only have a URL.","name":"post_id","in":"path"},{"schema":{"type":"string","enum":["x","instagram","tiktok","linkedin","facebook","youtube","reddit"],"description":"Required only when `post_id` is a bare platform ID; ignored when a synthetic pid_ token is supplied."},"required":false,"description":"Required only when `post_id` is a bare platform ID; ignored when a synthetic pid_ token is supplied.","name":"platform","in":"query"},{"schema":{"type":"string","description":"Pagination cursor for next page"},"required":false,"description":"Pagination cursor for next page","name":"cursor","in":"query"}],"responses":{"200":{"description":"Post comments","content":{"application/json":{"schema":{"type":"object","properties":{"data":{},"meta":{"$ref":"#/components/schemas/Meta"}},"required":["meta"]},"examples":{"sample":{"summary":"Sample response","value":{"data":{"items":[{"id":"17852385210692365","text":"incredible","author":{"id":"13310615","username":"nickpbaker","profilePicture":"https://scontent-lga3-2.cdninstagram.com/v/t51.2885-19/436536588_328617099860280_2235763667943534443_n.jpg?stp=dst-jpg_e0_s150x150_tt6&_nc_cat=105&ig_cache_key=GAwFBRo4GYEh4CoBAGuvf901BwcfbkULAAAB1501500j-ccb7-5&ccb=7-5&_nc_sid=669407&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLnd3dy4xMDgwLkMzIn0%3D&_nc_ohc=uHheLPZoyEwQ7kNvwH5wPGT&_nc_oc=Adpl89fuB3HQrAmnTMTKe7qNSzq1fTeb9z5X4frN52jJpusS7gWNjhWXNoVpCEaFZh0&_nc_ad=z-m&_nc_cid=0&_nc_zt=24&_nc_ht=scontent-lga3-2.cdninstagram.com&_nc_ss=783ba&oh=00_AQAdOdGI7BsMVQJefa5Umaeept-s1gaVzhlp9NiGQzrmwQ&oe=6A4C86E8"},"createdAt":"2026-06-09T14:17:59.000Z","likes":7},{"id":"18094395305337681","text":"🔥","author":{"id":"51870206129","username":"shopify.rajimul","profilePicture":"https://scontent-lga3-3.cdninstagram.com/v/t51.82787-19/658717967_18046439153734130_1110020192028040450_n.jpg?stp=dst-jpg_e0_s150x150_tt6&_nc_cat=104&ig_cache_key=GA89QyfyETgLJB1AAAKdV8d7lWcPbmNDAQAB1501500j-ccb7-5&ccb=7-5&_nc_sid=669407&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLnd3dy41OTUuQzMifQ%3D%3D&_nc_ohc=dhiGFXPaEsoQ7kNvwFDpAg4&_nc_oc=AdrPUBFqU_xKYYXQUUyga8YyOgb-bC9Zaaa6CX-t9SSC4RiW9zo8Os4fX2CgxLu2Bmc&_nc_ad=z-m&_nc_cid=0&_nc_zt=24&_nc_ht=scontent-lga3-3.cdninstagram.com&_nc_gid=HqCo1UU4Bu-OKS-mpoCPtg&_nc_ss=783ba&oh=00_AQB3BQBO11Dlu1wmlpHe5ck9oO9ZlVCt7YLlIuaapQLIzw&oe=6A4CA437"},"createdAt":"2026-06-09T14:17:29.000Z","likes":8},{"id":"17974862699885601","text":"Teach me","author":{"id":"63366128921","username":"grabriel_vanstaden","profilePicture":"https://scontent-lga3-1.cdninstagram.com/v/t51.82787-19/523327771_17916852912112922_2969124481534100690_n.jpg?stp=dst-jpg_e0_s150x150_tt6&_nc_cat=109&ig_cache_key=GBtZMR8axVFlSKc-ANKEwR-8cjQpbmNDAQAB1501500j-ccb7-5&ccb=7-5&_nc_sid=669407&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLnd3dy4xMDgwLkMzIn0%3D&_nc_ohc=Hro8ywGWICwQ7kNvwFTleWr&_nc_oc=AdrhDqeDH-OZDKCf4QLVBk2WUhJrAshPXzuIlhWw_P6AR_nX2BaEMqPIktCAHVeR1TQ&_nc_ad=z-m&_nc_cid=0&_nc_zt=24&_nc_ht=scontent-lga3-1.cdninstagram.com&_nc_gid=HqCo1UU4Bu-OKS-mpoCPtg&_nc_ss=783ba&oh=00_AQCEFWKvv3G1YFBQVYuQeQ2WiqaOlYNaJfYc45gWaOii3A&oe=6A4C87F4"},"createdAt":"2026-06-09T16:22:45.000Z","likes":5}]},"meta":{"request_id":"req_example","next_cursor":"eyJtIjoie1wiY2FjaGVkX2NvbW1lbnRzX2N1cnNvclwiOlwiMTgwODE5NDQ5NDU2MzgyMDRcIixcImJpZmlsdGVyX3Rva2VuXCI6XCJHZ1lZZVFBTmMtQldwbXdfQUZHam1iVEJTRUFBSWZRYzJncmNQd0I2ZjhwdGpUeEJBRl9uemZXeFBrRUFuZmQ3Y0FkclFBQ0NjcEcyZW84X0FOb1pidlktWkVBQUFfR2pnX2NEUUFCWUtLLTRteVpBQUR0bDNqekljejhBM3BDclU1c1BRZ0JZR1J1dTdWNUFBQVBuQlFsQVAwQUFWUG1USmpxZFFBQUFcIn0ifQ==::sid::a1cfed67-d765-46b9-a260-01b2618f2147"}}}}}}}}}},"/v1/profiles/{platform}/{username}":{"get":{"tags":["Enrichment"],"summary":"Get social profile","description":"Retrieve a social media profile by platform and username.","parameters":[{"schema":{"type":"string","enum":["x","instagram","tiktok","linkedin","facebook","youtube","reddit"],"description":"Social platform"},"required":true,"description":"Social platform","name":"platform","in":"path"},{"schema":{"type":"string","description":"Username or handle (without @)"},"required":true,"description":"Username or handle (without @)","name":"username","in":"path"}],"responses":{"200":{"description":"Profile data","content":{"application/json":{"schema":{"type":"object","properties":{"data":{},"meta":{"$ref":"#/components/schemas/Meta"}},"required":["meta"]},"examples":{"sample":{"summary":"Sample response","value":{"data":{"type":"profile","id":"3cd43482-1588-5272-b84a-5c52c695f93a","platform":{"source":"instagram","name":"Instagram","id":"shopify","url":"https://www.instagram.com/shopify"},"content":{"name":"Shopify","bio":"The entrepreneurship company","url":"https://www.instagram.com/shopify","profilePicture":"https://graphql-staging.development.waldo.fyi/file/a096edbc-dd28-461d-acea-75b453dc6426"},"metrics":{"followers":2513954},"metadata":{"following":1697,"mediaCount":3678,"isVerified":true,"isBusiness":true,"isPrivate":false,"externalUrl":"https://shopify.supply/"}},"meta":{"request_id":"req_example"}}}}}}}}}},"/v1/profiles/{platform}/{username}/posts":{"get":{"tags":["Enrichment"],"summary":"Get user's recent posts","description":"Retrieve recent posts from a user's profile on the specified platform. For YouTube, `type` is required — YouTube splits a channel's uploads into separate `videos` (long-form) and `shorts` streams that must be fetched independently. Call this endpoint twice (once per type) if you want both.","parameters":[{"schema":{"type":"string","enum":["x","instagram","tiktok","linkedin","facebook","youtube","reddit"],"description":"Social platform"},"required":true,"description":"Social platform","name":"platform","in":"path"},{"schema":{"type":"string","description":"Username or handle (without @)"},"required":true,"description":"Username or handle (without @)","name":"username","in":"path"},{"schema":{"type":"string","enum":["videos","shorts"],"description":"YouTube only — selects which upload stream to fetch. Required when `platform=youtube`."},"required":false,"description":"YouTube only — selects which upload stream to fetch. Required when `platform=youtube`.","name":"type","in":"query"},{"schema":{"type":"string","description":"Pagination cursor for next page. One request returns one page; follow `meta.next_cursor` for deeper history."},"required":false,"description":"Pagination cursor for next page. One request returns one page; follow `meta.next_cursor` for deeper history.","name":"cursor","in":"query"}],"responses":{"200":{"description":"User's posts (single page)","content":{"application/json":{"schema":{"type":"object","properties":{"data":{},"meta":{"$ref":"#/components/schemas/Meta"}},"required":["meta"]},"examples":{"sample":{"summary":"Sample response","value":{"data":{"items":[{"type":"post","platform":{"source":"instagram","name":"Instagram","id":"3932455874203062376_207642893","url":"https://www.instagram.com/p/DaS48hUxZBo/"},"publishedAt":"2026-07-02T15:16:00.000Z","content":{"text":"meet your store’s new AI assistant","author":{"id":"207642893","username":"shopify","name":"Shopify","profileUrl":"https://instagram.com/shopify"},"media":[{"type":"video","url":"https://scontent-dfw5-2.cdninstagram.com/o1/v/t2/f2/m86/AQPEAop_OiffHZP1W85S-AZMVvPmydMPYngSQhmQf4CCEG8k_CXCr8I-J69HOWmphzt9bRa-ERL3ToOIG0z63zuhNShc4UufAh76y3A.mp4?_nc_cat=100&_nc_sid=5e9851&_nc_ht=scontent-dfw5-2.cdninstagram.com&_nc_ohc=dIBLL0ZcJtEQ7kNvwE91GV2&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5JTlNUQUdSQU0uQ0xJUFMuQzMuNzIwLmRhc2hfYmFzZWxpbmVfMV92MSIsInhwdl9hc3NldF9pZCI6MjM5OTAxNDYwMzkyNTkyMCwiYXNzZXRfYWdlX2RheXMiOjAsInZpX3VzZWNhc2VfaWQiOjEwMDk5LCJkdXJhdGlvbl9zIjozNCwidXJsZ2VuX3NvdXJjZSI6Ind3dyJ9&ccb=17-1&vs=39c422709aab9514&_nc_vs=HBksFQIYUmlnX3hwdl9yZWVsc19wZXJtYW5lbnRfc3JfcHJvZC8yNDRENjBDMzdFNUFENDg4QTY1RDY3MTZGRjJEM0Y5NF92aWRlb19kYXNoaW5pdC5tcDQVAALIARIAFQIYUWlnX3hwdl9wbGFjZW1lbnRfcGVybWFuZW50X3YyLzgwNDgxRDVDNzMwMzA5RURCNjE3RTBGNjk0N0UxMkI2X2F1ZGlvX2Rhc2hpbml0Lm1wNBUCAsgBEgAoABgAGwKIB3VzZV9vaWwBMRJwcm9ncmVzc2l2ZV9yZWNpcGUBMRUAACbAprnUg_nCCBUCKAJDMywXQEEd0vGp--cYEmRhc2hfYmFzZWxpbmVfMV92MREAdf4HZeadAQA&_nc_gid=R4zsr0fB1BOz-VPqYTg-Lg&_nc_ss=7a3ba&_nc_zt=28&oh=00_AQBFMe3IgRXF0uKGxZKl9J6jFHBHlKGIBI6HH_kkRUdWyg&oe=6A48A841","thumbnail":"https://scontent-dfw5-2.cdninstagram.com/v/t51.82787-15/731173287_18621289519026894_6056425848554652199_n.jpg?stp=dst-jpg_e15_s640x640_tt6&_nc_cat=100&ig_cache_key=MzkzMjQ1NTg3NDIwMzA2MjM3NjE4NjIxMjg5NTEzMDI2ODk0.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6IkNMSVBTLnhwaWRzLjEwODAuc2RyLnZpZGVvX2RlZmF1bHRfY292ZXJfZnJhbWUuQzMifQ%3D%3D&_nc_ohc=EkSNGhkOpnQQ7kNvwF8S945&_nc_oc=AdrBYhqP05-SPWfBide4Oc93afGhwtW0kEVK2WZBdvRsyHkqepsA69Q8FFYCORjewAQ&_nc_ad=z-m&_nc_cid=0&_nc_zt=23&_nc_ht=scontent-dfw5-2.cdninstagram.com&_nc_gid=R4zsr0fB1BOz-VPqYTg-Lg&_nc_ss=7a3ba&oh=00_AQAvUjL7ImSnr5B8A3OYOBWqz1yWUD9YKN_ZFAKTYTUJrg&oe=6A4C9AB5"}],"metrics":{"likes":86,"comments":8,"views":35668}},"post_id":"pid_eyJwIjoiaW5zdGFncmFtIiwiayI6Imh0dHBzOi8vd3d3Lmluc3RhZ3JhbS5jb20vcC9EYVM0OGhVeFpCby8iLCJpIjoiMzkzMjQ1NTg3NDIwMzA2MjM3Nl8yMDc2NDI4OTMifQ"},{"type":"post","platform":{"source":"instagram","name":"Instagram","id":"3931029577611173112_207642893","url":"https://www.instagram.com/p/DaN0pLHEVz4/"},"publishedAt":"2026-06-30T16:01:04.000Z","content":{"text":"still not over these Spring ’26 Edition updates","author":{"id":"207642893","username":"shopify","name":"Shopify","profileUrl":"https://instagram.com/shopify"},"media":[{"type":"image","url":"https://scontent-dfw5-1.cdninstagram.com/v/t51.82787-15/730949167_18620659255026894_597429242497491174_n.jpg?stp=dst-jpg_e35_tt6&_nc_cat=111&ig_cache_key=MzkzMTAyOTU2MjQzNjE3MDE3MQ%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6IkNBUk9VU0VMX0lURU0ueHBpZHMuMTA4MC5zZHIucmVndWxhcl9waG90by5DMyJ9&_nc_ohc=zeS3zm3MW0wQ7kNvwHIGyhi&_nc_oc=AdpdccRschRNV6nPK1oOqGtrRP-US4AvoSqJO6qIVPF2Gkbzqu7YbxGwI4Ye9q-fvL8&_nc_ad=z-m&_nc_cid=0&_nc_zt=23&se=7&_nc_ht=scontent-dfw5-1.cdninstagram.com&_nc_gid=R4zsr0fB1BOz-VPqYTg-Lg&_nc_ss=7a3ba&oh=00_AQDcCv_1wNYuj-j8alfN3cWSB3qL1LpJ2hG8QwMJTjfa4w&oe=6A4C90FA","thumbnail":"https://scontent-dfw5-1.cdninstagram.com/v/t51.82787-15/730949167_18620659255026894_597429242497491174_n.jpg?stp=dst-jpg_e35_s480x480_sh2.08_tt6&_nc_cat=111&ig_cache_key=MzkzMTAyOTU2MjQzNjE3MDE3MQ%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6IkNBUk9VU0VMX0lURU0ueHBpZHMuMTA4MC5zZHIucmVndWxhcl9waG90by5DMyJ9&_nc_ohc=zeS3zm3MW0wQ7kNvwHIGyhi&_nc_oc=AdpdccRschRNV6nPK1oOqGtrRP-US4AvoSqJO6qIVPF2Gkbzqu7YbxGwI4Ye9q-fvL8&_nc_ad=z-m&_nc_cid=0&_nc_zt=23&_nc_ht=scontent-dfw5-1.cdninstagram.com&_nc_gid=R4zsr0fB1BOz-VPqYTg-Lg&_nc_ss=7a3ba&oh=00_AQBeP7G4IrILqpGobDzGFV9j1_PWwxCUN8pBIlkYKZufVg&oe=6A4C90FA"},{"type":"video","url":"https://scontent-dfw5-2.cdninstagram.com/o1/v/t16/f2/m84/AQNG5cEk5L1iwHMyBAtZhINjKLFzonAFi4ga9GH1qPmTnLX5Mk4sz6ZGFHiiuaq17oXf1PduIW0_aQE97Qj7Gc7JMiC4Z2Z5z_6pXok.mp4?_nc_cat=107&_nc_sid=5e9851&_nc_ht=scontent-dfw5-2.cdninstagram.com&_nc_ohc=zaas6Kq6DUcQ7kNvwGdMKnc&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5JTlNUQUdSQU0uQ0FST1VTRUxfSVRFTS5DMy43MjAuZGFzaF9iYXNlbGluZV8xX3YxIiwieHB2X2Fzc2V0X2lkIjoxODYyMDY1OTI3MDAyNjg5NCwiYXNzZXRfYWdlX2RheXMiOjIsInZpX3VzZWNhc2VfaWQiOjEwMTQ2LCJkdXJhdGlvbl9zIjoxNSwidXJsZ2VuX3NvdXJjZSI6Ind3dyJ9&ccb=17-1&vs=f371dc6b01fa6b12&_nc_vs=HBksFQIYTGlnX2JhY2tmaWxsX3RpbWVsaW5lX3ZvZC8zQTRDNTVEMUNDODNGNUY3RTIwRDNEMTkxMkZFNThBRF92aWRlb19kYXNoaW5pdC5tcDQVAALIARIAFQIYUWlnX3hwdl9wbGFjZW1lbnRfcGVybWFuZW50X3YyL0M0NDYxNkYwRUIwQzkzMTg2NTYwNTQ4RjcxNEFFMEE2X2F1ZGlvX2Rhc2hpbml0Lm1wNBUCAsgBEgAoABgAGwKIB3VzZV9vaWwBMRJwcm9ncmVzc2l2ZV9yZWNpcGUBMRUAACacmrDUgtmTQhUCKAJDMywXQC5uFHrhR64YEmRhc2hfYmFzZWxpbmVfMV92MREAde4HZcSeAQA&_nc_gid=R4zsr0fB1BOz-VPqYTg-Lg&_nc_ss=7a3ba&_nc_zt=28&oh=00_AQBoYnh8bSU9zd-5WycOookgk9OsUl67oeBLEqBn12Tong&oe=6A48A8FD","thumbnail":"https://scontent-dfw6-1.cdninstagram.com/v/t51.82787-15/730459126_18620659330026894_6020759325255510127_n.jpg?stp=dst-jpg_e15_s480x480_tt6&_nc_cat=101&ig_cache_key=MzkzMTAyOTM4MDE5MzY3MzI2Ng%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6IkNBUk9VU0VMX0lURU0ueHBpZHMuMTA4MC5zZHIudmlkZW9fZGVmYXVsdF9jb3Zlcl9mcmFtZS5DMyJ9&_nc_ohc=OOSOBC_gbnkQ7kNvwG_r6qG&_nc_oc=AdpAsR_EZZ2uYBbjyHCzAHlsXsoQEIyKGJonvET99lAzLi4NC0DcJdmf49l_57q6NIY&_nc_ad=z-m&_nc_cid=0&_nc_zt=23&_nc_ht=scontent-dfw6-1.cdninstagram.com&_nc_gid=R4zsr0fB1BOz-VPqYTg-Lg&_nc_ss=7a3ba&oh=00_AQDF8VSRLijIuSTG0wO0j7lJL0hor0WaI8qUvWJVoc02IQ&oe=6A4CB425"},{"type":"image","url":"https://scontent-dfw6-2.cdninstagram.com/v/t51.82787-15/731093848_18620659243026894_6925856025405780322_n.jpg?stp=dst-jpg_e35_tt6&_nc_cat=108&ig_cache_key=MzkzMTAyOTU2MjQ4NjQ5MzE3Nw%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6IkNBUk9VU0VMX0lURU0ueHBpZHMuMTA4MC5zZHIucmVndWxhcl9waG90by5DMyJ9&_nc_ohc=mGHWxea0sSkQ7kNvwG0j9Zz&_nc_oc=AdoTQewCnT-najpARA2rSlEs6rt36mDuVmk3R6D-R2ITg1Ncy3oNR5DLna1kXTPz71k&_nc_ad=z-m&_nc_cid=0&_nc_zt=23&se=7&_nc_ht=scontent-dfw6-2.cdninstagram.com&_nc_gid=R4zsr0fB1BOz-VPqYTg-Lg&_nc_ss=7a3ba&oh=00_AQDdeIf-HSTcwduE5zT1BibIJuCd-z_5wSNfayKdHp7G5w&oe=6A4C90F2","thumbnail":"https://scontent-dfw6-2.cdninstagram.com/v/t51.82787-15/731093848_18620659243026894_6925856025405780322_n.jpg?stp=dst-jpg_e35_s480x480_sh2.08_tt6&_nc_cat=108&ig_cache_key=MzkzMTAyOTU2MjQ4NjQ5MzE3Nw%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6IkNBUk9VU0VMX0lURU0ueHBpZHMuMTA4MC5zZHIucmVndWxhcl9waG90by5DMyJ9&_nc_ohc=mGHWxea0sSkQ7kNvwG0j9Zz&_nc_oc=AdoTQewCnT-najpARA2rSlEs6rt36mDuVmk3R6D-R2ITg1Ncy3oNR5DLna1kXTPz71k&_nc_ad=z-m&_nc_cid=0&_nc_zt=23&_nc_ht=scontent-dfw6-2.cdninstagram.com&_nc_gid=R4zsr0fB1BOz-VPqYTg-Lg&_nc_ss=7a3ba&oh=00_AQAdioQu5LQe1j7_B5svlAjaCr-Z0A8QYiWGZwNOQebTMg&oe=6A4C90F2"}],"metrics":{"likes":387,"comments":30}},"post_id":"pid_eyJwIjoiaW5zdGFncmFtIiwiayI6Imh0dHBzOi8vd3d3Lmluc3RhZ3JhbS5jb20vcC9EYU4wcExIRVZ6NC8iLCJpIjoiMzkzMTAyOTU3NzYxMTE3MzExMl8yMDc2NDI4OTMifQ"},{"type":"post","platform":{"source":"instagram","name":"Instagram","id":"3930315988868918229_207642893","url":"https://www.instagram.com/p/DaLSZFzkevV/"},"publishedAt":"2026-06-29T16:23:18.000Z","content":{"text":"you get the point. right?","author":{"id":"207642893","username":"shopify","name":"Shopify","profileUrl":"https://instagram.com/shopify"},"media":[{"type":"image","url":"https://scontent-dfw5-1.cdninstagram.com/v/t51.82787-15/730397788_18620321059026894_5631571691523317896_n.jpg?stp=dst-jpg_e35_p1080x1080_sh2.08_tt6&_nc_cat=106&ig_cache_key=MzkzMDMxNTUzOTQ0NDI2MzI1Mg%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6IkNBUk9VU0VMX0lURU0ueHBpZHMuMjI1MC5zZHIucmVndWxhcl9waG90by5DMyJ9&_nc_ohc=d82gkcI3TKoQ7kNvwEO2AZk&_nc_oc=Adraym4D64IIsIwD18VUVnasdIBO0VfmYhqtjTznTfEeyUfq7J-cWDjZ559B4cUZp7o&_nc_ad=z-m&_nc_cid=0&_nc_zt=23&_nc_ht=scontent-dfw5-1.cdninstagram.com&_nc_gid=R4zsr0fB1BOz-VPqYTg-Lg&_nc_ss=7a3ba&oh=00_AQAzlN6XDvJ33R0Cq46JLZoTpnJQX-aqS4kP-6znMFOwpg&oe=6A4C83C7","thumbnail":"https://scontent-dfw5-1.cdninstagram.com/v/t51.82787-15/730397788_18620321059026894_5631571691523317896_n.jpg?stp=dst-jpg_e35_s480x480_sh2.08_tt6&_nc_cat=106&ig_cache_key=MzkzMDMxNTUzOTQ0NDI2MzI1Mg%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6IkNBUk9VU0VMX0lURU0ueHBpZHMuMjI1MC5zZHIucmVndWxhcl9waG90by5DMyJ9&_nc_ohc=d82gkcI3TKoQ7kNvwEO2AZk&_nc_oc=Adraym4D64IIsIwD18VUVnasdIBO0VfmYhqtjTznTfEeyUfq7J-cWDjZ559B4cUZp7o&_nc_ad=z-m&_nc_cid=0&_nc_zt=23&_nc_ht=scontent-dfw5-1.cdninstagram.com&_nc_gid=R4zsr0fB1BOz-VPqYTg-Lg&_nc_ss=7a3ba&oh=00_AQCRSusviNhIW8BiasY0wr5zqUbTMOeDJsrsyvGXPr68rw&oe=6A4C83C7"},{"type":"image","url":"https://scontent-dfw6-2.cdninstagram.com/v/t51.82787-15/731037741_18620321056026894_3018214990530625326_n.jpg?stp=dst-jpg_e35_p1080x1080_sh2.08_tt6&_nc_cat=108&ig_cache_key=MzkzMDMxNTU0MDcwMjUyMDQ4NQ%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6IkNBUk9VU0VMX0lURU0ueHBpZHMuMjI1MC5zZHIucmVndWxhcl9waG90by5DMyJ9&_nc_ohc=o9d95nGvBEEQ7kNvwHPXLMm&_nc_oc=Adpgmz_F6FjE6lU2cKAQfmsiuBI5jdC7s8HLMEpZ6dc7LLgXXl8ushOmSlsrQtb6DL4&_nc_ad=z-m&_nc_cid=0&_nc_zt=23&_nc_ht=scontent-dfw6-2.cdninstagram.com&_nc_gid=R4zsr0fB1BOz-VPqYTg-Lg&_nc_ss=7a3ba&oh=00_AQAqxJX_Tchi2uIhEaQXYEzYgNcDIF5ej39aPI1JvipMyQ&oe=6A4CA04D","thumbnail":"https://scontent-dfw6-2.cdninstagram.com/v/t51.82787-15/731037741_18620321056026894_3018214990530625326_n.jpg?stp=dst-jpg_e35_s480x480_sh2.08_tt6&_nc_cat=108&ig_cache_key=MzkzMDMxNTU0MDcwMjUyMDQ4NQ%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6IkNBUk9VU0VMX0lURU0ueHBpZHMuMjI1MC5zZHIucmVndWxhcl9waG90by5DMyJ9&_nc_ohc=o9d95nGvBEEQ7kNvwHPXLMm&_nc_oc=Adpgmz_F6FjE6lU2cKAQfmsiuBI5jdC7s8HLMEpZ6dc7LLgXXl8ushOmSlsrQtb6DL4&_nc_ad=z-m&_nc_cid=0&_nc_zt=23&_nc_ht=scontent-dfw6-2.cdninstagram.com&_nc_gid=R4zsr0fB1BOz-VPqYTg-Lg&_nc_ss=7a3ba&oh=00_AQBeLSTl9EaS4ft44twm_2K8l3tWo3hizGPlPltDojdD7g&oe=6A4CA04D"},{"type":"image","url":"https://scontent-dfw6-1.cdninstagram.com/v/t51.82787-15/731350619_18620321068026894_2023573432799055443_n.jpg?stp=dst-jpg_e35_p1080x1080_sh2.08_tt6&_nc_cat=101&ig_cache_key=MzkzMDMxNTU0MTY5MjM0MTk1OA%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6IkNBUk9VU0VMX0lURU0ueHBpZHMuMjI1MC5zZHIucmVndWxhcl9waG90by5DMyJ9&_nc_ohc=R5W0Tj4kfU8Q7kNvwFGdx4h&_nc_oc=AdrO0x4UF1a-1PPAg5DogZXRuEVl1SLb4Hkn4PFdc3pmFwzyzk0SpzS7nPLQ5GFjlq0&_nc_ad=z-m&_nc_cid=0&_nc_zt=23&_nc_ht=scontent-dfw6-1.cdninstagram.com&_nc_gid=R4zsr0fB1BOz-VPqYTg-Lg&_nc_ss=7a3ba&oh=00_AQCn6gP44TggSR4PCuiWvY36RtL8Ut6_-ypyxAd7dWpHrA&oe=6A4CB01C","thumbnail":"https://scontent-dfw6-1.cdninstagram.com/v/t51.82787-15/731350619_18620321068026894_2023573432799055443_n.jpg?stp=dst-jpg_e35_s480x480_sh2.08_tt6&_nc_cat=101&ig_cache_key=MzkzMDMxNTU0MTY5MjM0MTk1OA%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6IkNBUk9VU0VMX0lURU0ueHBpZHMuMjI1MC5zZHIucmVndWxhcl9waG90by5DMyJ9&_nc_ohc=R5W0Tj4kfU8Q7kNvwFGdx4h&_nc_oc=AdrO0x4UF1a-1PPAg5DogZXRuEVl1SLb4Hkn4PFdc3pmFwzyzk0SpzS7nPLQ5GFjlq0&_nc_ad=z-m&_nc_cid=0&_nc_zt=23&_nc_ht=scontent-dfw6-1.cdninstagram.com&_nc_gid=R4zsr0fB1BOz-VPqYTg-Lg&_nc_ss=7a3ba&oh=00_AQAFwsw4C1yLsAJLHxMlLc6UPpeBLJh4TFUupewNhjgyrw&oe=6A4CB01C"}],"metrics":{"likes":532,"comments":38}},"post_id":"pid_eyJwIjoiaW5zdGFncmFtIiwiayI6Imh0dHBzOi8vd3d3Lmluc3RhZ3JhbS5jb20vcC9EYUxTWkZ6a2V2Vi8iLCJpIjoiMzkzMDMxNTk4ODg2ODkxODIyOV8yMDc2NDI4OTMifQ"}]},"meta":{"request_id":"req_example","next_cursor":"eyJpIjoiMzkyMDk4NTcxNzQzNzI1MjE2OCIsImciOiJRVkZEWldGeFFsVmhiVUl5VTBjNFZFRkxXSEY0YzBGMlpYWlNUbkEyVjBoWlRHMXhUV2t0WWpGbVpGZDVhRzVpY2xwbVNYVkVNMFJwWVdJNE1XNXVXVUV0VDJSNlgwd3pkazlrV0c1WWJGTnJPWGxHVWtaZmNBPT0ifQ==::sid::ae543558-c093-4060-9215-18cf4e19bd6f"}}}}}}}}}},"/v1/profiles/{platform}/{username}/following":{"get":{"tags":["Enrichment"],"summary":"Get accounts a user follows","description":"Retrieve the accounts a user follows on the specified platform. Supported on x, instagram, tiktok, and facebook. One request returns one page (~50–70 accounts); follow `meta.next_cursor` in the response to page deeper.","parameters":[{"schema":{"type":"string","enum":["x","instagram","tiktok","facebook"],"description":"Social platform (x, instagram, tiktok, facebook)"},"required":true,"description":"Social platform (x, instagram, tiktok, facebook)","name":"platform","in":"path"},{"schema":{"type":"string","description":"Username or handle (without @)"},"required":true,"description":"Username or handle (without @)","name":"username","in":"path"},{"schema":{"type":"string","description":"Pagination cursor for the next page. One request returns one page; pass back the `meta.next_cursor` returned in the response for more."},"required":false,"description":"Pagination cursor for the next page. One request returns one page; pass back the `meta.next_cursor` returned in the response for more.","name":"cursor","in":"query"}],"responses":{"200":{"description":"Accounts the user follows (single page)","content":{"application/json":{"schema":{"type":"object","properties":{"data":{},"meta":{"$ref":"#/components/schemas/Meta"}},"required":["meta"]}}}}}}},"/v1/videos/{video_id}/transcript":{"get":{"tags":["Enrichment"],"summary":"Get video transcript","description":"Retrieve the transcript for a YouTube video.","parameters":[{"schema":{"type":"string","description":"YouTube video ID"},"required":true,"description":"YouTube video ID","name":"video_id","in":"path"}],"responses":{"200":{"description":"Video transcript","content":{"application/json":{"schema":{"type":"object","properties":{"data":{},"meta":{"$ref":"#/components/schemas/Meta"}},"required":["meta"]},"examples":{"sample":{"summary":"Sample response","value":{"data":{"data":[{"text":"","startMs":0,"durationMs":28875},{"text":"Can I use Shopify to sell these cookies","startMs":0,"durationMs":5560},{"text":"\n","startMs":2150,"durationMs":3410}]},"meta":{"request_id":"req_example"}}}}}}}}}},"/v1/companies/{platform}/search":{"get":{"tags":["Enrichment"],"summary":"Search company directory","description":"Search a platform's company directory by name. LinkedIn dispatches to the Vetric companies search; Facebook dispatches to the Meta Ad Library (returning page_alias and ig_username natively). Other platforms return 400 'platform not supported'.","parameters":[{"schema":{"type":"string","enum":["x","instagram","tiktok","linkedin","facebook","youtube","reddit"],"description":"Platform (linkedin and facebook supported today)"},"required":true,"description":"Platform (linkedin and facebook supported today)","name":"platform","in":"path"},{"schema":{"type":"string","minLength":1,"description":"Search query (typically a brand name)"},"required":true,"description":"Search query (typically a brand name)","name":"q","in":"query"},{"schema":{"type":"string","description":"Pagination cursor for next page. One request returns one page; follow `meta.next_cursor` for more."},"required":false,"description":"Pagination cursor for next page. One request returns one page; follow `meta.next_cursor` for more.","name":"cursor","in":"query"},{"schema":{"type":"string","description":"ISO 2-letter country code (Facebook / Meta Ad Library only)"},"required":false,"description":"ISO 2-letter country code (Facebook / Meta Ad Library only)","name":"country","in":"query"}],"responses":{"200":{"description":"Company search results (single page)","content":{"application/json":{"schema":{"type":"object","properties":{"data":{},"meta":{"$ref":"#/components/schemas/Meta"}},"required":["meta"]}}}}}}},"/v1/companies/{platform}/{identifier}":{"get":{"tags":["Enrichment"],"summary":"Get company profile","description":"Retrieve a company profile (org page, not a personal user profile) by identifier on the specified platform. LinkedIn supported today.","parameters":[{"schema":{"type":"string","enum":["x","instagram","tiktok","linkedin","facebook","youtube","reddit"],"description":"Platform (linkedin supported today)"},"required":true,"description":"Platform (linkedin supported today)","name":"platform","in":"path"},{"schema":{"type":"string","description":"Company URL, slug, or numeric identifier"},"required":true,"description":"Company URL, slug, or numeric identifier","name":"identifier","in":"path"}],"responses":{"200":{"description":"Company profile","content":{"application/json":{"schema":{"type":"object","properties":{"data":{},"meta":{"$ref":"#/components/schemas/Meta"}},"required":["meta"]},"examples":{"sample":{"summary":"Sample response","value":{"data":{"platform":"linkedin","name":"Shopify","publicIdentifier":"shopify","universalName":"shopify","linkedinId":784652,"urn":"urn:li:fsd_company:784652","url":"https://www.linkedin.com/company/shopify/","logo":"https://media.licdn.com/dms/image/v2/D560BAQG_KjTcNcrLVw/company-logo_400_400/B56ZZolTV.HUAk-/0/1745511331439/shopify_logo?e=1784160000&v=beta&t=s3b-rgvU_hQkCcEysdV3U6Nn2_YFTa4gh_nWCACTJDo","backgroundImage":"https://media.licdn.com/dms/image/v2/D561BAQHhgj9vXYPfGw/company-background_10000/B56ZanR4DlHUAg-/0/1746563203645/shopify_cover?e=1782918000&v=beta&t=MOgFwx8Dbnv6e-ibC9U-3cFUlLg1ln2XtQxr0_3JSQg","headline":"Make commerce better for everyone","followersCount":1092017,"employeeCountRange":{"start":10001,"end":null},"industry":[{"name":"Software Development","urn":"urn:li:fsd_industryV2:4"}]},"meta":{"request_id":"req_example"}}}}}}}}}},"/v1/companies/{platform}/{identifier}/jobs":{"get":{"tags":["Enrichment"],"summary":"Get company jobs","description":"Retrieve job listings for a company on the specified platform. One request returns one page; follow `meta.next_cursor` in the response to page deeper.","parameters":[{"schema":{"type":"string","enum":["x","instagram","tiktok","linkedin","facebook","youtube","reddit"],"description":"Platform (linkedin supported today)"},"required":true,"description":"Platform (linkedin supported today)","name":"platform","in":"path"},{"schema":{"type":"string","description":"Company URL, slug, or numeric identifier"},"required":true,"description":"Company URL, slug, or numeric identifier","name":"identifier","in":"path"},{"schema":{"type":"string","description":"Pagination cursor for the next page. One request returns one page; pass back the `meta.next_cursor` returned in the response for more."},"required":false,"description":"Pagination cursor for the next page. One request returns one page; pass back the `meta.next_cursor` returned in the response for more.","name":"cursor","in":"query"}],"responses":{"200":{"description":"Company job listings","content":{"application/json":{"schema":{"type":"object","properties":{"data":{},"meta":{"$ref":"#/components/schemas/Meta"}},"required":["meta"]},"examples":{"sample":{"summary":"Sample response","value":{"data":{"items":[{"company":"Shopify","listing_date":"2026-07-02T17:38:33.000Z","location":"Toronto, ON (On-site)","subtitle":null,"title":"Protective Intelligence Analyst, Security Operations (Toronto)","url":"https://www.linkedin.com/jobs/view/4435234827","urn":"urn:li:fs_normalized_jobPosting:4435234827"},{"company":"Shopify","listing_date":"2026-07-02T11:46:59.000Z","location":"NAMER (Remote)","subtitle":null,"title":"Enterprise Account Executive (Americas)","url":"https://www.linkedin.com/jobs/view/4426172819","urn":"urn:li:fs_normalized_jobPosting:4426172819"},{"company":"Shopify","listing_date":"2026-07-02T05:38:31.000Z","location":"NAMER (Remote)","subtitle":null,"title":"Staff Product Data Scientist -  Developer Productivity (Americas)","url":"https://www.linkedin.com/jobs/view/4435046146","urn":"urn:li:fs_normalized_jobPosting:4435046146"}]},"meta":{"request_id":"req_example","next_cursor":"eyJjb3VudCI6MTAwLCJzdGFydCI6MTAwLCJ0b3RhbCI6MTI3LCJwYWdpbmF0aW9uVG9rZW4iOm51bGx9"}}}}}}}}}},"/v1/companies/{platform}/{identifier}/people":{"get":{"tags":["Enrichment"],"summary":"Get company people","description":"Retrieve people associated with a company on the specified platform. One request returns one page; follow `meta.next_cursor` in the response to page deeper.","parameters":[{"schema":{"type":"string","enum":["x","instagram","tiktok","linkedin","facebook","youtube","reddit"],"description":"Platform (linkedin supported today)"},"required":true,"description":"Platform (linkedin supported today)","name":"platform","in":"path"},{"schema":{"type":"string","description":"Company URL, slug, or numeric identifier"},"required":true,"description":"Company URL, slug, or numeric identifier","name":"identifier","in":"path"},{"schema":{"type":"string","description":"Pagination cursor for the next page. One request returns one page; pass back the `meta.next_cursor` returned in the response for more."},"required":false,"description":"Pagination cursor for the next page. One request returns one page; pass back the `meta.next_cursor` returned in the response for more.","name":"cursor","in":"query"}],"responses":{"200":{"description":"Company people","content":{"application/json":{"schema":{"type":"object","properties":{"data":{},"meta":{"$ref":"#/components/schemas/Meta"}},"required":["meta"]},"examples":{"sample":{"summary":"Sample response","value":{"data":{"items":[{"name":"Karan Beer","position":"Entrepreneur at Shopify","location":"Wednesbury","publicIdentifier":"karan-beer-086920411","urn":"urn:li:fsd_profile:ACoAAGj3HmYBwqWMobHIUVoBvpoxqtduV3CD0yE","url":"https://www.linkedin.com/in/karan-beer-086920411","image":"https://media.licdn.com/dms/image/v2/D4D03AQG6612RaB1vjw/profile-displayphoto-shrink_800_800/B4DZ5gzRZLKIAg-/0/1779740514242?e=1784764800&v=beta&t=5IvKVhp-hSaAWjqfYEGBxlwMUQpauv9vT9TxavBud6k"},{"name":"Faith Tayengwa","position":"Business Management Graduate | Aspiring Brand Marketing Executive | Founder of Cosmetics Brand","location":"Salford","publicIdentifier":"faith-tayengwa-bb5567404","urn":"urn:li:fsd_profile:ACoAAGdPV_kBKF3tGyW9LF4Bn6NRoMKvch_n7ZM","url":"https://www.linkedin.com/in/faith-tayengwa-bb5567404","image":"https://media.licdn.com/dms/image/v2/D4E03AQFAAkzF9cvR3A/profile-displayphoto-scale_100_100/B4EZ2mWH4oJkAc-/0/1776612314209?e=1784764800&v=beta&t=C5QUEtGRBmcJJpbe-BzkBZMRezBBuVWTUkvw1oRF0dM"},{"name":"Muhammad Ahmed","position":"Student at New City College","location":"Greater London","publicIdentifier":"muhammadahmed28","urn":"urn:li:fsd_profile:ACoAAF0cO3sB2SRugX7UNtoBd-Ypc9X5uT9WBy4","url":"https://www.linkedin.com/in/muhammadahmed28","image":"https://media.licdn.com/dms/image/v2/D4E03AQF-loKNJtFLvA/profile-displayphoto-scale_100_100/B4EZ7KOkdpKQAY-/0/1781509278392?e=1784764800&v=beta&t=SrO0ea55qk3JwcfEEf4W0Lsw6MoTf9tS4w9JIFgLLNU"}]},"meta":{"request_id":"req_example","next_cursor":"eyJjb3VudCI6MTAsInN0YXJ0IjoxMCwidG90YWwiOjEwMDAsInBhZ2luYXRpb25Ub2tlbiI6bnVsbCwiX3NpZCI6IjI4ODQ2ZGQ4LThlOGMtNDY0Yy1iYTJiLTA0MmNkZDk3MzM2ZiJ9"}}}}}}}}}},"/v1/account":{"get":{"tags":["Account"],"summary":"Get account","description":"Returns account profile information for the authenticated team, including entity counts (brands, categories, audiences).","responses":{"200":{"description":"Account profile","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/AccountProfile"},"meta":{"$ref":"#/components/schemas/Meta"}},"required":["data","meta"]},"examples":{"sample":{"summary":"Sample response","value":{"data":{"account_id":"1","email":null,"entities":{"brands":18,"categories":129,"audiences":150},"requests_this_month":0},"meta":{"request_id":"req_example"}}}}}}}}}},"/v1/account/balance":{"get":{"tags":["Account"],"summary":"Get credit balance","description":"Returns the team's credit balance for the current billing period: remaining balance, used, limit, plan, and period bounds.","responses":{"200":{"description":"Credit balance","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/AccountBalance"},"meta":{"$ref":"#/components/schemas/Meta"}},"required":["data","meta"]},"examples":{"sample":{"summary":"Sample response","value":{"data":{"balance":10000,"used":0,"limit":0,"plan":null,"status":null,"period":{"start":null,"end":null,"days_remaining":null}},"meta":{"request_id":"req_example"}}}}}}}}}},"/v1/account/usage":{"get":{"tags":["Account"],"summary":"Get usage","description":"Returns API usage breakdown for the current billing period. V1 returns placeholder data; metering will be available in a future version.","responses":{"200":{"description":"Usage breakdown","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/AccountUsage"},"meta":{"$ref":"#/components/schemas/Meta"}},"required":["data","meta"]},"examples":{"sample":{"summary":"Sample response","value":{"data":{"period":{"start":"2026-06-01","end":"2026-06-30"},"total_calls":0,"by_domain":[]},"meta":{"request_id":"req_example"}}}}}}}}}}},"webhooks":{},"x-tagGroups":[{"name":"Discover","tags":["Discover"]},{"name":"Enrichment","tags":["Enrichment"]},{"name":"Account & Access","tags":["Account","API Keys"]}]}