{"openapi":"3.0.3","info":{"title":"virev.ai Social Data API","version":"5.0.0","description":"Social data and profile intelligence across Instagram, TikTok, YouTube, LinkedIn, Facebook, Douyin, Xiaohongshu (RED) and the Meta Ad Library, plus Instagram DM outreach. Every operation is one HTTPS call with a `kb_live_…` key, and every answer is `{ data, meta }`. No SDK is needed.\n\n## Quickstart\n\n1. Create an account, top up from $1 by card, and copy your `kb_live_…` key from the [dashboard](/dashboard/keys).\n2. Send the key as a Bearer token on every request.\n3. Call any operation in this reference.\n\n```bash\ncurl \"https://api.virev.ai/v1/instagram/profile?q=nike\" \\\n  -H \"Authorization: Bearer $VIREV_API_KEY\"\n```\n\nTo run an operation from this page, paste your key under Authentication in the operation's request panel and send it.\n\n## Authentication\n\nSend your secret API key as a Bearer token. A key is `kb_live_` followed by 32 hex characters. Keep it on your server and never ship it in client code. All keys of one organization share its balance and its rate limit.\n\n```http\nAuthorization: Bearer $VIREV_API_KEY\n```\n\n## Response envelope\n\nA successful answer puts the payload in `data` and adds a `meta` block with the amount charged, your remaining balance and a request id to quote to support. Every answer, an error included, also carries that id in the `X-Request-Id` header. A read that can crawl also carries `meta.source`, `meta.source_copy` and `meta.fetched_at`.\n\n```json\n{\n  \"data\": { \"...\": \"operation payload\" },\n  \"meta\": {\n    \"cost\": \"$0.0005\",\n    \"balance\": \"$9.9995\",\n    \"request_id\": \"req_de5f6bdc8ee143b29e5533ec34728e50\"\n  }\n}\n```\n\n## Errors\n\nAn error answers with a standard HTTP status and a body of `{ \"error\": { \"code\", \"message\", \"request_id\" } }`, where `code` is stable. You pay only for a successful answer, so a failed upstream call never costs you.\n\n- `invalid_request` (400): A required parameter is missing or malformed.\n- `invalid_api_key` (401): The API key is missing, malformed or revoked.\n- `insufficient_balance` (402): Your balance is too low for this request. Top up to continue.\n- `account_unavailable` (403): Instagram does not show this account to logged-out readers, because it is private, hidden, restricted or gone. A retry will not help, and you are not charged.\n- `not_found` (404): The profile or advertiser was not found.\n- `not_cached` (404): `cached=cache_only` found nothing saved for these arguments. Call again with `cached=auto` to fetch it.\n- `gone` (410): The path is retired. The message names the path that replaced it.\n- `message_undeliverable` (422): Instagram will not deliver messages to this person, for example because they blocked us. Nothing was sent, you are not charged, and a retry will not help.\n- `rate_limit_exceeded` (429): Your organization is over its per-minute limit, which all its keys share. Wait for the `Retry-After` header.\n- `upstream_error` (502 or 504): The upstream fetch failed or timed out. You are not charged.\n- `proxy_provider_down` (503): Our proxy provider is not serving reads right now. Retry after the `Retry-After` delay. You are not charged.\n- `source_paused` (503): This source is paused for now. Retry later, and honor `Retry-After` when it is sent. You are not charged.\n- `auth_unavailable` (503): The API key could not be checked right now. Retry it. No data was returned and you are not charged.\n- `rate_limit_unavailable` (503): The rate limiter could not count this call. Retry it. No data was returned and you are not charged.\n- `billing_unavailable` (503): The charge could not be confirmed, so no data was returned. Retry it. You are not charged.\n\nThe Instagram DM calls have a few codes of their own, listed under [Instagram DM](#tag/instagram-dm).\n\n## Rate limits\n\nThe default limit is 100 requests per minute for each organization, and all of its API keys share it. Every response carries `X-RateLimit-Limit`, `X-RateLimit-Remaining` and `X-RateLimit-Reset`. On a `429`, wait for the `Retry-After` header before you retry. To get more throughput, ask for an increase on the [Keys page](/dashboard/keys) of your dashboard.\n\n## Pagination\n\nSeven Instagram wrappers walk lists: `user_feed`, `usertags_feed` (tagged media), `post_comments`, `popular_search_media`, `loggedout_timeline`, `followers` and `following`. Their page controls are `since`, `max_pages`, `cursor` and `page_size`, in that order.\n\n- `max_pages=1` answers one page in the request.\n- Any other `max_pages`, or none, starts a durable job that answers HTTP 202.\n- `max_pages=-1` walks with no page cap, and a positive number stops after that many pages.\n- Zero and other negative values answer 400.\n- A call with neither `since` nor `max_pages` stops after 10 pages.\n- When both are set, the first boundary reached stops the walk.\n\n### One year with no page limit\n\nThis call answers HTTP 202, and the crawler walks the last 365 days with no cursor handling on your side.\n\n```bash\ncurl \"https://api.virev.ai/v1/instagram/user_feed?handle=instagram&since=365d\" \\\n  -H \"Authorization: Bearer $VIREV_API_KEY\"\n```\n\nFor the posts that tag a brand, use the brand's handle.\n\n```bash\ncurl \"https://api.virev.ai/v1/instagram/usertags_feed?handle=nike&since=365d\" \\\n  -H \"Authorization: Bearer $VIREV_API_KEY\"\n```\n\n### A date with a page limit\n\nThis job stops at 10 pages or at the date, whichever it reaches first.\n\n```bash\ncurl \"https://api.virev.ai/v1/instagram/user_feed?handle=instagram&since=2025-09-21&max_pages=10\" \\\n  -H \"Authorization: Bearer $VIREV_API_KEY\"\n```\n\n### Dates\n\n`since=2025-09-21` means midnight UTC, 2025-09-21T00:00:00Z. A datetime needs an RFC3339 timezone, such as 2025-09-21T09:00:00+09:00, and `365d` means 365 days before you submit. An invalid calendar date answers 400. Only `user_feed`, `usertags_feed` and `post_comments` take `since`, and the other operations answer 400 to it before any crawl or charge.\n\n### Jobs\n\nSave the job's `batch_id`, `status_url` and `results_url`. Poll `status_url` until the job is ready, then read `results_url` and send back its `next_cursor` until `complete` is true. Every collection job also answers at `/v1/jobs/{job_id}`.\n\nEach result response is at most 3 MiB, and that bound does not cap the crawl. Send an `Idempotency-Key` header and reuse it with the same inputs to recover a lost submission response. A job keeps running after you disconnect.\n\nA job charges once, when it completes, for the unique units it returned. Submitting, polling and repeated downloads are free, and a failed job never charges. If your balance is too low, the results answer 402 with no data until you top up and poll again. Generic batch rows for these operations need `max_pages=1`, so submit a longer walk through the operation's own path.\n\n### Synchronous pages\n\nA synchronous answer holds `items`, `pages`, `next_cursor`, `stop_reason` and `coverage`. Its acquisition cursor resumes the same operation, and it is not the result download cursor of a job. The stop reasons are `pages`, `deadline`, `since`, `exhausted`, `cursor_stalled`, `repeated_content` and `blocked`.\n\nEvery wrapper takes `cached=auto|cache_only|live` and `get_raw`. A raw job returns the native pages. An output unit above 3 MiB fails the job before billing, and its results answer 413. The `cached` mode you pick never changes on its own. Followers and following carry `rank_token` inside the opaque cursor.\n\n### Page sizes\n\n`page_size` sets the native page size. The defaults are 12 for `user_feed` and `loggedout_timeline`, 21 for `usertags_feed`, 24 for `post_comments`, 50 for `followers` and `following`, and 100 for `popular_search_media`, which is the only one with a measured maximum, 100. Instagram decides how many items it returns. The native `max_id`, `after`, `count` and `first` names answer 400.\n\n`highlights_tray` takes `max_highlights_to_fetch_on_pagination`, and `popular_search` takes `media_count` and `related_keywords_count`. These operations return one document.\n\n`username` is an old name of `handle` on `web_profile_info`, `user_feed`, `embed`, `loggedout_profile` and `loggedout_timeline`. It keeps working, and new code should send `handle`.\n\n### Other networks\n\nYouTube channel videos, Shorts and lives take the same `since`, `max_pages`, `cursor`, `cached` and `get_raw` controls. Send `handle` or `channel_id`, never both. YouTube sets the page size, so an explicit `page_size` answers 400. `sort=popular` works on videos and Shorts only, and ranked pages filter out old items without assuming that later pages are older. The YouTube flat price applies once to a successful job.\n\nThe paged operations of the other networks use the same grammar, and each operation's parameters list the controls it takes.\n\n## Reads and sends\n\nAlmost every operation here reads data. The two [Instagram DM](#tag/instagram-dm) calls send messages to real people, so a send cannot be undone. Read that section before you integrate.\n\n## One folder per network\n\nEvery operation lives under `api.virev.ai/v1`, in one folder per network.\n\n- A library read sits at the network root, such as `/v1/instagram/profile`. It answers at once from the tracked corpus, and a miss is a `404`, never a crawl.\n- A stored read sits under `/v1/{network}/stored/…` and also never crawls.\n- An operation wrapper, `/v1/{network}/<op>`, is the only kind of call that can crawl. It takes `cached=auto|cache_only|live`, where `auto` serves a saved read younger than 24 hours, plus `get_raw` and the page controls. The default answer is a documented normalized type, and `get_raw=true` returns the upstream JSON.\n\nThe networks are these.\n\n- Instagram has the library profile and one wrapper per Instagram operation at `/v1/instagram/<op>`, such as `web_profile_info`, `user_feed`, `post`, `post_comments`, `followers` and `story`.\n- TikTok has library profiles, videos and stats, stored videos and comments, and one wrapper per TikTok operation at `/v1/tiktok/<op>`, such as `user_detail`, `item_list` and `comment_list`.\n- YouTube has library profiles, videos and stats, the stored video and its comments, and one wrapper per YouTube operation at `/v1/youtube/<op>`, such as `channel`, `channel_videos`, `video` and `video_transcript`.\n- LinkedIn has public company pages, members, posts, jobs, job search and the LinkedIn Ad Library at `/v1/linkedin/<op>`, and stored reads under `/v1/linkedin/stored/…`.\n- Facebook has a page with its photos, reels and events, a public group, a post with its comments, replies and caption track, one event and event search at `/v1/facebook/<op>`, and stored pages, posts and comments.\n- Xiaohongshu has its logged-out `explore`, `user_profile` and `note_detail` pages at `/v1/xiaohongshu/<op>`, and stored notes and creators.\n- Douyin has profiles, posts, comments and related posts at `/v1/douyin/<op>`, and stored profiles and posts.\n- Meta Ads has an advertiser's ads, keyword ad search, advertiser search and one ad at `/v1/meta_ads/<op>`, and stored ad search, advertisers, their ads and ad-strategy insights under `/v1/meta_ads/stored/…`.\n- Intelligence has the AI enrichment bundle and contact discovery, which runs no model.\n\nAn old `/v1/{network}/live/…` or `/v1/live/{network}/…` path answers `410 Gone` with the path that replaced it, and a few old paths that customers still call keep answering in their old shape with `Deprecation` and `Link` headers.\n\n## Media URLs\n\nA fresh answer (`cached=live`) holds signed platform CDN URLs that expire, often within hours. A stored answer (`cache_only`, or an `auto` hit) has its expired image URLs swapped to our media mirror where we hold a copy. That is a permanent file URL, or a signed `/v1/media/...` URL on this host that works for at least 7 days with no API key. Video URLs are not mirrored and may be expired. We keep the exact acquisition payloads privately for replay and audit, and never expose them as public object URLs.\n\nThe Instagram wrapper examples are the crawler's own projection of synthetic upstream documents into the normalized types, not live captures. The other response examples come from captured API responses, with long lists cut short."},"servers":[{"url":"/","description":"Current environment"},{"url":"https://api.virev.ai","description":"Production"}],"tags":[{"name":"Crawl jobs","description":"Durable collection status and byte-bounded paid downloads. Polling and repeat downloads are free."},{"name":"Instagram","description":"One folder: `/v1/instagram/profile` reads the tracked corpus (strictly DB); every other path is one Instagram operation, `/v1/instagram/<op>`, with `cached=auto|cache_only|live` and `get_raw` on each. `usertags_feed`, `followers`, `following`, `story`, `likers`, `about`, and `highlight` run on our signed-in account pool and are priced apart."},{"name":"Instagram DM","description":"Message creators on Instagram and read their replies with two calls. We send from an Instagram account we run for your organization, so you never log in to Instagram and never pick an account. The [DM playground](/playground/dm-playground) shows the same conversations, which is the easiest place to see what happened.\n\n### The two calls\n\n1. [Send outreach](#tag/instagram-dm/POST/v1/instagram/dm/outreach) sends one message to a person, and continues your conversation with them or starts one. It costs $0.05 per message.\n2. [Check conversation](#tag/instagram-dm/GET/v1/instagram/dm/conversations/{conversation_id}) shows every message, with their replies. It costs $0.0005, or $0.001 with `refresh=true`, which reads Instagram for new replies first.\n\n### Send outreach\n\nPut the person in `to` as a handle (`nike` or `@nike`) or a profile link (`https://www.instagram.com/nike/`), and the message in `text`. To write again to the same person, call Send outreach again, and the message goes into the same conversation.\n\n```bash\ncurl -X POST \"https://api.virev.ai/v1/instagram/dm/outreach\" \\\n  -H \"Authorization: Bearer $VIREV_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{ \"to\": \"rhino.29941499\", \"text\": \"Hi! We’re Glow Lab, a clean skincare brand. Can we send you our new Vitamin C serum?\", \"client_token\": \"gifting-oct-01\" }'\n```\n\nThe answer is the conversation. Keep its `id` for Check conversation, and read `sent.status` to see what happened to this message.\n\n### Check conversation\n\nPass the `id` from the Send outreach answer. Their replies have `direction: \"received\"`.\n\n```bash\ncurl \"https://api.virev.ai/v1/instagram/dm/conversations/21?refresh=true\" \\\n  -H \"Authorization: Bearer $VIREV_API_KEY\"\n```\n\nWithout `refresh`, you get the messages we already saved, at once and with no Instagram call. With `refresh=true`, we read Instagram first, which usually takes 1 to 10 seconds, so call it when you want to look and not on a tight loop.\n\n### Retry safety\n\nSend a `client_token` with every message, such as `gifting-oct-01`. If a call fails or your connection drops, retry with the same token: the person never gets the message twice, and a repeat costs $0 with `sent.deduplicated: true`.\n\nMake a new token for each new message. If you leave the token out, each retry is a new message to a real person.\n\n### Delivery states\n\n`sent.status` says what happened to the message you just sent.\n\n- `sent`: Instagram took the message.\n- `operation_in_progress`: It is still going out. Run Check conversation in a moment to see where it landed.\n- `delivery_unknown`: We could not confirm delivery. Run Check conversation before you send again, and retry only with the same client_token, so it never goes out twice.\n\n### Errors and what to do\n\nEvery DM error says what went wrong and what to do, and none of them is charged. They come on top of the [standard errors](#description/errors), such as `invalid_request` for a missing `to` or empty `text`.\n\n- `upstream_unavailable` (503). The DM service is temporarily unavailable, and you are not charged. Try again shortly. Retry a send with the same client_token, so the message never goes out twice.\n- `dm_sending_paused` (503). We have no free capacity for this right now. Nothing was sent and you are not charged. Try again later.\n- `try_again_shortly` (503). This conversation is busy on our side for a moment. Nothing was sent and you are not charged. Try again shortly with the same client_token.\n- `recipient_not_found` (404). Instagram has no account with this handle. Check the spelling in to. Nothing was sent and you are not charged.\n- `recipient_pending` (409). This person has not accepted your first message yet, and Instagram allows more messages only after they accept. Nothing was sent and you are not charged. Check the conversation later and send again once they reply.\n- `account_paused` (409). Instagram paused the account we send this conversation from, and the conversation keeps that account, so this person always hears from the same one. Nothing was sent and you are not charged. Send again after the Retry-After seconds, when we check the account again.\n- `message_undeliverable` (422). Instagram will not deliver messages to this person, for example because they blocked the account we send from. Nothing was sent and you are not charged. Do not retry.\n- `daily_limit_reached` (429). Today's messages are used up. Nothing was sent and you are not charged. Try again after the Retry-After seconds, after 00:00 UTC.\n- `rate_limited` (429). Instagram asked us to slow down, so nothing was done and you are not charged. Try again after the Retry-After seconds.\n- `conversation_not_found` (404). No conversation with this id belongs to your organization. Use the id from the Send outreach answer. You are not charged.\n- `conversation_closed` (409). This conversation is closed, so it can no longer send or check for new replies. Its saved messages still show without refresh=true. To write to this person again, call Send outreach, which starts a new conversation. You are not charged.\n- `replies_unavailable` (503). Checking for new replies is broken on our side, and we are fixing it. Saved messages still show without refresh=true. You are not charged.\n\n### This is cold outreach, not your inbox\n\nThis API sends to people who have no prior link with you. It is not connected to your own Instagram account, it does not read your own inbox, and it never asks you to connect an account or grant Instagram permissions.\n\n### Try it in the playground\n\nThe [DM playground](/playground/dm-playground) runs the same two calls for your organization with no API key and no balance. Sign in with your organization, and it lists the conversations you sent through the API, so you can open one and see each message and its state."},{"name":"TikTok","description":"One folder: `/v1/tiktok` library profiles, tracked videos and engagement analytics, the stored reads under `/v1/tiktok/stored` (strictly DB), and one wrapper per TikTok operation at `/v1/tiktok/<op>`."},{"name":"TikTok Shop","description":"Stored TikTok Shop data under `/v1/tiktok_shop/…`: product and shop search, the category tree, one product, shop or creator, and the videos and affiliate creators that sell them, with daily units and GMV. Strictly DB: an id the store does not hold is a `404` and is not billed. Ids are strings because TikTok ids have 19 digits."},{"name":"YouTube","description":"One folder: `/v1/youtube` library profiles, tracked videos and view analytics, the stored reads under `/v1/youtube/stored` (strictly DB), and one wrapper per YouTube operation at `/v1/youtube/<op>`."},{"name":"LinkedIn","description":"Public LinkedIn reads under `/v1/linkedin/<op>` (company pages, members, posts, jobs, job search and the LinkedIn Ad Library) and stored reads under `/v1/linkedin/stored/…`."},{"name":"Facebook","description":"Public Facebook reads, one path per operation at `/v1/facebook/<op>` on the Instagram grammar (`cached`, `get_raw`, and `since`, `max_pages` and `cursor` on paged operations), and the stored reads under `/v1/facebook/stored`. The Meta Ad Library reads are under `/v1/meta_ads`. Transient challenge failures never become empty successes."},{"name":"Xiaohongshu","description":"Xiaohongshu (RED): logged-out explore, creator and note reads at `/v1/xiaohongshu/<op>`, and stored notes and creators under `/v1/xiaohongshu/stored/…` (strictly DB)."},{"name":"Douyin","description":"Douyin (the Chinese TikTok): one wrapper per Douyin operation at `/v1/douyin/<op>` (`user_profile`, `aweme_post`, `aweme_detail`, `comment_list`, `aweme_related`) on the Instagram grammar, and stored profiles and posts by `sec_uid` under `/v1/douyin/stored/…` (strictly DB)."},{"name":"Meta Ads","description":"Meta Ad Library reads at `/v1/meta_ads/<op>` on the Instagram grammar (`cached`, `get_raw`, and `max_pages` and `cursor` on paged operations), where an ad answers as a `Post` and an advertiser as an `Account`, and stored reads under `/v1/meta_ads/stored/…` (strictly DB): full-text ad search with structured filters, advertiser profiles and ads, and aggregate ad-strategy insights."},{"name":"Crawl","description":"The scrape-any-URL product (`POST /v1/crawl/web-scraping-api`) plus portal-owned presets for non-core networks (`/v1/crawl/{network}/{resource}`). Presets compile to one network-blind crawler door, and every fetch runs through residential proxies, with SSRF, redirect, and size boundaries enforced server-side."},{"name":"Web Search","description":"Live web search against a named engine — `/v1/search/google` and `/v1/search/bing` — returning organic results in the DataForSEO `serp/{engine}/organic/live/regular` response shape, with pagination via `depth`. The engine you ask for is the engine that answers: we never substitute another index behind the name. A blocked engine returns 502 `upstream_error` (and is never billed), never an empty result list, so \"no results\" always means the engine genuinely had none."},{"name":"Creator Search","description":"Search the stored creator index under `/v1/creators/…`: creators by brand collab, profiles by audience filters, posts by caption and collab, and profile lookups by handle or id, across networks. Every call reads stored data and never crawls. Rows carry no contact data; find contacts with /v1/contacts/find."},{"name":"Intelligence","description":"AI profile intelligence, custom enrichment, and brand and creator analytics."},{"name":"Contacts","description":"The contact finder: everything you know about a creator or brand goes in, and their emails (ranked by type and confidence, each with its evidence), social handles, websites and phones come out. `fast` answers within 2 seconds, `thorough` within about 30. `POST /v1/contacts/find/{level}` takes any subject; `GET /v1/contacts/find-from-{instagram,tiktok,youtube}/{level}` take one handle."},{"name":"Batch","description":"Async jobs over the whole catalog: submit an array of inputs against any batchable operation (`batchable` on its doc entry), poll `progress`, download the finished snapshot. One control plane — no per-operation batch endpoints. Rows are the exact single-call inputs (query params as a JSON object for GET operations, the request body for POST operations); each row bills at the normal single-call price as it executes, failed rows are free, and the control-plane calls themselves are free. Bright Data-compatible polling shape: `trigger → progress → snapshot`, 409 `snapshot_not_ready` until terminal, results retained 14 days."}],"x-tagGroups":[{"name":"Social data","tags":["Instagram","TikTok","TikTok Shop","YouTube","LinkedIn","Facebook","Xiaohongshu","Douyin","Creator Search"]},{"name":"Outreach","tags":["Instagram DM"]},{"name":"Ads","tags":["Meta Ads"]},{"name":"Toolkit","tags":["Crawl","Web Search","Intelligence","Contacts"]},{"name":"Jobs","tags":["Crawl jobs","Batch"]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"API key","description":"Paste the full `kb_live_...` token."}},"schemas":{"ApiMeta":{"type":"object","required":["cost","balance","request_id"],"properties":{"cost":{"type":"string","example":"$0.0005","description":"Amount charged for this request."},"balance":{"type":"string","example":"$9.99","description":"Remaining balance after the request."},"request_id":{"type":"string","example":"req_44f06ebf59a653090cca7817b6664ff2"},"source":{"type":"string","enum":["db","live"],"description":"Live surface only: how this payload was resolved — a fresh crawl or the archive."},"fetched_at":{"type":"string","description":"Live surface only: when this payload was acquired (ISO-8601 UTC).","example":"2026-07-10T11:24:31.518402+00:00"}}},"ApiError":{"type":"object","required":["code","message","request_id"],"properties":{"code":{"type":"string","example":"invalid_api_key"},"message":{"type":"string","example":"Missing or malformed API key."},"request_id":{"type":"string","example":"req_44f06ebf59a653090cca7817b6664ff2"}}},"ErrorEnvelope":{"type":"object","required":["error"],"properties":{"error":{"$ref":"#/components/schemas/ApiError"}}},"Account":{"additionalProperties":false,"properties":{"id":{"type":"string","nullable":true},"username":{"type":"string","nullable":true},"full_name":{"type":"string","nullable":true},"is_verified":{"type":"boolean","nullable":true},"is_private":{"type":"boolean","nullable":true},"avatar_url":{"type":"string","nullable":true},"latest_story_at":{"type":"string","nullable":true},"extra":{"additionalProperties":true,"default":{},"type":"object"}},"required":["id","username","full_name","is_verified","is_private","avatar_url","latest_story_at"],"type":"object"},"Link":{"additionalProperties":false,"properties":{"url":{"type":"string","nullable":true},"title":{"type":"string","nullable":true}},"required":["url","title"],"type":"object"},"Profile":{"additionalProperties":false,"properties":{"id":{"type":"string","nullable":true},"username":{"type":"string","nullable":true},"full_name":{"type":"string","nullable":true},"biography":{"type":"string","nullable":true},"followers":{"type":"integer","nullable":true},"following":{"type":"integer","nullable":true},"posts":{"type":"integer","nullable":true},"is_verified":{"type":"boolean","nullable":true},"is_private":{"type":"boolean","nullable":true},"avatar_url":{"type":"string","nullable":true},"external_url":{"type":"string","nullable":true},"links":{"items":{"$ref":"#/components/schemas/Link"},"type":"array"},"category":{"type":"string","nullable":true},"business_category":{"type":"string","nullable":true},"is_business":{"type":"boolean","nullable":true},"is_professional":{"type":"boolean","nullable":true},"business_email":{"type":"string","nullable":true},"business_phone":{"type":"string","nullable":true},"business_address":{"type":"string","nullable":true},"pronouns":{"items":{"type":"string"},"type":"array"},"highlight_reel_count":{"type":"integer","nullable":true},"has_clips":{"type":"boolean","nullable":true},"is_recently_joined":{"type":"boolean","nullable":true},"fbid":{"type":"string","nullable":true},"extra":{"additionalProperties":true,"default":{},"type":"object"}},"required":["id","username","full_name","biography","followers","following","posts","is_verified","is_private","avatar_url","external_url","links","category","business_category","is_business","is_professional","business_email","business_phone","business_address","pronouns","highlight_reel_count","has_clips","is_recently_joined","fbid"],"type":"object"},"Media":{"additionalProperties":false,"description":"One media slot of a post or story: the post itself, or one carousel child.","properties":{"kind":{"enum":["image","video"],"type":"string","nullable":true},"url":{"type":"string","nullable":true},"width":{"type":"integer","nullable":true},"height":{"type":"integer","nullable":true},"duration":{"type":"number","nullable":true}},"required":["kind","url","width","height","duration"],"type":"object"},"Audio":{"additionalProperties":false,"properties":{"id":{"type":"string","nullable":true},"title":{"type":"string","nullable":true},"artist":{"type":"string","nullable":true},"is_original":{"type":"boolean","nullable":true}},"required":["id","title","artist","is_original"],"type":"object"},"Post":{"additionalProperties":false,"properties":{"id":{"type":"string","nullable":true},"shortcode":{"type":"string","nullable":true},"taken_at":{"type":"string","nullable":true},"kind":{"enum":["image","video","carousel"],"type":"string","nullable":true},"product_type":{"type":"string","nullable":true},"caption":{"type":"string","nullable":true},"hashtags":{"items":{"type":"string"},"type":"array"},"mentions":{"items":{"type":"string"},"type":"array"},"accessibility_caption":{"type":"string","nullable":true},"likes":{"type":"integer","nullable":true},"comments":{"type":"integer","nullable":true},"views":{"type":"integer","nullable":true},"counts_hidden":{"type":"boolean","nullable":true},"comments_disabled":{"type":"boolean","nullable":true},"is_pinned":{"type":"boolean","nullable":true},"is_paid_partnership":{"type":"boolean","nullable":true},"owner":{"allOf":[{"$ref":"#/components/schemas/Account"}],"nullable":true},"coauthors":{"items":{"$ref":"#/components/schemas/Account"},"type":"array"},"sponsors":{"items":{"$ref":"#/components/schemas/Account"},"type":"array"},"tagged":{"items":{"$ref":"#/components/schemas/Account"},"type":"array"},"location":{"allOf":[{"$ref":"#/components/schemas/Location"}],"nullable":true},"audio":{"allOf":[{"$ref":"#/components/schemas/Audio"}],"nullable":true},"thumbnail_url":{"type":"string","nullable":true},"video_duration":{"type":"number","nullable":true},"media":{"items":{"$ref":"#/components/schemas/Media"},"type":"array"},"media_urls":{"items":{"type":"string"},"type":"array"},"extra":{"additionalProperties":true,"default":{},"type":"object"}},"required":["id","shortcode","taken_at","kind","product_type","caption","hashtags","mentions","accessibility_caption","likes","comments","views","counts_hidden","comments_disabled","is_pinned","is_paid_partnership","owner","coauthors","sponsors","tagged","location","audio","thumbnail_url","video_duration","media","media_urls"],"type":"object"},"Comment":{"additionalProperties":false,"properties":{"id":{"type":"string","nullable":true},"text":{"type":"string","nullable":true},"created_at":{"type":"string","nullable":true},"likes":{"type":"integer","nullable":true},"replies":{"type":"integer","nullable":true},"liked_by_owner":{"type":"boolean","nullable":true},"owner":{"allOf":[{"$ref":"#/components/schemas/Account"}],"nullable":true},"extra":{"additionalProperties":true,"default":{},"type":"object"}},"required":["id","text","created_at","likes","replies","liked_by_owner","owner"],"type":"object"},"Story":{"additionalProperties":false,"properties":{"id":{"type":"string","nullable":true},"taken_at":{"type":"string","nullable":true},"kind":{"enum":["image","video"],"type":"string","nullable":true},"media_url":{"type":"string","nullable":true},"expires_at":{"type":"string","nullable":true},"video_duration":{"type":"number","nullable":true},"mentions":{"items":{"$ref":"#/components/schemas/Account"},"type":"array"},"link":{"type":"string","nullable":true}},"required":["id","taken_at","kind","media_url","expires_at","video_duration","mentions","link"],"type":"object"},"Highlight":{"additionalProperties":false,"properties":{"id":{"type":"string","nullable":true},"title":{"type":"string","nullable":true},"cover_url":{"type":"string","nullable":true},"items":{"type":"integer","nullable":true},"created_at":{"type":"string","nullable":true},"owner":{"allOf":[{"$ref":"#/components/schemas/Account"}],"nullable":true},"stories":{"items":{"$ref":"#/components/schemas/Story"},"type":"array"}},"required":["id","title","cover_url","items","created_at","owner","stories"],"type":"object"},"Location":{"additionalProperties":false,"properties":{"id":{"type":"string","nullable":true},"name":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true},"lat":{"type":"number","nullable":true},"lng":{"type":"number","nullable":true},"address":{"type":"string","nullable":true},"city":{"type":"string","nullable":true},"phone":{"type":"string","nullable":true},"website":{"type":"string","nullable":true},"posts":{"type":"integer","nullable":true}},"required":["id","name","slug","lat","lng","address","city","phone","website","posts"],"type":"object"},"Keyword":{"additionalProperties":false,"properties":{"keyword":{"type":"string","nullable":true},"description":{"type":"string","nullable":true},"description_sources":{"items":{"type":"string"},"type":"array"},"related":{"items":{"type":"string"},"type":"array"},"posts":{"items":{"$ref":"#/components/schemas/Post"},"type":"array"}},"required":["keyword","description","description_sources","related","posts"],"type":"object"},"About":{"additionalProperties":false,"properties":{"date_joined":{"type":"string","nullable":true},"country":{"type":"string","nullable":true},"former_usernames":{"items":{"type":"string"},"type":"array"},"former_username_count":{"type":"integer","nullable":true},"runs_ads":{"type":"boolean","nullable":true}},"required":["date_joined","country","former_usernames","former_username_count","runs_ads"],"type":"object"},"PageRead":{"type":"object","description":"One page of a walk.","required":["cursor","fetched_at","count","signed_in"],"properties":{"cursor":{"type":"string","nullable":true,"description":"The opaque cursor this page was requested with; null on the first page of a fresh walk."},"fetched_at":{"type":"string","format":"date-time","description":"ISO-8601 UTC; the stored time on a cache hit."},"count":{"type":"integer","description":"Native items on the page."},"signed_in":{"type":"boolean","description":"True when one of our signed-in Instagram accounts read the page, live or when the stored read was captured. Such a page bills the signed-in page price."}}},"Coverage":{"type":"object","description":"What the walk observed against `since`.","required":["since","oldest_at","since_reached"],"properties":{"since":{"type":"string","nullable":true,"description":"The boundary asked for, as sent."},"oldest_at":{"type":"string","nullable":true,"format":"date-time","description":"The oldest item timestamp seen on any page; null where items carry none."},"since_reached":{"type":"boolean","description":"A whole page fell behind `since`."}}},"Page":{"type":"object","description":"Every paged operation: a synchronous page when `max_pages=1`. `items` carries the operation’s type (Post, Comment, or Account) across every page walked; `next_cursor` is opaque and goes back as `cursor`; `stop_reason` names why the walk stopped.","required":["items","pages","next_cursor","has_more","stop_reason","coverage"],"properties":{"items":{"type":"array","items":{"type":"object","additionalProperties":true}},"pages":{"type":"array","items":{"$ref":"#/components/schemas/PageRead"}},"next_cursor":{"type":"string","nullable":true},"has_more":{"type":"boolean","description":"True exactly when `next_cursor` is set."},"stop_reason":{"type":"string","enum":["pages","since","exhausted","cursor_stalled","repeated_content","deadline","blocked","caught_up"],"description":"Why the walk stopped. `pages`: the page budget is spent and `next_cursor` continues it. `deadline`: the call ran out of time before its next page; `next_cursor` continues it. `since`: a whole page was older than `since`. `exhausted`: Instagram reported the end. `cursor_stalled`: Instagram claimed more but repeated or omitted its cursor. `repeated_content`: a page held only items already seen. `blocked`: Instagram refused a later page; `next_cursor` is the page it refused. `caught_up`: the walk reached the newest post an earlier read of the feed returned; only watch passes the crawler runs for itself stop this way."},"coverage":{"$ref":"#/components/schemas/Coverage"}}},"Transcript":{"type":"object","additionalProperties":false,"description":"A video’s native caption track as text.","required":["video_id","language","source_url","text"],"properties":{"video_id":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"source_url":{"type":"string","nullable":true,"description":"The caption file TikTok served."},"text":{"type":"string","nullable":true}}},"Challenge":{"type":"object","additionalProperties":false,"description":"One hashtag as its own TikTok page describes it.","required":["id","title","description","videos","views","extra"],"properties":{"id":{"type":"string","nullable":true,"description":"The challenge id TikTok keys the hashtag feed by."},"title":{"type":"string","nullable":true},"description":{"type":"string","nullable":true},"videos":{"type":"integer","nullable":true,"description":"Videos TikTok counts under the tag."},"views":{"type":"integer","nullable":true,"description":"Views TikTok counts across those videos."},"extra":{"type":"object","additionalProperties":true}}},"Playlist":{"type":"object","additionalProperties":false,"description":"One playlist (series) a creator curates.","required":["id","name","videos","cover_url"],"properties":{"id":{"type":"string","nullable":true},"name":{"type":"string","nullable":true},"videos":{"type":"integer","nullable":true,"description":"Video count; null when TikTok leaves it out."},"cover_url":{"type":"string","nullable":true}}},"YouTubePlaylist":{"type":"object","additionalProperties":false,"description":"One playlist.","required":["id","title","description","videos","thumbnail_url","url"],"properties":{"id":{"type":"string","nullable":true},"title":{"type":"string","nullable":true},"description":{"type":"string","nullable":true},"videos":{"type":"integer","nullable":true,"description":"Video count; null when YouTube leaves it out."},"thumbnail_url":{"type":"string","nullable":true},"url":{"type":"string","nullable":true}}},"YouTubeSearchResult":{"description":"A video (`Post`), a channel (`Account`) or a playlist (`YouTubePlaylist`), in rank order.","anyOf":[{"$ref":"#/components/schemas/Post"},{"$ref":"#/components/schemas/Account"},{"$ref":"#/components/schemas/YouTubePlaylist"}]},"YouTubeSuggestion":{"type":"object","additionalProperties":false,"required":["text","channel"],"properties":{"text":{"type":"string","nullable":true},"channel":{"allOf":[{"$ref":"#/components/schemas/Account"}],"nullable":true}}},"YouTubeTranscript":{"type":"object","additionalProperties":false,"description":"A video’s caption track as timed segments and joined text.","required":["video_id","language","language_name","text","segments","segments_complete"],"properties":{"video_id":{"type":"string","nullable":true},"language":{"type":"string","nullable":true},"language_name":{"type":"string","nullable":true},"text":{"type":"string","nullable":true},"segments":{"type":"array","items":{"type":"object","properties":{"start_ms":{"type":"integer"},"duration_ms":{"type":"integer","nullable":true},"text":{"type":"string"}},"additionalProperties":true}},"segments_complete":{"type":"boolean","nullable":true,"description":"false when YouTube cut the track short."}}},"YouTubeSponsors":{"type":"object","additionalProperties":false,"required":["video_id","is_paid_partnership","sponsors"],"properties":{"video_id":{"type":"string","nullable":true},"is_paid_partnership":{"type":"boolean","nullable":true,"description":"The watch page’s paid promotion disclosure."},"sponsors":{"type":"array","items":{"type":"object","additionalProperties":false,"required":["name","confidence","evidence","source"],"properties":{"name":{"type":"string","nullable":true},"confidence":{"type":"number","nullable":true},"evidence":{"type":"string","nullable":true,"description":"The phrase that names the sponsor."},"source":{"type":"string","nullable":true,"description":"`description` or `transcript`."}}}}}},"YouTubeThumbnail":{"type":"object","additionalProperties":false,"required":["url","width","height"],"properties":{"url":{"type":"string","nullable":true},"width":{"type":"integer","nullable":true},"height":{"type":"integer","nullable":true}}},"YouTubeProfileFull":{"type":"object","additionalProperties":false,"required":["profile","posts","computed"],"properties":{"profile":{"$ref":"#/components/schemas/Profile"},"posts":{"type":"array","items":{"$ref":"#/components/schemas/Post"}},"computed":{"type":"object","additionalProperties":true,"nullable":true,"description":"Engagement, cadence and format figures."}}},"FacebookEvent":{"type":"object","additionalProperties":false,"description":"One public event.","required":["id","name","description","url","starts_at","ends_at","timezone","location_name","address","lat","lng","host","going","interested","is_online"],"properties":{"id":{"type":"string","nullable":true},"name":{"type":"string","nullable":true},"description":{"type":"string","nullable":true},"url":{"type":"string","nullable":true},"starts_at":{"type":"string","nullable":true,"description":"ISO 8601."},"ends_at":{"type":"string","nullable":true,"description":"ISO 8601."},"timezone":{"type":"string","nullable":true},"location_name":{"type":"string","nullable":true},"address":{"type":"string","nullable":true},"lat":{"type":"number","nullable":true},"lng":{"type":"number","nullable":true},"host":{"allOf":[{"$ref":"#/components/schemas/Account"}],"nullable":true},"going":{"type":"integer","nullable":true},"interested":{"type":"integer","nullable":true},"is_online":{"type":"boolean","nullable":true}}},"FacebookGroupPosts":{"type":"object","additionalProperties":false,"description":"A public group and the posts its logged-out discussion page shows.","required":["group","posts"],"properties":{"group":{"type":"object","additionalProperties":false,"required":["id","slug","url","name","description","privacy","members","avatar_url","extra"],"properties":{"id":{"type":"string","nullable":true},"slug":{"type":"string","nullable":true},"url":{"type":"string","nullable":true},"name":{"type":"string","nullable":true},"description":{"type":"string","nullable":true},"privacy":{"type":"string","nullable":true,"description":"As Facebook words it, such as `Public group`."},"members":{"type":"integer","nullable":true},"avatar_url":{"type":"string","nullable":true},"extra":{"type":"object","additionalProperties":true,"description":"`activity`, the recent post count Facebook shows, and `cover_url`, the group cover photo."}}},"posts":{"type":"array","items":{"$ref":"#/components/schemas/Post"}}}},"FacebookTranscript":{"type":"object","additionalProperties":false,"description":"A video’s own caption track as timed segments and joined text.","required":["post_id","language","text","segments","segments_complete","source_url"],"properties":{"post_id":{"type":"string","nullable":true},"language":{"type":"string","nullable":true,"description":"A Facebook locale such as `en_US`."},"text":{"type":"string","nullable":true},"segments":{"type":"array","items":{"type":"object","properties":{"index":{"type":"integer"},"start_ms":{"type":"integer"},"end_ms":{"type":"integer"},"text":{"type":"string"}},"additionalProperties":true}},"segments_complete":{"type":"boolean","nullable":true,"description":"false when Facebook cut the track short."},"source_url":{"type":"string","nullable":true,"description":"The track’s signed fbcdn URL, which expires."}}},"LinkedInJob":{"type":"object","additionalProperties":false,"description":"One job posting, as a search card or its own page reads it.","required":["id","title","company","location","employment_type","seniority_level","workplace_type","description","skills","published_at","expires_at","applicants","url","apply_url","extra"],"properties":{"id":{"type":"string","nullable":true},"title":{"type":"string","nullable":true},"company":{"allOf":[{"$ref":"#/components/schemas/Account"}],"nullable":true},"location":{"type":"string","nullable":true},"employment_type":{"type":"string","nullable":true},"seniority_level":{"type":"string","nullable":true},"workplace_type":{"type":"string","nullable":true},"description":{"type":"string","nullable":true,"description":"Null on a search card; the job read carries it."},"skills":{"type":"array","items":{"type":"string"}},"published_at":{"type":"string","nullable":true},"expires_at":{"type":"string","nullable":true},"applicants":{"type":"integer","nullable":true},"url":{"type":"string","nullable":true},"apply_url":{"type":"string","nullable":true},"extra":{"type":"object","additionalProperties":true,"description":"Facts only LinkedIn carries; `{}` when none."}}},"LinkedInJobCount":{"type":"object","additionalProperties":false,"required":["company_id","count","count_exact","count_lower_bound"],"properties":{"company_id":{"type":"string","nullable":true},"count":{"type":"integer","nullable":true},"count_exact":{"type":"boolean","nullable":true,"description":"False when LinkedIn shows a rounded figure such as 10,000+."},"count_lower_bound":{"type":"boolean","nullable":true}}},"LinkedInAd":{"type":"object","additionalProperties":false,"description":"One Ad Library ad.","required":["id","advertiser","advertiser_type","payer","format","ad_copy","media_urls","destination_urls","impression_start","impression_end","impressions_exact","impressions_min","impressions_max","targeting","restricted","url","extra"],"properties":{"id":{"type":"string","nullable":true},"advertiser":{"allOf":[{"$ref":"#/components/schemas/Account"}],"nullable":true},"advertiser_type":{"type":"string","nullable":true},"payer":{"type":"string","nullable":true},"format":{"type":"string","nullable":true},"ad_copy":{"type":"string","nullable":true},"media_urls":{"type":"array","items":{"type":"string"}},"destination_urls":{"type":"array","items":{"type":"string"}},"impression_start":{"type":"string","nullable":true,"description":"The first day the ad ran, `YYYY-MM-DD`."},"impression_end":{"type":"string","nullable":true},"impressions_exact":{"type":"integer","nullable":true},"impressions_min":{"type":"integer","nullable":true},"impressions_max":{"type":"integer","nullable":true},"targeting":{"type":"object","additionalProperties":true},"restricted":{"type":"boolean","nullable":true},"url":{"type":"string","nullable":true},"extra":{"type":"object","additionalProperties":true,"description":"Facts only LinkedIn carries; `{}` when none."}}},"LinkedInCompanyFull":{"type":"object","additionalProperties":false,"required":["profile","posts","computed"],"properties":{"profile":{"$ref":"#/components/schemas/Profile"},"posts":{"type":"array","items":{"$ref":"#/components/schemas/Post"}},"computed":{"type":"object","additionalProperties":true,"nullable":true,"description":"Cadence, engagement and format figures."}}},"EnrichmentResponseData":{"type":"object","description":"AI enrichment output — niche classification, demographics, brand fit, summaries. Null fields are omitted from the response.","properties":{"entity_type":{"type":"string","example":"brand","description":"`person`, `brand`, or `character`."},"account_role":{"type":"string","example":"brand","description":"Role in the ecosystem (creator, brand, athlete, etc.)."},"primary_niche":{"type":"string","enum":["art_design","automotive","beauty","books","business","comedy","dance","education","entertainment","fashion","film_tv","finance","fitness","food_drink","gaming","health_wellness","home","lifestyle","music","news_politics","outdoors","parenting_family","pets","photography","religion","shopping","social_impact","sports","technology","travel","other"],"example":"fashion","description":"One slug from the fixed niche list. Omitted when the account shows no niche."},"sub_niches":{"type":"array","items":{"type":"string"},"example":["Sneakers","Performance training","Basketball"]},"content_tags":{"type":"array","items":{"type":"object","additionalProperties":true}},"commercial_intent":{"type":"string","example":"fully_commercial"},"brand_safety":{"type":"string","example":"safe"},"content_style":{"type":"string","nullable":true},"collab_readiness":{"type":"boolean","nullable":true},"gender":{"type":"string","example":"unknown"},"age_range":{"type":"string","nullable":true},"profession":{"type":"string","nullable":true},"country":{"type":"string","example":"United States","description":"Full country name."},"state_or_region":{"type":"string","nullable":true},"city":{"type":"string","nullable":true},"primary_language":{"type":"string","example":"English","description":"Full language name."},"languages":{"type":"array","items":{"type":"string"}},"tagline":{"type":"string","example":"Just Do It."},"bio_summary":{"type":"string","example":"Nike is a global sportswear and athletic lifestyle brand focused on performance…"},"content_summary":{"type":"string","example":"Posts highlight sponsored athletes, championship moments, new footwear releases…"},"audience_summary":{"type":"string","nullable":true},"brand_fit_summary":{"type":"string","nullable":true},"sources":{"type":"array","items":{"type":"string"}}},"additionalProperties":true},"ContactFindRequest":{"type":"object","additionalProperties":false,"description":"Body for `POST /v1/contacts/find/{level}`: everything you know about one subject, at least one of `handles`, `urls`, `emails`, `websites` or `name`. Unknown fields are rejected with 400 before auth or billing.","properties":{"handles":{"type":"array","items":{"type":"object","required":["platform","handle"],"properties":{"platform":{"type":"string","enum":["instagram","tiktok","youtube","x","facebook","threads","linkedin","pinterest","snapchat","twitch"]},"handle":{"type":"string","maxLength":200,"example":"mrbeast"}}}},"urls":{"type":"array","items":{"type":"string","maxLength":200}},"emails":{"type":"array","items":{"type":"string","maxLength":200}},"websites":{"type":"array","items":{"type":"string","maxLength":200}},"phones":{"type":"array","items":{"type":"string","maxLength":200}},"name":{"type":"string","maxLength":200},"kind_hint":{"type":"string","enum":["creator","brand","unknown"]},"note":{"type":"string","maxLength":200},"freshness":{"type":"string","enum":["auto","refresh","stored"],"default":"auto"}}},"ContactFindResult":{"type":"object","description":"One subject’s contacts. `outcome` is `found` (with `best_email`), `none_found`, or `unknown_subject` (with `reason` and `run` only).","required":["outcome","run"],"properties":{"outcome":{"type":"string","enum":["found","none_found","unknown_subject"]},"best_email":{"type":"string","nullable":true,"description":"The first active contactable email."},"reason":{"type":"string","enum":["account_not_found","nothing_reachable"]},"subject":{"type":"object","additionalProperties":true},"emails":{"type":"array","description":"Best first.","items":{"type":"object","properties":{"address":{"type":"string"},"rank":{"type":"integer"},"type":{"type":"string","enum":["business","management","press","general","support","sales","personal","other_role","noreply"]},"contactable":{"type":"boolean"},"confidence":{"type":"number"},"owner":{"type":"string","enum":["subject","representative","parent_company","other"]},"status":{"type":"string","enum":["active","stale"]},"evidence":{"type":"array","items":{"type":"object","additionalProperties":true}},"verification":{"type":"object","additionalProperties":true}},"additionalProperties":true}},"handles":{"type":"object","additionalProperties":{"type":"array","items":{"type":"object","additionalProperties":true}}},"websites":{"type":"array","items":{"type":"object","additionalProperties":true}},"link_pages":{"type":"array","items":{"type":"object","additionalProperties":true}},"phones":{"type":"array","items":{"type":"object","additionalProperties":true}},"run":{"type":"object","description":"What the run did: level, freshness, elapsed time, the pages it read, any model call and its cost.","additionalProperties":true}},"additionalProperties":true},"XiaohongshuStoredNoteResponseData":{"type":"object","required":["note_id","user_id","media"],"properties":{"note_id":{"type":"string","pattern":"^[0-9a-f]{24}$"},"user_id":{"type":"string"},"title":{"type":"string","nullable":true},"caption":{"type":"string","nullable":true},"likes":{"type":"integer","nullable":true},"comments":{"type":"integer","nullable":true},"collected":{"type":"integer","nullable":true},"shares":{"type":"integer","nullable":true},"posted_at":{"type":"string","nullable":true},"note_type":{"type":"string","nullable":true},"is_video":{"type":"boolean"},"image_urls":{"type":"array","items":{"type":"string"}},"video_url":{"type":"string","nullable":true},"media":{"type":"array","items":{"type":"object","additionalProperties":true}}},"additionalProperties":true}},"responses":{"Unauthorized":{"description":"Missing, malformed, or revoked API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"invalid_api_key","message":"Missing or malformed API key. Use: Authorization: Bearer $VIREV_API_KEY","request_id":"req_de5f6bdc8ee143b29e5533ec34728e50"}}}}},"InsufficientBalance":{"description":"Balance is too low for this request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"insufficient_balance","message":"Balance $0.0000, but this costs $0.0005. Top up at https://api.virev.ai/settings/billing","request_id":"req_2764a093246ac0aa1f1033ba1fcec504"}}}}},"InvalidRequest":{"description":"The request parameters are invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"invalid_request","message":"q query parameter is required","request_id":"req_44f06ebf59a653090cca7817b6664ff2"}}}}},"UpstreamError":{"description":"The upstream fetch failed. You are not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"upstream_error","message":"Upstream error","request_id":"req_d891b8a98f2f51afda7a7aad04b395f0"}}}}},"UpstreamTimeout":{"description":"The upstream request timed out. You are not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"upstream_timeout","message":"Upstream error","request_id":"req_7000ca2bd5c1397eb9c085d00761758e"}}}}},"BillingUnavailable":{"description":"Billing could not be confirmed, so no upstream data was returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"billing_unavailable","message":"Billing is temporarily unavailable. No data was returned.","request_id":"req_7000ca2bd5c1397eb9c085d00761758e"}}}}},"RateLimitExceeded":{"description":"Over the per-minute limit. The limit belongs to your organization and all its API keys share it: 100 requests per minute unless an increase was granted. Wait for the Retry-After seconds, then retry. On a live read, code `rate_limited` means the platform itself rate-limited this read; retry after the Retry-After seconds. You are not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limit_exceeded","message":"Rate limit exceeded (100 req/min for your organization, shared by all its keys). Retry after 23s. Request an increase at https://api.virev.ai/dashboard/keys","request_id":"req_7000ca2bd5c1397eb9c085d00761758e"}}}}},"AcquisitionRateLimited":{"description":"Crawler acquisition capacity is exhausted. Retry after the response delay; you are not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"rate_limited","message":"Xiaohongshu note acquisition rate limit exceeded","request_id":"req_7000ca2bd5c1397eb9c085d00761758e"}}}}}}},"security":[{"bearerAuth":[]}],"paths":{"/v1/facebook/stored/profile":{"get":{"tags":["Facebook"],"operationId":"facebookStoredProfile","summary":"Stored page","description":"One stored page: name, category, followers, links and when it was last read, with `metric_precision` naming the counts Facebook rounds.\n\nStrictly DB: this reads what the crawler already stored and never crawls. A miss is a `404` and is not billed. Fetch a fresh one with `/v1/facebook/profile`.","x-dashboard-cost":"$0.0005","security":[{"bearerAuth":[]}],"parameters":[{"name":"q","in":"query","required":true,"description":"A page’s vanity name or numeric id, or its facebook.com page URL.","example":"natgeo","schema":{"type":"string","maxLength":300,"example":"natgeo"}}],"responses":{"200":{"description":"Success. The example is a captured response; long lists are truncated.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":true},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"id":129,"profile_id":1084076,"platform":"facebook","username":"natgeo","facebook_user_id":"100044623170418","full_name":"National Geographic","biography":null,"category":"Media/news company","profile_pic_url":"/api/media/facebook_account/129/profile_pic?e=1793750400&s=1cc0b48de8c02aab26b7cdb56727919f","external_urls":[],"website":null,"location":null,"followers":51000000,"following":2,"posts_count":null,"likes":null,"is_verified":true,"is_private":false,"metric_precision":{"followers":"approximate"},"last_scraped_at":"2026-10-12T16:29:15.276052Z","enrichment":null},"meta":{"cost":"$0.0005","balance":"$9.9990","request_id":"req_51dd3ae808b467bb7eaed3dd050009c3"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"404":{"description":"The page is not stored. You are not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/facebook/stored/profile/posts":{"get":{"tags":["Facebook"],"operationId":"facebookStoredProfilePosts","summary":"Stored page posts","description":"The posts stored for one page, newest first, with an opaque `next_cursor` while more are stored.\n\nStrictly DB: this reads what the crawler already stored and never crawls. A miss is a `404` and is not billed. Collect more with `/v1/facebook/profile_reels` or `/v1/facebook/profile_photos`.","x-dashboard-cost":"$0.0005","security":[{"bearerAuth":[]}],"parameters":[{"name":"q","in":"query","required":true,"description":"A page’s vanity name or numeric id, or its facebook.com page URL.","example":"natgeo","schema":{"type":"string","maxLength":300,"example":"natgeo"}},{"name":"limit","in":"query","required":false,"description":"Posts per page.","schema":{"type":"integer","minimum":1,"maximum":100,"default":30},"examples":{"default":{"value":30,"x-disabled":true}}},{"name":"cursor","in":"query","required":false,"description":"`next_cursor` from the previous page.","schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Success. The example is a captured response; long lists are truncated.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":true},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"posts":[{"facebook_content_id":"1687661559397934","content_type":"post","canonical_url":"https://www.facebook.com/reel/942459548952900","title":null,"caption":"Presented by ROLEX. A lion can be difficult to track across Zambia’s vast wetlands, even with a radio collar. When the Busanga pride’s matriarch, Princess, hadn’t been seen for six months, conservationists set out to find her across a territory larger than Manhattan.\n\nThrough its partnership with the National Geographic Society and as part of its Perpetual Planet Initiative, #Rolex supports expeditions exploring and protecting remarkable places around the world, a selection of which are featured in Africa Earth’s Wild Home. #PerpetualPlanet\n\n#AfricaEarthsWildHome now streaming on Disney+ and Hulu.","likes":1170,"comments":14,"shares":null,"views":92000,"duration_ms":null,"posted_at":"2026-10-11T22:00:12Z","image_url":null,"video_url":null,"is_video":false,"metric_precision":{"views":"approximate"}},{"facebook_content_id":"1687552099408880","content_type":"post","canonical_url":"https://www.facebook.com/reel/1068261349577561","title":null,"caption":"It’s snack time for these humpback whales. They use rings of bubbles like nets to concentrate fish and krill before surging through for a feast. \n\n#EuropeFromAbove is streaming on Disney+","likes":2183,"comments":20,"shares":null,"views":151000,"duration_ms":null,"posted_at":"2026-10-11T19:00:08Z","image_url":null,"video_url":null,"is_video":false,"metric_precision":{"views":"approximate"}}],"next_cursor":"WzQwMzUsIjIwMjYtMTAtMTFUMTk6MDA6MDgrMDA6MDAiXQ","has_more":true},"meta":{"cost":"$0.0005","balance":"$9.9990","request_id":"req_f2f47fb1c518e233eb1c4ee26f6d538f"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"404":{"description":"The page is not stored. You are not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/facebook/stored/post":{"get":{"tags":["Facebook"],"operationId":"facebookStoredPost","summary":"Stored post","description":"One stored post with its page and group: caption, counts, time, media paths and `metric_precision`.\n\nStrictly DB: this reads what the crawler already stored and never crawls. A miss is a `404` and is not billed. Fetch a fresh one with `/v1/facebook/post`.","x-dashboard-cost":"$0.0005","security":[{"bearerAuth":[]}],"parameters":[{"name":"q","in":"query","required":true,"description":"The post’s numeric id, `facebook_content_id` in a stored answer or `id` in a live one.","example":"1687661559397934","schema":{"type":"string","maxLength":40,"example":"1687661559397934"}}],"responses":{"200":{"description":"Success. The example is a captured response; long lists are truncated.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":true},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"facebook_content_id":"1687661559397934","content_type":"post","canonical_url":"https://www.facebook.com/reel/942459548952900","title":null,"caption":"Presented by ROLEX. A lion can be difficult to track across Zambia’s vast wetlands, even with a radio collar. When the Busanga pride’s matriarch, Princess, hadn’t been seen for six months, conservationists set out to find her across a territory larger than Manhattan.\n\nThrough its partnership with the National Geographic Society and as part of its Perpetual Planet Initiative, #Rolex supports expeditions exploring and protecting remarkable places around the world, a selection of which are featured in Africa Earth’s Wild Home. #PerpetualPlanet\n\n#AfricaEarthsWildHome now streaming on Disney+ and Hulu.","likes":1170,"comments":14,"shares":null,"views":92000,"duration_ms":null,"posted_at":"2026-10-11T22:00:12Z","image_url":null,"video_url":null,"is_video":false,"metric_precision":{"views":"approximate"},"author_username":"natgeo","author_facebook_id":"100044623170418","author_full_name":"National Geographic","author_followers":51000000,"author_is_verified":true,"facebook_group_id":null,"group_name":null},"meta":{"cost":"$0.0005","balance":"$9.9990","request_id":"req_bfcb4d95c252a3c4d91df738a4dfada9"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"404":{"description":"The post is not stored. You are not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/facebook/stored/post/comments":{"get":{"tags":["Facebook"],"operationId":"facebookStoredPostComments","summary":"Stored post comments","description":"The comments stored for one post, in the order they were stored, with `next_cursor` while `has_more` is true. A stored post with no collected comment page answers an empty list.\n\nStrictly DB: this reads what the crawler already stored and never crawls. A miss is a `404` and is not billed. Collect more with `/v1/facebook/post_comments`.","x-dashboard-cost":"$0.0005","security":[{"bearerAuth":[]}],"parameters":[{"name":"q","in":"query","required":true,"description":"The post’s numeric id, `facebook_content_id` in a stored answer or `id` in a live one.","example":"1688249899339100","schema":{"type":"string","maxLength":40,"example":"1688249899339100"}},{"name":"cursor","in":"query","required":false,"description":"Opaque `next_cursor` from the previous page.","schema":{"type":"string","maxLength":500}},{"name":"limit","in":"query","required":false,"description":"Comments per page.","schema":{"type":"integer","minimum":1,"maximum":200,"default":50},"examples":{"default":{"value":50,"x-disabled":true}}}],"responses":{"200":{"description":"Success. The example is a captured response; long lists are truncated.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":true},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"post":{"content_id":"1688249899339100"},"comments":[{"facebook_comment_id":"1125478196505563","parent_comment_id":null,"author_facebook_id":"100002649497188","author_username":"randomcloud","author_name":"Daxesh Dalicha","body":"I don't know, how he got any time to do anything else. 🤪","likes":null,"reply_count":null,"commented_at":"2026-10-12T14:40:42Z"},{"facebook_comment_id":"1129503553380559","parent_comment_id":null,"author_facebook_id":"pfbid0qXyi9CodRZEkV6QzQWKH5pAjhge7kr3RTRW5CeKtxumQthBU8CshSEB48T8gc3SYl","author_username":null,"author_name":"Chase Ayers","body":"Man the lies we could get away with before the internet. Those were the days. This guy took it too far though","likes":null,"reply_count":null,"commented_at":"2026-10-12T13:07:29Z"}],"stored_total":8,"next_cursor":"WzU4XQ","has_more":true},"meta":{"cost":"$0.0005","balance":"$9.9990","request_id":"req_a34e18d03c8761e1efb72d80871f1c65"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"404":{"description":"The post is not stored. You are not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/facebook/profile":{"get":{"tags":["Facebook"],"operationId":"facebookProfile","summary":"profile","x-dashboard-cost":"$0.0005","x-example-query":{"handle":"natgeo"},"description":"A page's public profile: name, category, followers and links. `extra` carries `likes`, `website`, `location`, `delegate_page_id` and, with `get_business_hours=true`, `business_hours`. Returns `Profile` under `data`; the upstream document is an HTML page, so `get_raw` is not available.\n\nA field Facebook does not carry is null, a list it does not carry is `[]`, and Facebook-only facts sit under `extra`. Unknown, unsupported, and repeated query parameters return 400 before acquisition or billing.","security":[{"bearerAuth":[]}],"parameters":[{"name":"handle","in":"query","required":true,"description":"A page’s vanity name, its numeric id, or its https://www.facebook.com/<page> URL.","example":"natgeo","schema":{"type":"string"}},{"name":"get_business_hours","in":"query","required":false,"description":"`true` also reads the page’s weekly business hours into `extra.business_hours`.","schema":{"type":"boolean","default":false},"examples":{"default":{"value":false,"x-disabled":true}}},{"name":"cached","in":"query","required":false,"description":"`auto` (default) serves a read saved within the last 24 hours for these exact arguments, otherwise fetches. `cache_only` never contacts Facebook (404 `not_cached` when nothing is saved, whatever its age). `live` always fetches. Anything else is a `400`.","schema":{"type":"string","enum":["auto","cache_only","live"],"default":"auto"},"examples":{"default":{"value":"auto","x-disabled":true}}},{"name":"get_raw","in":"query","required":false,"description":"Not available on this operation: the upstream document is an HTML page, and `true` answers 400. The default `false` returns the normalized type.","schema":{"type":"boolean","default":false},"examples":{"default":{"value":false,"x-disabled":true}}}],"responses":{"200":{"description":"`Profile` under `data`.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/Profile"},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"id":"100044623170418","username":"natgeo","full_name":"National Geographic","biography":null,"followers":51000000,"following":2,"posts":null,"is_verified":true,"is_private":false,"avatar_url":"https://scontent.fppb9-1.fna.fbcdn.net/v/t39.30808-1/475979419_1182307929933302_8257114326919725462_n.jpg?stp=dst-jpg_tt6&cstp=mx400x400&ctp=s100x100&_nc_cat=1&ccb=1-7&_nc_sid=2d3e12&_nc_ohc=3Oz3Y5zFgasQ7kNvwH32Bob&_nc_oc=Adr2zp6FrHb41fdimfvC0RBECptnsAA_AlGaTV_9V1RnEnTx3WSw0jxMTbZ5usgPa08&_nc_zt=24&_nc_ht=scontent.fppb9-1.fna&_nc_gid=g5ym-RnLvyjLqkPLgScvgA&_nc_ss=7b289&oh=00_AQPlJyDUvzGUB0Ij3R2_V2R-hMQ793kIfI_DY31DniY-hA&oe=6AE6D1FD","external_url":null,"links":[],"category":"Media/news company","business_category":null,"is_business":null,"is_professional":null,"business_email":null,"business_phone":null,"business_address":null,"pronouns":[],"highlight_reel_count":null,"has_clips":null,"is_recently_joined":null,"fbid":null,"extra":{"followers_raw":"51M","following_raw":"2","cover_url":null,"website":null,"location":null,"likes":null,"canonical_url":"https://www.facebook.com/natgeo/","delegate_page_id":"23497828950","contact":{}}},"meta":{"source":"live","fetched_at":"2026-10-27T20:35:33.849992+00:00","cost":"$0.0005","balance":"$9.9995","request_id":"req_ce091767ee86ba9038d4bd60dc4443b0"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"404":{"description":"`cached=cache_only` found nothing saved for these arguments (`not_cached`; call again with `cached=auto` to fetch it), or the Facebook account or item does not exist (`not_found`). You are not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_cached","message":"no saved facebook/profile read for 'natgeo'. cached=cache_only never fetches, so call again with cached=auto to fetch it. You are not charged.","request_id":"req_5c10900e919bc7a3ff79b7501d582b4c"}}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/facebook/profile_photos":{"get":{"tags":["Facebook"],"operationId":"facebookProfilePhotos","summary":"profile_photos","x-dashboard-cost":"$0.0005/8","x-example-query":{"handle":"natgeo","max_pages":"1"},"description":"The photos a page shows, 8 a page. Returns `Page[Post]` under `data`; the upstream document is an HTML page, so `get_raw` is not available.\n\nThe default request creates a durable job (202). Use max_pages=1 for one synchronous Page response (200). Poll status_url, then read results_url with its opaque cursor. Acquisition stops at the first of since, max_pages, or exhaustion. Jobs continue after disconnects. Result responses are bounded to 3 MiB; this does not limit the crawl. Supply Idempotency-Key to recover a lost submission response; reuse it with the same inputs. Facebook sets every page’s size, so there is no `page_size`.\n\nA field Facebook does not carry is null, a list it does not carry is `[]`, and Facebook-only facts sit under `extra`. Unknown, unsupported, and repeated query parameters return 400 before acquisition or billing.\n\nBilling: $0.0005 per 8 unique returned items (one native page), rounded up to a minimum of one billing unit; a `get_raw=true` page bills one unit. Jobs settle once after successful completion. Submission, polling and repeat downloads are free.","security":[{"bearerAuth":[]}],"parameters":[{"name":"handle","in":"query","required":true,"description":"A page’s vanity name, its numeric id, or its https://www.facebook.com/<page> URL.","example":"natgeo","schema":{"type":"string"}},{"name":"since","in":"query","required":false,"description":"Stop at this date. `2025-09-21` means midnight UTC (2025-09-21T00:00:00Z). Datetimes must use RFC3339 with a timezone, for example `2025-09-21T09:00:00+09:00`. `365d` means 365 days before submission. Invalid calendar dates return 400. With max_pages, the first boundary reached stops the walk. since alone creates a job.","schema":{"type":"string"},"examples":{"default":{"value":"2025-09-21","x-disabled":true},"date":{"value":"2025-09-21","x-disabled":true},"datetime":{"value":"2025-09-21T00:00:00Z","x-disabled":true},"duration":{"value":"365d","x-disabled":true}}},{"name":"max_pages","in":"query","required":false,"example":1,"description":"Maximum pages to fetch. -1 walks until exhaustion or since with no page cap, and must be written. Omitted, since alone bounds the walk; with neither, the job stops after 10 pages. Any positive integer is accepted. 1 returns one page synchronously with HTTP 200; any other value creates a durable job with HTTP 202.","schema":{"type":"integer","anyOf":[{"enum":[-1]},{"minimum":1}]}},{"name":"cursor","in":"query","required":false,"description":"Opaque next_cursor from an earlier answer of this operation, also with `get_raw=true`. A native Facebook cursor from a raw page answers 400. Result download cursors belong to the results route.","schema":{"type":"string","minLength":1}},{"name":"cached","in":"query","required":false,"description":"`auto` (default) serves a read saved within the last 24 hours for these exact arguments, otherwise fetches. `cache_only` never contacts Facebook (404 `not_cached` when nothing is saved, whatever its age). `live` always fetches. Anything else is a `400`. `cache_only` reads one saved page per request: omit `max_pages` or pass 1, and continue with `next_cursor`.","schema":{"type":"string","enum":["auto","cache_only","live"],"default":"auto"},"examples":{"default":{"value":"auto","x-disabled":true}}},{"name":"get_raw","in":"query","required":false,"description":"Not available on this operation: the upstream document is an HTML page, and `true` answers 400. The default `false` returns the normalized type.","schema":{"type":"boolean","default":false},"examples":{"default":{"value":false,"x-disabled":true}}},{"name":"Idempotency-Key","in":"header","required":false,"description":"Reuse this key with the same inputs to recover a lost job submission. A different input with the same key returns 409.","schema":{"type":"string","minLength":1,"maxLength":200}}],"responses":{"200":{"description":"`Page[Post]` under `data`.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","required":["items","pages","next_cursor","has_more","stop_reason","coverage"],"properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/Post"},"description":"`Post` of every page walked, in page order."},"pages":{"type":"array","items":{"$ref":"#/components/schemas/PageRead"},"description":"One entry per page walked."},"next_cursor":{"type":"string","nullable":true,"description":"Opaque; pass back as `cursor` to continue."},"has_more":{"type":"boolean","description":"True when `next_cursor` is set, and when the walk stopped `cursor_stalled` on a page that said more results exist but gave no cursor to send back."},"stop_reason":{"type":"string","enum":["pages","since","exhausted","cursor_stalled","repeated_content","deadline","blocked","caught_up"],"description":"Why the walk stopped. `pages`: the page budget is spent and `next_cursor` continues it. `deadline`: the call ran out of time before its next page; `next_cursor` continues it. `since`: a whole page was older than `since`. `exhausted`: Facebook reported the end. `cursor_stalled`: Facebook claimed more but repeated or omitted its cursor. `repeated_content`: a page held only items already seen. `blocked`: Facebook refused a later page; `next_cursor` is the page it refused. `caught_up`: only watch passes the crawler runs for itself stop this way."},"coverage":{"$ref":"#/components/schemas/Coverage"}}},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"items":[{"id":"1702974071200016","shortcode":null,"taken_at":null,"kind":"image","product_type":"photo","caption":"May be an image of text","hashtags":[],"mentions":[],"accessibility_caption":null,"likes":null,"comments":null,"views":null,"counts_hidden":null,"comments_disabled":null,"is_pinned":null,"is_paid_partnership":null,"owner":{"id":"100044623170418","username":null,"full_name":null,"is_verified":null,"is_private":null,"avatar_url":null,"latest_story_at":null,"extra":{}},"coauthors":[],"sponsors":[],"tagged":[],"location":null,"audio":null,"thumbnail_url":"https://scontent.fppb9-1.fna.fbcdn.net/v/t39.99422-6/860299954_1894639838169424_8451507359144585010_n.png?stp=dst-jpg_tt6&cstp=mx1080x1350&ctp=s1080x1350&_nc_cat=1&ccb=1-7&_nc_sid=127cfc&_nc_ohc=UDPtIn5BHJoQ7kNvwFqKEx5&_nc_oc=AdoBoKfE1zUyuG-76RaIbYO4748yisgQE-QBxqGaeTUiytAvKA5vr4Va_A6kUb6Zhs4&_nc_zt=14&_nc_ht=scontent.fppb9-1.fna&_nc_gid=pE7Sc1eCjqFw_OQ-NoFQiw&_nc_ss=7b289&oh=00_AQNb3trBVudOrZIxP1LFa8QPuMtDcXaGbSB6H2hzJeQkXw&oe=6AE6E8FF","video_duration":null,"media":[{"kind":"image","url":"https://scontent.fppb9-1.fna.fbcdn.net/v/t39.99422-6/860299954_1894639838169424_8451507359144585010_n.png?stp=dst-jpg_tt6&cstp=mx1080x1350&ctp=s1080x1350&_nc_cat=1&ccb=1-7&_nc_sid=127cfc&_nc_ohc=UDPtIn5BHJoQ7kNvwFqKEx5&_nc_oc=AdoBoKfE1zUyuG-76RaIbYO4748yisgQE-QBxqGaeTUiytAvKA5vr4Va_A6kUb6Zhs4&_nc_zt=14&_nc_ht=scontent.fppb9-1.fna&_nc_gid=pE7Sc1eCjqFw_OQ-NoFQiw&_nc_ss=7b289&oh=00_AQNb3trBVudOrZIxP1LFa8QPuMtDcXaGbSB6H2hzJeQkXw&oe=6AE6E8FF","width":1080,"height":1350,"duration":null}],"media_urls":["https://scontent.fppb9-1.fna.fbcdn.net/v/t39.99422-6/860299954_1894639838169424_8451507359144585010_n.png?stp=dst-jpg_tt6&cstp=mx1080x1350&ctp=s1080x1350&_nc_cat=1&ccb=1-7&_nc_sid=127cfc&_nc_ohc=UDPtIn5BHJoQ7kNvwFqKEx5&_nc_oc=AdoBoKfE1zUyuG-76RaIbYO4748yisgQE-QBxqGaeTUiytAvKA5vr4Va_A6kUb6Zhs4&_nc_zt=14&_nc_ht=scontent.fppb9-1.fna&_nc_gid=pE7Sc1eCjqFw_OQ-NoFQiw&_nc_ss=7b289&oh=00_AQNb3trBVudOrZIxP1LFa8QPuMtDcXaGbSB6H2hzJeQkXw&oe=6AE6E8FF"],"extra":{"group_id":null,"feedback_id":null,"canonical_url":"https://www.facebook.com/photo.php?fbid=1702974071200016&set=pb.100044623170418.-2207520000&type=3","title":null,"shares":null}},{"id":"1702468301250593","shortcode":null,"taken_at":null,"kind":"image","product_type":"photo","caption":"May be an image of text","hashtags":[],"mentions":[],"accessibility_caption":null,"likes":null,"comments":null,"views":null,"counts_hidden":null,"comments_disabled":null,"is_pinned":null,"is_paid_partnership":null,"owner":{"id":"100044623170418","username":null,"full_name":null,"is_verified":null,"is_private":null,"avatar_url":null,"latest_story_at":null,"extra":{}},"coauthors":[],"sponsors":[],"tagged":[],"location":null,"audio":null,"thumbnail_url":"https://scontent.fppb9-1.fna.fbcdn.net/v/t39.99422-6/863382827_1839499183852364_6668556144523203533_n.png?stp=dst-jpg_tt6&cstp=mx1080x1350&ctp=s1080x1350&_nc_cat=1&ccb=1-7&_nc_sid=127cfc&_nc_ohc=X4RNU7c8gZcQ7kNvwGvg8vI&_nc_oc=Adq3d668GW1le2eAFhVHySxrmsxr0IDNDUXypTy2B_nVmSkBKrq0eGGoYyIDm4DRnq4&_nc_zt=14&_nc_ht=scontent.fppb9-1.fna&_nc_gid=pE7Sc1eCjqFw_OQ-NoFQiw&_nc_ss=7b289&oh=00_AQPelka0fEZ_itv0RWEdTrs6_koBEsVlVezwORdJ6iBBow&oe=6AE6F324","video_duration":null,"media":[{"kind":"image","url":"https://scontent.fppb9-1.fna.fbcdn.net/v/t39.99422-6/863382827_1839499183852364_6668556144523203533_n.png?stp=dst-jpg_tt6&cstp=mx1080x1350&ctp=s1080x1350&_nc_cat=1&ccb=1-7&_nc_sid=127cfc&_nc_ohc=X4RNU7c8gZcQ7kNvwGvg8vI&_nc_oc=Adq3d668GW1le2eAFhVHySxrmsxr0IDNDUXypTy2B_nVmSkBKrq0eGGoYyIDm4DRnq4&_nc_zt=14&_nc_ht=scontent.fppb9-1.fna&_nc_gid=pE7Sc1eCjqFw_OQ-NoFQiw&_nc_ss=7b289&oh=00_AQPelka0fEZ_itv0RWEdTrs6_koBEsVlVezwORdJ6iBBow&oe=6AE6F324","width":1080,"height":1350,"duration":null}],"media_urls":["https://scontent.fppb9-1.fna.fbcdn.net/v/t39.99422-6/863382827_1839499183852364_6668556144523203533_n.png?stp=dst-jpg_tt6&cstp=mx1080x1350&ctp=s1080x1350&_nc_cat=1&ccb=1-7&_nc_sid=127cfc&_nc_ohc=X4RNU7c8gZcQ7kNvwGvg8vI&_nc_oc=Adq3d668GW1le2eAFhVHySxrmsxr0IDNDUXypTy2B_nVmSkBKrq0eGGoYyIDm4DRnq4&_nc_zt=14&_nc_ht=scontent.fppb9-1.fna&_nc_gid=pE7Sc1eCjqFw_OQ-NoFQiw&_nc_ss=7b289&oh=00_AQPelka0fEZ_itv0RWEdTrs6_koBEsVlVezwORdJ6iBBow&oe=6AE6F324"],"extra":{"group_id":null,"feedback_id":null,"canonical_url":"https://www.facebook.com/photo.php?fbid=1702468301250593&set=pb.100044623170418.-2207520000&type=3","title":null,"shares":null}}],"pages":[{"cursor":null,"fetched_at":"2026-10-27T20:35:35.111515+00:00","count":2}],"next_cursor":"eyJhZnRlciI6IkFRSFR4UzhMY2VJMEhSQS1ZR2xMb09JSVRFeUlYMlNrWW9rSVNia0l3MzJ4MFZvX3J0bFBKeW5SSmh4NzB3MktKU0NpdEtZRTZXZ282dU9NdGR4RmxJQ1RIQSIsIm9wIjoicHJvZmlsZV9waG90b3MifQ","has_more":true,"stop_reason":"pages","coverage":{"since":null,"oldest_at":null,"since_reached":false}},"meta":{"source":"live","fetched_at":"2026-10-27T20:35:35.111515+00:00","cost":"$0.0005","balance":"$9.9995","request_id":"req_cc16497dfb0509403366aa7a5a1a9f71"}}}}},"202":{"description":"Durable job accepted. No completed-result charge. Save batch_id; poll status_url. Retry submission with the same Idempotency-Key after a lost response. An account may have five queued, running or payment-required jobs. A sixth new job returns 429 rate_limited. Matching idempotent replays still work at the limit. Ready and failed jobs release their slots; pages within a job remain unbounded. This is a synthetic contract example, not a live capture.","x-example-provenance":"synthetic-contract","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","required":["batch_id","status","status_url","results_url","cost","item_count","error","retry_at","total","done_count","failed_count","created_at","started_at","finished_at"],"properties":{"batch_id":{"type":"string"},"status":{"type":"string","enum":["queued","running","payment_required","ready","failed"]},"status_url":{"type":"string"},"results_url":{"type":"string"},"cost":{"type":"string"},"item_count":{"type":"integer","nullable":true},"error":{"type":"string","nullable":true,"description":"Null unless failed. A failed target carries its own code; incomplete_result appears only when it has none and pages of the result are missing. profile_not_found, post_not_found, upstream_not_found or not_found: the target does not exist or is not visible. not_visible: The account exists, but its posts are not visible to logged-out readers (private, restricted, or hidden by Instagram). Retrying will not change the result until the account changes. not_cached: cached=cache_only found no saved read. incomplete_result: pages of the result are missing. temporarily_unavailable: the target could not be read for now (no capacity, a pause or repeated refusals); retry later with a new job. result_item_too_large: one result unit exceeds the delivery budget. result_snapshot_missing or result_snapshot_corrupt: the crawler could not serve the retained result of a paid job, and its charge is refunded; if the crawler serves it again, a later results read returns it and charges the job again. crawler_submit_400, crawler_submit_404 or crawler_submit_422: the crawl service refused the job request. crawler_job_failed: any other failure; the same job is not expected to succeed if resubmitted. cancelled: the job was cancelled with POST /v1/jobs/{job_id}/cancel. No failed job costs anything: only result_snapshot_missing and result_snapshot_corrupt follow a charge, and that charge is refunded."},"retry_at":{"type":"string","format":"date-time","nullable":true,"description":"Null unless the job failed temporarily_unavailable because a crawl route was closed for every caller. Then it is when the route opens again, and the response carries the same time as a Retry-After header in seconds. Submit a new job after it."},"total":{"type":"integer","description":"Targets in the job. A job submitted through a /v1 route has one."},"done_count":{"type":"integer","description":"Targets the crawler finished."},"failed_count":{"type":"integer","description":"Targets that failed."},"created_at":{"type":"string","format":"date-time","description":"When the job was submitted."},"started_at":{"type":"string","format":"date-time","nullable":true,"description":"When the crawler started the job. Null until it starts."},"finished_at":{"type":"string","format":"date-time","nullable":true,"description":"When the job finished or failed. Null while it is queued or running."}}},"meta":{"type":"object","required":["cost","request_id"],"properties":{"cost":{"type":"string","example":"$0.0000"},"request_id":{"type":"string"}}}}},"example":{"data":{"batch_id":"job_7641d5f0-717d-4b70-a2f1-f58d846d7242","status":"queued","status_url":"/v1/jobs/job_7641d5f0-717d-4b70-a2f1-f58d846d7242","results_url":"/v1/jobs/job_7641d5f0-717d-4b70-a2f1-f58d846d7242/results","cost":"$0.0000","item_count":null,"error":null,"retry_at":null,"total":1,"done_count":0,"failed_count":0,"created_at":"2026-10-12T12:56:17.403Z","started_at":null,"finished_at":null},"meta":{"cost":"$0.0000","request_id":"req_job_example"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"404":{"description":"`cached=cache_only` found nothing saved for these arguments (`not_cached`; call again with `cached=auto` to fetch it), or the Facebook account or item does not exist (`not_found`). You are not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_cached","message":"no saved facebook/profile_photos read for 'natgeo'. cached=cache_only never fetches, so call again with cached=auto to fetch it. You are not charged.","request_id":"req_5c10900e919bc7a3ff79b7501d582b4c"}}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/facebook/profile_reels":{"get":{"tags":["Facebook"],"operationId":"facebookProfileReels","summary":"profile_reels","x-dashboard-cost":"$0.0005/10","x-example-query":{"handle":"natgeo","max_pages":"1"},"description":"A page's reels, 10 a page, with views, likes and comments. Returns `Page[Post]` under `data`; the upstream document is an HTML page, so `get_raw` is not available.\n\nThe default request creates a durable job (202). Use max_pages=1 for one synchronous Page response (200). Poll status_url, then read results_url with its opaque cursor. Acquisition stops at the first of since, max_pages, or exhaustion. Jobs continue after disconnects. Result responses are bounded to 3 MiB; this does not limit the crawl. Supply Idempotency-Key to recover a lost submission response; reuse it with the same inputs. Facebook sets every page’s size, so there is no `page_size`.\n\nA field Facebook does not carry is null, a list it does not carry is `[]`, and Facebook-only facts sit under `extra`. Unknown, unsupported, and repeated query parameters return 400 before acquisition or billing.\n\nBilling: $0.0005 per 10 unique returned items (one native page), rounded up to a minimum of one billing unit; a `get_raw=true` page bills one unit. Jobs settle once after successful completion. Submission, polling and repeat downloads are free.","security":[{"bearerAuth":[]}],"parameters":[{"name":"handle","in":"query","required":true,"description":"A page’s vanity name, its numeric id, or its https://www.facebook.com/<page> URL.","example":"natgeo","schema":{"type":"string"}},{"name":"since","in":"query","required":false,"description":"Stop at this date. `2025-09-21` means midnight UTC (2025-09-21T00:00:00Z). Datetimes must use RFC3339 with a timezone, for example `2025-09-21T09:00:00+09:00`. `365d` means 365 days before submission. Invalid calendar dates return 400. With max_pages, the first boundary reached stops the walk. since alone creates a job.","schema":{"type":"string"},"examples":{"default":{"value":"2025-09-21","x-disabled":true},"date":{"value":"2025-09-21","x-disabled":true},"datetime":{"value":"2025-09-21T00:00:00Z","x-disabled":true},"duration":{"value":"365d","x-disabled":true}}},{"name":"max_pages","in":"query","required":false,"example":1,"description":"Maximum pages to fetch. -1 walks until exhaustion or since with no page cap, and must be written. Omitted, since alone bounds the walk; with neither, the job stops after 10 pages. Any positive integer is accepted. 1 returns one page synchronously with HTTP 200; any other value creates a durable job with HTTP 202.","schema":{"type":"integer","anyOf":[{"enum":[-1]},{"minimum":1}]}},{"name":"cursor","in":"query","required":false,"description":"Opaque next_cursor from an earlier answer of this operation, also with `get_raw=true`. A native Facebook cursor from a raw page answers 400. Result download cursors belong to the results route.","schema":{"type":"string","minLength":1}},{"name":"cached","in":"query","required":false,"description":"`auto` (default) serves a read saved within the last 24 hours for these exact arguments, otherwise fetches. `cache_only` never contacts Facebook (404 `not_cached` when nothing is saved, whatever its age). `live` always fetches. Anything else is a `400`. `cache_only` reads one saved page per request: omit `max_pages` or pass 1, and continue with `next_cursor`.","schema":{"type":"string","enum":["auto","cache_only","live"],"default":"auto"},"examples":{"default":{"value":"auto","x-disabled":true}}},{"name":"get_raw","in":"query","required":false,"description":"Not available on this operation: the upstream document is an HTML page, and `true` answers 400. The default `false` returns the normalized type.","schema":{"type":"boolean","default":false},"examples":{"default":{"value":false,"x-disabled":true}}},{"name":"Idempotency-Key","in":"header","required":false,"description":"Reuse this key with the same inputs to recover a lost job submission. A different input with the same key returns 409.","schema":{"type":"string","minLength":1,"maxLength":200}}],"responses":{"200":{"description":"`Page[Post]` under `data`.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","required":["items","pages","next_cursor","has_more","stop_reason","coverage"],"properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/Post"},"description":"`Post` of every page walked, in page order."},"pages":{"type":"array","items":{"$ref":"#/components/schemas/PageRead"},"description":"One entry per page walked."},"next_cursor":{"type":"string","nullable":true,"description":"Opaque; pass back as `cursor` to continue."},"has_more":{"type":"boolean","description":"True when `next_cursor` is set, and when the walk stopped `cursor_stalled` on a page that said more results exist but gave no cursor to send back."},"stop_reason":{"type":"string","enum":["pages","since","exhausted","cursor_stalled","repeated_content","deadline","blocked","caught_up"],"description":"Why the walk stopped. `pages`: the page budget is spent and `next_cursor` continues it. `deadline`: the call ran out of time before its next page; `next_cursor` continues it. `since`: a whole page was older than `since`. `exhausted`: Facebook reported the end. `cursor_stalled`: Facebook claimed more but repeated or omitted its cursor. `repeated_content`: a page held only items already seen. `blocked`: Facebook refused a later page; `next_cursor` is the page it refused. `caught_up`: only watch passes the crawler runs for itself stop this way."},"coverage":{"$ref":"#/components/schemas/Coverage"}}},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"items":[{"id":"1703232194507537","shortcode":null,"taken_at":"2026-10-27T18:00:00Z","kind":"video","product_type":"reel","caption":"Even a moment’s rest on Everest can come with a reminder of just how unpredictable the mountain can be.\n\nFrom Oscar®-winning filmmakers Elizabeth Chai Vasarhelyi and Jimmy Chin, EVEREST: THE OTHER SIDE, only in theaters and IMAX worldwide on October 30.","hashtags":[],"mentions":[],"accessibility_caption":null,"likes":86,"comments":1,"views":14000,"counts_hidden":null,"comments_disabled":null,"is_pinned":null,"is_paid_partnership":null,"owner":{"id":"100044623170418","username":null,"full_name":null,"is_verified":null,"is_private":null,"avatar_url":null,"latest_story_at":null,"extra":{}},"coauthors":[],"sponsors":[],"tagged":[],"location":null,"audio":null,"thumbnail_url":null,"video_duration":null,"media":[],"media_urls":[],"extra":{"group_id":null,"feedback_id":"ZmVlZGJhY2s6MTcwMzIzMjE5NDUwNzUzNw==","canonical_url":"https://www.facebook.com/reel/2574821923003417","title":null,"shares":null,"plays_raw":"14K"}},{"id":"1703133444517412","shortcode":null,"taken_at":"2026-10-27T16:00:00Z","kind":"video","product_type":"reel","caption":"Friendship is important, especially for bonobos. This primate quickly learns that grooming can help break the ice and build new bonds.\n\n#NatGeoQueens is streaming on Disney+ and Hulu.","hashtags":["NatGeoQueens"],"mentions":[],"accessibility_caption":null,"likes":276,"comments":7,"views":25000,"counts_hidden":null,"comments_disabled":null,"is_pinned":null,"is_paid_partnership":null,"owner":{"id":"100044623170418","username":null,"full_name":null,"is_verified":null,"is_private":null,"avatar_url":null,"latest_story_at":null,"extra":{}},"coauthors":[],"sponsors":[],"tagged":[],"location":null,"audio":null,"thumbnail_url":null,"video_duration":null,"media":[],"media_urls":[],"extra":{"group_id":null,"feedback_id":"ZmVlZGJhY2s6cGZiaWQweW5EYWk5d2RocVdOeEhETGFDeVI4OUU2RVg1Z1FENUdQYXJCRVpZWkRwaGRaTkVUSFhhcDN2R0xRYjFLUFZBbWw=","canonical_url":"https://www.facebook.com/reel/2613977089029646","title":null,"shares":null,"plays_raw":"25K"}}],"pages":[{"cursor":null,"fetched_at":"2026-10-27T20:35:38.118869+00:00","count":2}],"next_cursor":"eyJhZnRlciI6IkFRSFRmb2lvUDhxbWEzcWtual9feUlLZm12LUVKOUJkX0V3Q09xSzFUZ0ViWlRRWjZoSG0xLUNpa1BEVmhMd1Vqc2hJMElRUm9MR3N4SUVjbkFvbEhhRXZGQSIsIm9wIjoicHJvZmlsZV9yZWVscyJ9","has_more":true,"stop_reason":"pages","coverage":{"since":null,"oldest_at":"2026-10-24T13:00:08+00:00","since_reached":false}},"meta":{"source":"live","fetched_at":"2026-10-27T20:35:38.118869+00:00","cost":"$0.0005","balance":"$9.9995","request_id":"req_b223fc6eef3c216c10386c302ae3d2a9"}}}}},"202":{"description":"Durable job accepted. No completed-result charge. Save batch_id; poll status_url. Retry submission with the same Idempotency-Key after a lost response. An account may have five queued, running or payment-required jobs. A sixth new job returns 429 rate_limited. Matching idempotent replays still work at the limit. Ready and failed jobs release their slots; pages within a job remain unbounded. This is a synthetic contract example, not a live capture.","x-example-provenance":"synthetic-contract","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","required":["batch_id","status","status_url","results_url","cost","item_count","error","retry_at","total","done_count","failed_count","created_at","started_at","finished_at"],"properties":{"batch_id":{"type":"string"},"status":{"type":"string","enum":["queued","running","payment_required","ready","failed"]},"status_url":{"type":"string"},"results_url":{"type":"string"},"cost":{"type":"string"},"item_count":{"type":"integer","nullable":true},"error":{"type":"string","nullable":true,"description":"Null unless failed. A failed target carries its own code; incomplete_result appears only when it has none and pages of the result are missing. profile_not_found, post_not_found, upstream_not_found or not_found: the target does not exist or is not visible. not_visible: The account exists, but its posts are not visible to logged-out readers (private, restricted, or hidden by Instagram). Retrying will not change the result until the account changes. not_cached: cached=cache_only found no saved read. incomplete_result: pages of the result are missing. temporarily_unavailable: the target could not be read for now (no capacity, a pause or repeated refusals); retry later with a new job. result_item_too_large: one result unit exceeds the delivery budget. result_snapshot_missing or result_snapshot_corrupt: the crawler could not serve the retained result of a paid job, and its charge is refunded; if the crawler serves it again, a later results read returns it and charges the job again. crawler_submit_400, crawler_submit_404 or crawler_submit_422: the crawl service refused the job request. crawler_job_failed: any other failure; the same job is not expected to succeed if resubmitted. cancelled: the job was cancelled with POST /v1/jobs/{job_id}/cancel. No failed job costs anything: only result_snapshot_missing and result_snapshot_corrupt follow a charge, and that charge is refunded."},"retry_at":{"type":"string","format":"date-time","nullable":true,"description":"Null unless the job failed temporarily_unavailable because a crawl route was closed for every caller. Then it is when the route opens again, and the response carries the same time as a Retry-After header in seconds. Submit a new job after it."},"total":{"type":"integer","description":"Targets in the job. A job submitted through a /v1 route has one."},"done_count":{"type":"integer","description":"Targets the crawler finished."},"failed_count":{"type":"integer","description":"Targets that failed."},"created_at":{"type":"string","format":"date-time","description":"When the job was submitted."},"started_at":{"type":"string","format":"date-time","nullable":true,"description":"When the crawler started the job. Null until it starts."},"finished_at":{"type":"string","format":"date-time","nullable":true,"description":"When the job finished or failed. Null while it is queued or running."}}},"meta":{"type":"object","required":["cost","request_id"],"properties":{"cost":{"type":"string","example":"$0.0000"},"request_id":{"type":"string"}}}}},"example":{"data":{"batch_id":"job_7641d5f0-717d-4b70-a2f1-f58d846d7242","status":"queued","status_url":"/v1/jobs/job_7641d5f0-717d-4b70-a2f1-f58d846d7242","results_url":"/v1/jobs/job_7641d5f0-717d-4b70-a2f1-f58d846d7242/results","cost":"$0.0000","item_count":null,"error":null,"retry_at":null,"total":1,"done_count":0,"failed_count":0,"created_at":"2026-10-12T12:56:17.403Z","started_at":null,"finished_at":null},"meta":{"cost":"$0.0000","request_id":"req_job_example"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"404":{"description":"`cached=cache_only` found nothing saved for these arguments (`not_cached`; call again with `cached=auto` to fetch it), or the Facebook account or item does not exist (`not_found`). You are not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_cached","message":"no saved facebook/profile_reels read for 'natgeo'. cached=cache_only never fetches, so call again with cached=auto to fetch it. You are not charged.","request_id":"req_5c10900e919bc7a3ff79b7501d582b4c"}}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/facebook/profile_events":{"get":{"tags":["Facebook"],"operationId":"facebookProfileEvents","summary":"profile_events","x-dashboard-cost":"$0.0005/8","x-example-query":{"handle":"natgeo","max_pages":"1"},"description":"The events a page hosts, 8 a page. Returns `Page[FacebookEvent]` under `data`; the upstream document is an HTML page, so `get_raw` is not available.\n\nThe default request creates a durable job (202). Use max_pages=1 for one synchronous Page response (200). Poll status_url, then read results_url with its opaque cursor. Acquisition stops at the first of since, max_pages, or exhaustion. Jobs continue after disconnects. Result responses are bounded to 3 MiB; this does not limit the crawl. Supply Idempotency-Key to recover a lost submission response; reuse it with the same inputs. Facebook sets every page’s size, so there is no `page_size`.\n\nA field Facebook does not carry is null, a list it does not carry is `[]`, and Facebook-only facts sit under `extra`. Unknown, unsupported, and repeated query parameters return 400 before acquisition or billing.\n\nBilling: $0.0005 per 8 unique returned items (one native page), rounded up to a minimum of one billing unit; a `get_raw=true` page bills one unit. Jobs settle once after successful completion. Submission, polling and repeat downloads are free.","security":[{"bearerAuth":[]}],"parameters":[{"name":"handle","in":"query","required":true,"description":"A page’s vanity name, its numeric id, or its https://www.facebook.com/<page> URL.","example":"natgeo","schema":{"type":"string"}},{"name":"since","in":"query","required":false,"description":"Not accepted on this operation: its items carry no timestamp, so since returns 400 before billing.","schema":{"type":"string"}},{"name":"max_pages","in":"query","required":false,"example":1,"description":"Maximum pages to fetch. -1 walks until exhaustion or since with no page cap, and must be written. Omitted, since alone bounds the walk; with neither, the job stops after 10 pages. Any positive integer is accepted. 1 returns one page synchronously with HTTP 200; any other value creates a durable job with HTTP 202.","schema":{"type":"integer","anyOf":[{"enum":[-1]},{"minimum":1}]}},{"name":"cursor","in":"query","required":false,"description":"Opaque next_cursor from an earlier answer of this operation, also with `get_raw=true`. A native Facebook cursor from a raw page answers 400. Result download cursors belong to the results route.","schema":{"type":"string","minLength":1}},{"name":"cached","in":"query","required":false,"description":"`auto` (default) serves a read saved within the last 24 hours for these exact arguments, otherwise fetches. `cache_only` never contacts Facebook (404 `not_cached` when nothing is saved, whatever its age). `live` always fetches. Anything else is a `400`. `cache_only` reads one saved page per request: omit `max_pages` or pass 1, and continue with `next_cursor`.","schema":{"type":"string","enum":["auto","cache_only","live"],"default":"auto"},"examples":{"default":{"value":"auto","x-disabled":true}}},{"name":"get_raw","in":"query","required":false,"description":"Not available on this operation: the upstream document is an HTML page, and `true` answers 400. The default `false` returns the normalized type.","schema":{"type":"boolean","default":false},"examples":{"default":{"value":false,"x-disabled":true}}},{"name":"Idempotency-Key","in":"header","required":false,"description":"Reuse this key with the same inputs to recover a lost job submission. A different input with the same key returns 409.","schema":{"type":"string","minLength":1,"maxLength":200}}],"responses":{"200":{"description":"`Page[FacebookEvent]` under `data`.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","required":["items","pages","next_cursor","has_more","stop_reason","coverage"],"properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/FacebookEvent"},"description":"`FacebookEvent` of every page walked, in page order."},"pages":{"type":"array","items":{"$ref":"#/components/schemas/PageRead"},"description":"One entry per page walked."},"next_cursor":{"type":"string","nullable":true,"description":"Opaque; pass back as `cursor` to continue."},"has_more":{"type":"boolean","description":"True when `next_cursor` is set, and when the walk stopped `cursor_stalled` on a page that said more results exist but gave no cursor to send back."},"stop_reason":{"type":"string","enum":["pages","since","exhausted","cursor_stalled","repeated_content","deadline","blocked","caught_up"],"description":"Why the walk stopped. `pages`: the page budget is spent and `next_cursor` continues it. `deadline`: the call ran out of time before its next page; `next_cursor` continues it. `since`: a whole page was older than `since`. `exhausted`: Facebook reported the end. `cursor_stalled`: Facebook claimed more but repeated or omitted its cursor. `repeated_content`: a page held only items already seen. `blocked`: Facebook refused a later page; `next_cursor` is the page it refused. `caught_up`: only watch passes the crawler runs for itself stop this way."},"coverage":{"$ref":"#/components/schemas/Coverage"}}},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"items":[{"id":"877611112888425","name":"How Asian Elephants Communicate","description":null,"url":"https://www.facebook.com/events/877611112888425/","starts_at":null,"ends_at":null,"timezone":null,"location_name":null,"address":null,"lat":null,"lng":null,"host":null,"going":null,"interested":null,"is_online":null},{"id":"508327580188480","name":"Nat Geo’s Earth Day Eve 2021","description":null,"url":"https://www.facebook.com/events/508327580188480/","starts_at":null,"ends_at":null,"timezone":null,"location_name":null,"address":null,"lat":null,"lng":null,"host":null,"going":null,"interested":null,"is_online":null}],"pages":[{"cursor":null,"fetched_at":"2026-10-27T20:35:40.184001+00:00","count":2}],"next_cursor":"eyJhZnRlciI6IkFRSFRNT185U2FfbEhmb0dwV2JjWmpwcEpYRXNDSDdkdlZ3cnNmRG5sQkYyTjFBMGZKbzlJQ21RcGdXQmRISm1wNVgybnYtZFlrdHg2VkhrMnJPWTdDbFdiZyIsIm9wIjoicHJvZmlsZV9ldmVudHMifQ","has_more":true,"stop_reason":"pages","coverage":{"since":null,"oldest_at":null,"since_reached":false}},"meta":{"source":"live","fetched_at":"2026-10-27T20:35:40.184001+00:00","cost":"$0.0005","balance":"$9.9995","request_id":"req_4e3398979aef537fcdae59bf3764b651"}}}}},"202":{"description":"Durable job accepted. No completed-result charge. Save batch_id; poll status_url. Retry submission with the same Idempotency-Key after a lost response. An account may have five queued, running or payment-required jobs. A sixth new job returns 429 rate_limited. Matching idempotent replays still work at the limit. Ready and failed jobs release their slots; pages within a job remain unbounded. This is a synthetic contract example, not a live capture.","x-example-provenance":"synthetic-contract","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","required":["batch_id","status","status_url","results_url","cost","item_count","error","retry_at","total","done_count","failed_count","created_at","started_at","finished_at"],"properties":{"batch_id":{"type":"string"},"status":{"type":"string","enum":["queued","running","payment_required","ready","failed"]},"status_url":{"type":"string"},"results_url":{"type":"string"},"cost":{"type":"string"},"item_count":{"type":"integer","nullable":true},"error":{"type":"string","nullable":true,"description":"Null unless failed. A failed target carries its own code; incomplete_result appears only when it has none and pages of the result are missing. profile_not_found, post_not_found, upstream_not_found or not_found: the target does not exist or is not visible. not_visible: The account exists, but its posts are not visible to logged-out readers (private, restricted, or hidden by Instagram). Retrying will not change the result until the account changes. not_cached: cached=cache_only found no saved read. incomplete_result: pages of the result are missing. temporarily_unavailable: the target could not be read for now (no capacity, a pause or repeated refusals); retry later with a new job. result_item_too_large: one result unit exceeds the delivery budget. result_snapshot_missing or result_snapshot_corrupt: the crawler could not serve the retained result of a paid job, and its charge is refunded; if the crawler serves it again, a later results read returns it and charges the job again. crawler_submit_400, crawler_submit_404 or crawler_submit_422: the crawl service refused the job request. crawler_job_failed: any other failure; the same job is not expected to succeed if resubmitted. cancelled: the job was cancelled with POST /v1/jobs/{job_id}/cancel. No failed job costs anything: only result_snapshot_missing and result_snapshot_corrupt follow a charge, and that charge is refunded."},"retry_at":{"type":"string","format":"date-time","nullable":true,"description":"Null unless the job failed temporarily_unavailable because a crawl route was closed for every caller. Then it is when the route opens again, and the response carries the same time as a Retry-After header in seconds. Submit a new job after it."},"total":{"type":"integer","description":"Targets in the job. A job submitted through a /v1 route has one."},"done_count":{"type":"integer","description":"Targets the crawler finished."},"failed_count":{"type":"integer","description":"Targets that failed."},"created_at":{"type":"string","format":"date-time","description":"When the job was submitted."},"started_at":{"type":"string","format":"date-time","nullable":true,"description":"When the crawler started the job. Null until it starts."},"finished_at":{"type":"string","format":"date-time","nullable":true,"description":"When the job finished or failed. Null while it is queued or running."}}},"meta":{"type":"object","required":["cost","request_id"],"properties":{"cost":{"type":"string","example":"$0.0000"},"request_id":{"type":"string"}}}}},"example":{"data":{"batch_id":"job_7641d5f0-717d-4b70-a2f1-f58d846d7242","status":"queued","status_url":"/v1/jobs/job_7641d5f0-717d-4b70-a2f1-f58d846d7242","results_url":"/v1/jobs/job_7641d5f0-717d-4b70-a2f1-f58d846d7242/results","cost":"$0.0000","item_count":null,"error":null,"retry_at":null,"total":1,"done_count":0,"failed_count":0,"created_at":"2026-10-12T12:56:17.403Z","started_at":null,"finished_at":null},"meta":{"cost":"$0.0000","request_id":"req_job_example"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"404":{"description":"`cached=cache_only` found nothing saved for these arguments (`not_cached`; call again with `cached=auto` to fetch it), or the Facebook account or item does not exist (`not_found`). You are not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_cached","message":"no saved facebook/profile_events read for 'natgeo'. cached=cache_only never fetches, so call again with cached=auto to fetch it. You are not charged.","request_id":"req_5c10900e919bc7a3ff79b7501d582b4c"}}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/facebook/group_posts":{"get":{"tags":["Facebook"],"operationId":"facebookGroupPosts","summary":"group_posts","x-dashboard-cost":"$0.0005","x-example-query":{"group":"https://www.facebook.com/groups/NASA.SCIENCE"},"description":"A public group and the posts its logged-out discussion page shows, usually only the newest one. Facebook gives a logged-out reader no further page. Returns `FacebookGroupPosts` under `data`; the upstream document is an HTML page, so `get_raw` is not available.\n\nA field Facebook does not carry is null, a list it does not carry is `[]`, and Facebook-only facts sit under `extra`. Unknown, unsupported, and repeated query parameters return 400 before acquisition or billing.","security":[{"bearerAuth":[]}],"parameters":[{"name":"group","in":"query","required":true,"description":"A public group’s numeric id or https://www.facebook.com/groups/<group> URL.","example":"https://www.facebook.com/groups/NASA.SCIENCE","schema":{"type":"string"}},{"name":"cached","in":"query","required":false,"description":"`auto` (default) serves a read saved within the last 24 hours for these exact arguments, otherwise fetches. `cache_only` never contacts Facebook (404 `not_cached` when nothing is saved, whatever its age). `live` always fetches. Anything else is a `400`.","schema":{"type":"string","enum":["auto","cache_only","live"],"default":"auto"},"examples":{"default":{"value":"auto","x-disabled":true}}},{"name":"get_raw","in":"query","required":false,"description":"Not available on this operation: the upstream document is an HTML page, and `true` answers 400. The default `false` returns the normalized type.","schema":{"type":"boolean","default":false},"examples":{"default":{"value":false,"x-disabled":true}}}],"responses":{"200":{"description":"`FacebookGroupPosts` under `data`.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/FacebookGroupPosts"},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"group":{"id":"349554945138653","slug":"NASA.SCIENCE","url":"https://www.facebook.com/groups/NASA.SCIENCE/","name":"NASA - National Aeronautics and Space Administration","description":null,"privacy":"Public group","members":null,"avatar_url":null,"extra":{"activity":null}},"posts":[{"id":"26479473648386759","shortcode":null,"taken_at":"2026-04-08T15:36:34Z","kind":"image","product_type":"post","caption":"How do you say moon in your Language?","hashtags":[],"mentions":[],"accessibility_caption":null,"likes":14548,"comments":1711,"views":null,"counts_hidden":null,"comments_disabled":null,"is_pinned":null,"is_paid_partnership":null,"owner":{"id":"61559408325583","username":null,"full_name":null,"is_verified":null,"is_private":null,"avatar_url":null,"latest_story_at":null,"extra":{}},"coauthors":[],"sponsors":[],"tagged":[],"location":null,"audio":null,"thumbnail_url":null,"video_duration":null,"media":[],"media_urls":[],"extra":{"group_id":"349554945138653","feedback_id":"ZmVlZGJhY2s6MjY0Nzk0NzM2NDgzODY3NTk=","canonical_url":null,"title":null,"shares":null,"plays_raw":null}},{"id":"28959366860397413","shortcode":null,"taken_at":"2026-10-26T18:57:57Z","kind":"image","product_type":"post","caption":"Voyager 1 just sent back coordinates to an unknown object 🛰️🌌","hashtags":[],"mentions":[],"accessibility_caption":null,"likes":148,"comments":null,"views":null,"counts_hidden":null,"comments_disabled":null,"is_pinned":null,"is_paid_partnership":null,"owner":{"id":"61591150441205","username":null,"full_name":null,"is_verified":null,"is_private":null,"avatar_url":null,"latest_story_at":null,"extra":{}},"coauthors":[],"sponsors":[],"tagged":[],"location":null,"audio":null,"thumbnail_url":null,"video_duration":null,"media":[],"media_urls":[],"extra":{"group_id":"349554945138653","feedback_id":"ZmVlZGJhY2s6Mjg5NTkzNjY4NjAzOTc0MTM=","canonical_url":"https://www.facebook.com/groups/NASA.SCIENCE/posts/28959366860397413/","title":null,"shares":null,"plays_raw":null}}]},"meta":{"source":"live","fetched_at":"2026-10-27T20:35:41.929673+00:00","cost":"$0.0005","balance":"$9.9995","request_id":"req_9dcefb7faa047be938edf38d50a6863b"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"404":{"description":"`cached=cache_only` found nothing saved for these arguments (`not_cached`; call again with `cached=auto` to fetch it), or the Facebook account or item does not exist (`not_found`). You are not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_cached","message":"no saved facebook/group_posts read for 'https://www.facebook.com/groups/NASA.SCIENCE'. cached=cache_only never fetches, so call again with cached=auto to fetch it. You are not charged.","request_id":"req_5c10900e919bc7a3ff79b7501d582b4c"}}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/facebook/post":{"get":{"tags":["Facebook"],"operationId":"facebookPost","summary":"post","x-dashboard-cost":"$0.0005","x-example-query":{"url":"https://www.facebook.com/reel/2574821923003417"},"description":"One post, reel, video or photo from its public page. Send its URL to `/v1/facebook/post_comments` for its comments. Returns `Post` under `data`; the upstream document is an HTML page, so `get_raw` is not available.\n\nA field Facebook does not carry is null, a list it does not carry is `[]`, and Facebook-only facts sit under `extra`. Unknown, unsupported, and repeated query parameters return 400 before acquisition or billing.","security":[{"bearerAuth":[]}],"parameters":[{"name":"url","in":"query","required":true,"description":"A post, reel, video or photo URL on facebook.com.","example":"https://www.facebook.com/reel/2574821923003417","schema":{"type":"string"}},{"name":"cached","in":"query","required":false,"description":"`auto` (default) serves a read saved within the last 24 hours for these exact arguments, otherwise fetches. `cache_only` never contacts Facebook (404 `not_cached` when nothing is saved, whatever its age). `live` always fetches. Anything else is a `400`.","schema":{"type":"string","enum":["auto","cache_only","live"],"default":"auto"},"examples":{"default":{"value":"auto","x-disabled":true}}},{"name":"get_raw","in":"query","required":false,"description":"Not available on this operation: the upstream document is an HTML page, and `true` answers 400. The default `false` returns the normalized type.","schema":{"type":"boolean","default":false},"examples":{"default":{"value":false,"x-disabled":true}}}],"responses":{"200":{"description":"`Post` under `data`.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/Post"},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"id":"1703232194507537","shortcode":null,"taken_at":"2026-10-27T18:00:00Z","kind":"image","product_type":"post","caption":"Even a moment’s rest on Everest can come with a reminder of just how unpredictable the mountain can be.\n\nFrom Oscar®-winning filmmakers Elizabeth Chai Vasarhelyi and Jimmy Chin, EVEREST: THE OTHER SIDE, only in theaters and IMAX worldwide on October 30.","hashtags":[],"mentions":[],"accessibility_caption":null,"likes":86,"comments":1,"views":null,"counts_hidden":null,"comments_disabled":null,"is_pinned":null,"is_paid_partnership":null,"owner":null,"coauthors":[],"sponsors":[],"tagged":[],"location":null,"audio":null,"thumbnail_url":null,"video_duration":null,"media":[],"media_urls":[],"extra":{"group_id":null,"feedback_id":"ZmVlZGJhY2s6MTcwMzIzMjE5NDUwNzUzNw==","canonical_url":null,"title":null,"shares":null,"plays_raw":null}},"meta":{"source":"live","fetched_at":"2026-10-27T20:35:43.664910+00:00","cost":"$0.0005","balance":"$9.9995","request_id":"req_ce091767ee86ba9038d4bd60dc4443b0"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"404":{"description":"`cached=cache_only` found nothing saved for these arguments (`not_cached`; call again with `cached=auto` to fetch it), or the Facebook account or item does not exist (`not_found`). You are not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_cached","message":"no saved facebook/post read for 'https://www.facebook.com/reel/2574821923003417'. cached=cache_only never fetches, so call again with cached=auto to fetch it. You are not charged.","request_id":"req_5c10900e919bc7a3ff79b7501d582b4c"}}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/facebook/post_comments":{"get":{"tags":["Facebook"],"operationId":"facebookPostComments","summary":"post_comments","x-dashboard-cost":"$0.0005/10","x-example-query":{"post":"https://www.facebook.com/photo/?fbid=1688249899339100","max_pages":"1"},"description":"A post's top-level comments, 10 a page. Send a comment's `id` as `feedback_id`, with this post's URL as `url`, to `/v1/facebook/post_comment_replies` for its replies. With max_pages=1, returns `Page[Comment]` under `data`; with `get_raw=true` returns the upstream JSON.\n\nThe default request creates a durable job (202). Use max_pages=1 for one synchronous Page response (200). Poll status_url, then read results_url with its opaque cursor. Acquisition stops at the first of since, max_pages, or exhaustion. Jobs continue after disconnects. Result responses are bounded to 3 MiB; this does not limit the crawl. Supply Idempotency-Key to recover a lost submission response; reuse it with the same inputs. Facebook sets every page’s size, so there is no `page_size`.\n\nA field Facebook does not carry is null, a list it does not carry is `[]`, and Facebook-only facts sit under `extra`. Unknown, unsupported, and repeated query parameters return 400 before acquisition or billing.\n\nBilling: $0.0005 per 10 unique returned items (one native page), rounded up to a minimum of one billing unit; a `get_raw=true` page bills one unit. Jobs settle once after successful completion. Submission, polling and repeat downloads are free.","security":[{"bearerAuth":[]}],"parameters":[{"name":"post","in":"query","required":true,"description":"A post, reel, video or photo URL on facebook.com.","example":"https://www.facebook.com/photo/?fbid=1688249899339100","schema":{"type":"string"}},{"name":"since","in":"query","required":false,"description":"Stop at this date. `2025-09-21` means midnight UTC (2025-09-21T00:00:00Z). Datetimes must use RFC3339 with a timezone, for example `2025-09-21T09:00:00+09:00`. `365d` means 365 days before submission. Invalid calendar dates return 400. With max_pages, the first boundary reached stops the walk. since alone creates a job.","schema":{"type":"string"},"examples":{"default":{"value":"2025-09-21","x-disabled":true},"date":{"value":"2025-09-21","x-disabled":true},"datetime":{"value":"2025-09-21T00:00:00Z","x-disabled":true},"duration":{"value":"365d","x-disabled":true}}},{"name":"max_pages","in":"query","required":false,"example":1,"description":"Maximum pages to fetch. -1 walks until exhaustion or since with no page cap, and must be written. Omitted, since alone bounds the walk; with neither, the job stops after 10 pages. Any positive integer is accepted. 1 returns one page synchronously with HTTP 200; any other value creates a durable job with HTTP 202.","schema":{"type":"integer","anyOf":[{"enum":[-1]},{"minimum":1}]}},{"name":"cursor","in":"query","required":false,"description":"Opaque next_cursor from an earlier answer of this operation, also with `get_raw=true`. A native Facebook cursor from a raw page answers 400. Result download cursors belong to the results route.","schema":{"type":"string","minLength":1}},{"name":"cached","in":"query","required":false,"description":"`auto` (default) serves a read saved within the last 24 hours for these exact arguments, otherwise fetches. `cache_only` never contacts Facebook (404 `not_cached` when nothing is saved, whatever its age). `live` always fetches. Anything else is a `400`. `cache_only` reads one saved page per request: omit `max_pages` or pass 1, and continue with `next_cursor`.","schema":{"type":"string","enum":["auto","cache_only","live"],"default":"auto"},"examples":{"default":{"value":"auto","x-disabled":true}}},{"name":"get_raw","in":"query","required":false,"description":"`true` returns the upstream JSON exactly as Facebook answered it instead of the normalized `Page[Comment]`.","schema":{"type":"boolean","default":false},"examples":{"default":{"value":false,"x-disabled":true}}},{"name":"Idempotency-Key","in":"header","required":false,"description":"Reuse this key with the same inputs to recover a lost job submission. A different input with the same key returns 409.","schema":{"type":"string","minLength":1,"maxLength":200}}],"responses":{"200":{"description":"`Page[Comment]` under `data`; with `get_raw=true` the upstream JSON.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"anyOf":[{"type":"object","required":["items","pages","next_cursor","has_more","stop_reason","coverage"],"properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/Comment"},"description":"`Comment` of every page walked, in page order."},"pages":{"type":"array","items":{"$ref":"#/components/schemas/PageRead"},"description":"One entry per page walked."},"next_cursor":{"type":"string","nullable":true,"description":"Opaque; pass back as `cursor` to continue."},"has_more":{"type":"boolean","description":"True when `next_cursor` is set, and when the walk stopped `cursor_stalled` on a page that said more results exist but gave no cursor to send back."},"stop_reason":{"type":"string","enum":["pages","since","exhausted","cursor_stalled","repeated_content","deadline","blocked","caught_up"],"description":"Why the walk stopped. `pages`: the page budget is spent and `next_cursor` continues it. `deadline`: the call ran out of time before its next page; `next_cursor` continues it. `since`: a whole page was older than `since`. `exhausted`: Facebook reported the end. `cursor_stalled`: Facebook claimed more but repeated or omitted its cursor. `repeated_content`: a page held only items already seen. `blocked`: Facebook refused a later page; `next_cursor` is the page it refused. `caught_up`: only watch passes the crawler runs for itself stop this way."},"coverage":{"$ref":"#/components/schemas/Coverage"}}},{"type":"object","additionalProperties":true}],"description":"`Page[Comment]`, or the upstream JSON when `get_raw=true`."},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"items":[{"id":"1428109295963941","text":"Believe whatever you want, but consider this simplification... Would a man be tarred and feathered, ridiculed, and chased nearly his entire life, by people wanting to kill him (until they did), over a lie? I certainly would have backed out of the \"lie\" very early on in life, unless I feared God more than man. Losing everything over a lie, seems extreme.","created_at":"2026-10-12T16:32:41+00:00","likes":null,"replies":null,"liked_by_owner":null,"owner":{"id":"pfbid0dECjKZUoR8CmHPCnDLBonPfjSdDHVmg5tHd8rg48U7EaqoiXBq3CZkSithknQMT7l","username":null,"full_name":"Parker Lamoreaux","is_verified":null,"is_private":null,"avatar_url":null,"latest_story_at":null,"extra":{}},"extra":{"feedback_id":"ZmVlZGJhY2s6cGZiaWQwM2h0YkZrdjhkNW9uR1NaRjhGZlRmNDNONmE3U1A5YVF3cU5WTERlUXU3UTg3RFAyZFdKUVJIMng1bkVoZjJ4Uk42dWVjc2ZmYU5ubVhucGJZRmtVWWh0amlXWkF1b0ZVUzZRbA==","parent_comment_id":null,"expansion_token":"MjoxNzk1MTMxMDA1OgF_6CgICXHFue1mUjR7eVGeRHbUqKo29jQ8cfa1wc0gWXIXcX2UKcU1AAItSmUNel_6Pphqy3tVdvqZtqgY0XIZkFjj3LHAq-gEUz7HbNmgUGw7YKfjJnOIKvjUAVdrZpJfzug_D_thbX4035k4wqpvhWR78sK2lXltuCj_xn8E2gXIi-CbHarEx1oYz0hMgepSVakto7C0zaJFlqnW60fvryqShPWVdrYgKdZw552cVdDmzJyTTeC0vOjDYr7oQ5nAAIejO2QEIt_s2fPzZUZj4pUSPa8BdyWgMIrb0-YJrVJz42R18_WId2fKded7CL2Imm3hYK_ePr3jJJbrcZ60dpyIApo-UsvI9Lp4JYCIG7hFhNSMvLczIQE3llMStTtzefGrXwrsuyQVijnznRXwKj6wWiEjRIle_-USRNsPHLR4_0aaqdlfa0qw25ZiDUISxE2HsrJo7bFsvhSzl7nqJs6rkfx0Yk5nxr_ZUjTwf5Hl5qac7HrBaO43PU0URj71XY2EmuKQg0BfLtpDqPn5H01FHHO5Opqr7emigwZcNbJ22hvMvqTW9M1nAnoZnUou259hhxfTl7F3JWQFuLeLnP4BSlcqWVtaxdq-QDo1n-0gI19BOgNc"}},{"id":"4593165040946161","text":"If you read the Book of Mormon with real intent (meaning being open to changing your life an converting if it is true), and then pray about it, then the Holy Ghost will testify to you it is true. The proof is in the pudding","created_at":"2026-10-12T18:35:09+00:00","likes":null,"replies":null,"liked_by_owner":null,"owner":{"id":"1807722794","username":"MelissaRose723","full_name":"Melissa Rose Palmer","is_verified":null,"is_private":null,"avatar_url":null,"latest_story_at":null,"extra":{}},"extra":{"feedback_id":"ZmVlZGJhY2s6cGZiaWQwMmRNd2s4MnQ4Qks5M0xvY2Y4VHBrOWZZRUo4NlAydGptZFpQZ01tbzlhQ2FhUFdvOGRkRmtwMnRCVVdVVFNTQXdjV0t2b2MxVEZnbU5vNkVGNmFqOWM0am1NZWtVbm5tY3NSbA==","parent_comment_id":null,"expansion_token":"MjoxNzk1MTMxMDA1OgF_86Si2pl-cF3cL25gvjYNqVNKzZwQED9RKWKz3BNFoIMkVx3KuIHrVcKQTd6Z5Ifw2W-YskZIijJmJTVPSpWJ1XJirAYcK9IZD1-xuHUhyrr17gGixfl9fX0doRm4cEkqZabFvCoeqms1SiPndIF-w4vU8bmyod-1K4Z3YG94KKNMXPJgIQNpuzr_yq6Y5AK5na1ZotWsdyPQkt_75RtcoDEcyfVLGgmedaSW8hvro0oToLkyZcqw2ZnyvTyV7rwrggWLC687mydiPu0oU3pqSpsc-LNJHL7JScPrvotcjLuzUDcxvBdUZEzee1KDRiEt62iCmAspzLtJOdbA16A-akqGpND_9e8d3vOXetLuJxYIdQsTe3FTF_SFcTOp4dXjDxMSdqcDxs6HHjIy2u7fotUZMZjhK1ZSCojErNJMSqJTHKVxvZKIfdF0hHmNbceYM9kmSyLvzQrcvwz-UAQ85ovEC81b7Of-Nt19livLmBZwzoFl4ZYZ8HtX-EaxKNQNa0CtKGfrVl0DyXgDUtP6vGQVK15GA4gSft5DR2AZrW27hPcUPumaCCgnxOrfk0I6N_I12bmXRIoviJr-B8OQ6UBo7Qx62CkrZZRg4G5SyTvNx18JVwZm"}}],"pages":[{"cursor":null,"fetched_at":"2026-11-19T23:30:05.688236+00:00","count":2,"signed_in":false}],"next_cursor":"eyJhZnRlciI6Ik1Ub3hOemsxTVRNeE1EQTFPZ0ZfdVBsQ2laUE9MN0ZaYWJ2a3dfQi1PZENHVHZJTUJVQ0I0MnV3MTJhbno4SXJNU24xUjBUWTlKOUZRQzVNdFl2NUN6a1VlZFNMdGxBNGZBUGZWMVBoS1JaVThrSzlZVWg3eEtLZi05WW51VVpFSnh0YWdQN1FyeE5ES1I1eHQxYndlRW8zaEMtbWR2WVRzNEs2U0QyLUdGa0Nya1hVb2VxaVh1WjBwMWpnb0ZEWVNmbzRVQ1MwVW16RGtQN3lWdW1tMEZVQXVvRkJsSS1MemFYT2VhdjRuQmlUME1sQU9vZ0xXdmo2NmlPYVNtS3NmaEZzR3VtVzBWTWhoV3FUQnJSRVNFQVBkcTZfaFE5ek1kUlI0anVCSHR3Tms5QlNtcHZTN3o5UjhoY0lfQ0puaFRfekZTQmtaNkNfNVc0dVk1cHVwWFJiOUM5VkR1X01qOFJsbks4emJrYlNkVjBWODFjc2p4WkxnWGRnZDdkZTYxQjZNSHRGZmJvQXVNS0sxdHJoNWVJNnVscVVnOUF0WmRPOHJYNTVXZmhadVM1Q0k1STNDQnlKZjdUanZoSE1adF9nOGhGa09BIiwib3AiOiJwb3N0X2NvbW1lbnRzIn0","has_more":true,"stop_reason":"pages","coverage":{"since":null,"oldest_at":null,"since_reached":false}},"meta":{"source":"live","fetched_at":"2026-11-19T23:30:05.688236+00:00","cost":"$0.0005","balance":"$9.9995","request_id":"req_ce091767ee86ba9038d4bd60dc4443b0"}}}}},"202":{"description":"Durable job accepted. No completed-result charge. Save batch_id; poll status_url. Retry submission with the same Idempotency-Key after a lost response. An account may have five queued, running or payment-required jobs. A sixth new job returns 429 rate_limited. Matching idempotent replays still work at the limit. Ready and failed jobs release their slots; pages within a job remain unbounded. This is a synthetic contract example, not a live capture.","x-example-provenance":"synthetic-contract","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","required":["batch_id","status","status_url","results_url","cost","item_count","error","retry_at","total","done_count","failed_count","created_at","started_at","finished_at"],"properties":{"batch_id":{"type":"string"},"status":{"type":"string","enum":["queued","running","payment_required","ready","failed"]},"status_url":{"type":"string"},"results_url":{"type":"string"},"cost":{"type":"string"},"item_count":{"type":"integer","nullable":true},"error":{"type":"string","nullable":true,"description":"Null unless failed. A failed target carries its own code; incomplete_result appears only when it has none and pages of the result are missing. profile_not_found, post_not_found, upstream_not_found or not_found: the target does not exist or is not visible. not_visible: The account exists, but its posts are not visible to logged-out readers (private, restricted, or hidden by Instagram). Retrying will not change the result until the account changes. not_cached: cached=cache_only found no saved read. incomplete_result: pages of the result are missing. temporarily_unavailable: the target could not be read for now (no capacity, a pause or repeated refusals); retry later with a new job. result_item_too_large: one result unit exceeds the delivery budget. result_snapshot_missing or result_snapshot_corrupt: the crawler could not serve the retained result of a paid job, and its charge is refunded; if the crawler serves it again, a later results read returns it and charges the job again. crawler_submit_400, crawler_submit_404 or crawler_submit_422: the crawl service refused the job request. crawler_job_failed: any other failure; the same job is not expected to succeed if resubmitted. cancelled: the job was cancelled with POST /v1/jobs/{job_id}/cancel. No failed job costs anything: only result_snapshot_missing and result_snapshot_corrupt follow a charge, and that charge is refunded."},"retry_at":{"type":"string","format":"date-time","nullable":true,"description":"Null unless the job failed temporarily_unavailable because a crawl route was closed for every caller. Then it is when the route opens again, and the response carries the same time as a Retry-After header in seconds. Submit a new job after it."},"total":{"type":"integer","description":"Targets in the job. A job submitted through a /v1 route has one."},"done_count":{"type":"integer","description":"Targets the crawler finished."},"failed_count":{"type":"integer","description":"Targets that failed."},"created_at":{"type":"string","format":"date-time","description":"When the job was submitted."},"started_at":{"type":"string","format":"date-time","nullable":true,"description":"When the crawler started the job. Null until it starts."},"finished_at":{"type":"string","format":"date-time","nullable":true,"description":"When the job finished or failed. Null while it is queued or running."}}},"meta":{"type":"object","required":["cost","request_id"],"properties":{"cost":{"type":"string","example":"$0.0000"},"request_id":{"type":"string"}}}}},"example":{"data":{"batch_id":"job_7641d5f0-717d-4b70-a2f1-f58d846d7242","status":"queued","status_url":"/v1/jobs/job_7641d5f0-717d-4b70-a2f1-f58d846d7242","results_url":"/v1/jobs/job_7641d5f0-717d-4b70-a2f1-f58d846d7242/results","cost":"$0.0000","item_count":null,"error":null,"retry_at":null,"total":1,"done_count":0,"failed_count":0,"created_at":"2026-10-12T12:56:17.403Z","started_at":null,"finished_at":null},"meta":{"cost":"$0.0000","request_id":"req_job_example"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"404":{"description":"`cached=cache_only` found nothing saved for these arguments (`not_cached`; call again with `cached=auto` to fetch it), or the Facebook account or item does not exist (`not_found`). You are not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_cached","message":"no saved facebook/post_comments read for 'https://www.facebook.com/photo/?fbid=1688249899339100'. cached=cache_only never fetches, so call again with cached=auto to fetch it. You are not charged.","request_id":"req_5c10900e919bc7a3ff79b7501d582b4c"}}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/facebook/post_comment_replies":{"get":{"tags":["Facebook"],"operationId":"facebookPostCommentReplies","summary":"post_comment_replies","x-dashboard-cost":"$0.0005/10","x-example-query":{"feedback_id":"1428109295963941","url":"https://www.facebook.com/photo/?fbid=1688249899339100","max_pages":"1"},"description":"The replies to one comment, 10 a page, read on the page of the post the comment is on. A call by the comment’s numeric id costs the crawler one more request, which reads its current feedback id and token. A comment with no replies answers an empty page. With max_pages=1, returns `Page[Comment]` under `data`; with `get_raw=true` returns the upstream JSON.\n\nThe default request creates a durable job (202). Use max_pages=1 for one synchronous Page response (200). Poll status_url, then read results_url with its opaque cursor. Acquisition stops at the first of since, max_pages, or exhaustion. Jobs continue after disconnects. Result responses are bounded to 3 MiB; this does not limit the crawl. Supply Idempotency-Key to recover a lost submission response; reuse it with the same inputs. Facebook sets every page’s size, so there is no `page_size`.\n\nA field Facebook does not carry is null, a list it does not carry is `[]`, and Facebook-only facts sit under `extra`. Unknown, unsupported, and repeated query parameters return 400 before acquisition or billing.\n\nBilling: $0.0005 per 10 unique returned items (one native page), rounded up to a minimum of one billing unit; a `get_raw=true` page bills one unit. Jobs settle once after successful completion. Submission, polling and repeat downloads are free.","security":[{"bearerAuth":[]}],"parameters":[{"name":"feedback_id","in":"query","required":true,"description":"A comment’s numeric `id` from `/v1/facebook/post_comments`, or its `extra.feedback_id` with `expansion_token`.","example":"1428109295963941","schema":{"type":"string"}},{"name":"expansion_token","in":"query","required":false,"description":"Only with an `extra.feedback_id` as `feedback_id`: the same comment’s `extra.expansion_token` from `/v1/facebook/post_comments`. Facebook refuses a token older than 7 days, which answers 400. A numeric comment id needs no token, because the crawler reads a fresh one.","schema":{"type":"string","maxLength":8192},"examples":{"default":{"value":"MjoxNzk1MTMxMDA1OgF_6CgICXHFue1mUjR7eVGeRHbUqKo29jQ8cfa1wc0gWXIXcX2UKcU1AAItSmUNel_6Pphqy3tVdvqZtqgY0XIZkFjj3LHAq-gEUz7HbNmgUGw7YKfjJnOIKvjUAVdrZpJfzug_D_thbX4035k4wqpvhWR78sK2lXltuCj_xn8E2gXIi-CbHarEx1oYz0hMgepSVakto7C0zaJFlqnW60fvryqShPWVdrYgKdZw552cVdDmzJyTTeC0vOjDYr7oQ5nAAIejO2QEIt_s2fPzZUZj4pUSPa8BdyWgMIrb0-YJrVJz42R18_WId2fKded7CL2Imm3hYK_ePr3jJJbrcZ60dpyIApo-UsvI9Lp4JYCIG7hFhNSMvLczIQE3llMStTtzefGrXwrsuyQVijnznRXwKj6wWiEjRIle_-USRNsPHLR4_0aaqdlfa0qw25ZiDUISxE2HsrJo7bFsvhSzl7nqJs6rkfx0Yk5nxr_ZUjTwf5Hl5qac7HrBaO43PU0URj71XY2EmuKQg0BfLtpDqPn5H01FHHO5Opqr7emigwZcNbJ22hvMvqTW9M1nAnoZnUou259hhxfTl7F3JWQFuLeLnP4BSlcqWVtaxdq-QDo1n-0gI19BOgNc","x-disabled":true}}},{"name":"url","in":"query","required":true,"description":"The URL of the post the comment is on, the same `post` you sent to `/v1/facebook/post_comments`. Required.","example":"https://www.facebook.com/photo/?fbid=1688249899339100","schema":{"type":"string","format":"uri"}},{"name":"since","in":"query","required":false,"description":"Stop at this date. `2025-09-21` means midnight UTC (2025-09-21T00:00:00Z). Datetimes must use RFC3339 with a timezone, for example `2025-09-21T09:00:00+09:00`. `365d` means 365 days before submission. Invalid calendar dates return 400. With max_pages, the first boundary reached stops the walk. since alone creates a job.","schema":{"type":"string"},"examples":{"default":{"value":"2025-09-21","x-disabled":true},"date":{"value":"2025-09-21","x-disabled":true},"datetime":{"value":"2025-09-21T00:00:00Z","x-disabled":true},"duration":{"value":"365d","x-disabled":true}}},{"name":"max_pages","in":"query","required":false,"example":1,"description":"Maximum pages to fetch. -1 walks until exhaustion or since with no page cap, and must be written. Omitted, since alone bounds the walk; with neither, the job stops after 10 pages. Any positive integer is accepted. 1 returns one page synchronously with HTTP 200; any other value creates a durable job with HTTP 202.","schema":{"type":"integer","anyOf":[{"enum":[-1]},{"minimum":1}]}},{"name":"cursor","in":"query","required":false,"description":"Opaque next_cursor from an earlier answer of this operation, also with `get_raw=true`. A native Facebook cursor from a raw page answers 400. Result download cursors belong to the results route.","schema":{"type":"string","minLength":1}},{"name":"cached","in":"query","required":false,"description":"`auto` (default) serves a read saved within the last 24 hours for these exact arguments, otherwise fetches. `cache_only` never contacts Facebook (404 `not_cached` when nothing is saved, whatever its age). `live` always fetches. Anything else is a `400`. `cache_only` reads one saved page per request: omit `max_pages` or pass 1, and continue with `next_cursor`.","schema":{"type":"string","enum":["auto","cache_only","live"],"default":"auto"},"examples":{"default":{"value":"auto","x-disabled":true}}},{"name":"get_raw","in":"query","required":false,"description":"`true` returns the upstream JSON exactly as Facebook answered it instead of the normalized `Page[Comment]`.","schema":{"type":"boolean","default":false},"examples":{"default":{"value":false,"x-disabled":true}}},{"name":"Idempotency-Key","in":"header","required":false,"description":"Reuse this key with the same inputs to recover a lost job submission. A different input with the same key returns 409.","schema":{"type":"string","minLength":1,"maxLength":200}}],"responses":{"200":{"description":"`Page[Comment]` under `data`; with `get_raw=true` the upstream JSON.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"anyOf":[{"type":"object","required":["items","pages","next_cursor","has_more","stop_reason","coverage"],"properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/Comment"},"description":"`Comment` of every page walked, in page order."},"pages":{"type":"array","items":{"$ref":"#/components/schemas/PageRead"},"description":"One entry per page walked."},"next_cursor":{"type":"string","nullable":true,"description":"Opaque; pass back as `cursor` to continue."},"has_more":{"type":"boolean","description":"True when `next_cursor` is set, and when the walk stopped `cursor_stalled` on a page that said more results exist but gave no cursor to send back."},"stop_reason":{"type":"string","enum":["pages","since","exhausted","cursor_stalled","repeated_content","deadline","blocked","caught_up"],"description":"Why the walk stopped. `pages`: the page budget is spent and `next_cursor` continues it. `deadline`: the call ran out of time before its next page; `next_cursor` continues it. `since`: a whole page was older than `since`. `exhausted`: Facebook reported the end. `cursor_stalled`: Facebook claimed more but repeated or omitted its cursor. `repeated_content`: a page held only items already seen. `blocked`: Facebook refused a later page; `next_cursor` is the page it refused. `caught_up`: only watch passes the crawler runs for itself stop this way."},"coverage":{"$ref":"#/components/schemas/Coverage"}}},{"type":"object","additionalProperties":true}],"description":"`Page[Comment]`, or the upstream JSON when `get_raw=true`."},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"items":[{"id":"1449114220650169","text":"Parker Lamoreaux true of every religion","created_at":"2026-10-12T16:42:45+00:00","likes":null,"replies":null,"liked_by_owner":null,"owner":{"id":"pfbid02U66WHMTVqbk1LhkqhBKKLrFdEidLp4FMmb26vhGBCeMGkHLKxqPBhshGuzpSquPxl","username":"scott.nelson.714049","full_name":"Scott Nelson","is_verified":null,"is_private":null,"avatar_url":null,"latest_story_at":null,"extra":{}},"extra":{"feedback_id":"ZmVlZGJhY2s6cGZiaWQwMms4S2szSEJWeHlObTlCM1dLWjRLMktRWmpON3VSMUFjM1VNVkpSWTV5a2Z6aktqbTJpc3NDdWdFZ3kySmpXZnRTRUpldTZWSEc4UG0zd0NIRmQ5V3g3Zm5qb1pwSEtwUDJRbA==","parent_comment_id":"ZmVlZGJhY2s6cGZiaWQwM2h0YkZrdjhkNW9uR1NaRjhGZlRmNDNONmE3U1A5YVF3cU5WTERlUXU3UTg3RFAyZFdKUVJIMng1bkVoZjJ4Uk42dWVjc2ZmYU5ubVhucGJZRmtVWWh0amlXWkF1b0ZVUzZRbA==","expansion_token":"MjoxNzk1MTMxMDA2OgF_i4GW0ITUrX5ps8DRF06ZUf2etWL-SFO0KFTCFu3oeDVUaxdMf85zAORUoQj5wk_xTv9udTwjJoPI7nmCGu1LTH5b2EdOvFgmNsk4h8LEvjw5vUQEahwjHDhGBKHfjpyiwPo4fZEg818vsvqSO0VLFmDwJL4nipArYCPlcuEElrnviaSsTTrbK4OmbrrRTADTssX7onLjUpbHCNAoWuaFj-Wlsba8z0xlMtkNEqOIv3DWg78W9pYa1S9glggezqK1eJFPDerrKE4Wx_OT_lJhvDrbZUtsWZeO2EqvdFuwrW0lFP83bgL9udT_xTV-oa_H2YGQ0c_39iFNRc2FqyvCzKOYDagBS2-Sm8hz2O8Qi8D5215hkHWVOvvc8_1-AzUd-U7mnQK7PchspZXKO3PBvKLHwImviiWr9lZ-bW3IQp6DX6Oq_H8E_tRE02taZiokeA7a0qpmEoQEy1D9dlShgbi3msZ5eGXw9XbvcbLHdD9yrHN4BDbZCmsjzd9GH9Eq0U5eHW-lhv9Z1EdJZ9Zj_ILo2ivl_Hb5Yd9QIRrGbrhBTFcMQvBuI-G1Bf7Kwomjj7MEOdei8tbZbX74ZCapMdpUhlQOvIRWxP5qAOa5dMNUP_TOIeQk"}},{"id":"2034312820609931","text":"Parker Lamoreaux very well said","created_at":"2026-10-12T16:45:05+00:00","likes":null,"replies":null,"liked_by_owner":null,"owner":{"id":"pfbid02eENXisMHXFQUaBd1NraCG5YmTXCAasBGoxkL2bmoAwMLgTTpBpEokdvAAFgG19El","username":"people","full_name":"Kevin Scruggs","is_verified":null,"is_private":null,"avatar_url":null,"latest_story_at":null,"extra":{}},"extra":{"feedback_id":"ZmVlZGJhY2s6cGZiaWQwdVJXN0ZINldpMXBHWEdvYlNNYXllYThaTjF5ZHR1TDhMMWlibzdzUnNxaHdEc3E3ODJZdVFlZEpMaUs1ZWlCNGNNQXZKQWFUVHMybmFORHVrZFU2NWRGVWdnWXBLS1l2VG9s","parent_comment_id":"ZmVlZGJhY2s6cGZiaWQwM2h0YkZrdjhkNW9uR1NaRjhGZlRmNDNONmE3U1A5YVF3cU5WTERlUXU3UTg3RFAyZFdKUVJIMng1bkVoZjJ4Uk42dWVjc2ZmYU5ubVhucGJZRmtVWWh0amlXWkF1b0ZVUzZRbA==","expansion_token":"MjoxNzk1MTMxMDA2OgF_OJmjlkw3A8mmiMcsLUMun2DbdTWF7FBPhlSRsHonckQRB3f4VoUFHX5o_iHyS7DQmN7NSM7KP_OExljQIpFspNfqQoNcP6AcTgFQDCsMh5jRjSImhVYymCxb4q1KFXy_oelbM2IwXViAAL-3Y6wwqp8VkydBOGhaYPj3UJCtc2Fo2NuEntgbdBYAkL6bvLIFEAH1YmcXTN-JWQCGsBUuL628kBYnfdMKB3RYve4n3o3O8eS4IObBQKifHI9sULUpMseSHbF97iZEphfDT3MWeiiApz2Kj18GvzTJKSdt6koalXc3e9sJNPFutlE5-yjLOXEhNc0-f8s9k7t0aGwbk3hOr49nqFFk-zxtQzFrYmpUekd1oT_xL0Oavd1whretsAXG4DgXwNqlrDF67I_kTzBcIIn1Z9X8cPrCmV8E-SJGr30rJ9uRrnIY6rqF637SBqsOlYI9uBx6y6Btr2niMrHh0mJR6ljC0r_a2ToZyT1UIjSffTBAUvDe-np9YFGR-PLunQ7IC0O286B7bLUHX01MgMBJoAxQhWBD_0HOFgOwL0D-coI8M_W6E82GuaghE4UFRVTNuSYqH57k6u_3K-5JKDZ9KZFXXR-7ocIHxSEOWs8Y6CBE"}}],"pages":[{"cursor":null,"fetched_at":"2026-11-19T23:30:07.004037+00:00","count":2,"signed_in":false}],"next_cursor":"eyJhZnRlciI6Ik1Ub3hOemsxTVRNeE1EQTJPZ0ZfOWlVV3V5SEw4WWVhLS12Qm11bTZOWktGb00yaXZPWmtMOFFIT1pmUmJycklHOXVDSVU2M1dJOVp2eFVldGJ2WDVZaVFvX2NucG9lUEJiZDYwWHFZUkF1bllxd2RIMWdoTWl6bVhQRzg3Z3ZRMU5ZanloeW9kVTdPZWpuV19HelVKb1ltMDR3RHRoZ1lhZU1LUXZqX1lsRmtodkZ5WnRnelNOeG5CMk5RZEpYQzNsQmpGWmk3X29wQ3JXa2NsYVNKdy00WV9QQnJJTEZBbGtzWmQ0Nkt4dUs1WXhVMlRWNzlvQU5DbDNlQWdqalhGRHBTbGU0a3phVXRiX2hsSXdJOUdsUzY4UDNKNU9YUkRXN1ZOeVJ0OUdxVkJCcHdFLTF3N3Z2cmMyb2M2c0xvblA0d1pNXzA2dzhUakMyOUQtU2JNUGlwUWZWTGFqU3ZISk42TzFmUXpWd0FXalBVOHdBZWRLWTJsTUFOLVd2SkhjTkI4NXNmSEk4eVVrZ1hhdnBuQlZqRlM0emxhQ1FtVVd3VFdtZ3VmaF93TEtJeUhqY01oazQtNlBjNWJ6X0dvUUhIeDF4Nm9RIiwib3AiOiJwb3N0X2NvbW1lbnRfcmVwbGllcyJ9","has_more":true,"stop_reason":"pages","coverage":{"since":null,"oldest_at":null,"since_reached":false}},"meta":{"source":"live","fetched_at":"2026-11-19T23:30:07.004037+00:00","cost":"$0.0005","balance":"$9.9995","request_id":"req_6055af0b3f439996f3ac4aaaaed12358"}}}}},"202":{"description":"Durable job accepted. No completed-result charge. Save batch_id; poll status_url. Retry submission with the same Idempotency-Key after a lost response. An account may have five queued, running or payment-required jobs. A sixth new job returns 429 rate_limited. Matching idempotent replays still work at the limit. Ready and failed jobs release their slots; pages within a job remain unbounded. This is a synthetic contract example, not a live capture.","x-example-provenance":"synthetic-contract","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","required":["batch_id","status","status_url","results_url","cost","item_count","error","retry_at","total","done_count","failed_count","created_at","started_at","finished_at"],"properties":{"batch_id":{"type":"string"},"status":{"type":"string","enum":["queued","running","payment_required","ready","failed"]},"status_url":{"type":"string"},"results_url":{"type":"string"},"cost":{"type":"string"},"item_count":{"type":"integer","nullable":true},"error":{"type":"string","nullable":true,"description":"Null unless failed. A failed target carries its own code; incomplete_result appears only when it has none and pages of the result are missing. profile_not_found, post_not_found, upstream_not_found or not_found: the target does not exist or is not visible. not_visible: The account exists, but its posts are not visible to logged-out readers (private, restricted, or hidden by Instagram). Retrying will not change the result until the account changes. not_cached: cached=cache_only found no saved read. incomplete_result: pages of the result are missing. temporarily_unavailable: the target could not be read for now (no capacity, a pause or repeated refusals); retry later with a new job. result_item_too_large: one result unit exceeds the delivery budget. result_snapshot_missing or result_snapshot_corrupt: the crawler could not serve the retained result of a paid job, and its charge is refunded; if the crawler serves it again, a later results read returns it and charges the job again. crawler_submit_400, crawler_submit_404 or crawler_submit_422: the crawl service refused the job request. crawler_job_failed: any other failure; the same job is not expected to succeed if resubmitted. cancelled: the job was cancelled with POST /v1/jobs/{job_id}/cancel. No failed job costs anything: only result_snapshot_missing and result_snapshot_corrupt follow a charge, and that charge is refunded."},"retry_at":{"type":"string","format":"date-time","nullable":true,"description":"Null unless the job failed temporarily_unavailable because a crawl route was closed for every caller. Then it is when the route opens again, and the response carries the same time as a Retry-After header in seconds. Submit a new job after it."},"total":{"type":"integer","description":"Targets in the job. A job submitted through a /v1 route has one."},"done_count":{"type":"integer","description":"Targets the crawler finished."},"failed_count":{"type":"integer","description":"Targets that failed."},"created_at":{"type":"string","format":"date-time","description":"When the job was submitted."},"started_at":{"type":"string","format":"date-time","nullable":true,"description":"When the crawler started the job. Null until it starts."},"finished_at":{"type":"string","format":"date-time","nullable":true,"description":"When the job finished or failed. Null while it is queued or running."}}},"meta":{"type":"object","required":["cost","request_id"],"properties":{"cost":{"type":"string","example":"$0.0000"},"request_id":{"type":"string"}}}}},"example":{"data":{"batch_id":"job_7641d5f0-717d-4b70-a2f1-f58d846d7242","status":"queued","status_url":"/v1/jobs/job_7641d5f0-717d-4b70-a2f1-f58d846d7242","results_url":"/v1/jobs/job_7641d5f0-717d-4b70-a2f1-f58d846d7242/results","cost":"$0.0000","item_count":null,"error":null,"retry_at":null,"total":1,"done_count":0,"failed_count":0,"created_at":"2026-10-12T12:56:17.403Z","started_at":null,"finished_at":null},"meta":{"cost":"$0.0000","request_id":"req_job_example"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"404":{"description":"`cached=cache_only` found nothing saved for these arguments (`not_cached`; call again with `cached=auto` to fetch it), or the Facebook account or item does not exist (`not_found`). You are not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_cached","message":"no saved facebook/post_comment_replies read for '1428109295963941'. cached=cache_only never fetches, so call again with cached=auto to fetch it. You are not charged.","request_id":"req_5c10900e919bc7a3ff79b7501d582b4c"}}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/facebook/post_transcript":{"get":{"tags":["Facebook"],"operationId":"facebookPostTranscript","summary":"post_transcript","x-dashboard-cost":"$0.0005","x-example-query":{"url":"https://www.facebook.com/reel/1729248401649246"},"description":"A video's own caption track as Facebook serves it to a logged-out viewer. This reads captions Facebook already has; it does not transcribe. A video with no track answers 404 and is not billed. Returns `FacebookTranscript` under `data`; the upstream document is an HTML page, so `get_raw` is not available.\n\nA field Facebook does not carry is null, a list it does not carry is `[]`, and Facebook-only facts sit under `extra`. Unknown, unsupported, and repeated query parameters return 400 before acquisition or billing.","security":[{"bearerAuth":[]}],"parameters":[{"name":"url","in":"query","required":true,"description":"A post, reel, video or photo URL on facebook.com.","example":"https://www.facebook.com/reel/1729248401649246","schema":{"type":"string"}},{"name":"cached","in":"query","required":false,"description":"`auto` (default) serves a read saved within the last 24 hours for these exact arguments, otherwise fetches. `cache_only` never contacts Facebook (404 `not_cached` when nothing is saved, whatever its age). `live` always fetches. Anything else is a `400`.","schema":{"type":"string","enum":["auto","cache_only","live"],"default":"auto"},"examples":{"default":{"value":"auto","x-disabled":true}}},{"name":"get_raw","in":"query","required":false,"description":"Not available on this operation: the upstream document is an HTML page, and `true` answers 400. The default `false` returns the normalized type.","schema":{"type":"boolean","default":false},"examples":{"default":{"value":false,"x-disabled":true}}}],"responses":{"200":{"description":"`FacebookTranscript` under `data`.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/FacebookTranscript"},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"post_id":"1584673476360917","language":"en_US","text":"Eight soldiers shoot 10000 bullets at your Lamborghini. That's the scariest thing I've ever seen. Yeah, it's going to be fun. And you have exactly twenty-four hours to build whatever you want to protect your Lamborghini…","segments":[{"index":1,"start_ms":0,"end_ms":3761,"text":"Eight soldiers shoot 10000 bullets at your Lamborghini."}],"segments_complete":true,"source_url":"https://scontent.fplm4-1.fna.fbcdn.net/v/t39.2093-6/734733481_1552000396634805_7004551905271078638_n.srt?_nc_cat=110&_nc_map=urlgen_bucketless&ccb=1-7&_nc_sid=c211c2&_nc_ohc=HJT3EN…"},"meta":{"source":"live","fetched_at":"2026-10-28T01:50:32.474809+00:00","cost":"$0.0005","balance":"$9.9995","request_id":"req_b668e9f471caa1d2f2f436a077526025"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"404":{"description":"`cached=cache_only` found nothing saved for these arguments (`not_cached`; call again with `cached=auto` to fetch it), or the Facebook account or item does not exist (`not_found`). You are not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_cached","message":"no saved facebook/post_transcript read for 'https://www.facebook.com/reel/1729248401649246'. cached=cache_only never fetches, so call again with cached=auto to fetch it. You are not charged.","request_id":"req_5c10900e919bc7a3ff79b7501d582b4c"}}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/facebook/event_details":{"get":{"tags":["Facebook"],"operationId":"facebookEventDetails","summary":"event_details","x-dashboard-cost":"$0.0005","x-example-query":{"event":"298448234317243"},"description":"One event by id or URL. Facebook answers an unknown event id with a generic page that reads as a block, so take ids from `/v1/facebook/profile_events` or `/v1/facebook/events_search`. Returns `FacebookEvent` under `data`; the upstream document is an HTML page, so `get_raw` is not available.\n\nA field Facebook does not carry is null, a list it does not carry is `[]`, and Facebook-only facts sit under `extra`. Unknown, unsupported, and repeated query parameters return 400 before acquisition or billing.","security":[{"bearerAuth":[]}],"parameters":[{"name":"event","in":"query","required":true,"description":"An event’s numeric id or https://www.facebook.com/events/<id> URL.","example":"298448234317243","schema":{"type":"string"}},{"name":"cached","in":"query","required":false,"description":"`auto` (default) serves a read saved within the last 24 hours for these exact arguments, otherwise fetches. `cache_only` never contacts Facebook (404 `not_cached` when nothing is saved, whatever its age). `live` always fetches. Anything else is a `400`.","schema":{"type":"string","enum":["auto","cache_only","live"],"default":"auto"},"examples":{"default":{"value":"auto","x-disabled":true}}},{"name":"get_raw","in":"query","required":false,"description":"Not available on this operation: the upstream document is an HTML page, and `true` answers 400. The default `false` returns the normalized type.","schema":{"type":"boolean","default":false},"examples":{"default":{"value":false,"x-disabled":true}}}],"responses":{"200":{"description":"`FacebookEvent` under `data`.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/FacebookEvent"},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"id":"298448234317243","name":"Shoot The Style. VOGUE X NIKE","description":null,"url":"https://www.facebook.com/events/298448234317243/","starts_at":"2018-09-21T14:00:00+00:00","ends_at":null,"timezone":null,"location_name":"Carrer de l'Atlàntida, 78, 08003 Barcelona (Barcelona), Espanya","address":null,"lat":null,"lng":null,"host":null,"going":null,"interested":null,"is_online":false},"meta":{"source":"live","fetched_at":"2026-10-27T20:35:49.505600+00:00","cost":"$0.0005","balance":"$9.9995","request_id":"req_ce091767ee86ba9038d4bd60dc4443b0"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"404":{"description":"`cached=cache_only` found nothing saved for these arguments (`not_cached`; call again with `cached=auto` to fetch it), or the Facebook account or item does not exist (`not_found`). You are not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_cached","message":"no saved facebook/event_details read for '298448234317243'. cached=cache_only never fetches, so call again with cached=auto to fetch it. You are not charged.","request_id":"req_5c10900e919bc7a3ff79b7501d582b4c"}}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/facebook/events_search":{"get":{"tags":["Facebook"],"operationId":"facebookEventsSearch","summary":"events_search","x-dashboard-cost":"$0.0005/8","x-example-query":{"query":"NASA","max_pages":"1"},"description":"Facebook's public event search for a query. While the residential proxy pool is out, the search answers one page of about 8 events: a search with more results answers `next_cursor: null` and `stop_reason: \"cursor_stalled\"`, and a call that sends a `cursor` answers 400. Facebook answers some queries with a normal-looking empty page, so a first page with no events carries `meta.possibly_shadow_empty: true` and may be false. With max_pages=1, returns `Page[FacebookEvent]` under `data`; with `get_raw=true` returns the upstream JSON.\n\nThe default request creates a durable job (202). Use max_pages=1 for one synchronous Page response (200). Poll status_url, then read results_url with its opaque cursor. Acquisition stops at the first of since, max_pages, or exhaustion. Jobs continue after disconnects. Result responses are bounded to 3 MiB; this does not limit the crawl. Supply Idempotency-Key to recover a lost submission response; reuse it with the same inputs. Facebook sets every page’s size, so there is no `page_size`.\n\nA field Facebook does not carry is null, a list it does not carry is `[]`, and Facebook-only facts sit under `extra`. Unknown, unsupported, and repeated query parameters return 400 before acquisition or billing.\n\nBilling: $0.0005 per 8 unique returned items (one native page), rounded up to a minimum of one billing unit; a `get_raw=true` page bills one unit. Jobs settle once after successful completion. Submission, polling and repeat downloads are free.","security":[{"bearerAuth":[]}],"parameters":[{"name":"query","in":"query","required":true,"description":"The search text, 1 to 500 characters.","example":"NASA","schema":{"type":"string"}},{"name":"since","in":"query","required":false,"description":"Not accepted on this operation: its items carry no timestamp, so since returns 400 before billing.","schema":{"type":"string"}},{"name":"max_pages","in":"query","required":false,"example":1,"description":"Maximum pages to fetch. -1 walks until exhaustion or since with no page cap, and must be written. Omitted, since alone bounds the walk; with neither, the job stops after 10 pages. Any positive integer is accepted. 1 returns one page synchronously with HTTP 200; any other value creates a durable job with HTTP 202.","schema":{"type":"integer","anyOf":[{"enum":[-1]},{"minimum":1}]}},{"name":"cursor","in":"query","required":false,"description":"Opaque next_cursor from an earlier answer of this operation, also with `get_raw=true`. A native Facebook cursor from a raw page answers 400. Result download cursors belong to the results route.","schema":{"type":"string","minLength":1}},{"name":"cached","in":"query","required":false,"description":"`auto` (default) serves a read saved within the last 24 hours for these exact arguments, otherwise fetches. `cache_only` never contacts Facebook (404 `not_cached` when nothing is saved, whatever its age). `live` always fetches. Anything else is a `400`. `cache_only` reads one saved page per request: omit `max_pages` or pass 1, and continue with `next_cursor`.","schema":{"type":"string","enum":["auto","cache_only","live"],"default":"auto"},"examples":{"default":{"value":"auto","x-disabled":true}}},{"name":"get_raw","in":"query","required":false,"description":"`true` returns the upstream JSON exactly as Facebook answered it instead of the normalized `Page[FacebookEvent]`.","schema":{"type":"boolean","default":false},"examples":{"default":{"value":false,"x-disabled":true}}},{"name":"Idempotency-Key","in":"header","required":false,"description":"Reuse this key with the same inputs to recover a lost job submission. A different input with the same key returns 409.","schema":{"type":"string","minLength":1,"maxLength":200}}],"responses":{"200":{"description":"`Page[FacebookEvent]` under `data`; with `get_raw=true` the upstream JSON.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"anyOf":[{"type":"object","required":["items","pages","next_cursor","has_more","stop_reason","coverage"],"properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/FacebookEvent"},"description":"`FacebookEvent` of every page walked, in page order."},"pages":{"type":"array","items":{"$ref":"#/components/schemas/PageRead"},"description":"One entry per page walked."},"next_cursor":{"type":"string","nullable":true,"description":"Opaque; pass back as `cursor` to continue."},"has_more":{"type":"boolean","description":"True when `next_cursor` is set, and when the walk stopped `cursor_stalled` on a page that said more results exist but gave no cursor to send back."},"stop_reason":{"type":"string","enum":["pages","since","exhausted","cursor_stalled","repeated_content","deadline","blocked","caught_up"],"description":"Why the walk stopped. `pages`: the page budget is spent and `next_cursor` continues it. `deadline`: the call ran out of time before its next page; `next_cursor` continues it. `since`: a whole page was older than `since`. `exhausted`: Facebook reported the end. `cursor_stalled`: Facebook claimed more but repeated or omitted its cursor. `repeated_content`: a page held only items already seen. `blocked`: Facebook refused a later page; `next_cursor` is the page it refused. `caught_up`: only watch passes the crawler runs for itself stop this way."},"coverage":{"$ref":"#/components/schemas/Coverage"}}},{"type":"object","additionalProperties":true}],"description":"`Page[FacebookEvent]`, or the upstream JSON when `get_raw=true`."},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"items":[{"id":"1777966839979615","name":"\"AN ONLINE EVENING WITH MIRABAI BUSH\"","description":null,"url":"https://www.facebook.com/events/1777966839979615/","starts_at":null,"ends_at":null,"timezone":null,"location_name":null,"address":null,"lat":null,"lng":null,"host":null,"going":null,"interested":null,"is_online":null},{"id":"1474625497812411","name":"MAX POWER","description":null,"url":"https://www.facebook.com/events/1474625497812411/","starts_at":null,"ends_at":null,"timezone":null,"location_name":null,"address":null,"lat":null,"lng":null,"host":null,"going":null,"interested":null,"is_online":null}],"pages":[{"cursor":null,"fetched_at":"2026-10-27T20:35:51.228706+00:00","count":2}],"next_cursor":"eyJhZnRlciI6IntcInBhZ2VfbnVtYmVyXCI6MCxcImZsb3dfY3Vyc29yc19zZXJpYWxpemVkXCI6e1wiSU5URVJOQUxfREVCVUdfTU9EVUxFXCI6XCJ7fVwiLFwiU0VBUkNIX0NPTlRST0xTX0lOVEVSQ0VQVFwiOlwie31cIixcIklOVEVHUklUWVwiOlwie1xcXCJoYXNfbW9yZV9yZXN1bHRzXFxcIjpmYWxzZSxcXFwicHJvY2Vzc2VkX3VuaWNvcm5faWRzXFxcIjpbXSxcXFwiaXNfZW5kX29mX3NlcnBcXFwiOmZhbHNlfVwiLFwiU1BFTExFUlwiOlwie31cIixcIkVWRU5UU19UQUJcIjpcIntcXFwiaGFzX21vcmVfcmVzdWx0c1xcXCI6dHJ1ZSxcXFwiYnJvd3NlX2N1cnNvcl9zZXJpYWxpemVkXFxcIjpcXFwiQWJyLUhqajA3UkZOUTB6V3ctRUY0R3ZZMi0zSzM1UkYyV05qYU8wQkRCQ2Q1TS1nLWdHVWp2YXdsaHhsQm9KOXhCTUFVS3NVRnNZNGgzWWI3N01xUnV0SW9qTk5WZlFJR2ZqWGJRT2lnNkhBN3E2VkNFbFNlcEdZMFhPcEdyUjNxRVpvYVE0cGVVME90Y1Q4T2ZmT1UwcGRUc2JDRXhSbzJhWVNxUGVETTNCUHRBUE1fMzRJdkx5RXN5Q3p1Y1VIN3RBSGt5emp0bnA3eWphSEJ5TFlwOE5BaXFWdGNITlViaXlfaENrN0RpcFMzU1YxNURveURJOEhkM1ZQNy01bTd1U1dnTklHYlVzZlZBYWRZUzRMb3BTcmtVMmRMci1XbS1oSFE0c09aZjdQaFJiUVRhOFhiRTI3UkkxMFBSN0tLRzB1VTA2a0syeXlIOWIyU0VVZGprQU04WUdXbWhMX2VHeGE4aTg1VHI3QzliTm0xR0Fnb0EyZ1lOYXJ1anpBVE9PaUxYYk9OY3NoSDhUMjZVWmV3YWxPR05RVU9KSlk5azMxUG5UUjB4OWVXVEdKOG5FX0k5a3p2TC1zR05WZENKUVNxaE1XaThQUTNtMXoza3pJUWJkR2s2TG1xd2lkWW41NF84Z0ZTaXV6ejJjVDBJNC1UQjhyd3lQWXpuYkVYVndIUXg0ZTc4TnR6WE5uZGgxQzJUc0tJLUVGM0tNYjVYNTBKTkxWR3VVazV1OGRMM3FUTnZjN2Z4aFJ4a3phNHdXZkgzbnVLQml1aFhiejIyTEhmbWRySFFaWjhxWHR1UFpEa183UEhqSFRGRkdzRVZXWmt3ekV1UHA2UW5QQTdDMm1SdlFYRHgxd1NKWW1WcmxFNFo5a29UTVY2TDEyUVhnQUNPZUJsTU1zanYxRzBSTVdvRHFBVWpqYkZsbnZTYjB1dGxVNm9pdzd6ZUY5M0FIUUhSYmMzVG9GeTNyRHMwclRTWGJuZVk5QlhrakpzYWZ1X1VhZllRaGVoYlBlam9zaXh0cGJoZjNjRW1XbV8zLU00Q0JWTEhnbmFqbmVYUm9JU2NodEVyQ2JSMWxWd1FTbXRzN2VncGM0bUV2ZExMNmRLUnJiUGJwWVp4ODJGWjVPMnNMVkxkYjJrS2N6WmMzMEQ5OGJIMW45dkZTbTY0NWZ5d0NvdURLSUVTeEtMY3BjWFlFd1B6TEtMblFzWDc1VFRKNXZ1Vk5IcEtJS1Z3T1Rfbkd2X1JWSHJ3Y1RLNDdJZDNmZlhHMGVjMXpjMXRZbEc1RGpiMjlLVVJkYm5EWVl1ZzFoVmlkSFlYSTBBVk5VZE9UZl9QMkdLODR2b0tIYk4teDJEdVZYMmg0VjljRnZlTWFWdzVCTEloaGNOc2F0Y0xNckpCcVRmMzVERUZGQ1gxZm1mYm9EeE56dnFaTmZpMEpza2xhTHNwZ3piVTZsNEU0VDRxQUY2aDZRSWhORW5Lb1hXNkVmMkp6QkF5bmllbUFoMDltQnFVVWNMMTVlMXRrY2JGMVF1MkRPRjNRZ2xXUEtnbmdISlZ0eVowZXMwa29MU3hBbmx3MUVsZmc5dHFaNHVKbVRqZ1xcXCIsXFxcInByb2Nlc3NlZF91bmljb3JuX2lkc1xcXCI6WzExMjgzMzEyMzY4MDI2MDUsMTc3Nzk2NjgzOTk3OTYxNSwxNDc0NjI1NDk3ODEyNDExLDIzNDA3NTAyNDAwMDUyNzgsMTE2MTQ2NDU5OTgxMTE1OSwzMTU5NzI5NjE3NTcwMzg5LDE4MTk3MTkzNzkwNTQ4NzYsMjI3NjI0MTM0NjU0Nzk3NSwxODc5NDA1NjkwMDc3MTI0LDE2MzAxNTU5NTEzMTg5MTUsMjUzOTE2NDIwMTM4MTkyNzAsNDU5NTI1ODYyMDY5MjkzNCwxOTQ4MzMxNjc5OTA4NDcwLDI1NDY5NTQxNTkxNTExODksMjMyNzM3NDE0ODEwMDk5OSwxMzg0MDY1OTE3MTM2MDgzLDExMTY3NTgzNDQ2MTUzNzAsMTY1NzYyNzM5MjY0NjE3NSwxMTIzMzgzMDg3MTU0OTg0LDEzODM3NjAyODcwNzc4ODIsMTA0MjYxMDAzNTQ2MTI4MiwxMTE3OTYzODYwNjE2NjYzLDE3NTg0MjQ2NDU0NTI2NjEsMTE0ODI4NzI3NzcyMDYzMCwxNTk2ODY4ODUxNTQ5MTc1LDE1MDQ3NzQ1NTE2OTcwODgsMTM3MTgwNDY4MTQ4OTg0MSwxNDA0NTQwOTM0OTk3NTcwLDExMjM0OTkwNjM5NTAxMjksMTczNTg3NjIxMDg0ODc5NSwxMjkyNDYzNTc5NTQyMzc4LDIzMzgzMjQ5ODAyNTc2NzMsMTMwODExODQ1MjM5MjIzNCwyMjYwNjc5NjgxNDQzOTk1LDEzNjgyNjUxNTQ3NjE2ODAsMTEwMDA4NzI0OTM4NTQyMiwxMTI4MDU0OTU2NjMzNzAwLDExMzk2NjcyMTUwNTIzMTcsMTQyOTA3NTM4MjY2NzY5MCw0NzIyNjA4NjM0NjgyMDY1LDE0MDg2OTk4ODA2NTgwMDMsMTU4ODQzMjExOTcyOTI4MywyNTQwMTMyNzQ2NDUwMTc2LDE3Njk1MDkzMjQwOTI1MzEsMjU2ODE3ODE2Njk1MTg5OCwxNDk0NTc0NDYyNDg0NzUyLDEwOTI0MzI4MDk4MzA2OTgsMjI2OTc2NzE1MDIzMTQ4MSwxMDY4NDY2MjY1OTAxOTQ2LDE2NjE2MTQyODIxNjc4NDAsMTM4MzIwMjcwMDMxOTQzMyw4MjY1ODE3MzczOTYxNTksOTU0MzU2MzIwOTgwOTExLDQ2MzAxMDQ1OTcyMTI0NTgsMjE0ODE2NDQ5MjQ4OTQwNiwxODIyMDA1MDcyNDc0MTcwLDE2MTgyNzQwMjk1OTc4MDgsMTQxNTI1MDk0MDU1NzEyNSwxNzg5MTM3NjU4OTcyOTkxLDExMDgwNjcyMTg0MTA5OTIsMTc3MDgyMzY5MDg3Nzc5MiwxMzAzMDQwMzM4NTY4NjgxLDI4ODczMzAwNDA1NTkyNjA1LDIzMDkxNjQ2NjMyNjczNDQsMTcwNTY1NzgwMzg1OTcxOCwxNzIwODA2MzkyNTk5OTE4LDE0Njc3NzcxNjE5NjE0MjMsMTc0MDE1NTc3MzcxOTc0NiwyNDkzOTE4Mjk3Nzk1NDI1LDE1NTI2MzA2MTI5OTU4NzcsMzA1OTYwNTgzNzcxNjgwMSwxNTk5NTY4ODI0OTk5MzczLDE0OTMyMjU0NjU5ODIxODAsMTAzMzA5NDQxOTY2NzUzNSwxODkzNjAzNTcxNjA5ODIyLDE0NTM3NDM0OTY3MzA5ODcsMTgwODk3Nzk5MzQ3MTE0MywyNTA1NzY4NzE2NTY0NTUyLDc5NzkyNDkxOTM3MDExNSwyMTIxNjQ0MDI4NDY4MjYyLDEzMzU3MzI5OTUzMjM2MzgsMTM0OTQ2OTE1NzMyMDM3OCwzOTE4MzQxMTQ0MTI3MzY3NiwxNDQyNDk2MTgxMTY0ODMxLDE3NzQ0NTE2NzA0MzQ0MTQsMTEyNDQ3NjIyMzI3NDc5MCwxNzYzOTMzOTI4MjE1MTY5LDE2Mjk3NzgwMjg1NTk1MjQsMjM5MzU0NTgxMTEzNDMwMiwxOTI3OTE0OTE0NTQ4MzI3LDEwOTY5ODA2MDYxMjE0OTIsMTEyNzc2NzkyMzI2NDEwMCwxNjA3MDgwOTQwOTE0OTk3LDE0MDY1MTAwOTE1ODEyODAsMTM5MTgwMTg3MzEyNTM2OSw0NzI2MzU2NjU0MzE5Mzc0LDExMTc5MjUzMDQyMDE0MDMsMjU3ODEyNzM4OTM3MjAzNiwxNzkyMjIxMjgyMTI4NjEyLDEwMTI3ODU4NDUxODc2NzBdLFxcXCJpc19lbmRfb2Zfc2VycFxcXCI6ZmFsc2V9XCJ9LFwicmVzdWx0X2lkc19zaG93blwiOltcIjE3Nzc5NjY4Mzk5Nzk2MTVcIixcIjE0NzQ2MjU0OTc4MTI0MTFcIixcIjIzNDA3NTAyNDAwMDUyNzhcIixcIjExNjE0NjQ1OTk4MTExNTlcIixcIjMxNTk3Mjk2MTc1NzAzODlcIixcIjE4MTk3MTkzNzkwNTQ4NzZcIixcIjIyNzYyNDEzNDY1NDc5NzVcIixcIjE4Nzk0MDU2OTAwNzcxMjRcIl0sXCJ1bml0X2lkX2xvZ2dpbmdfZmllbGRzXCI6e1wibnVtX3RvdGFsX21vZHVsZXNcIjoxLFwibnVtX3RvdGFsX3Jlc3VsdHNcIjo4LFwibnVtX3RvdGFsX3ZlcnRpY2FsX3Jlc3VsdHNcIjo4fSxcImVudGl0eV9pZHNfc2hvd25fYnlfdHlwZVwiOnt9LFwicHJvY2Vzc2VkX3VuaWNvcm5faWRzXCI6W10sXCJjb21wbGV0ZWRfZmxvd3NcIjpbXCJJTlRFUk5BTF9ERUJVR19NT0RVTEVcIixcIlNFQVJDSF9DT05UUk9MU19JTlRFUkNFUFRcIixcIklOVEVHUklUWVwiLFwiU1BFTExFUlwiXSxcImN1c3RvbV9jdXJzb3JzX3NlcmlhbGl6ZWRcIjp7fX0iLCJvcCI6ImV2ZW50c19zZWFyY2gifQ","has_more":true,"stop_reason":"pages","coverage":{"since":null,"oldest_at":null,"since_reached":false}},"meta":{"source":"live","fetched_at":"2026-10-27T20:35:51.228706+00:00","cost":"$0.0005","balance":"$9.9995","request_id":"req_738a7813573f78f37dbfa3672e99f99e"}}}}},"202":{"description":"Durable job accepted. No completed-result charge. Save batch_id; poll status_url. Retry submission with the same Idempotency-Key after a lost response. An account may have five queued, running or payment-required jobs. A sixth new job returns 429 rate_limited. Matching idempotent replays still work at the limit. Ready and failed jobs release their slots; pages within a job remain unbounded. This is a synthetic contract example, not a live capture.","x-example-provenance":"synthetic-contract","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","required":["batch_id","status","status_url","results_url","cost","item_count","error","retry_at","total","done_count","failed_count","created_at","started_at","finished_at"],"properties":{"batch_id":{"type":"string"},"status":{"type":"string","enum":["queued","running","payment_required","ready","failed"]},"status_url":{"type":"string"},"results_url":{"type":"string"},"cost":{"type":"string"},"item_count":{"type":"integer","nullable":true},"error":{"type":"string","nullable":true,"description":"Null unless failed. A failed target carries its own code; incomplete_result appears only when it has none and pages of the result are missing. profile_not_found, post_not_found, upstream_not_found or not_found: the target does not exist or is not visible. not_visible: The account exists, but its posts are not visible to logged-out readers (private, restricted, or hidden by Instagram). Retrying will not change the result until the account changes. not_cached: cached=cache_only found no saved read. incomplete_result: pages of the result are missing. temporarily_unavailable: the target could not be read for now (no capacity, a pause or repeated refusals); retry later with a new job. result_item_too_large: one result unit exceeds the delivery budget. result_snapshot_missing or result_snapshot_corrupt: the crawler could not serve the retained result of a paid job, and its charge is refunded; if the crawler serves it again, a later results read returns it and charges the job again. crawler_submit_400, crawler_submit_404 or crawler_submit_422: the crawl service refused the job request. crawler_job_failed: any other failure; the same job is not expected to succeed if resubmitted. cancelled: the job was cancelled with POST /v1/jobs/{job_id}/cancel. No failed job costs anything: only result_snapshot_missing and result_snapshot_corrupt follow a charge, and that charge is refunded."},"retry_at":{"type":"string","format":"date-time","nullable":true,"description":"Null unless the job failed temporarily_unavailable because a crawl route was closed for every caller. Then it is when the route opens again, and the response carries the same time as a Retry-After header in seconds. Submit a new job after it."},"total":{"type":"integer","description":"Targets in the job. A job submitted through a /v1 route has one."},"done_count":{"type":"integer","description":"Targets the crawler finished."},"failed_count":{"type":"integer","description":"Targets that failed."},"created_at":{"type":"string","format":"date-time","description":"When the job was submitted."},"started_at":{"type":"string","format":"date-time","nullable":true,"description":"When the crawler started the job. Null until it starts."},"finished_at":{"type":"string","format":"date-time","nullable":true,"description":"When the job finished or failed. Null while it is queued or running."}}},"meta":{"type":"object","required":["cost","request_id"],"properties":{"cost":{"type":"string","example":"$0.0000"},"request_id":{"type":"string"}}}}},"example":{"data":{"batch_id":"job_7641d5f0-717d-4b70-a2f1-f58d846d7242","status":"queued","status_url":"/v1/jobs/job_7641d5f0-717d-4b70-a2f1-f58d846d7242","results_url":"/v1/jobs/job_7641d5f0-717d-4b70-a2f1-f58d846d7242/results","cost":"$0.0000","item_count":null,"error":null,"retry_at":null,"total":1,"done_count":0,"failed_count":0,"created_at":"2026-10-12T12:56:17.403Z","started_at":null,"finished_at":null},"meta":{"cost":"$0.0000","request_id":"req_job_example"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"404":{"description":"`cached=cache_only` found nothing saved for these arguments (`not_cached`; call again with `cached=auto` to fetch it), or the Facebook account or item does not exist (`not_found`). You are not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_cached","message":"no saved facebook/events_search read for 'NASA'. cached=cache_only never fetches, so call again with cached=auto to fetch it. You are not charged.","request_id":"req_5c10900e919bc7a3ff79b7501d582b4c"}}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/tiktok_shop/products":{"get":{"tags":["TikTok Shop"],"operationId":"tiktokShopProducts","summary":"Search TikTok Shop products","description":"Products that sold or have a selling video, searched by title, brand or shop name and filtered by market, category subtree, shop, price, 30-day units, lifetime units and status. The default sort is `relevance` with `q`, else `units_30d`; ties go to lifetime units sold. `total` is exact up to 10,000; past that it is a floor and `total_exact` is false.","x-dashboard-cost":"$0.0005","x-example-query":{"page_size":"2"},"security":[{"bearerAuth":[]}],"parameters":[{"name":"q","in":"query","required":false,"description":"Words of the title, brand or shop name.","schema":{"type":"string","maxLength":200}},{"name":"region","in":"query","required":false,"description":"Market, ISO 3166 alpha-2 in upper case.","schema":{"type":"string","pattern":"^[A-Z]{2}$","default":"US"},"examples":{"default":{"value":"US","x-disabled":true}}},{"name":"category_id","in":"query","required":false,"description":"Category id; matches the whole subtree (see `/v1/tiktok_shop/categories`).","schema":{"type":"string","pattern":"^\\d{1,19}$"}},{"name":"seller_id","in":"query","required":false,"description":"Only this shop.","schema":{"type":"string","pattern":"^\\d{1,19}$"}},{"name":"min_price","in":"query","required":false,"description":"Lowest sale price, in the product currency.","schema":{"type":"number","minimum":0}},{"name":"max_price","in":"query","required":false,"description":"Highest sale price, in the product currency.","schema":{"type":"number","minimum":0}},{"name":"min_units_30d","in":"query","required":false,"description":"Fewest units sold in the last 30 days.","schema":{"type":"integer","minimum":0}},{"name":"min_sold_count","in":"query","required":false,"description":"Fewest lifetime units sold.","schema":{"type":"integer","minimum":0}},{"name":"status","in":"query","required":false,"description":"Listing status.","schema":{"type":"string","enum":["on_sale","off_shelf","gone"]}},{"name":"sort","in":"query","required":false,"description":"Sort field.","schema":{"type":"string","enum":["relevance","units_7d","units_30d","gmv_30d","sold_count","price","rating","review_count","first_seen_at"]}},{"name":"order","in":"query","required":false,"description":"Sort direction. `relevance` ignores it.","schema":{"type":"string","enum":["asc","desc"],"default":"desc"},"examples":{"default":{"value":"desc","x-disabled":true}}},{"name":"cursor","in":"query","required":false,"description":"`next_cursor` of the previous page. A cursor only continues the query that issued it.","schema":{"type":"string","minLength":1,"maxLength":2048}},{"name":"page_size","in":"query","required":false,"description":"Rows per page.","schema":{"type":"integer","minimum":1,"maximum":100,"default":25},"examples":{"default":{"value":25,"x-disabled":true}}}],"responses":{"200":{"description":"Search TikTok Shop products","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":true},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"items":[{"product_id":"1730895301663428994","seller_id":"8647052287234642306","region":"US","title":"Women's Solid/Leopard Print Spaghetti Strap Cami Top & Lace Trim Shorts Pyjama Two-piece Set, Casual Comfy Fitted Camisole & Shorts PJ Set, Ladies Breathable Sleepwear Lingerie for All Seasons Camisole Sets","image_url":"https://p16-oec-general.ttcdn-us.com/tos-alisg-i-aphluv4xwc-sg/516db871970949da946feb033c1b0d0a~tplv-fhlh96nyum-crop-webp:1350:1800.webp?dr=12190&t=555f072d&ps=933b5bde&shp=8dbd94bf&shcp=a6e80448&idc=useast8&from=2378011839","canonical_url":null,"currency":"USD","sale_price":45.68,"origin_price":null,"discount":null,"sold_count":9328,"units_7d":95497,"units_30d":95497,"gmv_30d":4362302.96,"rating":4.7,"review_count":583,"status":"on_sale","first_seen_at":"2026-10-06T11:36:47.116429Z","shop_name":"dreamdarling","brand_name":null,"category_id":"1481616","category_ids":["601152","843016","845832","904720","1481616"],"category_names":["Womenswear & Underwear","Women's Sleepwear & Loungewear","Pajamas & Loungewear","Pajamas Sets","Mixed Pajamas Sets"],"creator_count":null,"video_count":null,"updated_at":"2026-10-10T16:41:51.430663Z"},{"product_id":"1730446080657035760","seller_id":"8648231900191232496","region":"US","title":"Portable Mini Travel Hand Sanitizer Spray, Moisturizing Fruit & Plant-Scented Liquid Hand Sanitizer, Hand Cleaning Product for Women & Girls, Hydrating & Moisturizing Hand Sanitizer","image_url":"https://f005.backblazeb2.com/file/influencer-dev/staging/crawler/tiktok_shop_product/1730446080657035760.webp","canonical_url":null,"currency":"USD","sale_price":3.59,"origin_price":null,"discount":null,"sold_count":112976,"units_7d":92669,"units_30d":92669,"gmv_30d":332681.71,"rating":4.7,"review_count":5713,"status":"on_sale","first_seen_at":"2026-10-06T11:36:04.111907Z","shop_name":"Sleek Style Beauty","brand_name":null,"category_id":"601508","category_ids":["601450","849032","601508"],"category_names":["Beauty & Personal Care","Hand & Foot Care","Hand Wash"],"creator_count":null,"video_count":null,"updated_at":"2026-10-09T17:33:49.562664Z"}],"total":10000,"total_exact":false,"next_cursor":"WyIzZWI5MmZmZjU3ZjE3ZTEwIixbOTI2NjksMTEyOTc2LCIxNzMwNDQ2MDgwNjU3MDM1NzYwIl1d"},"meta":{"cost":"$0.0005","balance":"$9.9995","request_id":"req_25b020389c695889f7f90139709f92ac"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/tiktok_shop/shops":{"get":{"tags":["TikTok Shop"],"operationId":"tiktokShopShops","summary":"Search TikTok Shop shops","description":"Every stored shop of a market, searched by shop name. The default sort is `relevance` with `q`, else `gmv_30d`.","x-dashboard-cost":"$0.0005","x-example-query":{"page_size":"2"},"security":[{"bearerAuth":[]}],"parameters":[{"name":"q","in":"query","required":false,"description":"Words of the shop name.","schema":{"type":"string","maxLength":200}},{"name":"region","in":"query","required":false,"description":"Market, ISO 3166 alpha-2 in upper case.","schema":{"type":"string","pattern":"^[A-Z]{2}$","default":"US"},"examples":{"default":{"value":"US","x-disabled":true}}},{"name":"is_brand","in":"query","required":false,"description":"Only brand shops (`true`) or only other shops (`false`).","schema":{"type":"boolean"}},{"name":"sort","in":"query","required":false,"description":"Sort field.","schema":{"type":"string","enum":["relevance","gmv_30d","units_30d","sold_count","followers","product_count","creator_count"]}},{"name":"order","in":"query","required":false,"description":"Sort direction. `relevance` ignores it.","schema":{"type":"string","enum":["asc","desc"],"default":"desc"},"examples":{"default":{"value":"desc","x-disabled":true}}},{"name":"cursor","in":"query","required":false,"description":"`next_cursor` of the previous page. A cursor only continues the query that issued it.","schema":{"type":"string","minLength":1,"maxLength":2048}},{"name":"page_size","in":"query","required":false,"description":"Rows per page.","schema":{"type":"integer","minimum":1,"maximum":100,"default":25},"examples":{"default":{"value":25,"x-disabled":true}}}],"responses":{"200":{"description":"Search TikTok Shop shops","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":true},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"items":[{"seller_id":"7495514739648989419","region":"US","shop_name":"medicube US Store","logo_url":"https://f005.backblazeb2.com/file/influencer-dev/staging/crawler/tiktok_shop_seller/7495514739648989419.webp","is_brand":true,"rating":4.6,"followers":695033,"sold_count":9918366,"product_count":159,"on_sell_product_count":161,"review_count":592270,"video_count":1048,"units_7d":null,"units_30d":null,"gmv_30d":null,"currency":null,"creator_count":null,"selling_video_count":null,"first_seen_at":"2026-10-06T11:03:57.167703Z","updated_at":"2026-10-12T13:09:35.127436Z"},{"seller_id":"7495150597721263036","region":"US","shop_name":"Tarte Cosmetics","logo_url":"https://f005.backblazeb2.com/file/influencer-dev/staging/crawler/tiktok_shop_seller/7495150597721263036.webp","is_brand":true,"rating":4.5,"followers":2363070,"sold_count":8522270,"product_count":165,"on_sell_product_count":165,"review_count":436649,"video_count":4636,"units_7d":null,"units_30d":null,"gmv_30d":null,"currency":null,"creator_count":null,"selling_video_count":null,"first_seen_at":"2026-10-06T11:07:48.897484Z","updated_at":"2026-10-12T07:44:23.592746Z"}],"total":10000,"total_exact":false,"next_cursor":"WyIzYTc1Njk2MDFmZmQ2YmM1IixbIi1JbmZpbml0eSIsODUyMjI3MCwiNzQ5NTE1MDU5NzcyMTI2MzAzNiJdXQ"},"meta":{"cost":"$0.0005","balance":"$9.9990","request_id":"req_ad4acf4f85c4283cacbc1f2762904304"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/tiktok_shop/categories":{"get":{"tags":["TikTok Shop"],"operationId":"tiktokShopCategories","summary":"TikTok Shop category tree","description":"The stored category tree of a market, children sorted by name. With `parent_id`, only the subtree under that category. Reference data for the `category_id` filter, so it is free.","x-dashboard-cost":"$0.0000","x-example-query":{"parent_id":"601152"},"security":[{"bearerAuth":[]}],"parameters":[{"name":"region","in":"query","required":false,"description":"Market, ISO 3166 alpha-2 in upper case.","schema":{"type":"string","pattern":"^[A-Z]{2}$","default":"US"},"examples":{"default":{"value":"US","x-disabled":true}}},{"name":"parent_id","in":"query","required":false,"description":"Return only the subtree under this category.","schema":{"type":"string","pattern":"^\\d{1,10}$","example":"601152"},"examples":{"default":{"value":"601152","x-disabled":true}}}],"responses":{"200":{"description":"TikTok Shop category tree","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":true},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"region":"US","categories":[{"category_id":"601152","parent_id":null,"level":1,"name":"Womenswear & Underwear","slug":"womenswear-underwear","is_leaf":false,"children":[{"category_id":"842376","parent_id":"601152","level":2,"name":"Women's Bottoms","slug":"women-s-bottoms","is_leaf":false,"children":[{"category_id":"601276","parent_id":"842376","level":3,"name":"Jeans","slug":"jeans","is_leaf":true,"children":[]},{"category_id":"601274","parent_id":"842376","level":3,"name":"Leggings","slug":"leggings","is_leaf":true,"children":[]}]},{"category_id":"842504","parent_id":"601152","level":2,"name":"Women's Dresses","slug":"women-s-dresses","is_leaf":false,"children":[{"category_id":"961672","parent_id":"842504","level":3,"name":"Bridesmaid Dresses","slug":"bridesmaid-dresses","is_leaf":true,"children":[]},{"category_id":"601281","parent_id":"842504","level":3,"name":"Casual Dresses","slug":"casual-dresses","is_leaf":true,"children":[]}]}]}]},"meta":{"cost":"$0.0000","balance":"$9.9960","request_id":"req_8c5a38548a721ac86de7f4577332dd92"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"404":{"description":"No stored category has this id in this market.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/tiktok_shop/product":{"get":{"tags":["TikTok Shop"],"operationId":"tiktokShopProduct","summary":"TikTok Shop product","description":"One product with its SKUs, category path, rating histogram, shop, video and creator counts, top selling videos by plays, and daily units and GMV for `days` days. If the sales store does not answer, the product still returns with `sales.available` false and `sales.error` naming the cause.","x-dashboard-cost":"$0.0010","x-example-query":{"product_id":"1730895301663428994"},"security":[{"bearerAuth":[]}],"parameters":[{"name":"product_id","in":"query","required":true,"description":"TikTok Shop product id, as a string.","example":"1730895301663428994","schema":{"type":"string","pattern":"^\\d{1,19}$","example":"1730895301663428994"}},{"name":"days","in":"query","required":false,"description":"Days of daily sales, ending with the last complete UTC day.","schema":{"type":"integer","minimum":1,"maximum":90,"default":30},"examples":{"default":{"value":30,"x-disabled":true}}}],"responses":{"200":{"description":"TikTok Shop product","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":true},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"product_id":"1730895301663428994","seller_id":"8647052287234642306","region":"US","title":"Women's Solid/Leopard Print Spaghetti Strap Cami Top & Lace Trim Shorts Pyjama Two-piece Set, Casual Comfy Fitted Camisole & Shorts PJ Set, Ladies Breathable Sleepwear Lingerie for All Seasons Camisole Sets","image_url":"https://p16-oec-general.ttcdn-us.com/tos-alisg-i-aphluv4xwc-sg/516db871970949da946feb033c1b0d0a~tplv-fhlh96nyum-crop-webp:1350:1800.webp?dr=12190&t=555f072d&ps=933b5bde&shp=8dbd94bf&shcp=a6e80448&idc=useast8&from=2378011839","canonical_url":"https://shop.tiktok.com/us/pdp/cami-top-lace-trim-shorts-set-by-brand-womens-solid-leopard-print-pj/1730895301663428994","currency":"USD","sale_price":45.68,"origin_price":null,"discount":null,"sold_count":9328,"units_7d":95497,"units_30d":95497,"gmv_30d":4362302.96,"rating":4.7,"review_count":583,"status":"on_sale","first_seen_at":"2026-10-06T11:36:47.116429Z","brand_name":null,"category_id":"1481616","categories":[{"category_id":"601152","name":"Womenswear & Underwear","level":1},{"category_id":"843016","name":"Women's Sleepwear & Loungewear","level":2},{"category_id":"845832","name":"Pajamas & Loungewear","level":3},{"category_id":"904720","name":"Pajamas Sets","level":4},{"category_id":"1481616","name":"Mixed Pajamas Sets","level":5}],"rating_histogram":{"1":7,"2":10,"3":22,"4":54,"5":518},"skus":[{"sku_id":"1729485287812208002","props":"Color: Purple / Size: S","price":45.68,"stock":3,"observed_at":"2026-10-09T17:54:47.242983Z"},{"sku_id":"1729485287812273538","props":"Color: Purple / Size: M","price":45.68,"stock":8,"observed_at":"2026-10-09T17:54:47.242983Z"}],"shop":{"seller_id":"8647052287234642306","region":"US","shop_name":"dreamdarling","logo_url":"https://f005.backblazeb2.com/file/influencer-dev/staging/crawler/tiktok_shop_seller/8647052287234642306.webp","is_brand":null,"rating":4.6,"followers":4826,"sold_count":656924,"product_count":177,"on_sell_product_count":170,"review_count":44657,"video_count":1604,"units_7d":null,"units_30d":null,"gmv_30d":null,"currency":null,"creator_count":null,"selling_video_count":null,"first_seen_at":"2026-10-06T11:15:02.357609Z","updated_at":"2026-10-09T17:59:14.488998Z"},"video_count":19,"creator_count":14,"top_videos":[{"video_id":"7531751611383811383","url":null,"creator":{"uid":"7434430695249151019","unique_id":null,"sec_uid":null,"nickname":"queensecret227","followers":null,"avatar_url":null,"profile_url":null},"product_ids":["1730895301663428994"],"caption":null,"cover_url":null,"posted_at":"2025-07-27T13:24:32Z","plays":3321789,"likes":25601,"comments":null,"shares":null,"duration":null,"ad_label":"Creator earns commission","via_anchor":false,"via_product_page":true,"first_seen_at":"2026-10-09T17:55:00.207266Z","last_seen_at":"2026-10-09T17:55:00.207266Z"},{"video_id":"7536778127427505421","url":null,"creator":{"uid":"7290771509621261355","unique_id":null,"sec_uid":null,"nickname":"bbhgyey8qw","followers":null,"avatar_url":null,"profile_url":null},"product_ids":["1730895301663428994"],"caption":null,"cover_url":null,"posted_at":"2025-08-10T02:28:49Z","plays":1146742,"likes":16097,"comments":null,"shares":null,"duration":null,"ad_label":"Creator earns commission","via_anchor":false,"via_product_page":true,"first_seen_at":"2026-10-09T17:55:00.207266Z","last_seen_at":"2026-10-09T17:55:00.207266Z"}],"sales":{"available":true,"days":7,"first_day":"2026-10-05","last_day":"2026-10-11","currency":"USD","units":95497,"gmv":4362302.96,"points":[{"day":"2026-10-05","units":0,"gmv":0},{"day":"2026-10-06","units":0,"gmv":0},{"day":"2026-10-07","units":31832,"gmv":1454100.99}],"error":null},"card_observed_at":"2026-10-10T16:41:50.901459Z","detail_observed_at":"2026-10-09T17:54:47.242983Z","rollup_at":"2026-10-10T04:53:00.529538Z","updated_at":"2026-10-10T16:41:51.430663Z"},"meta":{"cost":"$0.0010","balance":"$9.9950","request_id":"req_d6a38f3457bff8b8b19736a8f7920cfd"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"404":{"description":"No stored TikTok Shop product has this id. You are not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/tiktok_shop/product/videos":{"get":{"tags":["TikTok Shop"],"operationId":"tiktokShopProductVideos","summary":"TikTok Shop product videos","description":"Videos that sell the product: anchored on the video or listed on the product page. Each row names its creator and the paid or affiliate label TikTok shows.","x-dashboard-cost":"$0.0005","x-example-query":{"product_id":"1730895301663428994","page_size":"2"},"security":[{"bearerAuth":[]}],"parameters":[{"name":"product_id","in":"query","required":true,"description":"TikTok Shop product id, as a string.","example":"1730895301663428994","schema":{"type":"string","pattern":"^\\d{1,19}$","example":"1730895301663428994"}},{"name":"sort","in":"query","required":false,"description":"`plays` (default) or `recent` by post time.","schema":{"type":"string","enum":["plays","recent"],"default":"plays"},"examples":{"default":{"value":"plays","x-disabled":true}}},{"name":"cursor","in":"query","required":false,"description":"`next_cursor` of the previous page. A cursor only continues the query that issued it.","schema":{"type":"string","minLength":1,"maxLength":2048}},{"name":"page_size","in":"query","required":false,"description":"Rows per page.","schema":{"type":"integer","minimum":1,"maximum":100,"default":25},"examples":{"default":{"value":25,"x-disabled":true}}}],"responses":{"200":{"description":"TikTok Shop product videos","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":true},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"items":[{"video_id":"7531751611383811383","url":null,"creator":{"uid":"7434430695249151019","unique_id":null,"sec_uid":null,"nickname":"queensecret227","followers":null,"avatar_url":null,"profile_url":null},"product_ids":["1730895301663428994"],"caption":null,"cover_url":null,"posted_at":"2025-07-27T13:24:32Z","plays":3321789,"likes":25601,"comments":null,"shares":null,"duration":null,"ad_label":"Creator earns commission","via_anchor":false,"via_product_page":true,"first_seen_at":"2026-10-09T17:55:00.207266Z","last_seen_at":"2026-10-09T17:55:00.207266Z"},{"video_id":"7536778127427505421","url":null,"creator":{"uid":"7290771509621261355","unique_id":null,"sec_uid":null,"nickname":"bbhgyey8qw","followers":null,"avatar_url":null,"profile_url":null},"product_ids":["1730895301663428994"],"caption":null,"cover_url":null,"posted_at":"2025-08-10T02:28:49Z","plays":1146742,"likes":16097,"comments":null,"shares":null,"duration":null,"ad_label":"Creator earns commission","via_anchor":false,"via_product_page":true,"first_seen_at":"2026-10-09T17:55:00.207266Z","last_seen_at":"2026-10-09T17:55:00.207266Z"}],"next_cursor":"WyJmNWRiNjMwZDk5ZDFhZTIzIixbMTE0Njc0Mi4wLCI3NTM2Nzc4MTI3NDI3NTA1NDIxIl1d"},"meta":{"cost":"$0.0005","balance":"$9.9985","request_id":"req_e7e79d3533e4236c45c93e1dbf04a8d8"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"404":{"description":"No stored TikTok Shop product has this id. You are not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/tiktok_shop/product/creators":{"get":{"tags":["TikTok Shop"],"operationId":"tiktokShopProductCreators","summary":"TikTok Shop product creators","description":"Creators whose videos sell the product, with their video count and plays.","x-dashboard-cost":"$0.0005","x-example-query":{"product_id":"1730895301663428994","page_size":"2"},"security":[{"bearerAuth":[]}],"parameters":[{"name":"product_id","in":"query","required":true,"description":"TikTok Shop product id, as a string.","example":"1730895301663428994","schema":{"type":"string","pattern":"^\\d{1,19}$","example":"1730895301663428994"}},{"name":"sort","in":"query","required":false,"description":"Creator order.","schema":{"type":"string","enum":["videos","plays","followers"],"default":"videos"},"examples":{"default":{"value":"videos","x-disabled":true}}},{"name":"cursor","in":"query","required":false,"description":"`next_cursor` of the previous page. A cursor only continues the query that issued it.","schema":{"type":"string","minLength":1,"maxLength":2048}},{"name":"page_size","in":"query","required":false,"description":"Rows per page.","schema":{"type":"integer","minimum":1,"maximum":100,"default":25},"examples":{"default":{"value":25,"x-disabled":true}}}],"responses":{"200":{"description":"TikTok Shop product creators","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":true},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"items":[{"uid":"7568736363085153294","unique_id":null,"sec_uid":null,"nickname":"Selena","followers":null,"avatar_url":null,"profile_url":null,"video_count":3,"product_count":1,"plays":1505910,"last_seen_at":"2026-10-09T17:55:00.207266Z"},{"uid":"7434432785928438827","unique_id":null,"sec_uid":null,"nickname":"Lilian","followers":null,"avatar_url":null,"profile_url":null,"video_count":2,"product_count":1,"plays":1302417,"last_seen_at":"2026-10-09T17:55:00.207266Z"}],"next_cursor":"WyJkZWI3MDNlMzIxZWQ0ZDQ5IixbMi4wLCI3NDM0NDMyNzg1OTI4NDM4ODI3Il1d"},"meta":{"cost":"$0.0005","balance":"$9.9980","request_id":"req_a9a1b0e47a4e0e983701016572a475ef"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"404":{"description":"No stored TikTok Shop product has this id. You are not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/tiktok_shop/shop":{"get":{"tags":["TikTok Shop"],"operationId":"tiktokShopShop","summary":"TikTok Shop shop","description":"One shop with its business details, product, video and creator counts, top products by 30-day units, and daily units and GMV summed over its products for `days` days. If the sales store does not answer, the shop still returns with `sales.available` false.","x-dashboard-cost":"$0.0010","x-example-query":{"seller_id":"7495514739648989419"},"security":[{"bearerAuth":[]}],"parameters":[{"name":"seller_id","in":"query","required":true,"description":"TikTok Shop seller (shop) id, as a string.","example":"7495514739648989419","schema":{"type":"string","pattern":"^\\d{1,19}$","example":"7495514739648989419"}},{"name":"days","in":"query","required":false,"description":"Days of daily sales, ending with the last complete UTC day.","schema":{"type":"integer","minimum":1,"maximum":90,"default":30},"examples":{"default":{"value":30,"x-disabled":true}}}],"responses":{"200":{"description":"TikTok Shop shop","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":true},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"seller_id":"7495514739648989419","region":"US","shop_name":"medicube US Store","logo_url":"https://f005.backblazeb2.com/file/influencer-dev/staging/crawler/tiktok_shop_seller/7495514739648989419.webp","is_brand":true,"rating":4.6,"followers":695033,"sold_count":9918366,"product_count":159,"on_sell_product_count":161,"review_count":592270,"video_count":1048,"units_7d":null,"units_30d":null,"gmv_30d":null,"currency":null,"creator_count":null,"selling_video_count":null,"first_seen_at":"2026-10-06T11:03:57.167703Z","updated_at":"2026-10-12T13:29:54.732929Z","global_seller_id":"7495514739648989419","store_url":"https://www.tiktok.com/shop/store/medicube-us-store/7495514739648989419","business_name":"APR US INC","business_address":"41 GREENFIELD, Irvine, California, 92614, United States","walked_at":"2026-10-06T11:11:32.123465Z","info_observed_at":"2026-10-12T13:29:54.204187Z","rollup_at":null,"counts":{"products":161,"on_sale":161,"off_shelf":0,"gone":0,"sold_products":161,"selling_videos":13168,"creators":2275},"top_products":[{"product_id":"1732052189676081387","seller_id":"7495514739648989419","region":"US","title":"[medicube] Smooth & Clear Body Care Set | Hypochlorous Acid Body Peel Shot, Kojic Acid Turmeric Body Wash, Toner Pad, Toner, Mist | Exfoliating for Dead Skin Cells & Excess Sebum & Clearing for After Spots, Texture & Uneven Skin Tone | K-Beauty","image_url":"https://f005.backblazeb2.com/file/influencer-dev/staging/crawler/tiktok_shop_product/1732052189676081387.webp","canonical_url":"https://shop.tiktok.com/us/pdp/medicube-body-care-set-exfoliating-brightening-k-beauty/1732052189676081387","currency":"USD","sale_price":40.3,"origin_price":87.1,"discount":0.5373,"sold_count":453465,"units_7d":37911,"units_30d":37911,"gmv_30d":1527813.3,"rating":4.6,"review_count":22960,"status":"on_sale","first_seen_at":"2026-10-06T11:05:57.634755Z"},{"product_id":"1732293553906094315","seller_id":"7495514739648989419","region":"US","title":"[medicube] NAD+ EGF Firming Serum | NAD+, EGF, Collagen Extract, Anti-aging, Plumping, Radiance Boosting Serum | Cares for Look of Fine Lines, Skin Elasticity & Firmness For Youthful-looking Skin (30ml / 1.01 fl. oz.) | Korean Skincare, K-Beauty","image_url":"https://f005.backblazeb2.com/file/influencer-dev/staging/crawler/tiktok_shop_product/1732293553906094315.webp","canonical_url":"https://shop.tiktok.com/us/pdp/coming-soon-medicube-egf-serum-drops-launch-march/1732293553906094315","currency":"USD","sale_price":7599,"origin_price":29,"discount":0,"sold_count":401547,"units_7d":23381,"units_30d":23381,"gmv_30d":177672219,"rating":4.6,"review_count":26363,"status":"on_sale","first_seen_at":"2026-10-06T11:11:36.957787Z"}],"sales":{"available":true,"days":7,"first_day":"2026-10-05","last_day":"2026-10-11","currency":"USD","units":172910,"gmv":207383210.88,"points":[{"day":"2026-10-05","units":0,"gmv":0},{"day":"2026-10-06","units":0,"gmv":0},{"day":"2026-10-07","units":11384,"gmv":14917263.46}],"error":null}},"meta":{"cost":"$0.0010","balance":"$9.9940","request_id":"req_611264c592dfb3712490eb727cb03c19"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"404":{"description":"No stored TikTok Shop shop has this id. You are not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/tiktok_shop/shop/products":{"get":{"tags":["TikTok Shop"],"operationId":"tiktokShopShopProducts","summary":"TikTok Shop shop products","description":"Every listed product of the shop, sold or not. An empty sort value sorts last.","x-dashboard-cost":"$0.0005","x-example-query":{"seller_id":"7495514739648989419","page_size":"2"},"security":[{"bearerAuth":[]}],"parameters":[{"name":"seller_id","in":"query","required":true,"description":"TikTok Shop seller (shop) id, as a string.","example":"7495514739648989419","schema":{"type":"string","pattern":"^\\d{1,19}$","example":"7495514739648989419"}},{"name":"sort","in":"query","required":false,"description":"Sort field.","schema":{"type":"string","enum":["units_30d","units_7d","gmv_30d","sold_count","price","first_seen_at"],"default":"units_30d"},"examples":{"default":{"value":"units_30d","x-disabled":true}}},{"name":"order","in":"query","required":false,"description":"Sort direction. `relevance` ignores it.","schema":{"type":"string","enum":["asc","desc"],"default":"desc"},"examples":{"default":{"value":"desc","x-disabled":true}}},{"name":"status","in":"query","required":false,"description":"Listing status.","schema":{"type":"string","enum":["on_sale","off_shelf","gone"]}},{"name":"cursor","in":"query","required":false,"description":"`next_cursor` of the previous page. A cursor only continues the query that issued it.","schema":{"type":"string","minLength":1,"maxLength":2048}},{"name":"page_size","in":"query","required":false,"description":"Rows per page.","schema":{"type":"integer","minimum":1,"maximum":100,"default":25},"examples":{"default":{"value":25,"x-disabled":true}}}],"responses":{"200":{"description":"TikTok Shop shop products","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":true},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"items":[{"product_id":"1732052189676081387","seller_id":"7495514739648989419","region":"US","title":"[medicube] Smooth & Clear Body Care Set | Hypochlorous Acid Body Peel Shot, Kojic Acid Turmeric Body Wash, Toner Pad, Toner, Mist | Exfoliating for Dead Skin Cells & Excess Sebum & Clearing for After Spots, Texture & Uneven Skin Tone | K-Beauty","image_url":"https://f005.backblazeb2.com/file/influencer-dev/staging/crawler/tiktok_shop_product/1732052189676081387.webp","canonical_url":"https://shop.tiktok.com/us/pdp/medicube-body-care-set-exfoliating-brightening-k-beauty/1732052189676081387","currency":"USD","sale_price":40.3,"origin_price":87.1,"discount":0.5373,"sold_count":453465,"units_7d":37911,"units_30d":37911,"gmv_30d":1527813.3,"rating":4.6,"review_count":22960,"status":"on_sale","first_seen_at":"2026-10-06T11:05:57.634755Z"},{"product_id":"1732293553906094315","seller_id":"7495514739648989419","region":"US","title":"[medicube] NAD+ EGF Firming Serum | NAD+, EGF, Collagen Extract, Anti-aging, Plumping, Radiance Boosting Serum | Cares for Look of Fine Lines, Skin Elasticity & Firmness For Youthful-looking Skin (30ml / 1.01 fl. oz.) | Korean Skincare, K-Beauty","image_url":"https://f005.backblazeb2.com/file/influencer-dev/staging/crawler/tiktok_shop_product/1732293553906094315.webp","canonical_url":"https://shop.tiktok.com/us/pdp/coming-soon-medicube-egf-serum-drops-launch-march/1732293553906094315","currency":"USD","sale_price":7599,"origin_price":29,"discount":0,"sold_count":401547,"units_7d":23381,"units_30d":23381,"gmv_30d":177672219,"rating":4.6,"review_count":26363,"status":"on_sale","first_seen_at":"2026-10-06T11:11:36.957787Z"}],"next_cursor":"WyIzMGUwMTgyZjk5OWNjNGNhIixbMjMzODEuMCwiMTczMjI5MzU1MzkwNjA5NDMxNSJdXQ"},"meta":{"cost":"$0.0005","balance":"$9.9975","request_id":"req_a30f0d027ed4dee258319fb6c0d8bb52"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"404":{"description":"No stored TikTok Shop shop has this id. You are not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/tiktok_shop/shop/creators":{"get":{"tags":["TikTok Shop"],"operationId":"tiktokShopShopCreators","summary":"TikTok Shop shop creators","description":"The shop's affiliate creators: every creator whose videos sell one of its products, with videos, distinct products and plays. Each video counts once.","x-dashboard-cost":"$0.0005","x-example-query":{"seller_id":"7495514739648989419","page_size":"2"},"security":[{"bearerAuth":[]}],"parameters":[{"name":"seller_id","in":"query","required":true,"description":"TikTok Shop seller (shop) id, as a string.","example":"7495514739648989419","schema":{"type":"string","pattern":"^\\d{1,19}$","example":"7495514739648989419"}},{"name":"sort","in":"query","required":false,"description":"Creator order.","schema":{"type":"string","enum":["videos","plays","followers"],"default":"videos"},"examples":{"default":{"value":"videos","x-disabled":true}}},{"name":"cursor","in":"query","required":false,"description":"`next_cursor` of the previous page. A cursor only continues the query that issued it.","schema":{"type":"string","minLength":1,"maxLength":2048}},{"name":"page_size","in":"query","required":false,"description":"Rows per page.","schema":{"type":"integer","minimum":1,"maximum":100,"default":25},"examples":{"default":{"value":25,"x-disabled":true}}}],"responses":{"200":{"description":"TikTok Shop shop creators","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":true},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"items":[{"uid":"7517588670167368759","unique_id":"roseshopss","sec_uid":"MS4wLjABAAAA4CW8WM-EZbrM25bJGLRrhQyi8gm7A-0h_riRU_-zy-y-ovm8NYBcCBGNRwnkt_qz","nickname":"rose","followers":67500,"avatar_url":"https://p16-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/2e2ddb1d11737b5dd732d49532d661d0~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=9640&refresh_token=c365b553&x-expires=1791536400&x-signature=jzHvJaR%2FzdU9tpTNHIBwvshfmWw%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=useast5","profile_url":"https://www.tiktok.com/@roseshopss","video_count":120,"product_count":10,"plays":51313388,"last_seen_at":"2026-10-07T09:45:04.616264Z"},{"uid":"7215285688273798187","unique_id":"skincarepronikki","sec_uid":"MS4wLjABAAAAkDWjFL8CREBxygs9PSYb9uuiQEjO284tY9pJ0jO0Tsa2f4CF7LcjX0TOzXrLdLpP","nickname":"Esthetician Nikki","followers":174900,"avatar_url":"https://p19-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/21a21e15637827f0bf37d5e2894b822d~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=9640&refresh_token=6f654970&x-expires=1791536400&x-signature=gaHHcC96sFsVf5JP2W4KqHr9TtU%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=useast5","profile_url":"https://www.tiktok.com/@skincarepronikki","video_count":117,"product_count":28,"plays":86791631,"last_seen_at":"2026-10-09T19:48:28.189649Z"}],"next_cursor":"WyI3NDgxYjllYzI0Y2VkYWJiIixbMTE3LjAsIjcyMTUyODU2ODgyNzM3OTgxODciXV0"},"meta":{"cost":"$0.0005","balance":"$9.9970","request_id":"req_5a8c4aefbdeb7b8d2d1c1c2079b2c11c"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"404":{"description":"No stored TikTok Shop shop has this id. You are not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/tiktok_shop/shop/videos":{"get":{"tags":["TikTok Shop"],"operationId":"tiktokShopShopVideos","summary":"TikTok Shop shop videos","description":"Videos that sell the shop's products, one row per video with the products it sells.","x-dashboard-cost":"$0.0005","x-example-query":{"seller_id":"7495514739648989419","page_size":"2"},"security":[{"bearerAuth":[]}],"parameters":[{"name":"seller_id","in":"query","required":true,"description":"TikTok Shop seller (shop) id, as a string.","example":"7495514739648989419","schema":{"type":"string","pattern":"^\\d{1,19}$","example":"7495514739648989419"}},{"name":"sort","in":"query","required":false,"description":"`plays` (default) or `recent` by post time.","schema":{"type":"string","enum":["plays","recent"],"default":"plays"},"examples":{"default":{"value":"plays","x-disabled":true}}},{"name":"cursor","in":"query","required":false,"description":"`next_cursor` of the previous page. A cursor only continues the query that issued it.","schema":{"type":"string","minLength":1,"maxLength":2048}},{"name":"page_size","in":"query","required":false,"description":"Rows per page.","schema":{"type":"integer","minimum":1,"maximum":100,"default":25},"examples":{"default":{"value":25,"x-disabled":true}}}],"responses":{"200":{"description":"TikTok Shop shop videos","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":true},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"items":[{"video_id":"7573080707619130655","url":"https://www.tiktok.com/@kaycstash/video/7573080707619130655","creator":{"uid":"7446281618836603950","unique_id":"kaycstash","sec_uid":"MS4wLjABAAAALXOoBFUjbIk6yzyC5VaY4tIGaMrVVYRu7doao2EvjoFj09Jb5Olik000w0Z39EaJ","nickname":"Kayc","followers":39300,"avatar_url":"https://p19-common-sign.tiktokcdn-us.com/tos-useast8-avt-0068-tx2/e6ce29b0e7ae82f15ae148db03e77cbd~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=9640&refresh_token=3e8a7be4&x-expires=1791720000&x-signature=xx%2Fu%2F5cJ174J8vgemF68E9eF%2Ftw%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=useast8","profile_url":"https://www.tiktok.com/@kaycstash"},"product_ids":["1729606769780232427"],"caption":"Don’t sleep on this deal😳 #medicubeskincare #koreanskincare #tiktokshopcreatorpicks #medicube @medicube global ","cover_url":"https://p19-common-sign.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oYNR68fxxA2GMj7QGzfQAnFUfQYWQ4TekJitYo~tplv-tiktokx-origin.image?dr=9636&x-expires=1791720000&x-signature=RO7DhCuqOT8pHxxm%2Fh3bkLnK%2Bdc%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=useast5","posted_at":"2025-11-15T22:21:15Z","plays":120974794,"likes":351198,"comments":2010,"shares":24700,"duration":63,"ad_label":"Creator earns commission","via_anchor":true,"via_product_page":true,"first_seen_at":"2026-10-09T12:20:54.455282Z","last_seen_at":"2026-10-09T19:29:48.074381Z"},{"video_id":"7564192718474202399","url":"https://www.tiktok.com/@_serahmichelle/video/7564192718474202399","creator":{"uid":"6832482000264446981","unique_id":"_serahmichelle","sec_uid":"MS4wLjABAAAAWFyBOWFhcWTXcTPP6WwMJMz8IWAniZUR0Wu97RBBwXlpeDZ7Is-x-aR16DcKASdo","nickname":"Serah Michelle","followers":11100,"avatar_url":"https://p16-common-sign.tiktokcdn-us.com/tos-useast8-avt-0068-tx2/e5d88e10199cef6b43ea28c0cc4d2003~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=9640&refresh_token=a0435f29&x-expires=1791522000&x-signature=OtaQtg1MfPyRw2dO%2BMGMZqRpKtQ%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=useast8","profile_url":"https://www.tiktok.com/@_serahmichelle"},"product_ids":["1731192157304754411"],"caption":null,"cover_url":null,"posted_at":"2025-10-22T23:31:16Z","plays":49423444,"likes":220623,"comments":null,"shares":null,"duration":null,"ad_label":"Creator earns commission","via_anchor":false,"via_product_page":true,"first_seen_at":"2026-10-09T19:37:17.789032Z","last_seen_at":"2026-10-09T19:37:17.789032Z"}],"next_cursor":"WyI0ZTc5MGQ2YmJmMjc4MzJmIixbNDk0MjM0NDQuMCwiNzU2NDE5MjcxODQ3NDIwMjM5OSJdXQ"},"meta":{"cost":"$0.0005","balance":"$9.9965","request_id":"req_0202fa545687f426d5bd218b2454a2d2"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"404":{"description":"No stored TikTok Shop shop has this id. You are not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/tiktok_shop/creator":{"get":{"tags":["TikTok Shop"],"operationId":"tiktokShopCreator","summary":"TikTok Shop creator","description":"The shop side of a creator: their TikTok account once resolved, video, product and shop counts, the shops and products their videos sell (most videos first), and their top selling videos by plays. It reads stored TikTok Shop data only and never crawls, so read any other TikTok account with `/v1/tiktok/user_detail`.","x-dashboard-cost":"$0.0005","x-example-query":{"creator":"kymieann1"},"security":[{"bearerAuth":[]}],"parameters":[{"name":"creator","in":"query","required":true,"description":"A creator uid (digits) or TikTok handle. A handle made only of digits needs its leading `@`.","example":"kymieann1","schema":{"type":"string","pattern":"^@?[A-Za-z0-9._]{1,64}$","example":"kymieann1"}}],"responses":{"200":{"description":"TikTok Shop creator","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":true},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"uid":"7005009457713447941","unique_id":"kymieann1","sec_uid":"MS4wLjABAAAAMD5Nh6e1GdhYzIcYFGth9fQDsUHn6l-7LoDwn-IFFo-y8r5zh4iEw8B3EzyaqJ71","nickname":"Kymie Ann","followers":113400,"avatar_url":"https://f005.backblazeb2.com/file/influencer-prod/production/crawler/tiktok_account/1555734.webp","profile_url":"https://www.tiktok.com/@kymieann1","region":"US","seed_video_id":"7520655587932130615","resolved_at":"2026-10-14T21:52:57.493475Z","timeline_at":"2026-10-14T21:54:20.239126Z","first_seen_at":"2026-10-12T14:02:38.473228Z","last_seen_at":"2026-10-15T12:01:53.900123Z","full_name":"Kymie Ann","is_verified":false,"posts_count":1717,"heart_count":2500000,"counts":{"videos":222,"products":236,"shops":189},"shops":[{"seller_id":"7495847086510213337","region":"US","shop_name":"EXSIVIA","logo_url":"https://f005.backblazeb2.com/file/influencer-prod/production/crawler/tiktok_shop_seller/7495847086510213337.webp","is_brand":null,"rating":4.6,"followers":61438,"sold_count":192287,"product_count":35,"on_sell_product_count":35,"review_count":28177,"video_count":2912,"units_7d":237,"units_30d":237,"gmv_30d":3989.17,"currency":"USD","creator_count":null,"selling_video_count":null,"first_seen_at":"2026-10-12T13:49:36.087703Z","updated_at":"2026-10-13T14:03:23.785227Z","creator_videos":4,"creator_products":4},{"seller_id":"8647769220043739686","region":"US","shop_name":"Sleek Sleep","logo_url":"https://f005.backblazeb2.com/file/influencer-prod/production/crawler/tiktok_shop_seller/8647769220043739686.webp","is_brand":null,"rating":4.7,"followers":13422,"sold_count":470551,"product_count":36,"on_sell_product_count":36,"review_count":59644,"video_count":2262,"units_7d":4210,"units_30d":4210,"gmv_30d":89502.16,"currency":"USD","creator_count":null,"selling_video_count":null,"first_seen_at":"2026-10-12T13:46:10.418170Z","updated_at":"2026-10-13T04:11:25.129507Z","creator_videos":3,"creator_products":3}],"products":[{"product_id":"1729454915802075999","seller_id":"7495446497289931615","region":"US","title":"New!Sttes Perfume 05#（VANILLA ORCHID SANDALWOOD） - Eau De Perfume 100ml (3.4fl Oz)  Woody food tune (Vanilla+Orchid+Sandalwood), Aromatic Scent, Captivating Scents,back to school","image_url":"https://api.virev.ai/v1/media/tiktok_shop_product/1729454915802075999/image?e=1792713600&s=8efdf02c0cf24a495228954fa209eed7","canonical_url":"https://shop.tiktok.com/us/pdp/eau-de-perfume-509-by-sttes-vanilla-orchid-sandalwood-100ml/1729454915802075999","currency":"USD","sale_price":50,"origin_price":50,"discount":0,"sold_count":37018,"units_7d":25,"units_30d":25,"gmv_30d":1250,"rating":4.6,"review_count":4861,"status":"on_sale","first_seen_at":"2026-10-12T14:22:08.864008Z","creator_videos":2},{"product_id":"1732376094767681703","seller_id":"8647124233897349287","region":"US","title":"Pearl Drilled Letter off Women's Plush Slippers Footwear, Comfortable Cross Strap Design, Memory Foam, Perfect Home Gift for Wife","image_url":"https://api.virev.ai/v1/media/tiktok_shop_product/1732376094767681703/image?e=1792713600&s=f6af73b2438a50964ce43c500dd5819e","canonical_url":"https://shop.tiktok.com/us/pdp/pearl-drilled-letter-slippers-memory-foam-cross-strap-gift/1732376094767681703","currency":"USD","sale_price":8.21,"origin_price":15.79,"discount":0.4801,"sold_count":715,"units_7d":22,"units_30d":22,"gmv_30d":180.62,"rating":4.5,"review_count":81,"status":"on_sale","first_seen_at":"2026-10-12T14:02:38.473228Z","creator_videos":2}],"top_videos":[{"video_id":"7531965987927756046","url":"https://www.tiktok.com/@kymieann1/video/7531965987927756046","creator":{"uid":"7005009457713447941","unique_id":"kymieann1","sec_uid":"MS4wLjABAAAAMD5Nh6e1GdhYzIcYFGth9fQDsUHn6l-7LoDwn-IFFo-y8r5zh4iEw8B3EzyaqJ71","nickname":"Kymie Ann","followers":113400,"avatar_url":"https://f005.backblazeb2.com/file/influencer-prod/production/crawler/tiktok_account/1555734.webp","profile_url":"https://www.tiktok.com/@kymieann1"},"product_ids":["1730856024524820840"],"caption":null,"cover_url":null,"posted_at":"2025-07-28T03:15:33Z","plays":14602023,"likes":186970,"comments":null,"shares":null,"duration":null,"ad_label":"Creator earns commission","via_anchor":false,"via_product_page":true,"first_seen_at":"2026-10-12T22:00:48.937778Z","last_seen_at":"2026-10-12T22:00:48.937778Z"},{"video_id":"7387592902387551519","url":"https://www.tiktok.com/@kymieann1/video/7387592902387551519","creator":{"uid":"7005009457713447941","unique_id":"kymieann1","sec_uid":"MS4wLjABAAAAMD5Nh6e1GdhYzIcYFGth9fQDsUHn6l-7LoDwn-IFFo-y8r5zh4iEw8B3EzyaqJ71","nickname":"Kymie Ann","followers":113400,"avatar_url":"https://f005.backblazeb2.com/file/influencer-prod/production/crawler/tiktok_account/1555734.webp","profile_url":"https://www.tiktok.com/@kymieann1"},"product_ids":["1729449960929989466"],"caption":null,"cover_url":null,"posted_at":"2024-07-04T01:53:50Z","plays":2540706,"likes":171681,"comments":null,"shares":null,"duration":null,"ad_label":null,"via_anchor":false,"via_product_page":true,"first_seen_at":"2026-10-13T19:04:51.681396Z","last_seen_at":"2026-10-13T19:04:51.681396Z"}]},"meta":{"cost":"$0.0005","balance":"$597.5716","request_id":"req_8c202dbbebcce52b56fb3ea1a9e1cc40"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"404":{"description":"No stored TikTok Shop creator matches this uid or handle. A TikTok account answers 404 here until one of its videos sells through TikTok Shop and we store it. You are not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/tiktok_shop/creator/videos":{"get":{"tags":["TikTok Shop"],"operationId":"tiktokShopCreatorVideos","summary":"TikTok Shop creator videos","description":"The creator's selling videos, each with the products it sells.","x-dashboard-cost":"$0.0005","x-example-query":{"creator":"kymieann1","page_size":"2"},"security":[{"bearerAuth":[]}],"parameters":[{"name":"creator","in":"query","required":true,"description":"A creator uid (digits) or TikTok handle. A handle made only of digits needs its leading `@`.","example":"kymieann1","schema":{"type":"string","pattern":"^@?[A-Za-z0-9._]{1,64}$","example":"kymieann1"}},{"name":"sort","in":"query","required":false,"description":"`plays` (default) or `recent` by post time.","schema":{"type":"string","enum":["plays","recent"],"default":"plays"},"examples":{"default":{"value":"plays","x-disabled":true}}},{"name":"cursor","in":"query","required":false,"description":"`next_cursor` of the previous page. A cursor only continues the query that issued it.","schema":{"type":"string","minLength":1,"maxLength":2048}},{"name":"page_size","in":"query","required":false,"description":"Rows per page.","schema":{"type":"integer","minimum":1,"maximum":100,"default":25},"examples":{"default":{"value":25,"x-disabled":true}}}],"responses":{"200":{"description":"TikTok Shop creator videos","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":true},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"items":[{"video_id":"7531965987927756046","url":"https://www.tiktok.com/@kymieann1/video/7531965987927756046","creator":{"uid":"7005009457713447941","unique_id":"kymieann1","sec_uid":"MS4wLjABAAAAMD5Nh6e1GdhYzIcYFGth9fQDsUHn6l-7LoDwn-IFFo-y8r5zh4iEw8B3EzyaqJ71","nickname":"Kymie Ann","followers":113400,"avatar_url":"https://f005.backblazeb2.com/file/influencer-prod/production/crawler/tiktok_account/1555734.webp","profile_url":"https://www.tiktok.com/@kymieann1"},"product_ids":["1730856024524820840"],"caption":null,"cover_url":null,"posted_at":"2025-07-28T03:15:33Z","plays":14602023,"likes":186970,"comments":null,"shares":null,"duration":null,"ad_label":"Creator earns commission","via_anchor":false,"via_product_page":true,"first_seen_at":"2026-10-12T22:00:48.937778Z","last_seen_at":"2026-10-12T22:00:48.937778Z"},{"video_id":"7387592902387551519","url":"https://www.tiktok.com/@kymieann1/video/7387592902387551519","creator":{"uid":"7005009457713447941","unique_id":"kymieann1","sec_uid":"MS4wLjABAAAAMD5Nh6e1GdhYzIcYFGth9fQDsUHn6l-7LoDwn-IFFo-y8r5zh4iEw8B3EzyaqJ71","nickname":"Kymie Ann","followers":113400,"avatar_url":"https://f005.backblazeb2.com/file/influencer-prod/production/crawler/tiktok_account/1555734.webp","profile_url":"https://www.tiktok.com/@kymieann1"},"product_ids":["1729449960929989466"],"caption":null,"cover_url":null,"posted_at":"2024-07-04T01:53:50Z","plays":2540706,"likes":171681,"comments":null,"shares":null,"duration":null,"ad_label":null,"via_anchor":false,"via_product_page":true,"first_seen_at":"2026-10-13T19:04:51.681396Z","last_seen_at":"2026-10-13T19:04:51.681396Z"}],"next_cursor":"WyIwNDA0ZjYzZDk3ZDNhZmY1IixbMjU0MDcwNi4wLCI3Mzg3NTkyOTAyMzg3NTUxNTE5Il1d"},"meta":{"cost":"$0.0005","balance":"$597.5711","request_id":"req_6c47ff9ea73d4fb2ebbb2308ca9f7779"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"404":{"description":"No stored TikTok Shop creator matches this uid or handle. A TikTok account answers 404 here until one of its videos sells through TikTok Shop and we store it. You are not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/meta_ads/stored/advertisers":{"get":{"tags":["Meta Ads"],"operationId":"maStoredAdvertisers","summary":"Search advertisers","description":"The tracked advertiser directory: a prefix match on Page name or handle, sorted by active ads, total ads or Page likes. Without `query` it lists every tracked advertiser. `total` counts every match, and `next_cursor` (`{ offset }`) with `has_more` names the next page. Use a `pageId` with `/v1/meta_ads/stored/advertiser`, `/v1/meta_ads/stored/advertiser/ads`, `/v1/meta_ads/stored/insights` or `/v1/meta_ads/stored/search`.","x-dashboard-cost":"$0.0010","x-example-query":{"query":"nike","limit":"2"},"security":[{"bearerAuth":[]}],"parameters":[{"name":"query","in":"query","required":false,"description":"Start of the Page name or handle.","schema":{"type":"string","maxLength":120,"example":"nike"},"examples":{"default":{"value":"nike","x-disabled":true}}},{"name":"sort_by","in":"query","required":false,"description":"Sort order.","schema":{"type":"string","enum":["activeAds","totalAds","likes"],"default":"activeAds"},"examples":{"default":{"value":"activeAds","x-disabled":true}}},{"name":"limit","in":"query","required":false,"description":"Rows to return.","schema":{"type":"integer","minimum":1,"maximum":50,"default":24},"examples":{"default":{"value":24,"x-disabled":true}}},{"name":"offset","in":"query","required":false,"description":"Rows to skip.","schema":{"type":"integer","minimum":0,"maximum":10000,"default":0},"examples":{"default":{"value":0,"x-disabled":true}}}],"responses":{"200":{"description":"Search advertisers","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":true},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"advertisers":[{"pageId":"15087023444","pageName":"Nike","pageUsername":"nike","category":"Sportswear Store","verification":"BLUE_VERIFIED","profilePicUrl":"https://api.virev.ai/v1/media/meta_advertiser/15087023444/profile_pic?e=1793750400&s=98b4bdad4fd7074de644339239015e70","igUsername":"nike","country":null,"likes":39494438,"igFollowers":290888123,"adCount":90,"activeAdCount":22,"lastCrawledAt":"2026-10-27T21:34:15.574903Z","deepCrawledAt":"2026-09-30T06:14:00.881296Z","isTracked":true},{"pageId":"103164259268905","pageName":"Nike Seoul","pageUsername":"nikeseoul","category":"Brand","verification":"NOT_VERIFIED","profilePicUrl":"https://api.virev.ai/v1/media/meta_advertiser/103164259268905/profile_pic?e=1793750400&s=e966b7b00abe4e43f846c19d22a52392","igUsername":"nikeseoul","country":null,"likes":27010,"igFollowers":330824,"adCount":0,"activeAdCount":0,"lastCrawledAt":null,"deepCrawledAt":null,"isTracked":false}],"total":14,"next_cursor":{"offset":2},"has_more":true},"meta":{"cost":"$0.0010","balance":"$49.9785","request_id":"req_3c2af500dc0588dd10bcee4312c39f6c"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/meta_ads/stored/advertisers/lookup":{"post":{"tags":["Meta Ads"],"operationId":"maStoredAdvertisersLookup","summary":"Look up advertisers","description":"Many tracked advertisers in one call, for a watchlist: each row adds the latest ad start (`latestAdStartedAt`), the newest ingest time (`ingestCursor`), and `newAdCount`, the ads ingested after that page's `newSince` cursor. Store `ingestCursor` as the next `newSince`. Billed at the advertiser price per advertiser returned; an id the corpus does not hold is left out and not billed.\n\nA POST: the ids are a JSON body. Unknown fields are ignored; invalid types return `400` before billing.","x-dashboard-cost":"$0.0002","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["pageIds"],"properties":{"pageIds":{"type":"array","minItems":1,"maxItems":100,"items":{"type":"string","pattern":"^\\d{1,40}$"}},"newSince":{"type":"object","description":"pageId to an ISO date or datetime. Every key must be in `pageIds`.","additionalProperties":{"type":"string","example":"2026-10-01"}}}},"example":{"pageIds":["9465008123","15087023444"],"newSince":{"9465008123":"2026-10-01"}}}}},"responses":{"200":{"description":"Look up advertisers","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":true},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"advertisers":[{"pageId":"9465008123","pageName":"Amazon.com","pageUsername":"katrinaforeal","category":"Brand","verification":null,"profilePicUrl":"https://scontent.fyto1-2.fna.fbcdn.net/v/t39.35426-6/841736001_1573511383985637_1424000039841587378_n.jpg?stp=dst-jpg_s60x60_tt6&_nc_cat=104&_nc_map=urlgen_bucketless&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=uXYo2CjQlNMQ7kNvwGZOSfO&_nc_oc=AdqZvu3UjJlp8Rk3Osm2mFaPYG7-XrW5uH8uNkAxUdDq8K1LJQUSIlMrJ7Gj7h1_QOw&_nc_zt=14&_nc_ht=scontent.fyto1-2.fna&_nc_gid=xBw2JfNeO9QvLSC8xO5cKw&_nc_ss=7b289&oh=00_AQMshxv-ILu__pQ18uX8pL1k7Cadrhtp5qahs1lFEaxVPA&oe=6ACEDC05","igUsername":null,"country":null,"likes":14344,"igFollowers":null,"adCount":3995,"activeAdCount":3572,"lastCrawledAt":"2026-10-09T17:25:40.238919Z","deepCrawledAt":"2026-10-09T17:25:40.249946Z","isTracked":false,"latestAdStartedAt":"2026-10-09T07:00:00Z","ingestCursor":"2026-10-09T17:25:40.238919Z","newAdCount":3984},{"pageId":"15087023444","pageName":"Nike","pageUsername":"nike","category":"Sportswear","verification":null,"profilePicUrl":"https://scontent-lhr11-1.xx.fbcdn.net/v/t39.35426-6/158841078_220175766515160_5243641419988248381_n.jpg?stp=dst-jpg_s60x60_tt6&_nc_cat=106&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=dtfZ-RKNjxEQ7kNvwHPW5lA&_nc_oc=AdruTg7rzyMcvb80xVo8q_LWkiYFMVFF6idy311ieWfwKaDodFRF1NlIamxXOMeEQXM&_nc_zt=14&_nc_ht=scontent-lhr11-1.xx&_nc_gid=mMX5xGMShjzvHjgp85YYBA&_nc_ss=7b289&oh=00_AQN8eAMQc5WcqQG7ygQMIfvILSIy8H3LVbYNm3jzN77zPg&oe=6AD2A62A","igUsername":null,"country":null,"likes":39504399,"igFollowers":null,"adCount":0,"activeAdCount":0,"lastCrawledAt":"2026-10-12T13:07:46.356684Z","deepCrawledAt":null,"isTracked":false,"latestAdStartedAt":"2026-10-06T07:00:00Z","ingestCursor":"2026-10-12T13:07:46.356684Z","newAdCount":null}]},"meta":{"cost":"$0.0004","balance":"$9.9921","request_id":"req_4736a626aec97844ef91b5d69f526816"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/creators/search":{"post":{"tags":["Creator Search"],"operationId":"creatorsSearch","summary":"Find creators by brand collabs","description":"Creators who collaborated with a brand, newest collab first. `brandHandles` and the `collabSince` window apply to the same collab, so a creator whose only glossier collab is a year old does not match \"glossier in the last week\". Add free text, followers, country, niche and engagement filters, sort by last_collab, followers, relevance or engagement, and ask for `facets`. Each row carries its collab edges.\n\nStored index only, never a crawl. `total` is the exact number of matches, counted at most 2 minutes ago, with `totalExact` true. The first call of a broad search can take a few seconds longer while its count runs. If the count fails, `total` is the 10,000 floor and `totalExact` is false. A profile or creator page read with `searchAfter` carries no `total`. If the index does not answer in time, the page comes back empty with `degraded: true` and costs $0; retry the call. Custom AI column fields (`userFields`, `userScores`) belong to other accounts and are never accepted or returned. Rows carry no contact data: emails, phones, contact blocks, linked social accounts and bio links are removed, and contact filters return 400. Find contacts with /v1/contacts/find.","x-dashboard-cost":"$0.0010","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"brandHandles":{"type":"array","maxItems":100,"items":{"type":"string","maxLength":100},"description":"Creators with a collab edge to any of these brand handles."},"collabSince":{"type":"string","maxLength":40,"description":"Collab window start on the same edge: ISO date or date math such as now-7d."},"collabUntil":{"type":"string","maxLength":40,"description":"Collab window end: ISO date or date math."},"query":{"type":"string","maxLength":500,"description":"Free text over profile text."},"platform":{"type":"string","maxLength":32},"country":{"type":"string","maxLength":100},"niches":{"type":"array","maxItems":100,"items":{"type":"string","maxLength":100},"description":"Any of these primary niches."},"followersMin":{"type":"integer","minimum":0,"description":"Followers, lower bound."},"followersMax":{"type":"integer","minimum":0,"description":"Followers, upper bound."},"engagementMin":{"type":"number","description":"Engagement floor in percent, e.g. 3 for 3%."},"sortBy":{"type":"string","enum":["last_collab","followers","relevance","engagement"],"default":"last_collab"},"sortDir":{"type":"string","enum":["asc","desc"],"default":"desc"},"limit":{"type":"integer","minimum":1,"maximum":200,"default":50,"description":"Rows per page."},"offset":{"type":"integer","minimum":0,"maximum":10000,"default":0,"description":"Rows to skip."},"facets":{"type":"boolean","description":"Add counts by brand, country, niche and follower bucket."},"facetNames":{"type":"array","minItems":1,"maxItems":5,"items":{"type":"string","enum":["brandHandles","countries","niches","categories","followerBuckets"]},"description":"With facets, only these facets. brandHandles counts every collab edge of the matches and is the slow one on a broad query."},"profileIds":{"type":"array","maxItems":1000,"items":{"type":"integer","minimum":1},"description":"Only these profile ids."}}},"example":{"query":"fitness","sortBy":"followers","limit":2,"facets":true,"facetNames":["countries","niches","followerBuckets"]}}}},"responses":{"200":{"description":"Stored index rows.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":true},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"creators":[{"id":136010,"platform":"instagram","username":"rohittt_09_","fullName":"𝐑𝐨𝐡𝐢𝐭 𝐙𝐢𝐧𝐣𝐮𝐫𝐤𝐞 🇮🇳","profilePicUrl":"https://instagram.fala4-2.fna.fbcdn.net/v/t51.82787-19/628815878_18157501483455704_3666583749604594700_n.jpg?stp=dst-jpg_e0_s150x150_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby45NzIuYzIifQ&_nc_ht=instagram.fala4-2.fna.fbcdn.net&_nc_cat=1&_nc_oc=Q6cZ2gFnQFxrz1y2Chn4lNpdJnYw9okiUK5ttV34atkP0r3JpQQnJiecs3m9lOI0RJepQYs&_nc_ohc=_kGoI4lHIOEQ7kNvwHIPQLC&_nc_gid=V0GvAzSf9mkAOIMlUw98oQ&edm=ACWDqb8BAAAA&ccb=7-5&oh=00_AQKvb4OUkBAch4DD2bev-XUdlkp4PSlkeqKEkKC9Mz3zgw&oe=6AA4B3C9&_nc_sid=ee9879","profilePicCdnUrl":"https://f005.backblazeb2.com/file/influencer-dev/crawler/instagram_account/115989.webp","followers":27906238,"isVerified":true,"country":"India","primaryNiche":"Fashion and lifestyle entertainment","engagementRatio":2.253979916605026,"lastPostedAt":"2026-09-05T13:18:19+00:00","collabs":[{"brandHandle":"rohinizinjurke19298","platform":"instagram","firstAt":"2025-10-21T15:37:42+00:00","lastAt":"2026-08-28T10:09:23+00:00","postCount":2},{"brandHandle":"tadkaonjiohotstar","platform":"instagram","firstAt":"2026-04-22T13:45:18+00:00","lastAt":"2026-04-22T13:45:18+00:00","postCount":1}],"lastCollabAt":"2026-08-28T10:09:23+00:00","relevanceScore":7.71},{"id":133728,"platform":"instagram","username":"anllela_sagra","fullName":"Anllela Sagra","profilePicUrl":"https://scontent-mia5-2.cdninstagram.com/v/t51.2885-19/357901523_283456887688632_7297569822779759328_n.jpg?stp=dst-jpg_s320x320_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby45NTQuYzIifQ&_nc_ht=scontent-mia5-2.cdninstagram.com&_nc_cat=100&_nc_oc=Q6cZ2gGD_sywNa-j2Jiv1J43ieDxPRMR3Ge5Qj5UVd_xR2JB0SUCb8JMrRUkAdHYhJ-_7Z8&_nc_ohc=P55pTmA_wxQQ7kNvwHA-JbT&_nc_gid=59YJMD7rDwOBnSVzgFGuTQ&edm=AOQ1c0wBAAAA&ccb=7-5&oh=00_AQPq_EpxoSU08DlFsSG7ZK2hYVlpLmcw_w3-oVoZCEDyBg&oe=6ACAD40B&_nc_sid=8b3546","profilePicCdnUrl":"https://f005.backblazeb2.com/file/influencer-dev/staging/crawler/instagram_account/114200.webp","followers":25893542,"isVerified":true,"country":"Colombia","primaryNiche":"fitness","engagementRatio":0.2326854317574629,"lastPostedAt":"2026-09-02T18:14:47+00:00","collabs":[{"brandHandle":"ajkphotography","platform":"instagram","firstAt":"2026-07-29T18:54:31+00:00","lastAt":"2026-07-29T18:54:31+00:00","postCount":1},{"brandHandle":"camialgavi","platform":"instagram","firstAt":"2026-01-21T21:49:19+00:00","lastAt":"2026-04-30T13:07:57+00:00","postCount":2}],"lastCollabAt":"2026-07-29T18:54:31+00:00","relevanceScore":21.89}],"total":9073,"facets":{"countries":[{"code":"United States","count":431},{"code":"unknown","count":225}],"niches":[{"niche":"fitness","count":720},{"niche":"beauty","count":173}],"followerBuckets":[{"bucket":"0-10k","count":3677},{"bucket":"10k-100k","count":2334}]},"degraded":false},"meta":{"cost":"$0.0010","balance":"$9.9875","request_id":"req_510ae1792ebe3fdd2c66f3848e54f5c5"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/creators/profiles/search":{"post":{"tags":["Creator Search"],"operationId":"creatorsProfileSearch","summary":"Search profiles","description":"Profile search with the full filter set: followers, niche, country, language, gender, engagement and posting ranges. Rows carry the stored profile, AI enrichment fields, engagement statistics and recent post previews; set `omit: [\"previewPosts\"]` for smaller pages, or name the row fields you read in `fields`. Up to 200 rows per page.\n\nStored index only, never a crawl. `total` is the exact number of matches, counted at most 2 minutes ago, with `totalExact` true. The first call of a broad search can take a few seconds longer while its count runs. If the count fails, `total` is the 10,000 floor and `totalExact` is false. A profile or creator page read with `searchAfter` carries no `total`. If the index does not answer in time, the page comes back empty with `degraded: true` and costs $0; retry the call. Rows carry no contact data: emails, phones, contact blocks, linked social accounts and bio links are removed, and contact filters return 400. Find contacts with /v1/contacts/find.","x-dashboard-cost":"$0.0010","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"query":{"type":"string","maxLength":500,"description":"Free text over handle, name, bio and AI summary."},"usernames":{"type":"array","maxItems":1000,"items":{"type":"string","maxLength":100},"description":"Only these handles."},"profileIds":{"type":"array","maxItems":1000,"items":{"type":"integer","minimum":1},"description":"Only these profile ids."},"platform":{"type":"string","maxLength":32,"description":"One platform, e.g. instagram."},"platforms":{"type":"array","maxItems":10,"items":{"type":"string","maxLength":100},"description":"Any of these platforms."},"followersMin":{"type":"integer","minimum":0,"description":"Followers, lower bound."},"followersMax":{"type":"integer","minimum":0,"description":"Followers, upper bound."},"verified":{"type":"boolean"},"niche":{"type":"string","maxLength":100,"description":"Primary niche; see /v1/creators/filter-options."},"niches":{"type":"array","maxItems":100,"items":{"type":"string","maxLength":100},"description":"Any of these primary niches."},"subNiches":{"type":"array","maxItems":100,"items":{"type":"string","maxLength":100},"description":"Any of these sub-niches."},"accountRole":{"type":"string","maxLength":64},"accountRoles":{"type":"array","maxItems":20,"items":{"type":"string","maxLength":100}},"entityType":{"type":"string","maxLength":64},"gender":{"type":"string","maxLength":32},"genders":{"type":"array","maxItems":10,"items":{"type":"string","maxLength":100}},"ageRange":{"type":"string","maxLength":32},"ageRanges":{"type":"array","maxItems":10,"items":{"type":"string","maxLength":100}},"country":{"type":"string","maxLength":100,"description":"Country name as filter-options lists it, e.g. United States."},"countries":{"type":"array","maxItems":100,"items":{"type":"string","maxLength":100}},"language":{"type":"string","maxLength":100,"description":"Language name, e.g. English."},"languages":{"type":"array","maxItems":50,"items":{"type":"string","maxLength":100}},"profession":{"type":"string","maxLength":100},"commercialIntent":{"type":"string","maxLength":64},"brandSafety":{"type":"string","maxLength":64},"hasSocial":{"type":"boolean"},"hasYoutube":{"type":"boolean"},"hasTiktok":{"type":"boolean"},"hasLinkedin":{"type":"boolean"},"hasX":{"type":"boolean"},"hasInstagram":{"type":"boolean"},"hasWebsite":{"type":"boolean"},"hasEnrichment":{"type":"boolean","description":"Has an AI enrichment."},"postsCountMin":{"type":"integer","minimum":0,"description":"Post count, lower bound."},"postsCountMax":{"type":"integer","minimum":0,"description":"Post count, upper bound."},"followingMin":{"type":"integer","minimum":0,"description":"Following count, lower bound."},"followingMax":{"type":"integer","minimum":0,"description":"Following count, upper bound."},"engagementMin":{"type":"number","description":"Engagement ratio, lower bound."},"engagementMax":{"type":"number","description":"Engagement ratio, upper bound."},"engagementRatioMin":{"type":"number","description":"Engagement ratio, lower bound."},"engagementRatioMax":{"type":"number","description":"Engagement ratio, upper bound."},"brandCollabRatioMin":{"type":"number","description":"Share of posts that are brand collabs, lower bound."},"brandCollabRatioMax":{"type":"number","description":"Share of posts that are brand collabs, upper bound."},"averageBrandCollabEngagementRatioMin":{"type":"number","description":"Average brand collab engagement ratio, lower bound."},"averageBrandCollabEngagementRatioMax":{"type":"number","description":"Average brand collab engagement ratio, upper bound."},"averageBrandCollabReelViewsMin":{"type":"number","description":"Average brand collab reel views, lower bound."},"averageBrandCollabReelViewsMax":{"type":"number","description":"Average brand collab reel views, upper bound."},"reelRatioMin":{"type":"number","description":"Share of posts that are reels, lower bound."},"reelRatioMax":{"type":"number","description":"Share of posts that are reels, upper bound."},"medianPostGapMin":{"type":"number","description":"Median days between posts, lower bound."},"medianPostGapMax":{"type":"number","description":"Median days between posts, upper bound."},"medianDaysBetweenPostsMin":{"type":"number","description":"Median days between posts, lower bound."},"medianDaysBetweenPostsMax":{"type":"number","description":"Median days between posts, upper bound."},"lastPostedAfter":{"type":"string","description":"Last post on or after this ISO date.","example":"2026-01-01"},"lastPostedBefore":{"type":"string","description":"Last post before this ISO date.","example":"2026-01-01"},"sortBy":{"type":"string","maxLength":64,"description":"Any stored metric the profile rows carry, e.g. followers, engagementRatio, lastPostedAt, or relevanceScore with a query. An unknown key is a 400."},"sortDir":{"type":"string","enum":["asc","desc"],"default":"desc"},"limit":{"type":"integer","minimum":1,"maximum":200,"default":50,"description":"Rows per page."},"offset":{"type":"integer","minimum":0,"maximum":10000,"default":0,"description":"Rows to skip."},"omit":{"type":"array","items":{"type":"string","enum":["previewPosts"]},"description":"Leave previewPosts out of each row."},"fields":{"type":"array","minItems":1,"maxItems":106,"items":{"type":"string","enum":["id","platform","region","heartCount","username","fullName","biography","profilePicUrl","profilePicCdnUrl","followers","following","postsCount","avgEngagement","isVerified","isPrivate","isAuthoritative","isBusinessAccount","isProfessionalAccount","categoryName","businessCategoryName","pronouns","bioHashtags","hasChannel","hasSocial","hasYoutube","hasTiktok","hasLinkedin","hasX","hasInstagram","hasDouyin","hasXiaohongshu","hasWebsite","firstScrapedAt","lastScrapedAt","scrapeCount","accountRole","primaryNiche","subNiches","tagline","nicheAuthority","commercialIntent","gender","ageRange","race","country","city","language","bioSummary","socialCount","socialPlatforms","aiEnrichment","engagementRatio","averagePostEngagementRatio","averageReelEngagementRatio","averageContentEngagementRatio","postEngagement","reelEngagement","sumEngagement","averagePostLikes","averageReelLikes","averagePostComments","averageReelComments","averageReelViews","averageBrandCollabReelViews","reelViews25thPercentile","reelViews75thPercentile","postLikes25thPercentile","postLikes75thPercentile","reelLikes25thPercentile","reelLikes75thPercentile","avgPostLikes","avgReelLikes","avgPostComments","avgReelComments","avgReelViews","medianLikes","medianComments","medianViews","medianPostLikes","medianPostComments","medianReelLikes","medianReelComments","medianReelViews","postCountActual","reelCountActual","totalContentCount","reelRatio","paidPartnershipRate","paidPartnershipCount","brandCollabRatio","brandCollabCount","averageBrandCollabEngagementRatio","medianPostGap","medianDaysBetweenPosts","medianPostFreqDays","lastPostedAt","collabScore","previewPosts","topCollaborators","collaboratorUsernames","profileSearchProjectionVersion","relevanceScore","campaignRelevance","enrichedAt","hasEnrichment","identity"]},"description":"Row fields to return. Each row then holds `id` plus these fields, with the same values as a full row, and the read is smaller and faster. A name `omit` also lists is left out. `enrichedAt` is deprecated: it is always null, so use `hasEnrichment`, which says whether the AI read of the profile ran."}}},"example":{"query":"natgeo","limit":2}}}},"responses":{"200":{"description":"Stored index rows.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":true},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"profiles":[{"id":1172,"platform":"instagram","region":null,"heartCount":null,"username":"natgeo","fullName":"National Geographic","biography":"Step into wonder and find your inner explorer with National Geographic 🌎","profilePicUrl":"https://scontent-lhr11-1.cdninstagram.com/v/t51.82787-19/683576066_18653628823019133_9051036240972105113_n.jpg?stp=dst-jpg_s150x150_tt6&_nc_cat=1&ccb=7-5&_nc_sid=f7ccc5&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLnd3dy40MDAuQzMifQ%3D%3D&_nc_ohc=9DX3oxEQASoQ7kNvwHBMtqB&_nc_oc=AdoLsT7XulD3rUZmwPiL2zP84RGpDCno3HSdeQRzsJrWkeN7whc2taFWn-3j4c8V72s&_nc_zt=24&_nc_ht=scontent-lhr11-1.cdninstagram.com&_nc_gid=r77wIY_Pv1292hvHaSJsDA&_nc_ss=7ba8c&oh=00_AQMYabCNa-eOli00xUmqNA823ynF8gdlGwnz9JhIxkpVUA&oe=6AD2B02B","profilePicCdnUrl":"https://f005.backblazeb2.com/file/influencer-dev/staging/crawler/instagram_account/1070.webp","followers":268396140,"following":194,"postsCount":null,"avgEngagement":0.03781644208196636,"isVerified":true,"isPrivate":false,"isAuthoritative":false,"isBusinessAccount":false,"isProfessionalAccount":false,"categoryName":null,"businessCategoryName":null,"pronouns":null,"bioHashtags":[],"hasChannel":false,"hasSocial":false,"hasYoutube":false,"hasTiktok":false,"hasLinkedin":false,"hasX":false,"hasInstagram":true,"hasDouyin":false,"hasXiaohongshu":false,"hasWebsite":true,"firstScrapedAt":"2026-08-04T17:05:49.468519+00:00","lastScrapedAt":"2026-10-12T13:19:36.696294+00:00","scrapeCount":272,"accountRole":"media","primaryNiche":"outdoors","subNiches":["wildlife","nature"],"tagline":"Step into wonder and find your inner explorer.","nicheAuthority":null,"commercialIntent":"fully_commercial","gender":"unknown","ageRange":null,"race":null,"country":"United States","city":null,"language":"English","bioSummary":"National Geographic’s global media account focused on exploration, science, wildlife, nature, and conservation.","socialCount":0,"socialPlatforms":[],"aiEnrichment":null,"engagementRatio":0.019117264503133318,"averagePostEngagementRatio":0.035038125899876614,"averageReelEngagementRatio":0.04126986313073214,"averageContentEngagementRatio":0.03781644208196636,"postEngagement":0.035038125899876614,"reelEngagement":0.04126986313073214,"sumEngagement":0.03781644208196636,"averagePostLikes":92738.72932330827,"averageReelLikes":109018,"averagePostComments":434.0827067669173,"averageReelComments":582.9065420560747,"averageReelViews":3445616,"averageBrandCollabReelViews":1822336.25,"reelViews25thPercentile":1527559,"reelViews75thPercentile":3543076,"postLikes25thPercentile":27322,"postLikes75thPercentile":93145,"reelLikes25thPercentile":23624.5,"reelLikes75thPercentile":78535.5,"avgPostLikes":92738.72932330827,"avgReelLikes":109018,"avgPostComments":434.0827067669173,"avgReelComments":582.9065420560747,"avgReelViews":3445616,"medianLikes":50632,"medianComments":226,"medianViews":2178419,"medianPostLikes":54378,"medianPostComments":243,"medianReelLikes":39429,"medianReelComments":206,"medianReelViews":2178419,"postCountActual":133,"reelCountActual":107,"totalContentCount":240,"reelRatio":0.44583333333333336,"paidPartnershipRate":0.0625,"paidPartnershipCount":15,"brandCollabRatio":0.0625,"brandCollabCount":15,"averageBrandCollabEngagementRatio":0.011076761387104896,"medianPostGap":0.25,"medianDaysBetweenPosts":0.25,"medianPostFreqDays":0.25,"lastPostedAt":"2026-10-12T01:00:01+00:00","collabScore":46,"previewPosts":[{"is_video":false,"comments":125,"content_type":"Carousel","image_cdn_url":"https://f005.backblazeb2.com/file/influencer-dev/staging/crawler/instagram_post/30007916.webp","is_paid_partnership":false,"image_url":"https://instagram.flhr15-1.fna.fbcdn.net/v/t51.82787-15/845178050_18706675777019133_1919409563310583917_n.jpg?stp=dst-jpg_e35_s1080x1080_sh2.08_tt6&_nc_cat=1&ig_cache_key=NDAwNTU2MjUwMDkxMzc4MDE4Ng%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6IkNBUk9VU0VMX0lURU0ueHBpZHMuMTQzOS5zZHIucmVndWxhcl9waG90by5DMyJ9&_nc_ohc=e1gruOu1jDsQ7kNvwFynfEo&_nc_oc=AdpliV4V_H2XYngBfhlXeFwi1RlIcps-ftMV_7BTD08d1FIHRp2kL69OlrqjMJ_XB3o&_nc_ad=z-m&_nc_cid=803&_nc_zt=23&_nc_ht=instagram.flhr15-1.fna&_nc_gid=3Z_HI02M7PUErexXyac3ig&_nc_ss=7a3ba&oh=00_AQO-8HkD72VG9YpT_Dn6gg86WcxqsCbnpQBgnZD61ZQ7BA&oe=6AD2A74B","caption":"Presented by @Rolex. Pangolins usually roll into a ball when threatened, which can protect them even from hungry lions. But this defense mechanism can't protect them from those who hunt them for their meat and, more recently, their scales. Conservationists, like those at the @tikkihywoodfoundation, are taking on the labor-intensive challenge of caring for orphaned and injured pangolins while also working with authorities to stop black-market trafficking of these vulnerable creatures.\n\nThrough its partnership with the National Geographic Society and as part of its Perpetual Planet Initiative, #Rolex supports expeditions exploring and protecting remarkable places around the world, a selection of which are featured in #AfricaEarthsWildHome. #PerpetualPlanet\n\nLearn more about the effort to save the pangolin at the link in bio.\n\nPhotographs by @marcuswestbergphotography","posted_at":"2026-10-12T01:00:01+00:00","shortcode":"DeWne1TF__R","views":null,"likes":94358},{"is_video":true,"comments":156,"content_type":"Video","image_cdn_url":"https://f005.backblazeb2.com/file/influencer-dev/staging/crawler/instagram_post/30007918.webp","is_paid_partnership":false,"image_url":"https://instagram.flhr15-1.fna.fbcdn.net/v/t51.82787-15/847570097_18706820542019133_7455916707765318737_n.jpg?stp=dst-jpg_e15_s640x640_tt6&_nc_cat=1&ig_cache_key=NDAwNTc3MTU4MDI3MjU4MDY4OA%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6IkNMSVBTLnhwaWRzLjEwODAuc2RyLnZpZGVvX2RlZmF1bHRfY292ZXJfZnJhbWUuQzMifQ%3D%3D&_nc_ohc=XAJEojflihAQ7kNvwEYgYxw&_nc_oc=AdpdYY8YS8JpDILeqVhPelWzGAdrel3ZglAkiJHtykWSmaUl_he8BC1811ZCF3c4t9Y&_nc_ad=z-m&_nc_cid=803&_nc_zt=23&_nc_ht=instagram.flhr15-1.fna&_nc_gid=3Z_HI02M7PUErexXyac3ig&_nc_ss=7a3ba&oh=00_AQNB3xpSAGQ7tVwIBcH-z8p6ILv-l4-um2xFsqOSrlkFag&oe=6AD2A95E","caption":"It’s snack time for these humpback whales. They use rings of bubbles like nets to concentrate fish and krill before surging through for a feast.\n\n#EuropeFromAbove is streaming on @DisneyPlus","posted_at":"2026-10-11T19:01:22+00:00","shortcode":"DeXXAddgJhQ","views":1328158,"likes":70723}],"topCollaborators":[],"collaboratorUsernames":[],"profileSearchProjectionVersion":null,"relevanceScore":124.68,"campaignRelevance":null,"identity":{"displayName":"National Geographic","displayHandle":"natgeo","stableId":null,"stableIdType":"instagram_id","externalUrl":"https://www.instagram.com/natgeo/"}},{"id":4690103,"platform":"facebook","region":null,"heartCount":null,"username":"natgeo","fullName":"National Geographic","biography":null,"profilePicUrl":"https://scontent-man2-1.xx.fbcdn.net/v/t39.30808-1/475979419_1182307929933302_8257114326919725462_n.jpg?stp=cp0_dst-jpg_tt6&cstp=mx400x400&ctp=s80x80&_nc_cat=1&ccb=1-7&_nc_sid=2d3e12&_nc_ohc=O5idV2GJX20Q7kNvwEIiOjP&_nc_oc=AdqBDaoNIEHTGkOm7lsaXYbJpuqNV_R6hq_pzvmYSV_qRduswurD1K_QrYM7BjYvI3Q&_nc_zt=24&_nc_ht=scontent-man2-1.xx&_nc_gid=Sl4hTX-P2k8X8g9Yndpkrg&_nc_ss=7b289&oh=00_AQPJPcDNEFs4V-7BpDTdU9b5YzP_Hy4Oozs85zQ-sPApDA&oe=6AD29AFD","profilePicCdnUrl":"https://f005.backblazeb2.com/file/influencer-dev/staging/crawler/facebook_account/3.webp","followers":51000000,"following":2,"postsCount":null,"avgEngagement":null,"isVerified":true,"isPrivate":false,"isAuthoritative":false,"isBusinessAccount":false,"isProfessionalAccount":false,"categoryName":"Media/news company","businessCategoryName":null,"pronouns":null,"bioHashtags":[],"hasChannel":false,"hasSocial":false,"hasYoutube":false,"hasTiktok":false,"hasLinkedin":false,"hasX":false,"hasInstagram":false,"hasDouyin":false,"hasXiaohongshu":false,"hasWebsite":false,"firstScrapedAt":"2026-10-12T12:52:51.782752+00:00","lastScrapedAt":"2026-10-12T12:59:02.855885+00:00","scrapeCount":5,"accountRole":null,"primaryNiche":null,"subNiches":[],"tagline":null,"nicheAuthority":null,"commercialIntent":null,"gender":null,"ageRange":null,"race":null,"country":null,"city":null,"language":null,"bioSummary":null,"socialCount":0,"socialPlatforms":[],"aiEnrichment":null,"engagementRatio":null,"averagePostEngagementRatio":null,"averageReelEngagementRatio":null,"averageContentEngagementRatio":null,"postEngagement":null,"reelEngagement":null,"sumEngagement":null,"averagePostLikes":null,"averageReelLikes":null,"averagePostComments":null,"averageReelComments":null,"averageReelViews":null,"averageBrandCollabReelViews":null,"reelViews25thPercentile":null,"reelViews75thPercentile":null,"postLikes25thPercentile":null,"postLikes75thPercentile":null,"reelLikes25thPercentile":null,"reelLikes75thPercentile":null,"avgPostLikes":null,"avgReelLikes":null,"avgPostComments":null,"avgReelComments":null,"avgReelViews":null,"medianLikes":null,"medianComments":null,"medianViews":null,"medianPostLikes":null,"medianPostComments":null,"medianReelLikes":null,"medianReelComments":null,"medianReelViews":null,"postCountActual":0,"reelCountActual":0,"totalContentCount":0,"reelRatio":0,"paidPartnershipRate":0,"paidPartnershipCount":0,"brandCollabRatio":0,"brandCollabCount":0,"averageBrandCollabEngagementRatio":null,"medianPostGap":null,"medianDaysBetweenPosts":null,"medianPostFreqDays":null,"lastPostedAt":null,"collabScore":8,"previewPosts":[],"topCollaborators":[],"collaboratorUsernames":[],"profileSearchProjectionVersion":null,"relevanceScore":124.68,"campaignRelevance":null,"identity":{"displayName":"National Geographic","displayHandle":"natgeo","stableId":null,"stableIdType":"facebook_user_id","externalUrl":"https://www.facebook.com/natgeo"}}],"total":109},"meta":{"cost":"$0.0010","balance":"$9.9875","request_id":"req_8da590523a2d8bc2bff625524275c388"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/creators/content/search":{"post":{"tags":["Creator Search"],"operationId":"creatorsContentSearch","summary":"Search posts","description":"Post search over captions with platform, niche, country, date, likes and paid partnership filters, and brand collab retrieval through `collabBrands` or `collabOf`. Page past offset 10000 with `searchAfter`. With `mode: \"preview\"`, the answer is the newest posts per profile in `itemsByProfileId`.\n\nStored index only, never a crawl. `total` is the exact number of matches, counted at most 2 minutes ago, with `totalExact` true. The first call of a broad search can take a few seconds longer while its count runs. If the count fails, `total` is the 10,000 floor and `totalExact` is false. A profile or creator page read with `searchAfter` carries no `total`. If the index does not answer in time, the page comes back empty with `degraded: true` and costs $0; retry the call. Custom AI column fields (`userFields`, `userScores`) belong to other accounts and are never accepted or returned. Rows carry no contact data: emails, phones, contact blocks, linked social accounts and bio links are removed, and contact filters return 400. Find contacts with /v1/contacts/find.","x-dashboard-cost":"$0.0010","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"query":{"type":"string","maxLength":500,"description":"Free text over captions."},"platform":{"type":"string","maxLength":32},"platforms":{"type":"array","maxItems":10,"items":{"type":"string","maxLength":100}},"isVideo":{"type":"boolean"},"minLikes":{"type":"integer","minimum":0},"minComments":{"type":"integer","minimum":0},"niche":{"type":"string","maxLength":100,"description":"The author's primary niche."},"country":{"type":"string","maxLength":100,"description":"The author's country."},"postedAfter":{"type":"string","description":"ISO date or datetime, e.g. 2026-01-01.","example":"2026-01-01"},"postedBefore":{"type":"string","description":"ISO date or datetime, e.g. 2026-01-01.","example":"2026-01-01"},"onlyPaid":{"type":"boolean","description":"Only paid partnership posts."},"verifiedProfile":{"type":"boolean","description":"Only posts by verified accounts."},"collabBrands":{"type":"array","maxItems":32768,"items":{"type":"string","maxLength":100},"description":"Handles of one brand. A post is a collab when it names one of them in its platform's collab fields and none of them wrote it."},"collabOf":{"type":"object","description":"Collabs of several brands. Each brand lists its accounts per platform; a brand's own posts never count. The first page also answers caption_mentions, total_by_platform and collab_basis.","required":["brands"],"properties":{"brands":{"type":"array","minItems":1,"maxItems":100,"items":{"type":"object","required":["accounts"],"properties":{"accounts":{"type":"array","minItems":1,"maxItems":32768,"items":{"type":"object","required":["platform","handle"],"properties":{"platform":{"type":"string","enum":["instagram","tiktok","youtube"]},"handle":{"type":"string","maxLength":100}}}}}}},"since":{"type":"string","format":"date"},"until":{"type":"string","format":"date"}}},"sortBy":{"type":"string","enum":["likes","comments","date","postedAt","engagement","views","plays","relevanceScore"],"description":"Default relevanceScore with a query, else likes."},"limit":{"type":"integer","minimum":1,"maximum":200,"default":60,"description":"Rows per page."},"offset":{"type":"integer","minimum":0,"maximum":10000,"default":0,"description":"Rows to skip."},"searchAfter":{"type":"array","maxItems":5,"items":{},"description":"The previous page nextSearchAfter, for pages past the offset limit. Overrides offset."},"mode":{"type":"string","enum":["preview"],"description":"Return the newest posts grouped per profile (itemsByProfileId) for up to 50 profileIds."},"profileIds":{"type":"array","maxItems":1000,"items":{"type":"integer","minimum":1},"description":"Only posts by these profile ids."},"limitPerProfile":{"type":"integer","minimum":1,"maximum":20,"default":6,"description":"Posts per profile in preview mode."}}},"example":{"query":"skincare","limit":2}}}},"responses":{"200":{"description":"Stored index rows.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":true},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"items":[{"id":"instagram:3753932230511935811","platform":"instagram","platformPostId":"3753932230511935811","profileId":4555749,"caption":"Unboxing my new skincare obsession — the Pixel Pure Glow Cleansing Serum Pad! 💕\nIt gently cleanses, hydrates, and makes your skin instantly glow 🌸\nIf you’re chasing that dewy, fresh, “no-filter” glow, this is your sign 💫\n\n💧 Step into the glow world with #PixelPure\n💝 Perfect for all skin types\n💫 #SoothingAndGlowKit\n\n#PixelPure #GlowCleansingPad #UnboxingReel #SkincareAddict #GlowingSkin #SkincareRoutine #KBeautyVibes #FreshSkinGoals #DewySkinLook #SelfCareEssentials #ViralSkincare #RadiantSkin #BeautyReel #AestheticUnboxing #SkincareLover #SkincareObsessed #GlassSkinGoals\n#reels\n#reelitfeelit \n#reelkrofeelkro❤️ \n#reelinstagram❤️ \n\n@pixelpure.official\n@skincare\n@beautyunboxed\n@skincarebloggers\n@glowguide\n@skincarecommunity","likes":224,"comments":null,"postedAt":null,"contentType":"Image","postUrl":"https://www.instagram.com/p/DQYpXl2jcFD/","imageUrl":"https://instagram.ficn4-1.fna.fbcdn.net/v/t51.71878-15/573678845_1881811249353128_117388876448030865_n.jpg?stp=dst-jpg_e15_tt6&_nc_cat=109&_nc_map=urlgen_bucketless&ig_cache_key=Mzc1MzkzMjIzMDUxMTkzNTgxMTExODYyMDEwODY3MDgyNTk%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6IkNMSVBTLnhwaWRzLjY0MC5zZHIudmlkZW9fbmZyYW1lX2NvdmVyX2ZyYW1lLkMzIn0%3D&_nc_ohc=9V76Ma6SXIIQ7kNvwFm-IYw&_nc_oc=Adp8xFm_X7Wz56C1xaD8uho6uB6sk6F3oe3iMAkegWKGfzBBpgXzaBjWIW4GHM5PcwQ&_nc_zt=23&_nc_ht=instagram.ficn4-1.fna&_nc_gid=8qt5SoQ5VS5a9vL-B7P4wA&_nc_ss=7baaf&oh=00_AQORTr038MJT4wiJWgPdJbGoeSwYoTufGhpAAHixG18z0g&oe=6AD0E1A4","videoUrl":null,"plays":null,"shares":null,"engagementScore":224,"isVideo":false,"username":"glowwithuzma1","profilePicUrl":null,"profilePicCdnUrl":null,"fullName":null,"profileFollowers":null,"profileIsVerified":false,"captionMentions":["pixelpure.official","skincare"],"isPaidPartnership":false,"taggedBrands":["pixelpure_official"],"taggedBrandHandles":["pixelpure_official"]},{"id":"youtube:_4_RVxjm5hU","platform":"youtube","platformPostId":"_4_RVxjm5hU","profileId":211981,"caption":"[ASMR] Detox Sticky, scalp massage, Korean Skincare Asmr (No talking)\n안녕하세요 메디컬 스킨케어  '아오와'입니다\n오늘은 디톡스티키 +두피 마사지 ASMR 영상입니다 ✋🤚\n소리를 들으면서~\n영상을 보면서~\n직접 관리를 받는 듯한 느낌을 받아보세요❤️\n\n\n📍아오와 ASMR📍\n\n[ASMR] 잠이 솔솔 오는 피부 관리 Korean Skincare Massage Asmr (No talking)\nhttps://www.youtube.com/watch?v=LrEp6_aYjSM\n\n[ASMR] 두피 마사지 Korea scalp massage, Hair Brush for Sleep (No talking)\nhttps://www.youtube.com/watch?v=_s4nujEJld4&t=11s\n\n[ASMR] 무조건 잠드는 브러쉬 마사지 Korean Facial Brushing Massage (No talking)\nhttps://www.youtube.com/watch?v=eGmJp27arQ0&t=15s\n\n\n#asmr #massge @skincare\n\n📩   아오와\n📩   카카오톡 @ahohaw\n📩   본사 080.850.7778\n📩   아오와 공식 홈페지이: https://ahohaw.com\n📩   아오와 인스타그램 : https://www.instagram.com/ahohaw_official","likes":145,"comments":null,"postedAt":1615789172000,"contentType":"Video","postUrl":"https://www.youtube.com/watch?v=_4_RVxjm5hU","imageUrl":"https://i.ytimg.com/an_webp/_4_RVxjm5hU/mqdefault_6s.webp?du=3000&sqp=CLiGt9UG&rs=AOn4CLBhU8CI53C1I23XNH0tbeAQULYhgQ","videoUrl":null,"plays":9600,"shares":null,"engagementScore":145,"isVideo":true,"username":"ahohaw1001","profilePicUrl":null,"profilePicCdnUrl":null,"fullName":"AHOHWA아오와","profileFollowers":1110,"profileIsVerified":false,"captionMentions":["skincare","ahohaw"],"isPaidPartnership":false,"taggedBrands":[],"taggedBrandHandles":[]}],"total":1000,"degraded":false,"nextSearchAfter":[34.062366,145]},"meta":{"cost":"$0.0010","balance":"$9.9875","request_id":"req_f7b1e1311e9d6b7d8800f405bad2409b"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/creators/mget":{"post":{"tags":["Creator Search"],"operationId":"creatorsMget","summary":"Creator rows by handle","description":"The creator search rows for up to 200 handles, with their collab edges. Without `platform`, a handle that exists on several platforms returns one row per platform. A call that finds none of the handles costs $0.\n\nStored index only, never a crawl. Custom AI column fields (`userFields`, `userScores`) belong to other accounts and are never accepted or returned. Rows carry no contact data: emails, phones, contact blocks, linked social accounts and bio links are removed, and contact filters return 400. Find contacts with /v1/contacts/find.","x-dashboard-cost":"$0.0010","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["usernames"],"properties":{"usernames":{"type":"array","minItems":1,"maxItems":200,"items":{"type":"string","maxLength":100}},"platform":{"type":"string","maxLength":32,"description":"Only rows on this platform, e.g. instagram."}}},"example":{"usernames":["natgeo","nike"],"platform":"instagram"}}}},"responses":{"200":{"description":"Stored index rows.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":true},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"creators":[{"id":7448,"platform":"instagram","username":"nike","fullName":"Nike","profilePicUrl":"https://scontent-man2-1.cdninstagram.com/v/t51.82787-19/551608484_18567162979020081_1135468084872726555_n.jpg?stp=dst-jpg_e0_s150x150_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby4zOTkuYzIifQ&_nc_ht=scontent-man2-1.cdninstagram.com&_nc_cat=1&_nc_oc=Q6cZ2gGvcExHyZKFpk-z2JDvlW3CNFxUirGkheqtkpVPYVf9dlsZ0hM7xp2cl1mCqJtT2Cg&_nc_ohc=7F62uN1HdJgQ7kNvwHAMm4K&_nc_gid=ILRAPV9XkC5ggh1xXiaScw&edm=ACWDqb8BAAAA&ccb=7-5&oh=00_AQP1sPr93nM0gALPjlwTfAiNSdQDi9AYy0fhQ8Slb8JNBg&oe=6AD17B7A&_nc_sid=ee9879","profilePicCdnUrl":"https://f005.backblazeb2.com/file/influencer-dev/staging/crawler/instagram_account/7346.webp","followers":291022475,"isVerified":true,"country":"United States","primaryNiche":"other","engagementRatio":0.03457877265321175,"lastPostedAt":"2026-10-08T20:34:27+00:00","collabs":[{"brandHandle":"nikebasketball","platform":"instagram","firstAt":"2025-10-01T14:00:02+00:00","lastAt":"2026-10-08T20:34:27+00:00","postCount":12},{"brandHandle":"aja22wilson","platform":"instagram","firstAt":"2025-09-13T16:01:22+00:00","lastAt":"2026-10-08T20:34:27+00:00","postCount":3}],"lastCollabAt":"2026-10-08T20:34:27+00:00","relevanceScore":null},{"id":1172,"platform":"instagram","username":"natgeo","fullName":"National Geographic","profilePicUrl":"https://scontent-lhr11-1.cdninstagram.com/v/t51.82787-19/683576066_18653628823019133_9051036240972105113_n.jpg?stp=dst-jpg_s150x150_tt6&_nc_cat=1&ccb=7-5&_nc_sid=f7ccc5&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLnd3dy40MDAuQzMifQ%3D%3D&_nc_ohc=9DX3oxEQASoQ7kNvwHBMtqB&_nc_oc=AdoLsT7XulD3rUZmwPiL2zP84RGpDCno3HSdeQRzsJrWkeN7whc2taFWn-3j4c8V72s&_nc_zt=24&_nc_ht=scontent-lhr11-1.cdninstagram.com&_nc_gid=r77wIY_Pv1292hvHaSJsDA&_nc_ss=7ba8c&oh=00_AQMYabCNa-eOli00xUmqNA823ynF8gdlGwnz9JhIxkpVUA&oe=6AD2B02B","profilePicCdnUrl":"https://f005.backblazeb2.com/file/influencer-dev/staging/crawler/instagram_account/1070.webp","followers":268396140,"isVerified":true,"country":"United States","primaryNiche":"outdoors","engagementRatio":0.019117264503133318,"lastPostedAt":"2026-10-12T01:00:01+00:00","collabs":[{"brandHandle":"natgeoscience","platform":"instagram","firstAt":"2025-10-19T16:00:12+00:00","lastAt":"2026-10-09T22:00:01+00:00","postCount":55},{"brandHandle":"natgeoanimals","platform":"instagram","firstAt":"2025-09-29T22:00:03+00:00","lastAt":"2026-10-07T19:47:57+00:00","postCount":87}],"lastCollabAt":"2026-10-09T22:00:01+00:00","relevanceScore":null}],"total":2,"degraded":false},"meta":{"cost":"$0.0010","balance":"$9.9875","request_id":"req_6618e0318bab80e33454b5d7e3be67a0"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/creators/profiles":{"get":{"tags":["Creator Search"],"operationId":"creatorsProfiles","summary":"Instagram profiles by handle","description":"Stored Instagram profiles for up to 200 handles: bio, counts, niche, country, language and scrape times. A handle we never crawled is missing from the list, and a call that finds none of its handles costs $0.\n\nStored data only, never a crawl. Fetch a fresh profile with /v1/instagram/web_profile_info. Rows carry no contact data: emails, phones, contact blocks, linked social accounts and bio links are removed, and contact filters return 400. Find contacts with /v1/contacts/find.","x-dashboard-cost":"$0.0010","security":[{"bearerAuth":[]}],"parameters":[{"name":"usernames","in":"query","required":true,"description":"Comma-separated Instagram handles, up to 200. A leading @ is dropped.","example":"natgeo,nike","schema":{"type":"string","maxLength":20200,"example":"natgeo,nike"}}],"x-example-query":{"usernames":"natgeo,nike"},"responses":{"200":{"description":"Stored index rows.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"array","items":{"type":"object","additionalProperties":true}},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":[{"id":1070,"username":"natgeo","fullName":"National Geographic","biography":"Step into wonder and find your inner explorer with National Geographic 🌎","profilePicUrl":"https://scontent-lhr11-1.cdninstagram.com/v/t51.82787-19/683576066_18653628823019133_9051036240972105113_n.jpg?stp=dst-jpg_s150x150_tt6&_nc_cat=1&ccb=7-5&_nc_sid=f7ccc5&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLnd3dy40MDAuQzMifQ%3D%3D&_nc_ohc=9DX3oxEQASoQ7kNvwHBMtqB&_nc_oc=AdoLsT7XulD3rUZmwPiL2zP84RGpDCno3HSdeQRzsJrWkeN7whc2taFWn-3j4c8V72s&_nc_zt=24&_nc_ht=scontent-lhr11-1.cdninstagram.com&_nc_gid=r77wIY_Pv1292hvHaSJsDA&_nc_ss=7ba8c&oh=00_AQMYabCNa-eOli00xUmqNA823ynF8gdlGwnz9JhIxkpVUA&oe=6AD2B02B","followers":268396140,"following":194,"postsCount":null,"isVerified":true,"isBusinessAccount":false,"categoryName":null,"accountRole":"media","primaryNiche":"outdoors","subNiches":["wildlife","nature"],"country":"United States","language":"English","enrichedAt":"2026-10-12T12:53:37.236725+00:00","lastScrapedAt":"2026-10-12T13:19:36.696294+00:00","followersFetchedAt":"2026-10-12T13:19:36.696294+00:00","engagementRatio":0.019117264503133318},{"id":7346,"username":"nike","fullName":"Nike","biography":"Just Do It.","profilePicUrl":"https://scontent-man2-1.cdninstagram.com/v/t51.82787-19/551608484_18567162979020081_1135468084872726555_n.jpg?stp=dst-jpg_e0_s150x150_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby4zOTkuYzIifQ&_nc_ht=scontent-man2-1.cdninstagram.com&_nc_cat=1&_nc_oc=Q6cZ2gGvcExHyZKFpk-z2JDvlW3CNFxUirGkheqtkpVPYVf9dlsZ0hM7xp2cl1mCqJtT2Cg&_nc_ohc=7F62uN1HdJgQ7kNvwHAMm4K&_nc_gid=ILRAPV9XkC5ggh1xXiaScw&edm=ACWDqb8BAAAA&ccb=7-5&oh=00_AQP1sPr93nM0gALPjlwTfAiNSdQDi9AYy0fhQ8Slb8JNBg&oe=6AD17B7A&_nc_sid=ee9879","followers":291022475,"following":266,"postsCount":1669,"isVerified":true,"isBusinessAccount":true,"categoryName":null,"accountRole":"brand","primaryNiche":"other","subNiches":["Running and training apparel","Football"],"country":"United States","language":"English","enrichedAt":"2026-08-19T04:25:43.408163+00:00","lastScrapedAt":"2026-10-10T08:17:46.275764+00:00","followersFetchedAt":"2026-10-10T08:17:46.275764+00:00","engagementRatio":0.03457877265321175}],"meta":{"cost":"$0.0010","balance":"$9.9875","request_id":"req_449eef54fd17a9bae0e59004bcea89cc"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/creators/profile":{"get":{"tags":["Creator Search"],"operationId":"creatorsProfile","summary":"Creator profile","description":"One creator by the profile `id` that search, autocomplete and mget return. `surface=full` adds top content, hashtags, collaborations, mentioned accounts, brand collab rate and the post timeline to the profile; `overlay` and `preview` are smaller cuts.\n\nStored data only, never a crawl: an unknown id is a 404 and costs $0. Rows carry no contact data: emails, phones, contact blocks, linked social accounts and bio links are removed, and contact filters return 400. Find contacts with /v1/contacts/find.","x-dashboard-cost":"$0.0010","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"query","required":true,"description":"Profile id from search, autocomplete or mget.","example":"1172","schema":{"type":"integer","minimum":1,"example":"1172"}},{"name":"surface","in":"query","required":false,"description":"How much to return.","schema":{"type":"string","enum":["full","overlay","preview"],"default":"full"},"examples":{"default":{"value":"full","x-disabled":true}}}],"x-example-query":{"id":"1172"},"responses":{"200":{"description":"Stored index rows.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":true},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"profile":{"id":1172,"platform":"instagram","region":null,"heartCount":null,"username":"natgeo","fullName":"National Geographic","biography":"Step into wonder and find your inner explorer with National Geographic 🌎","profilePicUrl":"https://scontent-lhr11-1.cdninstagram.com/v/t51.82787-19/683576066_18653628823019133_9051036240972105113_n.jpg?stp=dst-jpg_s150x150_tt6&_nc_cat=1&ccb=7-5&_nc_sid=f7ccc5&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLnd3dy40MDAuQzMifQ%3D%3D&_nc_ohc=9DX3oxEQASoQ7kNvwHBMtqB&_nc_oc=AdoLsT7XulD3rUZmwPiL2zP84RGpDCno3HSdeQRzsJrWkeN7whc2taFWn-3j4c8V72s&_nc_zt=24&_nc_ht=scontent-lhr11-1.cdninstagram.com&_nc_gid=r77wIY_Pv1292hvHaSJsDA&_nc_ss=7ba8c&oh=00_AQMYabCNa-eOli00xUmqNA823ynF8gdlGwnz9JhIxkpVUA&oe=6AD2B02B","profilePicCdnUrl":"https://f005.backblazeb2.com/file/influencer-dev/staging/crawler/instagram_account/1070.webp","followers":268396140,"following":194,"postsCount":null,"avgEngagement":0.03781644208196636,"isVerified":true,"isPrivate":false,"isAuthoritative":false,"isBusinessAccount":false,"isProfessionalAccount":false,"categoryName":null,"businessCategoryName":null,"pronouns":null,"bioHashtags":[],"hasChannel":false,"hasSocial":false,"hasYoutube":false,"hasTiktok":false,"hasLinkedin":false,"hasX":false,"hasInstagram":true,"hasDouyin":false,"hasXiaohongshu":false,"hasWebsite":true,"firstScrapedAt":"2026-08-04T17:05:49.468519Z","lastScrapedAt":"2026-10-12T13:19:36.696294Z","scrapeCount":272,"accountRole":"media","primaryNiche":"outdoors","subNiches":["wildlife","nature"],"tagline":"Step into wonder and find your inner explorer.","nicheAuthority":null,"commercialIntent":"fully_commercial","gender":"unknown","ageRange":null,"race":null,"country":"United States","city":null,"language":"English","bioSummary":"National Geographic’s global media account focused on exploration, science, wildlife, nature, and conservation.","socialCount":0,"socialPlatforms":[],"aiEnrichment":null,"engagementRatio":0.019117264503133318,"averagePostEngagementRatio":0.035038125899876614,"averageReelEngagementRatio":0.04126986313073214,"averageContentEngagementRatio":0.03781644208196636,"postEngagement":0.035038125899876614,"reelEngagement":0.04126986313073214,"sumEngagement":0.03781644208196636,"averagePostLikes":92738.72932330827,"averageReelLikes":109018,"averagePostComments":434.0827067669173,"averageReelComments":582.9065420560747,"averageReelViews":3445616,"averageBrandCollabReelViews":1822336.25,"reelViews25thPercentile":1527559,"reelViews75thPercentile":3543076,"postLikes25thPercentile":27322,"postLikes75thPercentile":93145,"reelLikes25thPercentile":23624.5,"reelLikes75thPercentile":78535.5,"avgPostLikes":92738.72932330827,"avgReelLikes":109018,"avgPostComments":434.0827067669173,"avgReelComments":582.9065420560747,"avgReelViews":3445616,"medianLikes":50632,"medianComments":226,"medianViews":2178419,"medianPostLikes":54378,"medianPostComments":243,"medianReelLikes":39429,"medianReelComments":206,"medianReelViews":2178419,"postCountActual":133,"reelCountActual":107,"totalContentCount":240,"reelRatio":0.44583333333333336,"paidPartnershipRate":0.0625,"paidPartnershipCount":15,"brandCollabRatio":0.0625,"brandCollabCount":15,"averageBrandCollabEngagementRatio":0.011076761387104896,"medianPostGap":0.25,"medianDaysBetweenPosts":0.25,"medianPostFreqDays":0.25,"lastPostedAt":"2026-10-12T01:00:01Z","collabScore":46,"previewPosts":[{"likes":94358,"views":null,"caption":"Presented by @Rolex. Pangolins usually roll into a ball when threatened, which can protect them even from hungry lions. But this defense mechanism can't protect them from those who hunt them for their meat and, more recently, their scales. Conservationists, like those at the @tikkihywoodfoundation, are taking on the labor-intensive challenge of caring for orphaned and injured pangolins while also working with authorities to stop black-market trafficking of these vulnerable creatures.\n\nThrough its partnership with the National Geographic Society and as part of its Perpetual Planet Initiative, #Rolex supports expeditions exploring and protecting remarkable places around the world, a selection of which are featured in #AfricaEarthsWildHome. #PerpetualPlanet\n\nLearn more about the effort to save the pangolin at the link in bio.\n\nPhotographs by @marcuswestbergphotography","comments":125,"is_video":false,"image_url":"https://instagram.flhr15-1.fna.fbcdn.net/v/t51.82787-15/845178050_18706675777019133_1919409563310583917_n.jpg?stp=dst-jpg_e35_s1080x1080_sh2.08_tt6&_nc_cat=1&ig_cache_key=NDAwNTU2MjUwMDkxMzc4MDE4Ng%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6IkNBUk9VU0VMX0lURU0ueHBpZHMuMTQzOS5zZHIucmVndWxhcl9waG90by5DMyJ9&_nc_ohc=e1gruOu1jDsQ7kNvwFynfEo&_nc_oc=AdpliV4V_H2XYngBfhlXeFwi1RlIcps-ftMV_7BTD08d1FIHRp2kL69OlrqjMJ_XB3o&_nc_ad=z-m&_nc_cid=803&_nc_zt=23&_nc_ht=instagram.flhr15-1.fna&_nc_gid=3Z_HI02M7PUErexXyac3ig&_nc_ss=7a3ba&oh=00_AQO-8HkD72VG9YpT_Dn6gg86WcxqsCbnpQBgnZD61ZQ7BA&oe=6AD2A74B","posted_at":"2026-10-12T01:00:01+00:00","shortcode":"DeWne1TF__R","content_type":"Carousel","image_cdn_url":"https://f005.backblazeb2.com/file/influencer-dev/staging/crawler/instagram_post/30007916.webp","is_paid_partnership":false},{"likes":70723,"views":1328158,"caption":"It’s snack time for these humpback whales. They use rings of bubbles like nets to concentrate fish and krill before surging through for a feast.\n\n#EuropeFromAbove is streaming on @DisneyPlus","comments":156,"is_video":true,"image_url":"https://instagram.flhr15-1.fna.fbcdn.net/v/t51.82787-15/847570097_18706820542019133_7455916707765318737_n.jpg?stp=dst-jpg_e15_s640x640_tt6&_nc_cat=1&ig_cache_key=NDAwNTc3MTU4MDI3MjU4MDY4OA%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6IkNMSVBTLnhwaWRzLjEwODAuc2RyLnZpZGVvX2RlZmF1bHRfY292ZXJfZnJhbWUuQzMifQ%3D%3D&_nc_ohc=XAJEojflihAQ7kNvwEYgYxw&_nc_oc=AdpdYY8YS8JpDILeqVhPelWzGAdrel3ZglAkiJHtykWSmaUl_he8BC1811ZCF3c4t9Y&_nc_ad=z-m&_nc_cid=803&_nc_zt=23&_nc_ht=instagram.flhr15-1.fna&_nc_gid=3Z_HI02M7PUErexXyac3ig&_nc_ss=7a3ba&oh=00_AQNB3xpSAGQ7tVwIBcH-z8p6ILv-l4-um2xFsqOSrlkFag&oe=6AD2A95E","posted_at":"2026-10-11T19:01:22+00:00","shortcode":"DeXXAddgJhQ","content_type":"Video","image_cdn_url":"https://f005.backblazeb2.com/file/influencer-dev/staging/crawler/instagram_post/30007918.webp","is_paid_partnership":false}],"topCollaborators":[],"collaboratorUsernames":[],"profileSearchProjectionVersion":null,"relevanceScore":null,"campaignRelevance":null,"enrichedAt":null,"identity":{"displayName":"National Geographic","displayHandle":"natgeo","stableId":"787132","stableIdType":"instagram_id","externalUrl":"https://www.instagram.com/natgeo/"},"profileId":1172},"identity":{"displayName":"National Geographic","displayHandle":"natgeo","stableId":"787132","stableIdType":"instagram_id","externalUrl":"https://www.instagram.com/natgeo/"},"capabilities":{"canRefresh":true,"canEnrich":true,"canOpenContentDetail":true,"hasAuthoritativeProfile":true},"topContent":[{"contentId":"instagram:4004229035512958428","platformPostId":"4004229035512958428","shortcode":"4004229035512958428","likes":426689,"comments":1032,"views":0,"postedAt":1791583201000,"imageUrl":"https://f005.backblazeb2.com/file/influencer-dev/staging/crawler/instagram_post/29225631.webp","imageCdnUrl":"https://f005.backblazeb2.com/file/influencer-dev/staging/crawler/instagram_post/29225631.webp","videoUrl":null,"postUrl":"https://www.instagram.com/p/DeR4RetDg3c/","contentType":"Carousel","isVideo":false,"isCarousel":true,"caption":"Video and photos by @babaktafreshi | On Tuesday morning I photographed a celestial spectacle right in my backyard, near Boston. Hidden behind the moon for an hour, Jupiter reappeared from the dark night side of the moon, like a sparkling diamond. The rare phenomenon is called occultation. \n\nSlide 1: timelapse videos of the scene through a 600mm telephoto lens (cropped). Note the four lined up Galilean Moons of Jupiter. \nSlide 2: Moon is departing away from the alignment in twilight. \nSlide 3: An HDR image (3 exposures) to reveal the lunar details in both its bright dayside and the faint earthshine glow on the night side of the moon. \nSlide 4: A longer 30-second exposure on a star tracker has overexposed the moon to reveal the background starry sky.","captionMentions":["babaktafreshi"],"isPaidPartnership":false,"isPinned":false},{"contentId":"instagram:4004322549189214782","platformPostId":"4004322549189214782","shortcode":"4004322549189214782","likes":379336,"comments":1139,"views":3563292,"postedAt":1791572500000,"imageUrl":"https://f005.backblazeb2.com/file/influencer-dev/staging/crawler/instagram_post/29225632.webp","imageCdnUrl":"https://f005.backblazeb2.com/file/influencer-dev/staging/crawler/instagram_post/29225632.webp","videoUrl":"https://instagram.flhr15-1.fna.fbcdn.net/o1/v/t2/f2/m86/AQMdMrZT83Pf8Ij8yn7jzmMVrePHMkMYX3ZXpKjfFbXWKyvbTuifpO7Xx-FXXFaLnLOCHRv20_0bWLuRKkuGRZsrrhCzMx_kHgCSkpg.mp4?_nc_cat=105&_nc_oc=AdprvFwVMVIhLV2NpkPbSw9lmNFCGywhuLkn3D7ncjfgynp68bxOQPG6_ThKzP6L5NI&_nc_sid=5e9851&_nc_ht=instagram.flhr15-1.fna.fbcdn.net&_nc_ohc=KvIDFeBMxGsQ7kNvwHwL0Hv&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5JTlNUQUdSQU0uQ0xJUFMuQzMuNzIwLmRhc2hfYmFzZWxpbmVfMV92MSIsInhwdl9hc3NldF9pZCI6MjExODg5MjA1ODc0MTUyNiwiYXNzZXRfYWdlX2RheXMiOjIsInZpX3VzZWNhc2VfaWQiOjEwMDk5LCJkdXJhdGlvbl9zIjoxMSwidXJsZ2VuX3NvdXJjZSI6Ind3dyJ9&ccb=17-1&vs=700691ac237f07e6&_nc_vs=HBksFQIYUmlnX3hwdl9yZWVsc19wZXJtYW5lbnRfc3JfcHJvZC9ENTExRDBCQ0M1M0I0NjdEQjFDNUU0NjNCREU5NzA3Q192aWRlb19kYXNoaW5pdC5tcDQVAALIARIAFQIYUWlnX3hwdl9wbGFjZW1lbnRfcGVybWFuZW50X3YyL0MwRTFCMjE4QTNCNDQ1OTg5RDc4QzBFNTFGQkI2RjBFX2F1ZGlvX2Rhc2hpbml0Lm1wNBUCAsgBEgAoABgAGwKIB3VzZV9vaWwBMRJwcm9ncmVzc2l2ZV9yZWNpcGUBMRUAACasrNSH4MfDBxUCKAJDMywXQCY9cKPXCj0YEmRhc2hfYmFzZWxpbmVfMV92MREAdf4HZeadAQA&_nc_gid=3Z_HI02M7PUErexXyac3ig&_nc_ss=7a3ba&_nc_map=urlgen_bucketless&_nc_zt=28&oh=00_AQO2ARIsig39ZtQ_922ndu_1yJ0V_TQJ38VvdaWwP-Yi6g&oe=6ACEB382","postUrl":"https://www.instagram.com/reel/DeSNiSGgoI-/","contentType":"Video","isVideo":true,"isCarousel":false,"caption":"We could stay here a while. 🌿\n\n#Queens is streaming on @DisneyPlus and @hulu.","captionMentions":["DisneyPlus","hulu."],"isPaidPartnership":false,"isPinned":false}],"hashtags":[{"tag":"perpetualplanet","count":17},{"tag":"rolex","count":17}],"collaborations":[],"mentionedAccounts":[],"brandCollabRate":0.0625,"timeline":{"posts":[{"contentId":"instagram:4005562561219526609","platformPostId":"4005562561219526609","shortcode":"4005562561219526609","likes":94358,"comments":125,"views":0,"postedAt":1791766801000,"imageUrl":"https://f005.backblazeb2.com/file/influencer-dev/staging/crawler/instagram_post/30007916.webp","imageCdnUrl":"https://f005.backblazeb2.com/file/influencer-dev/staging/crawler/instagram_post/30007916.webp","videoUrl":null,"postUrl":"https://www.instagram.com/p/DeWne1TF__R/","contentType":"Carousel","isVideo":false,"isCarousel":true,"caption":"Presented by @Rolex. Pangolins usually roll into a ball when threatened, which can protect them even from hungry lions. But this defense mechanism can't protect them from those who hunt them for their meat and, more recently, their scales. Conservationists, like those at the @tikkihywoodfoundation, are taking on the labor-intensive challenge of caring for orphaned and injured pangolins while also working with authorities to stop black-market trafficking of these vulnerable creatures.\n\nThrough its partnership with the National Geographic Society and as part of its Perpetual Planet Initiative, #Rolex supports expeditions exploring and protecting remarkable places around the world, a selection of which are featured in #AfricaEarthsWildHome. #PerpetualPlanet\n\nLearn more about the effort to save the pangolin at the link in bio.\n\nPhotographs by @marcuswestbergphotography","captionMentions":["Rolex.","tikkihywoodfoundation"],"isPaidPartnership":false,"isPinned":false},{"contentId":"instagram:4005681753581760038","platformPostId":"4005681753581760038","shortcode":"4005681753581760038","likes":22845,"comments":64,"views":0,"postedAt":1791734559000,"imageUrl":"https://f005.backblazeb2.com/file/influencer-dev/staging/crawler/instagram_post/30007917.webp","imageCdnUrl":"https://f005.backblazeb2.com/file/influencer-dev/staging/crawler/instagram_post/30007917.webp","videoUrl":null,"postUrl":"https://www.instagram.com/p/DeXClT1gS4m/","contentType":"Image","isVideo":false,"isCarousel":false,"caption":"Presented by @Rolex. Mountain gorillas have made a comeback in recent decades, with their population nearly doubling since the 1990s. But their close contact with humans poses another threat: diseases can pass between the two, sometimes with deadly consequences for these endangered apes. In Uganda, Rolex National Geographic Perpetual Planet Explorer and wildlife veterinarian Gladys Kalema-Zikusoka is tackling that risk in a way that has changed the scope of gorilla conservation.\n\nThrough its partnership with the National Geographic Society and as part of its Perpetual Planet Initiative, #Rolex supports expeditions exploring and protecting remarkable places around the world, a selection of which are featured in Africa Earth’s Wild Home. #PerpetualPlanet\n\nDiscover more about Kalema-Zikusoka’s pioneering approach to conservation in this month’s issue of National Geographic and at the link in bio. \n\nPhotograph by Robin Hammond (@hammond_robin)","captionMentions":["Rolex.","hammond_robin"],"isPaidPartnership":true,"isPinned":false}],"reels":[{"contentId":"instagram:4005771580272580688","platformPostId":"4005771580272580688","shortcode":"4005771580272580688","likes":70723,"comments":156,"views":1328158,"postedAt":1791745282000,"imageUrl":"https://f005.backblazeb2.com/file/influencer-dev/staging/crawler/instagram_post/30007918.webp","imageCdnUrl":"https://f005.backblazeb2.com/file/influencer-dev/staging/crawler/instagram_post/30007918.webp","videoUrl":"https://instagram.flhr15-1.fna.fbcdn.net/o1/v/t2/f2/m86/AQOkSrAEN8KwVY4aMEq8am1mrrOzzYjtCH_-noXMocBc8k7B4gHBV7l19_Qf_49Fv6gqJ0mrfMszGiesyhi1IjlavVP-vqz8SPVphSc.mp4?_nc_cat=100&_nc_oc=AdolydbzIfF03V1F0Deeql6_aYagLtKjJxw7qJzD4oD37cR8pgdrwcS3plhHKVxHc6U&_nc_sid=5e9851&_nc_ht=instagram.flhr15-1.fna.fbcdn.net&_nc_ohc=_XSdmi49HI4Q7kNvwFRjT1J&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5JTlNUQUdSQU0uQ0xJUFMuQzMuNzIwLmRhc2hfYmFzZWxpbmVfMV92MSIsInhwdl9hc3NldF9pZCI6MTE0MDE2NTU2ODQ1NDUxMCwiYXNzZXRfYWdlX2RheXMiOjAsInZpX3VzZWNhc2VfaWQiOjEwMDk5LCJkdXJhdGlvbl9zIjozMCwidXJsZ2VuX3NvdXJjZSI6Ind3dyJ9&ccb=17-1&vs=8b497b8adbeea4c7&_nc_vs=HBksFQIYUmlnX3hwdl9yZWVsc19wZXJtYW5lbnRfc3JfcHJvZC9FQzBFQzlDMDgwQkQ0NTBDQkQ0MzcyMDQ0QjcxNUQ2Ql92aWRlb19kYXNoaW5pdC5tcDQVAALIARIAFQIYUWlnX3hwdl9wbGFjZW1lbnRfcGVybWFuZW50X3YyLzgzMkJBQUY4QUJFRDQ4QzBBQzkyNDhGRjAyRkJFMzlFX2F1ZGlvX2Rhc2hpbml0Lm1wNBUCAsgBEgAoABgAGwKIB3VzZV9vaWwBMRJwcm9ncmVzc2l2ZV9yZWNpcGUBMRUAACbc_Yq7r76GBBUCKAJDMywXQD4yLQ5WBBkYEmRhc2hfYmFzZWxpbmVfMV92MREAdf4HZeadAQA&_nc_gid=3Z_HI02M7PUErexXyac3ig&_nc_ss=7a3ba&_nc_map=urlgen_bucketless&_nc_zt=28&oh=00_AQPxIFMmMwkcc6zNd4p_ldDSqPYhAHEIKucwvulXILWFPg&oe=6ACEA201","postUrl":"https://www.instagram.com/reel/DeXXAddgJhQ/","contentType":"Video","isVideo":true,"isCarousel":false,"caption":"It’s snack time for these humpback whales. They use rings of bubbles like nets to concentrate fish and krill before surging through for a feast.\n\n#EuropeFromAbove is streaming on @DisneyPlus","captionMentions":["DisneyPlus"],"isPaidPartnership":false,"isPinned":false},{"contentId":"instagram:4004872431117321041","platformPostId":"4004872431117321041","shortcode":"4004872431117321041","likes":199369,"comments":550,"views":4545709,"postedAt":1791638084000,"imageUrl":"https://f005.backblazeb2.com/file/influencer-dev/staging/crawler/instagram_post/30007914.webp","imageCdnUrl":"https://f005.backblazeb2.com/file/influencer-dev/staging/crawler/instagram_post/30007914.webp","videoUrl":"https://scontent-lhr6-1.cdninstagram.com/o1/v/t2/f2/m86/AQMddAY2601ikGKodOG47tYoVjvfPotfQW0qEkFlLhB4Zgd_cHxLakb5IVd7draQ25IP359GA_mlX1fa3CwtKZtsgeZZux6SPv1T_20.mp4?_nc_cat=108&_nc_sid=5e9851&_nc_ht=scontent-lhr6-1.cdninstagram.com&_nc_ohc=AcVumsm59hUQ7kNvwFNMPCu&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5JTlNUQUdSQU0uQ0xJUFMuQzMuNzIwLmRhc2hfYmFzZWxpbmVfMV92MSIsInhwdl9hc3NldF9pZCI6MTkxODA4NDU1OTYwMTcxOCwiYXNzZXRfYWdlX2RheXMiOjEsInZpX3VzZWNhc2VfaWQiOjEwMDk5LCJkdXJhdGlvbl9zIjoxNCwidXJsZ2VuX3NvdXJjZSI6Ind3dyJ9&ccb=17-1&vs=93f5d04d95e3fa9b&_nc_vs=HBksFQIYUmlnX3hwdl9yZWVsc19wZXJtYW5lbnRfc3JfcHJvZC81QTQ2NDAwOEQ4MDI0ODA5QUI1MEVENkZBRkRFRTlGMV92aWRlb19kYXNoaW5pdC5tcDQVAALIARIAFQIYUWlnX3hwdl9wbGFjZW1lbnRfcGVybWFuZW50X3YyL0Q0QjQ2QUZEN0Q4OTQ3N0VBNDg2RjBFNkJDMDI0RENFX2F1ZGlvX2Rhc2hpbml0Lm1wNBUCAsgBEgAoABgAGwKIB3VzZV9vaWwBMRJwcm9ncmVzc2l2ZV9yZWNpcGUBMRUAACbsgJjNm5_oBhUCKAJDMywXQC3dsi0OVgQYEmRhc2hfYmFzZWxpbmVfMV92MREAdf4HZeadAQA&_nc_gid=PNEmjqhcwjdd92JnBzD9HA&_nc_ss=7a3ba&_nc_zt=28&oh=00_AQNCFUEvhx_Gy1pfkjMzb7mvx0Ru4_EBNpChpRLHUgC8Dw&oe=6ACECB81","postUrl":"https://www.instagram.com/reel/DeUKkHjgMNR/","contentType":"Video","isVideo":true,"isCarousel":false,"caption":"Presented by @Rolex. Pangolins are notoriously difficult to rehabilitate and rewild because they need to learn where to forage for food. During their daily walks, carers at the Tikki Hywood Foundation's rescue center in Cameroon lend a helping hand by pointing infant pangolins to places they can find ants and termites and encouraging them to eat.\n\nThrough its partnership with the National Geographic Society and as part of its Perpetual Planet Initiative, #Rolex supports expeditions exploring and protecting remarkable places around the world, a selection of which are featured in #AfricaEarthsWildHome. #PerpetualPlanet\n\nLearn more about the @tikkihywoodfoundation's work to protect pangolins in the October edition of National Geographic at the link in bio.\n\nVideo by @marcuswestbergphotography","captionMentions":["Rolex.","tikkihywoodfoundation"],"isPaidPartnership":false,"isPinned":false}],"all":[{"contentId":"instagram:4005562561219526609","platformPostId":"4005562561219526609","shortcode":"4005562561219526609","likes":94358,"comments":125,"views":0,"postedAt":1791766801000,"imageUrl":"https://f005.backblazeb2.com/file/influencer-dev/staging/crawler/instagram_post/30007916.webp","imageCdnUrl":"https://f005.backblazeb2.com/file/influencer-dev/staging/crawler/instagram_post/30007916.webp","videoUrl":null,"postUrl":"https://www.instagram.com/p/DeWne1TF__R/","contentType":"Carousel","isVideo":false,"isCarousel":true,"caption":"Presented by @Rolex. Pangolins usually roll into a ball when threatened, which can protect them even from hungry lions. But this defense mechanism can't protect them from those who hunt them for their meat and, more recently, their scales. Conservationists, like those at the @tikkihywoodfoundation, are taking on the labor-intensive challenge of caring for orphaned and injured pangolins while also working with authorities to stop black-market trafficking of these vulnerable creatures.\n\nThrough its partnership with the National Geographic Society and as part of its Perpetual Planet Initiative, #Rolex supports expeditions exploring and protecting remarkable places around the world, a selection of which are featured in #AfricaEarthsWildHome. #PerpetualPlanet\n\nLearn more about the effort to save the pangolin at the link in bio.\n\nPhotographs by @marcuswestbergphotography","captionMentions":["Rolex.","tikkihywoodfoundation"],"isPaidPartnership":false,"isPinned":false},{"contentId":"instagram:4005771580272580688","platformPostId":"4005771580272580688","shortcode":"4005771580272580688","likes":70723,"comments":156,"views":1328158,"postedAt":1791745282000,"imageUrl":"https://f005.backblazeb2.com/file/influencer-dev/staging/crawler/instagram_post/30007918.webp","imageCdnUrl":"https://f005.backblazeb2.com/file/influencer-dev/staging/crawler/instagram_post/30007918.webp","videoUrl":"https://instagram.flhr15-1.fna.fbcdn.net/o1/v/t2/f2/m86/AQOkSrAEN8KwVY4aMEq8am1mrrOzzYjtCH_-noXMocBc8k7B4gHBV7l19_Qf_49Fv6gqJ0mrfMszGiesyhi1IjlavVP-vqz8SPVphSc.mp4?_nc_cat=100&_nc_oc=AdolydbzIfF03V1F0Deeql6_aYagLtKjJxw7qJzD4oD37cR8pgdrwcS3plhHKVxHc6U&_nc_sid=5e9851&_nc_ht=instagram.flhr15-1.fna.fbcdn.net&_nc_ohc=_XSdmi49HI4Q7kNvwFRjT1J&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5JTlNUQUdSQU0uQ0xJUFMuQzMuNzIwLmRhc2hfYmFzZWxpbmVfMV92MSIsInhwdl9hc3NldF9pZCI6MTE0MDE2NTU2ODQ1NDUxMCwiYXNzZXRfYWdlX2RheXMiOjAsInZpX3VzZWNhc2VfaWQiOjEwMDk5LCJkdXJhdGlvbl9zIjozMCwidXJsZ2VuX3NvdXJjZSI6Ind3dyJ9&ccb=17-1&vs=8b497b8adbeea4c7&_nc_vs=HBksFQIYUmlnX3hwdl9yZWVsc19wZXJtYW5lbnRfc3JfcHJvZC9FQzBFQzlDMDgwQkQ0NTBDQkQ0MzcyMDQ0QjcxNUQ2Ql92aWRlb19kYXNoaW5pdC5tcDQVAALIARIAFQIYUWlnX3hwdl9wbGFjZW1lbnRfcGVybWFuZW50X3YyLzgzMkJBQUY4QUJFRDQ4QzBBQzkyNDhGRjAyRkJFMzlFX2F1ZGlvX2Rhc2hpbml0Lm1wNBUCAsgBEgAoABgAGwKIB3VzZV9vaWwBMRJwcm9ncmVzc2l2ZV9yZWNpcGUBMRUAACbc_Yq7r76GBBUCKAJDMywXQD4yLQ5WBBkYEmRhc2hfYmFzZWxpbmVfMV92MREAdf4HZeadAQA&_nc_gid=3Z_HI02M7PUErexXyac3ig&_nc_ss=7a3ba&_nc_map=urlgen_bucketless&_nc_zt=28&oh=00_AQPxIFMmMwkcc6zNd4p_ldDSqPYhAHEIKucwvulXILWFPg&oe=6ACEA201","postUrl":"https://www.instagram.com/reel/DeXXAddgJhQ/","contentType":"Video","isVideo":true,"isCarousel":false,"caption":"It’s snack time for these humpback whales. They use rings of bubbles like nets to concentrate fish and krill before surging through for a feast.\n\n#EuropeFromAbove is streaming on @DisneyPlus","captionMentions":["DisneyPlus"],"isPaidPartnership":false,"isPinned":false}]}},"meta":{"cost":"$0.0010","balance":"$9.9875","request_id":"req_210448f80bd923619832fceec99d1926"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"404":{"description":"No stored profile has this id.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_found","message":"profile not found","request_id":"req_5c10900e919bc7a3ff79b7501d582b4c"}}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/creators/autocomplete":{"get":{"tags":["Creator Search"],"operationId":"creatorsAutocomplete","summary":"Autocomplete creators","description":"Handle suggestions for a search box: accounts whose handle starts with `q`, largest first, across platforms. `followers` is null for an account we have not read yet, and those come last. Each suggestion carries the profile id that /v1/creators/profile reads, and `isAccount`: true for the account of a brand or a page, false for a person who makes content, null before we judged it. An empty list costs $0. Suggestions carry no email; find contacts with /v1/contacts/find/fast or /v1/contacts/find/thorough.","x-dashboard-cost":"$0.0002","security":[{"bearerAuth":[]}],"parameters":[{"name":"q","in":"query","required":true,"description":"Start of a handle, 2 characters or more.","example":"natg","schema":{"type":"string","minLength":2,"maxLength":100,"example":"natg"}},{"name":"limit","in":"query","required":false,"description":"Suggestions to return.","schema":{"type":"integer","minimum":1,"maximum":50,"default":8},"examples":{"default":{"value":8,"x-disabled":true}}}],"x-example-query":{"q":"natg","limit":"3"},"responses":{"200":{"description":"Stored index rows.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"array","items":{"type":"object","additionalProperties":true}},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":[{"id":1172,"platform":"instagram","username":"natgeo","fullName":"National Geographic","profilePicUrl":null,"profilePicCdnUrl":null,"followers":268396140,"primaryNiche":"outdoors","identity":{"displayName":"National Geographic","displayHandle":"natgeo","stableId":null,"stableIdType":"instagram_id","externalUrl":"https://www.instagram.com/natgeo/"}},{"id":4690103,"platform":"facebook","username":"natgeo","fullName":"National Geographic","profilePicUrl":null,"profilePicCdnUrl":null,"followers":51000000,"primaryNiche":null,"identity":{"displayName":"National Geographic","displayHandle":"natgeo","stableId":null,"stableIdType":"facebook_user_id","externalUrl":"https://www.facebook.com/natgeo"}},{"id":1519,"platform":"instagram","username":"natgeotravel","fullName":"National Geographic Travel","profilePicUrl":null,"profilePicCdnUrl":null,"followers":44520150,"primaryNiche":null,"identity":{"displayName":"National Geographic Travel","displayHandle":"natgeotravel","stableId":null,"stableIdType":"instagram_id","externalUrl":"https://www.instagram.com/natgeotravel/"}}],"meta":{"cost":"$0.0002","balance":"$9.9875","request_id":"req_4ec594af878fa2929bbf601a5e808276"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/creators/filter-options":{"get":{"tags":["Creator Search"],"operationId":"creatorsFilterOptions","summary":"Filter values","description":"The countries, niches, sub-niches and languages in the index, each with its profile count. Use these spellings in the search filters. Free: reference data costs nothing.","x-dashboard-cost":"Free","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Stored index rows.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":true},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"countries":[{"code":"United States","count":8370},{"code":"South Korea","count":6208},{"code":"Brazil","count":4317},{"code":"unknown","count":4266},{"code":"India","count":3929}],"niches":[{"niche":"beauty","count":9808},{"niche":"music","count":3635},{"niche":"fashion","count":3263},{"niche":"lifestyle","count":2780},{"niche":"entertainment","count":2260}],"subNiches":[{"subNiche":"skincare","count":4845},{"subNiche":"makeup","count":2906},{"subNiche":"K-beauty","count":2467},{"subNiche":"lifestyle","count":1717},{"subNiche":"beauty product reviews","count":1622}],"languages":[{"code":"English","count":23999},{"code":"Korean","count":5692},{"code":"Portuguese","count":4501},{"code":"Spanish","count":4180},{"code":"Arabic","count":1313}]},"meta":{"cost":"$0.00","balance":"$9.9875","request_id":"req_1e6d54611d8e7a66235851c2b98c387a"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/creators/avatars":{"get":{"tags":["Creator Search"],"operationId":"creatorsAvatars","summary":"Avatar URLs","description":"Profile picture URLs for up to 100 Instagram handles, as `{ handle: url }`. The URL is our permanent mirror copy when we hold one, else the platform CDN URL, which expires. A handle we do not hold maps to null, and a call that finds no avatar costs $0.","x-dashboard-cost":"$0.0002","security":[{"bearerAuth":[]}],"parameters":[{"name":"usernames","in":"query","required":true,"description":"Comma-separated Instagram handles, up to 100. A leading @ is dropped.","example":"natgeo,nike","schema":{"type":"string","maxLength":10100,"example":"natgeo,nike"}}],"x-example-query":{"usernames":"natgeo,nike"},"responses":{"200":{"description":"Stored index rows.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":true},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"natgeo":"https://f005.backblazeb2.com/file/influencer-dev/staging/crawler/instagram_account/1070.webp","nike":"https://f005.backblazeb2.com/file/influencer-dev/staging/crawler/instagram_account/7346.webp"},"meta":{"cost":"$0.0002","balance":"$9.9875","request_id":"req_845f68f2441805c7ec91ff66e08054bd"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/creators/profiles/refresh-status":{"post":{"tags":["Creator Search"],"operationId":"creatorsRefreshStatus","summary":"Data freshness","description":"How fresh our stored copy of each handle is, for up to 500 handles on one platform: `known` (we hold the account), `last_scraped_at`, `candidate_status` and `refresh_pending` (a crawl is queued). It reads state and never queues a crawl; fetch a fresh copy with the live operations.","x-dashboard-cost":"$0.0002","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["usernames"],"properties":{"platform":{"type":"string","enum":["instagram","tiktok","youtube"],"default":"instagram"},"usernames":{"type":"array","minItems":1,"maxItems":500,"items":{"type":"string","maxLength":100}}}},"example":{"platform":"instagram","usernames":["natgeo","nike"]}}}},"responses":{"200":{"description":"Stored index rows.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":true},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"platform":"instagram","profiles":{"natgeo":{"known":true,"last_scraped_at":"2026-10-12T13:19:36.696294+00:00","candidate_status":"queued","refresh_pending":true},"nike":{"known":true,"last_scraped_at":"2026-10-10T08:17:46.275764+00:00","candidate_status":"crawled","refresh_pending":false}}},"meta":{"cost":"$0.0002","balance":"$9.9875","request_id":"req_21a0750e0b2e0ebc208d70b43d9fc026"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/instagram/profile":{"get":{"tags":["Instagram"],"operationId":"igProfile","summary":"Profile","x-dashboard-cost":"$0.0005","description":"The canonical Instagram profile read model over the tracked corpus: followers, bio, category, engagement fields, and the AI enrichment block when present.\n\nStrictly DB — a profile we have never crawled is a `404`, never a crawl. Fetch fresh raw data with `/v1/instagram/web_profile_info`.\n\nThe response carries no email or contact block. Find emails with `/v1/contacts/find-from-instagram/fast` or the other `/v1/contacts/find*` paths.","security":[{"bearerAuth":[]}],"parameters":[{"name":"q","in":"query","required":true,"description":"Instagram username, @handle, or full profile URL (`instagram.com/username`).","schema":{"type":"string"},"example":"nike"}],"responses":{"200":{"description":"Canonical profile.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object"},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"id":1417,"profile_id":258299,"platform":"instagram","username":"nike","ig_id":"13460080","fbid":"17841400602400210","full_name":"Nike","biography":"Just Do It.","profile_pic_url":"https://instagram.fsal2-2.fna.fbcdn.net/v/t51.82787-19/551608484_18567162979020081_1135468084872726555_n.jpg?stp=dst-jpg_s320x320_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby4zOTkuYzIifQ&_nc_ht=instagram.fsal2-2.fna.fbcdn.net&_nc_cat=1&_nc_oc=Q6cZ2gGg3efrgzYJ5DUjyr-OTzRsNs0zMfBHYSZMcBp9diVJykLrFs17yVbZu4RS9yUOzfY7Lp8oS9VmPjlBVwQ8G3Nf&_nc_ohc=avi3U-uQwMoQ7kNvwF4mFEl&_nc_gid=qylNB7Z2Q5ACJy8qLvZHAQ&edm=AOQ1c0wBAAAA&ccb=7-5&oh=00_AQAAGJX8ReesYygfEmJ_xZT0p1QJAnM9jSCTgnKs7_HeDw&oe=6A5982FA&_nc_sid=8b3546","external_urls":["http://empli.fi/nike"],"followers":291803736,"following":264,"posts_count":1661,"is_verified":true,"is_private":false,"is_business_account":true,"is_professional_account":true,"category_name":null,"business_category_name":null,"has_channel":false,"scrape_count":11,"first_scraped_at":"2026-07-09T16:06:59.020178Z","last_scraped_at":"2026-07-12T15:46:31.029881Z","enriched_at":"2026-07-09T20:37:29.016981Z","enrichment":{"entity_type":"brand","account_role":"brand","primary_niche":"Sportswear / Athletic Apparel","sub_niches":["Sneakers","Performance training"],"content_tags":null,"commercial_intent":"fully_commercial","gender":"unknown","age_range":null,"profession":null,"country":"United States","city":null,"primary_language":"English","languages":null,"tagline":"Just Do It.","bio_summary":"Nike is a global sportswear and athletic lifestyle brand focused on performance, innovation, and athlete storytelling. Its Instagram centers on major sports moments, product launches, and endorsements featuring elite athletes across football, basketball, tennis, and broader sports culture.","content_summary":"Posts highlight sponsored athletes, championship moments, new footwear and apparel releases, and branded storytelling around football and basketball. The account blends product marketing with aspirational sports content and cultural collaborations.","audience_summary":null,"brand_fit_summary":null,"brand_safety":"safe","content_style":null,"collab_readiness":null,"enrichment_version":"v3-gpt5.4mini","enriched_at":"2026-07-09T20:37:29.016981Z"}},"meta":{"cost":"$0.0005","balance":"$0.3762","request_id":"req_9cf15dc982c8f4d80b26495b3932b542"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"404":{"description":"Profile not in the tracked corpus.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_found","message":"nosuchuser","request_id":"req_5c10900e919bc7a3ff79b7501d582b4c"}}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/instagram/stored/profile/full":{"get":{"tags":["Instagram"],"operationId":"igStoredProfileFull","summary":"Stored full profile","description":"The stored full profile view in one call: `profile` (with AI enrichment fields when present), `topContent`, `hashtags`, `collaborations`, `mentionedAccounts`, `brandCollabRate` and a posting `timeline`. `surface` picks a smaller view: `overlay` or `preview`. Contact fields are not included; emails come from `/v1/contacts/find-from-instagram/{fast,thorough}`.\n\nStrictly DB: this reads what the crawler already stored and never crawls. A miss is a `404` and is not billed. Fresh data comes from `/v1/instagram/web_profile_info` and `/v1/instagram/user_feed`.","x-dashboard-cost":"$0.001","security":[{"bearerAuth":[]}],"parameters":[{"name":"q","in":"query","required":true,"description":"Username, @handle, or profile URL.","example":"natgeo","schema":{"type":"string","maxLength":200,"example":"natgeo"}},{"name":"surface","in":"query","required":false,"description":"Which view to return.","schema":{"type":"string","enum":["full","overlay","preview"],"default":"full"},"examples":{"default":{"value":"full","x-disabled":true}}}],"responses":{"200":{"description":"Success. The example is a captured response; long lists are truncated.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":true},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"profile":{"id":1070,"profileId":1172,"username":"natgeo","fullName":"National Geographic","biography":"Step into wonder and find your inner explorer with National Geographic 🌎","profilePicUrl":"https://scontent-bos5-1.cdninstagram.com/v/t51.82787-19/683576066_18653628823019133_9051036240972105113_n.jpg?stp=dst-jpg_s150x150_tt6&_nc_cat=1&ccb=7-5&_nc_sid=f7ccc5&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLnd3dy40MDAuQzMifQ%3D%3D&_nc_ohc=9DX3oxEQASoQ7kNvwHuwd5t&_nc_oc=AdqTjrV5nKAeDwYI85Qw551hNy8DZnv4F6v2e5dfd_8JkXgmW2H9OxI0EJwnI0NGA7s&_nc_zt=24&_nc_ht=scontent-bos5-1.cdninstagram.com&_nc_gid=CmiPjGYQxxCghW14b-9urw&_nc_ss=7ba8c&oh=00_AQPljNrV_pNJxTZ6ybh7zr3KN_4mJcTnGn6Yc-6I1T52vA&oe=6AD2B02B","externalUrls":["http://visitstore.bio/natgeo","https://ngmdomsubs.nationalgeographic.com/servlet/OrdersGateway?cds_mag_code=NGM&cds_page_id=283562&cds_response_key=I5FX10002"],"followers":268396479,"following":194,"postsCount":null,"isVerified":true,"isPrivate":false,"isBusinessAccount":false,"categoryName":null,"lastScrapedAt":"2026-10-12T12:48:21.285547+00:00","accountRole":"media","primaryNiche":"outdoors","subNiches":["wildlife","nature","conservation","science","exploration","nature photography","travel"],"tagline":"Step into wonder and find your inner explorer.","country":"United States","gender":"unknown","ageRange":null,"language":"English","bioSummary":"National Geographic’s global media account focused on exploration, science, wildlife, nature, and conservation.","enrichedAt":"2026-10-12T12:53:37.236725+00:00"},"topContent":[{"shortcode":"DdZI_E3gMqg","caption":"New cat alert! A call from a wildlife sanctuary about a \"weird cat\" has led to the first new cat species discovered in over 100 years. Smaller than an average housecat and covered in leopard-like spots, the cat species—proposed name Leopardus tilcayo—lives in Bolivia’s Yungas forest ecoregion, and very little is known about its day-to-day life in the wild. Its discovery is redrawing the branches of the cat family tree, and researchers hope the methods used to identify it could be used to find even more new cat species around the world.\n\nLearn more about this feline surprise at the link in bio. \n\nVideo by @joelsartore, National Geographic Photo Ark","likes":3088502,"comments":15823,"views":35482621,"postedAt":"2026-09-17T15:05:25+00:00","imageUrl":"https://instagram.fymq3-1.fna.fbcdn.net/v/t51.82787-15/813582906_18698219032019133_7848075312635520841_n.jpg?stp=dst-jpg_e15_s640x640_tt6&_nc_cat=107&_nc_map=urlgen_bucketless&ig_cache_key=Mzk4ODI1ODQ2MzkzODU2MjcyMDE4Njk4MjE5MDI2MDE5MTMz.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6IkNMSVBTLnhwaWRzLjEwODAuc2RyLnZpZGVvX2RlZmF1bHRfY292ZXJfZnJhbWUuQzMifQ%3D%3D&_nc_ohc=W8hQW2QOoH4Q7kNvwGxtf4e&_nc_oc=AdrSWmm5PreZOo-8pCTAHnA3FOdZGPKpquDmd5lRlTUtq65zscGvNk5HoYsDPAWIYPQ&_nc_ad=z-m&_nc_cid=0&_nc_zt=23&_nc_ht=instagram.fymq3-1.fna&_nc_gid=FLs6GXRyvd9_5eNwpKkX_g&_nc_ss=7a3ba&oh=00_AQO3tZwhFUvNFq8-oKIUmJkmg5LNpyHbBJxLxFdWv5mz9g&oe=6AC509AA","imageCdnUrl":null,"videoUrl":"https://instagram.fyhu2-1.fna.fbcdn.net/o1/v/t2/f2/m86/AQOkf7NQAcQRZit4GgZVys1N6tW54bBBXcG6h9FnStFOx5ovT3q4-iIiDiQWAVedU5TTrZzBgWEaK-LQuvGC2ddTSzxo0PkMw9o3MhY.mp4?_nc_cat=102&_nc_oc=AdryVYsw9LEagEu23Ba0tcF_ehJXBkMRue7tSfGbsxyal-Y1pKF5u5t08WfmjlulJsI&_nc_sid=5e9851&_nc_ht=instagram.fyhu2-1.fna.fbcdn.net&_nc_ohc=_TiR5bpo0cIQ7kNvwEfVvuY&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5JTlNUQUdSQU0uQ0xJUFMuQzMuNzIwLmRhc2hfYmFzZWxpbmVfMV92MSIsInhwdl9hc3NldF9pZCI6MjU5NTQ5MDgxNDIwNTI2NywiYXNzZXRfYWdlX2RheXMiOjE0LCJ2aV91c2VjYXNlX2lkIjoxMDA5OSwiZHVyYXRpb25fcyI6MTAsInVybGdlbl9zb3VyY2UiOiJ3d3cifQ%3D%3D&ccb=17-1&vs=7741d60a75b95e80&_nc_vs=HBksFQIYUmlnX3hwdl9yZWVsc19wZXJtYW5lbnRfc3JfcHJvZC9EQjRGQzE3ODQyMDlGRkU2OEZGNDUwQjBBNjFFNkVBQV92aWRlb19kYXNoaW5pdC5tcDQVAALIARIAFQIYUWlnX3hwdl9wbGFjZW1lbnRfcGVybWFuZW50X3YyLzI5NDE3QUVGOUU0QTUwNjdGOUExNTlDQTY3RjM4MzlCX2F1ZGlvX2Rhc2hpbml0Lm1wNBUCAsgBEgAoABgAGwKIB3VzZV9vaWwBMRJwcm9ncmVzc2l2ZV9yZWNpcGUBMRUAACam9fy_uaWcCRUCKAJDMywXQCQFHrhR64UYEmRhc2hfYmFzZWxpbmVfMV92MREAdf4HZeadAQA&_nc_gid=FLs6GXRyvd9_5eNwpKkX_g&_nc_ss=7a3ba&_nc_map=urlgen_bucketless&_nc_zt=28&oh=00_AQPZu80P8REhswTZLw6D1s25IP1h9_eSU-K2xFGDAWjk9A&oe=6AC1042B","isVideo":true,"isPinned":false,"captionMentions":[]},{"shortcode":"DdZlgTZgUkJ","caption":"On safari in the Pantanal, photographer @sandesh_kadur noticed a black vulture in the middle of the water. \"I wasn't sure what was going on, so our amazing Boat Guide, Branco, veered towards the vulture. That’s when I saw a dead caiman floating on the water's surface. The single vulture that had landed on it was trying in desperation to feed on the carcass, but the log-rolling caiman proved to be quite the challenge—like trying to eat while on a treadmill.\"","likes":1359002,"comments":8008,"views":31293188,"postedAt":"2026-09-17T19:14:33+00:00","imageUrl":"https://instagram.fymq2-1.fna.fbcdn.net/v/t51.82787-15/814651185_18698292772019133_1184202256474398124_n.jpg?stp=dst-jpg_e15_s640x640_tt6&_nc_cat=105&_nc_map=urlgen_bucketless&ig_cache_key=Mzk4ODM4Mzg5MjU4NjQ0OTE2MTE4Njk4MjkyNzY5MDE5MTMz.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6IkNMSVBTLnhwaWRzLjEwODAuc2RyLnZpZGVvX2RlZmF1bHRfY292ZXJfZnJhbWUuQzMifQ%3D%3D&_nc_ohc=peDe6RmTxykQ7kNvwE0cQFw&_nc_oc=Adpd43dICcZNIVOFmGinmuQ2hqE7wNfYNMzIqHXzbY10FgruamD4RGRC17l8JRW8THc&_nc_ad=z-m&_nc_cid=0&_nc_zt=23&_nc_ht=instagram.fymq2-1.fna&_nc_gid=FLs6GXRyvd9_5eNwpKkX_g&_nc_ss=7a3ba&oh=00_AQMKea-uhLOhcrQH1ycmMp7tnIIdqf2NRwy9kJ900lX6uQ&oe=6AC4FAAE","imageCdnUrl":null,"videoUrl":"https://instagram.fymq3-1.fna.fbcdn.net/o1/v/t2/f2/m86/AQNkECWJ6QijX5H-Hc2FKP09Mt9khocrQzsulCJl8YEZCmPVH6OMRAjGgEDL8gArbIo7263LmMHBS5O2BZUd2lVOMRZkPH2pmgZ-SmM.mp4?_nc_cat=110&_nc_oc=AdosgYJcKY4rVpX2xcU6gPBppMAeAY6M3tUKwkMi3DNL6XeVAHzuIHSLL0xoie11NUA&_nc_sid=5e9851&_nc_ht=instagram.fymq3-1.fna.fbcdn.net&_nc_ohc=YDS7-ItpoOYQ7kNvwFqpTbc&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5JTlNUQUdSQU0uQ0xJUFMuQzMuNzIwLmRhc2hfYmFzZWxpbmVfMV92MSIsInhwdl9hc3NldF9pZCI6MTQ0ODMwMjU5Mzg3MjU1MCwiYXNzZXRfYWdlX2RheXMiOjE0LCJ2aV91c2VjYXNlX2lkIjoxMDA5OSwiZHVyYXRpb25fcyI6MTIsInVybGdlbl9zb3VyY2UiOiJ3d3cifQ%3D%3D&ccb=17-1&vs=e8bfcb8035e6a9e9&_nc_vs=HBksFQIYUmlnX3hwdl9yZWVsc19wZXJtYW5lbnRfc3JfcHJvZC9GMDRBOUJFMTFGMDc4RjAxMkVGQzY1RDg5MzRCRjBCNV92aWRlb19kYXNoaW5pdC5tcDQVAALIARIAFQIYUWlnX3hwdl9wbGFjZW1lbnRfcGVybWFuZW50X3YyL0QyNDEyRDU1MTcxOTNDMTBGN0NCNUFDQTU2NzIyNTkxX2F1ZGlvX2Rhc2hpbml0Lm1wNBUCAsgBEgAoABgAGwKIB3VzZV9vaWwBMRJwcm9ncmVzc2l2ZV9yZWNpcGUBMRUAACbMypSap86SBRUCKAJDMywXQCgGJN0vGqAYEmRhc2hfYmFzZWxpbmVfMV92MREAdf4HZeadAQA&_nc_gid=FLs6GXRyvd9_5eNwpKkX_g&_nc_ss=7a3ba&_nc_map=urlgen_bucketless&_nc_zt=28&oh=00_AQPlvzDjUbkIaVtmphViwbRTSA7Hyy4ekw9Jja6QQQQeEA&oe=6AC113FF","isVideo":true,"isPinned":false,"captionMentions":[]}],"hashtags":[],"collaborations":[],"mentionedAccounts":[],"brandCollabRate":0,"timeline":{"posts":[{"shortcode":"DeR4RetDg3c","caption":"Video and photos by @babaktafreshi | On Tuesday morning I photographed a celestial spectacle right in my backyard, near Boston. Hidden behind the moon for an hour, Jupiter reappeared from the dark night side of the moon, like a sparkling diamond. The rare phenomenon is called occultation. \n\nSlide 1: timelapse videos of the scene through a 600mm telephoto lens (cropped). Note the four lined up Galilean Moons of Jupiter. \nSlide 2: Moon is departing away from the alignment in twilight. \nSlide 3: An HDR image (3 exposures) to reveal the lunar details in both its bright dayside and the faint earthshine glow on the night side of the moon. \nSlide 4: A longer 30-second exposure on a star tracker has overexposed the moon to reveal the background starry sky.","likes":213810,"comments":498,"views":null,"postedAt":"2026-10-09T22:00:01+00:00","imageUrl":"https://scontent-mia3-3.cdninstagram.com/v/t51.71878-15/842400173_1638075984369415_3088859804842363817_n.jpg?stp=dst-jpg_e15_p360x360_tt6&_nc_cat=1&ig_cache_key=NDAwNDIyODc2Nzc4MTI1NDkxMw%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6IkNBUk9VU0VMX0lURU0ueHBpZHMuNjQwLnNkci52aWRlb19kZWZhdWx0X2NvdmVyX2ZyYW1lLkMzIn0%3D&_nc_ohc=uU9Y8k2bGK8Q7kNvwFeEqaD&_nc_oc=AdovECtWSUTBJ018Ck6RN2uLndFArvaWA5ZIeskSljDOv-incnUwYPEq89UaBtOa-eM&_nc_ad=z-m&_nc_cid=0&_nc_zt=23&_nc_ht=scontent-mia3-3.cdninstagram.com&_nc_gid=wVJjx_oUQmu1xjgLFVei-A&_nc_ss=7a3ba&oh=00_AQPCRjGz0236zn2w31u1iBxLessVU9tEOf6wOBknvcs-8A&oe=6ACFBE60","imageCdnUrl":null,"videoUrl":null,"isVideo":false,"isPinned":false,"captionMentions":[]},{"shortcode":"DeNRLCCF4kk","caption":"In the Alaska Peninsula, a brown bear surrounds a school of sockeye salmon that had journeyed thousands of miles upstream to the freshwaters of Alaska from the Pacific Ocean. Photographer @mikerigney told National Geographic this salmon migration was \"easily one of the most beautiful natural displays I've ever seen.\"\n\nSee more Photos of the Day at the link in bio.","likes":220542,"comments":334,"views":null,"postedAt":"2026-10-08T16:00:01+00:00","imageUrl":"https://scontent-mia3-3.cdninstagram.com/v/t51.82787-15/841815809_18705347188019133_8640404105611254917_n.jpg?stp=dst-jpg_e35_s1080x1080_sh2.08_tt6&_nc_cat=1&ig_cache_key=NDAwMjkzMTE2ODY4OTc1MjM1Ng%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6IkZFRUQueHBpZHMuMTQzOS5zZHIucmVndWxhcl9waG90by5DMyJ9&_nc_ohc=GTUjj2uHYbMQ7kNvwEPPhRl&_nc_oc=AdqilNzFOGe7VjwRIOhKvfNBD0v07TYUoQTnx6RiT4K4HC4nKMGJWjtau6j1Iu7CbYo&_nc_ad=z-m&_nc_cid=0&_nc_zt=23&_nc_ht=scontent-mia3-3.cdninstagram.com&_nc_gid=wVJjx_oUQmu1xjgLFVei-A&_nc_ss=7a3ba&oh=00_AQOOEuYPJ0NdhBmYIBg-6SFl_YYyiLGJpECR64FRgzlVQQ&oe=6ACFB9C6","imageCdnUrl":null,"videoUrl":null,"isVideo":false,"isPinned":false,"captionMentions":[]}],"reels":[{"shortcode":"DeSNiSGgoI-","caption":"We could stay here a while. 🌿\n\n#Queens is streaming on @DisneyPlus and @hulu.","likes":162131,"comments":520,"views":1459303,"postedAt":"2026-10-09T19:01:40+00:00","imageUrl":"https://scontent-mia3-3.cdninstagram.com/v/t51.82787-15/844190302_18706032907019133_2439034891193281727_n.jpg?stp=dst-jpg_e15_s640x640_tt6&_nc_cat=1&ig_cache_key=NDAwNDMyMjU0OTE4OTIxNDc4Mg%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6IkNMSVBTLnhwaWRzLjEwODAuc2RyLnZpZGVvX2RlZmF1bHRfY292ZXJfZnJhbWUuQzMifQ%3D%3D&_nc_ohc=9pthyby7djoQ7kNvwEe3-L0&_nc_oc=AdqWSHySBVOORJBb09NdxP69qpJ1Vxym3VYnz4CgtfcAEM6BV5u2DnzGR--jit8g9ks&_nc_ad=z-m&_nc_cid=0&_nc_zt=23&_nc_ht=scontent-mia3-3.cdninstagram.com&_nc_gid=wVJjx_oUQmu1xjgLFVei-A&_nc_ss=7a3ba&oh=00_AQP__qc-5jfDrPCWwxMAaBKie4g_97_jBZpzo5gC2RrYBw&oe=6ACFD810","imageCdnUrl":null,"videoUrl":"https://scontent-mia3-2.cdninstagram.com/o1/v/t2/f2/m86/AQMdMrZT83Pf8Ij8yn7jzmMVrePHMkMYX3ZXpKjfFbXWKyvbTuifpO7Xx-FXXFaLnLOCHRv20_0bWLuRKkuGRZsrrhCzMx_kHgCSkpg.mp4?_nc_cat=105&_nc_sid=5e9851&_nc_ht=scontent-mia3-2.cdninstagram.com&_nc_ohc=Ne45CjAn7kIQ7kNvwFhiRdZ&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5JTlNUQUdSQU0uQ0xJUFMuQzMuNzIwLmRhc2hfYmFzZWxpbmVfMV92MSIsInhwdl9hc3NldF9pZCI6MjExODg5MjA1ODc0MTUyNiwiYXNzZXRfYWdlX2RheXMiOjAsInZpX3VzZWNhc2VfaWQiOjEwMDk5LCJkdXJhdGlvbl9zIjoxMSwidXJsZ2VuX3NvdXJjZSI6Ind3dyJ9&ccb=17-1&vs=700691ac237f07e6&_nc_vs=HBksFQIYUmlnX3hwdl9yZWVsc19wZXJtYW5lbnRfc3JfcHJvZC9ENTExRDBCQ0M1M0I0NjdEQjFDNUU0NjNCREU5NzA3Q192aWRlb19kYXNoaW5pdC5tcDQVAALIARIAFQIYUWlnX3hwdl9wbGFjZW1lbnRfcGVybWFuZW50X3YyL0MwRTFCMjE4QTNCNDQ1OTg5RDc4QzBFNTFGQkI2RjBFX2F1ZGlvX2Rhc2hpbml0Lm1wNBUCAsgBEgAoABgAGwKIB3VzZV9vaWwBMRJwcm9ncmVzc2l2ZV9yZWNpcGUBMRUAACasrNSH4MfDBxUCKAJDMywXQCY9cKPXCj0YEmRhc2hfYmFzZWxpbmVfMV92MREAdf4HZeadAQA&_nc_gid=wVJjx_oUQmu1xjgLFVei-A&_nc_ss=7a3ba&_nc_zt=28&oh=00_AQOdChf47UC3yPKAX9oxaT8_TyDDb09KebLs-jy6wNc1-Q&oe=6ACBD842","isVideo":true,"isPinned":false,"captionMentions":[]},{"shortcode":"DePpLegAuKI","caption":"Many orphaned giant anteater pups in Brazil are still nursing when their mothers are killed in road collisions. At rehabilitation centers, caregivers bottle-feed them, provide around-the-clock care, and help them build strength for a possible return to the wild. Nat Geo Explorer @fernando.faciole spent three years documenting these young animals and the people caring for them.\n\nSee how researchers are making Brazil's roads safer for giant anteaters at the link in bio.","likes":80742,"comments":283,"views":2090870,"postedAt":"2026-10-08T19:05:31+00:00","imageUrl":"https://scontent-mia3-3.cdninstagram.com/v/t51.82787-15/839913705_18705672832019133_6199658414569469270_n.jpg?stp=dst-jpg_e15_s640x640_tt6&_nc_cat=1&ig_cache_key=NDAwMzU5OTcwMjMyNjE3NDM0NA%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6IkNMSVBTLnhwaWRzLjEwODAuc2RyLnZpZGVvX2RlZmF1bHRfY292ZXJfZnJhbWUuQzMifQ%3D%3D&_nc_ohc=Q5SWD2YYg8YQ7kNvwH6yhug&_nc_oc=Adqh6HInTekiVaL_WLJV91k5AwvTz4zLvPxJ6_IQPg4chQ5JGXCKJv0LT19BGbocINc&_nc_ad=z-m&_nc_cid=0&_nc_zt=23&_nc_ht=scontent-mia3-3.cdninstagram.com&_nc_gid=wVJjx_oUQmu1xjgLFVei-A&_nc_ss=7a3ba&oh=00_AQNlGhclveuv1y8eXC9mbLZ8N0nYn54eRNtLIAUHcZ2Oew&oe=6ACFB9F4","imageCdnUrl":null,"videoUrl":"https://scontent-mia5-2.cdninstagram.com/o1/v/t2/f2/m86/AQNeQcVPUc6Q79ehc_Emag_zdCCgJchkrR3eofjReM16iHBjJpxKWFOeghoCB3KPGay8WE-QEo2Vm_-4Zhax485A4tOaRe_Fn0Spp-8.mp4?_nc_cat=100&_nc_sid=5e9851&_nc_ht=scontent-mia5-2.cdninstagram.com&_nc_ohc=mHUxFt_JSrkQ7kNvwGsDa7p&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5JTlNUQUdSQU0uQ0xJUFMuQzMuNzIwLmRhc2hfYmFzZWxpbmVfMV92MSIsInhwdl9hc3NldF9pZCI6MTc5NjUyMDg0NDg4NTIyNywiYXNzZXRfYWdlX2RheXMiOjEsInZpX3VzZWNhc2VfaWQiOjEwMDk5LCJkdXJhdGlvbl9zIjo5LCJ1cmxnZW5fc291cmNlIjoid3d3In0%3D&ccb=17-1&vs=98e564bceb9bb8d8&_nc_vs=HBksFQIYUmlnX3hwdl9yZWVsc19wZXJtYW5lbnRfc3JfcHJvZC8xMUZBMDFGOTk5QTI0RTlEQjFFNzI2MjZDRDQ5MkIzMF92aWRlb19kYXNoaW5pdC5tcDQVAALIARIAFQIYUWlnX3hwdl9wbGFjZW1lbnRfcGVybWFuZW50X3YyLzVDRkRDMDUzN0VGNzQ1MzU4NDI3ODM2QkIyNUJFRTdFX2F1ZGlvX2Rhc2hpbml0Lm1wNBUCAsgBEgAoABgAGwKIB3VzZV9vaWwBMRJwcm9ncmVzc2l2ZV9yZWNpcGUBMRUAACbW89Oso_uwBhUCKAJDMywXQCJ752yLQ5YYEmRhc2hfYmFzZWxpbmVfMV92MREAdf4HZeadAQA&_nc_gid=wVJjx_oUQmu1xjgLFVei-A&_nc_ss=7a3ba&_nc_zt=28&oh=00_AQN-11_X3Pn4ny_DxGAPAR7P163r_2Y53FbZhw_W34x7_Q&oe=6ACBAE01","isVideo":true,"isPinned":false,"captionMentions":[]}],"all":[{"shortcode":"DeR4RetDg3c","caption":"Video and photos by @babaktafreshi | On Tuesday morning I photographed a celestial spectacle right in my backyard, near Boston. Hidden behind the moon for an hour, Jupiter reappeared from the dark night side of the moon, like a sparkling diamond. The rare phenomenon is called occultation. \n\nSlide 1: timelapse videos of the scene through a 600mm telephoto lens (cropped). Note the four lined up Galilean Moons of Jupiter. \nSlide 2: Moon is departing away from the alignment in twilight. \nSlide 3: An HDR image (3 exposures) to reveal the lunar details in both its bright dayside and the faint earthshine glow on the night side of the moon. \nSlide 4: A longer 30-second exposure on a star tracker has overexposed the moon to reveal the background starry sky.","likes":213810,"comments":498,"views":null,"postedAt":"2026-10-09T22:00:01+00:00","imageUrl":"https://scontent-mia3-3.cdninstagram.com/v/t51.71878-15/842400173_1638075984369415_3088859804842363817_n.jpg?stp=dst-jpg_e15_p360x360_tt6&_nc_cat=1&ig_cache_key=NDAwNDIyODc2Nzc4MTI1NDkxMw%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6IkNBUk9VU0VMX0lURU0ueHBpZHMuNjQwLnNkci52aWRlb19kZWZhdWx0X2NvdmVyX2ZyYW1lLkMzIn0%3D&_nc_ohc=uU9Y8k2bGK8Q7kNvwFeEqaD&_nc_oc=AdovECtWSUTBJ018Ck6RN2uLndFArvaWA5ZIeskSljDOv-incnUwYPEq89UaBtOa-eM&_nc_ad=z-m&_nc_cid=0&_nc_zt=23&_nc_ht=scontent-mia3-3.cdninstagram.com&_nc_gid=wVJjx_oUQmu1xjgLFVei-A&_nc_ss=7a3ba&oh=00_AQPCRjGz0236zn2w31u1iBxLessVU9tEOf6wOBknvcs-8A&oe=6ACFBE60","imageCdnUrl":null,"videoUrl":null,"isVideo":false,"isPinned":false,"captionMentions":[]},{"shortcode":"DeSNiSGgoI-","caption":"We could stay here a while. 🌿\n\n#Queens is streaming on @DisneyPlus and @hulu.","likes":162131,"comments":520,"views":1459303,"postedAt":"2026-10-09T19:01:40+00:00","imageUrl":"https://scontent-mia3-3.cdninstagram.com/v/t51.82787-15/844190302_18706032907019133_2439034891193281727_n.jpg?stp=dst-jpg_e15_s640x640_tt6&_nc_cat=1&ig_cache_key=NDAwNDMyMjU0OTE4OTIxNDc4Mg%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6IkNMSVBTLnhwaWRzLjEwODAuc2RyLnZpZGVvX2RlZmF1bHRfY292ZXJfZnJhbWUuQzMifQ%3D%3D&_nc_ohc=9pthyby7djoQ7kNvwEe3-L0&_nc_oc=AdqWSHySBVOORJBb09NdxP69qpJ1Vxym3VYnz4CgtfcAEM6BV5u2DnzGR--jit8g9ks&_nc_ad=z-m&_nc_cid=0&_nc_zt=23&_nc_ht=scontent-mia3-3.cdninstagram.com&_nc_gid=wVJjx_oUQmu1xjgLFVei-A&_nc_ss=7a3ba&oh=00_AQP__qc-5jfDrPCWwxMAaBKie4g_97_jBZpzo5gC2RrYBw&oe=6ACFD810","imageCdnUrl":null,"videoUrl":"https://scontent-mia3-2.cdninstagram.com/o1/v/t2/f2/m86/AQMdMrZT83Pf8Ij8yn7jzmMVrePHMkMYX3ZXpKjfFbXWKyvbTuifpO7Xx-FXXFaLnLOCHRv20_0bWLuRKkuGRZsrrhCzMx_kHgCSkpg.mp4?_nc_cat=105&_nc_sid=5e9851&_nc_ht=scontent-mia3-2.cdninstagram.com&_nc_ohc=Ne45CjAn7kIQ7kNvwFhiRdZ&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5JTlNUQUdSQU0uQ0xJUFMuQzMuNzIwLmRhc2hfYmFzZWxpbmVfMV92MSIsInhwdl9hc3NldF9pZCI6MjExODg5MjA1ODc0MTUyNiwiYXNzZXRfYWdlX2RheXMiOjAsInZpX3VzZWNhc2VfaWQiOjEwMDk5LCJkdXJhdGlvbl9zIjoxMSwidXJsZ2VuX3NvdXJjZSI6Ind3dyJ9&ccb=17-1&vs=700691ac237f07e6&_nc_vs=HBksFQIYUmlnX3hwdl9yZWVsc19wZXJtYW5lbnRfc3JfcHJvZC9ENTExRDBCQ0M1M0I0NjdEQjFDNUU0NjNCREU5NzA3Q192aWRlb19kYXNoaW5pdC5tcDQVAALIARIAFQIYUWlnX3hwdl9wbGFjZW1lbnRfcGVybWFuZW50X3YyL0MwRTFCMjE4QTNCNDQ1OTg5RDc4QzBFNTFGQkI2RjBFX2F1ZGlvX2Rhc2hpbml0Lm1wNBUCAsgBEgAoABgAGwKIB3VzZV9vaWwBMRJwcm9ncmVzc2l2ZV9yZWNpcGUBMRUAACasrNSH4MfDBxUCKAJDMywXQCY9cKPXCj0YEmRhc2hfYmFzZWxpbmVfMV92MREAdf4HZeadAQA&_nc_gid=wVJjx_oUQmu1xjgLFVei-A&_nc_ss=7a3ba&_nc_zt=28&oh=00_AQOdChf47UC3yPKAX9oxaT8_TyDDb09KebLs-jy6wNc1-Q&oe=6ACBD842","isVideo":true,"isPinned":false,"captionMentions":[]}]}},"meta":{"cost":"$0.0010","balance":"$474.5828","request_id":"req_6fa34a16dae173f3139e3bcbf229d860"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"404":{"description":"The profile is not stored. You are not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/instagram/stored/profile/media":{"get":{"tags":["Instagram"],"operationId":"igStoredProfileMedia","summary":"Stored profile media","description":"A profile block and its newest stored posts, each with every media item: `ig_url` (the Instagram URL), `cdn_url` (our mirrored copy, null until mirrored) and `cdn_status`. `next_cursor` is an opaque string, null on the last page; send it back as `cursor` for the next one. `cdn_url` is either a file URL or a signed `/v1/media/{kind}/{id}/{slot}` URL on this host that serves the same image without an API key. A signed URL works for at least 7 days, and a later read answers a fresh one.\n\nStrictly DB: this reads what the crawler already stored and never crawls. A miss is a `404` and is not billed.\n\nBilling: $0.0005 per started block of 12 posts returned, like `/v1/instagram/user_feed`. `limit` is pre-authorized in full.","x-dashboard-cost":"$0.0005 per 12 posts","security":[{"bearerAuth":[]}],"parameters":[{"name":"q","in":"query","required":true,"description":"Username, @handle, or profile URL.","example":"natgeo","schema":{"type":"string","maxLength":200,"example":"natgeo"}},{"name":"limit","in":"query","required":false,"description":"Posts per page.","schema":{"type":"integer","minimum":1,"maximum":240,"default":12},"examples":{"default":{"value":12,"x-disabled":true}}},{"name":"cursor","in":"query","required":false,"description":"Opaque `next_cursor` from the previous page.","schema":{"type":"string","maxLength":500}}],"responses":{"200":{"description":"Success. The example is a captured response; long lists are truncated.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":true},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"next_cursor":"WzI2MzI5MDg1LCIyMDI2LTEwLTAxVDIyOjAwOjE1KzAwOjAwIl0","has_more":true,"profile":{"username":"natgeo","full_name":"National Geographic","biography":"Step into wonder and find your inner explorer with National Geographic 🌎","followers":268396479,"following":194,"posts_count":null,"is_private":false,"is_verified":true,"category_name":null,"external_urls":["http://visitstore.bio/natgeo","https://ngmdomsubs.nationalgeographic.com/servlet/OrdersGateway?cds_mag_code=NGM&cds_page_id=283562&cds_response_key=I5FX10002"],"profile_pic":{"kind":"profile_pic","ig_url":"https://scontent-bos5-1.cdninstagram.com/v/t51.82787-19/683576066_18653628823019133_9051036240972105113_n.jpg?stp=dst-jpg_s150x150_tt6&_nc_cat=1&ccb=7-5&_nc_sid=f7ccc5&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLnd3dy40MDAuQzMifQ%3D%3D&_nc_ohc=9DX3oxEQASoQ7kNvwHuwd5t&_nc_oc=AdqTjrV5nKAeDwYI85Qw551hNy8DZnv4F6v2e5dfd_8JkXgmW2H9OxI0EJwnI0NGA7s&_nc_zt=24&_nc_ht=scontent-bos5-1.cdninstagram.com&_nc_gid=CmiPjGYQxxCghW14b-9urw&_nc_ss=7ba8c&oh=00_AQPljNrV_pNJxTZ6ybh7zr3KN_4mJcTnGn6Yc-6I1T52vA&oe=6AD2B02B","cdn_url":"https://f005.backblazeb2.com/file/influencer-dev/staging/crawler/instagram_account/1070.webp","cdn_status":"completed"}},"posts":[{"shortcode":"DeR4RetDg3c","media_type":"image","posted_at":"2026-10-09T22:00:01+00:00","caption":"Video and photos by @babaktafreshi | On Tuesday morning I photographed a celestial spectacle right in my backyard, near Boston. Hidden behind the moon for an hour, Jupiter reappeared from the dark night side of the moon, like a sparkling diamond. The rare phenomenon is called occultation. \n\nSlide 1: timelapse videos of the scene through a 600mm telephoto lens (cropped). Note the four lined up Galilean Moons of Jupiter. \nSlide 2: Moon is departing away from the alignment in twilight. \nSlide 3: An HDR image (3 exposures) to reveal the lunar details in both its bright dayside and the faint earthshine glow on the night side of the moon. \nSlide 4: A longer 30-second exposure on a star tracker has overexposed the moon to reveal the background starry sky.","likes":213810,"comments":498,"items":[{"kind":"post_image","ig_url":"https://scontent-mia3-3.cdninstagram.com/v/t51.71878-15/842400173_1638075984369415_3088859804842363817_n.jpg?stp=dst-jpg_e15_p360x360_tt6&_nc_cat=1&ig_cache_key=NDAwNDIyODc2Nzc4MTI1NDkxMw%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6IkNBUk9VU0VMX0lURU0ueHBpZHMuNjQwLnNkci52aWRlb19kZWZhdWx0X2NvdmVyX2ZyYW1lLkMzIn0%3D&_nc_ohc=uU9Y8k2bGK8Q7kNvwFeEqaD&_nc_oc=AdovECtWSUTBJ018Ck6RN2uLndFArvaWA5ZIeskSljDOv-incnUwYPEq89UaBtOa-eM&_nc_ad=z-m&_nc_cid=0&_nc_zt=23&_nc_ht=scontent-mia3-3.cdninstagram.com&_nc_gid=wVJjx_oUQmu1xjgLFVei-A&_nc_ss=7a3ba&oh=00_AQPCRjGz0236zn2w31u1iBxLessVU9tEOf6wOBknvcs-8A&oe=6ACFBE60","cdn_url":null,"cdn_status":"absent"}],"thumb":{"kind":"post_image","ig_url":"https://scontent-mia3-3.cdninstagram.com/v/t51.71878-15/842400173_1638075984369415_3088859804842363817_n.jpg?stp=dst-jpg_e15_p360x360_tt6&_nc_cat=1&ig_cache_key=NDAwNDIyODc2Nzc4MTI1NDkxMw%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6IkNBUk9VU0VMX0lURU0ueHBpZHMuNjQwLnNkci52aWRlb19kZWZhdWx0X2NvdmVyX2ZyYW1lLkMzIn0%3D&_nc_ohc=uU9Y8k2bGK8Q7kNvwFeEqaD&_nc_oc=AdovECtWSUTBJ018Ck6RN2uLndFArvaWA5ZIeskSljDOv-incnUwYPEq89UaBtOa-eM&_nc_ad=z-m&_nc_cid=0&_nc_zt=23&_nc_ht=scontent-mia3-3.cdninstagram.com&_nc_gid=wVJjx_oUQmu1xjgLFVei-A&_nc_ss=7a3ba&oh=00_AQPCRjGz0236zn2w31u1iBxLessVU9tEOf6wOBknvcs-8A&oe=6ACFBE60","cdn_url":null,"cdn_status":"absent"}},{"shortcode":"DeSNiSGgoI-","media_type":"video","posted_at":"2026-10-09T19:01:40+00:00","caption":"We could stay here a while. 🌿\n\n#Queens is streaming on @DisneyPlus and @hulu.","likes":162131,"comments":520,"items":[{"kind":"video_file","ig_url":"https://scontent-mia3-2.cdninstagram.com/o1/v/t2/f2/m86/AQMdMrZT83Pf8Ij8yn7jzmMVrePHMkMYX3ZXpKjfFbXWKyvbTuifpO7Xx-FXXFaLnLOCHRv20_0bWLuRKkuGRZsrrhCzMx_kHgCSkpg.mp4?_nc_cat=105&_nc_sid=5e9851&_nc_ht=scontent-mia3-2.cdninstagram.com&_nc_ohc=Ne45CjAn7kIQ7kNvwFhiRdZ&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5JTlNUQUdSQU0uQ0xJUFMuQzMuNzIwLmRhc2hfYmFzZWxpbmVfMV92MSIsInhwdl9hc3NldF9pZCI6MjExODg5MjA1ODc0MTUyNiwiYXNzZXRfYWdlX2RheXMiOjAsInZpX3VzZWNhc2VfaWQiOjEwMDk5LCJkdXJhdGlvbl9zIjoxMSwidXJsZ2VuX3NvdXJjZSI6Ind3dyJ9&ccb=17-1&vs=700691ac237f07e6&_nc_vs=HBksFQIYUmlnX3hwdl9yZWVsc19wZXJtYW5lbnRfc3JfcHJvZC9ENTExRDBCQ0M1M0I0NjdEQjFDNUU0NjNCREU5NzA3Q192aWRlb19kYXNoaW5pdC5tcDQVAALIARIAFQIYUWlnX3hwdl9wbGFjZW1lbnRfcGVybWFuZW50X3YyL0MwRTFCMjE4QTNCNDQ1OTg5RDc4QzBFNTFGQkI2RjBFX2F1ZGlvX2Rhc2hpbml0Lm1wNBUCAsgBEgAoABgAGwKIB3VzZV9vaWwBMRJwcm9ncmVzc2l2ZV9yZWNpcGUBMRUAACasrNSH4MfDBxUCKAJDMywXQCY9cKPXCj0YEmRhc2hfYmFzZWxpbmVfMV92MREAdf4HZeadAQA&_nc_gid=wVJjx_oUQmu1xjgLFVei-A&_nc_ss=7a3ba&_nc_zt=28&oh=00_AQOdChf47UC3yPKAX9oxaT8_TyDDb09KebLs-jy6wNc1-Q&oe=6ACBD842","cdn_url":null,"cdn_status":"absent"}],"thumb":{"kind":"post_image","ig_url":"https://scontent-mia3-3.cdninstagram.com/v/t51.82787-15/844190302_18706032907019133_2439034891193281727_n.jpg?stp=dst-jpg_e15_s640x640_tt6&_nc_cat=1&ig_cache_key=NDAwNDMyMjU0OTE4OTIxNDc4Mg%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6IkNMSVBTLnhwaWRzLjEwODAuc2RyLnZpZGVvX2RlZmF1bHRfY292ZXJfZnJhbWUuQzMifQ%3D%3D&_nc_ohc=9pthyby7djoQ7kNvwEe3-L0&_nc_oc=AdqWSHySBVOORJBb09NdxP69qpJ1Vxym3VYnz4CgtfcAEM6BV5u2DnzGR--jit8g9ks&_nc_ad=z-m&_nc_cid=0&_nc_zt=23&_nc_ht=scontent-mia3-3.cdninstagram.com&_nc_gid=wVJjx_oUQmu1xjgLFVei-A&_nc_ss=7a3ba&oh=00_AQP__qc-5jfDrPCWwxMAaBKie4g_97_jBZpzo5gC2RrYBw&oe=6ACFD810","cdn_url":null,"cdn_status":"absent"}}],"mirror_stats":{"total":12}},"meta":{"cost":"$0.0005","balance":"$474.5823","request_id":"req_0902efbb31fbf67fb2aba145a26c20b7"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"404":{"description":"The profile is not stored. You are not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/instagram/stored/post":{"get":{"tags":["Instagram"],"operationId":"igStoredPost","summary":"Stored post","description":"The stored record of one post: `caption`, `likes`, `comments`, `posted_at`, media URLs, `content_type`, `product_type`, size and flags.\n\nStrictly DB: this reads what the crawler already stored and never crawls. A miss is a `404` and is not billed. Fetch a fresh post with `/v1/instagram/post`.","x-dashboard-cost":"$0.0005","security":[{"bearerAuth":[]}],"parameters":[{"name":"q","in":"query","required":true,"description":"Shortcode, or a post, reel or tv URL.","example":"DblswrEy-OK","schema":{"type":"string","maxLength":300,"example":"DblswrEy-OK"}}],"responses":{"200":{"description":"Success. The example is a captured response; long lists are truncated.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":true},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"id":11,"ig_post_id":"3955764706547590026","shortcode":"DblswrEy-OK","caption":"Go inside @gracieabrams’ world ❤️🎶\n\nThe singer-songwriter shares the creative process behind her new album “Daughter from Hell” –  nature, dancing and the quiet in between. \n\n“Sometimes it can be surprising how strange and out-of-body the songwriting process can be – that an idea can come fully formed just like that, and five seconds prior it didn’t exist,” says Gracie. “Self-doubt is a theme in lots of my songs, but I’m learning to trust myself more and more as I grow up.” 💫","likes":205627,"comments":7429,"posted_at":"2026-08-03 19:07:27+00:00","content_type":"Video","image_url":"https://scontent-lga3-3.cdninstagram.com/v/t51.82787-15/764608272_18778832995001321_4491478198882769795_n.jpg?stp=dst-jpg_e15_tt6&_nc_cat=102&ig_cache_key=Mzk1NTc2NDcwNjU0NzU5MDAyNjE4Nzc4ODMyOTkyMDAxMzIx.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6IkNMSVBTLnhwaWRzLjEyMTUuc2RyLnZpZGVvX2RlZmF1bHRfY292ZXJfZnJhbWUuQzMifQ%3D%3D&_nc_ohc=437kErxzLIwQ7kNvwE4b_H1&_nc_oc=AdrUxn2-bQdF-ubdbZv45gq04Zzyu3kcp_vv10uzWLO7xCWcfqT32xjISRTXhi3hrrk&_nc_zt=23&_nc_ht=scontent-lga3-3.cdninstagram.com&_nc_gid=w0DBO5u26oqCD3uWB-tPlA&_nc_ss=7ba8c&oh=00_AQPpcQYScB1UGWaV5P1Jo2r2xMRryewL-VtUe5KuUGow9A&oe=6AD22E39","video_url":"https://scontent-lga3-1.cdninstagram.com/o1/v/t2/f2/m86/AQPkd8JknkaAgE6sTz1BRINW2tfvf0XhJjwIvNyvNvsRHEtfNpzECv1xOQAFWWFuyp-Me-QcDLji0-J2pw5bJPPBhQdgYB6JhFSd4Kg.mp4?_nc_cat=111&_nc_sid=5e9851&_nc_ht=scontent-lga3-1.cdninstagram.com&_nc_ohc=zSs9R3F3ok0Q7kNvwEqRhQS&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5JTlNUQUdSQU0uQ0xJUFMuQzMuNzIwLmRhc2hfYmFzZWxpbmVfMV92MSIsInhwdl9hc3NldF9pZCI6MjEzNTYxMzE0Mzk4MTY2MSwiYXNzZXRfYWdlX2RheXMiOjY5LCJ2aV91c2VjYXNlX2lkIjoxMDA5OSwiZHVyYXRpb25fcyI6MTUyLCJ1cmxnZW5fc291cmNlIjoid3d3In0%3D&ccb=17-1&vs=e079a7efdb533540&_nc_vs=HBksFQIYUmlnX3hwdl9yZWVsc19wZXJtYW5lbnRfc3JfcHJvZC85RTQ0MUE3OUU2OEYyNTUyNEU0RUM1OEM0NUI5RkJBQV92aWRlb19kYXNoaW5pdC5tcDQVAALIARIAFQIYUWlnX3hwdl9wbGFjZW1lbnRfcGVybWFuZW50X3YyLzcyNDNBMTkwMTRBRUVCMUYxRjgyQUVFMUY1NjFCQjlFX2F1ZGlvX2Rhc2hpbml0Lm1wNBUCAsgBEgAoABgAGwKIB3VzZV9vaWwBMRJwcm9ncmVzc2l2ZV9yZWNpcGUBMRUAACa6-ZjthZXLBxUCKAJDMywXQGMHdLxqfvoYEmRhc2hfYmFzZWxpbmVfMV92MREAdf4HZeadAQA&_nc_gid=w0DBO5u26oqCD3uWB-tPlA&_nc_ss=7ba8c&_nc_zt=28&oh=00_AQNuBfxkeMBtMOkBA7XgGZCcdf-kjBtI4M04z67i5o2ghQ&oe=6ACE6D00","is_video":true,"video_duration":152.218,"product_type":"clips","original_width":1080,"original_height":1920,"like_and_view_counts_disabled":false,"observed_surface":"post","is_pinned":false,"video_play_count":null,"is_paid_partnership":null,"post_url":"https://www.instagram.com/reel/DblswrEy-OK/","comments_list":[]},"meta":{"cost":"$0.0005","balance":"$474.5818","request_id":"req_d4da50e261b5e3ba4323c0f9d70e5b56"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"404":{"description":"The post is not stored. You are not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/instagram/stored/post/comments":{"get":{"tags":["Instagram"],"operationId":"igStoredPostComments","summary":"Stored post comments","description":"The comments stored for one post, in the order they were collected, with `stored_total`, `continuation` (how far collection got) and `next_cursor` while `has_more` is true. A stored post with no collected comment page answers an empty list.\n\nStrictly DB: this reads what the crawler already stored and never crawls. A miss is a `404` and is not billed. Collect more with `/v1/instagram/post_comments`.","x-dashboard-cost":"$0.0005","security":[{"bearerAuth":[]}],"parameters":[{"name":"q","in":"query","required":true,"description":"Shortcode, post URL, or numeric Instagram post id.","example":"DblswrEy-OK","schema":{"type":"string","maxLength":300,"example":"DblswrEy-OK"}},{"name":"cursor","in":"query","required":false,"description":"Opaque `next_cursor` from the previous page.","schema":{"type":"string","maxLength":500}},{"name":"limit","in":"query","required":false,"description":"Comments per page.","schema":{"type":"integer","minimum":1,"maximum":200,"default":50},"examples":{"default":{"value":50,"x-disabled":true}}}],"responses":{"200":{"description":"Success. The example is a captured response; long lists are truncated.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":true},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"post":{"ig_post_id":"3955764706547590026","shortcode":"DblswrEy-OK"},"continuation":{"next_page_cursor":null,"exhausted":true,"last_fetched_at":"2026-10-12T05:58:51.542060+00:00"},"comments":[{"comment_id":"18061339286756927","author":"sudhanmagician","author_id":"39279896131","author_verified":false,"text":"Hi instagram team my monetisation status and gifts suddenly shows ineligible.you solve my problem","likes":1,"replies":null,"posted_at":"2026-08-06T02:50:24+00:00"},{"comment_id":"18077818199690898","author":"g_sonu_king_123_kumar_raj_10k_","author_id":"79964099042","author_verified":false,"text":"❤️❤️❤️❤️","likes":0,"replies":null,"posted_at":"2026-08-06T02:52:26+00:00"},{"comment_id":"18093436325180837","author":"abhi_anish_rajbhar_ji","author_id":"52358150310","author_verified":false,"text":"❤️","likes":0,"replies":null,"posted_at":"2026-08-06T03:24:20+00:00"}],"stored_total":591,"next_cursor":"WzEwN10","has_more":true},"meta":{"cost":"$0.0005","balance":"$474.5813","request_id":"req_3b4163e4e40cc0e2a35602c476896c7e"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"404":{"description":"The post is not stored. You are not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/instagram/stored/post/media":{"get":{"tags":["Instagram"],"operationId":"igStoredPostMedia","summary":"Stored post media","description":"Every stored image or video item of one post, each with `ig_url`, `cdn_url` (our mirrored copy, null until mirrored) and `cdn_status`, plus the caption and counts. `cdn_url` is either a file URL or a signed `/v1/media/{kind}/{id}/{slot}` URL on this host that serves the same image without an API key. A signed URL works for at least 7 days, and a later read answers a fresh one.\n\nStrictly DB: this reads what the crawler already stored and never crawls. A miss is a `404` and is not billed.","x-dashboard-cost":"$0.0005","security":[{"bearerAuth":[]}],"parameters":[{"name":"q","in":"query","required":true,"description":"Shortcode, or a post, reel or tv URL.","example":"DblswrEy-OK","schema":{"type":"string","maxLength":300,"example":"DblswrEy-OK"}}],"responses":{"200":{"description":"Success. The example is a captured response; long lists are truncated.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":true},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"shortcode":"DblswrEy-OK","media_type":"video","posted_at":"2026-08-03T19:07:27+00:00","caption":"Go inside @gracieabrams’ world ❤️🎶\n\nThe singer-songwriter shares the creative process behind her new album “Daughter from Hell” –  nature, dancing and the quiet in between. \n\n“Sometimes it can be surprising how strange and out-of-body the songwriting process can be – that an idea can come fully formed just like that, and five seconds prior it didn’t exist,” says Gracie. “Self-doubt is a theme in lots of my songs, but I’m learning to trust myself more and more as I grow up.” 💫","likes":205627,"comments":7429,"items":[{"kind":"video_file","ig_url":"https://scontent-lga3-1.cdninstagram.com/o1/v/t2/f2/m86/AQPkd8JknkaAgE6sTz1BRINW2tfvf0XhJjwIvNyvNvsRHEtfNpzECv1xOQAFWWFuyp-Me-QcDLji0-J2pw5bJPPBhQdgYB6JhFSd4Kg.mp4?_nc_cat=111&_nc_sid=5e9851&_nc_ht=scontent-lga3-1.cdninstagram.com&_nc_ohc=zSs9R3F3ok0Q7kNvwEqRhQS&efg=eyJ2ZW5jb2RlX3RhZyI6Inhwdl9wcm9ncmVzc2l2ZS5JTlNUQUdSQU0uQ0xJUFMuQzMuNzIwLmRhc2hfYmFzZWxpbmVfMV92MSIsInhwdl9hc3NldF9pZCI6MjEzNTYxMzE0Mzk4MTY2MSwiYXNzZXRfYWdlX2RheXMiOjY5LCJ2aV91c2VjYXNlX2lkIjoxMDA5OSwiZHVyYXRpb25fcyI6MTUyLCJ1cmxnZW5fc291cmNlIjoid3d3In0%3D&ccb=17-1&vs=e079a7efdb533540&_nc_vs=HBksFQIYUmlnX3hwdl9yZWVsc19wZXJtYW5lbnRfc3JfcHJvZC85RTQ0MUE3OUU2OEYyNTUyNEU0RUM1OEM0NUI5RkJBQV92aWRlb19kYXNoaW5pdC5tcDQVAALIARIAFQIYUWlnX3hwdl9wbGFjZW1lbnRfcGVybWFuZW50X3YyLzcyNDNBMTkwMTRBRUVCMUYxRjgyQUVFMUY1NjFCQjlFX2F1ZGlvX2Rhc2hpbml0Lm1wNBUCAsgBEgAoABgAGwKIB3VzZV9vaWwBMRJwcm9ncmVzc2l2ZV9yZWNpcGUBMRUAACa6-ZjthZXLBxUCKAJDMywXQGMHdLxqfvoYEmRhc2hfYmFzZWxpbmVfMV92MREAdf4HZeadAQA&_nc_gid=w0DBO5u26oqCD3uWB-tPlA&_nc_ss=7ba8c&_nc_zt=28&oh=00_AQNuBfxkeMBtMOkBA7XgGZCcdf-kjBtI4M04z67i5o2ghQ&oe=6ACE6D00","cdn_url":null,"cdn_status":"absent"}]},"meta":{"cost":"$0.0005","balance":"$474.5808","request_id":"req_396a6f7be747a307f7a3339cc81bb8d2"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"404":{"description":"The post is not stored. You are not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/instagram/stored/comments":{"get":{"tags":["Instagram"],"operationId":"igStoredRecentComments","summary":"Stored recent comments","description":"Stored comments across the posts of up to 100 accounts, newest first, each with the `post` it sits on. Name accounts by `profile_id`, the number `/v1/instagram/profile` returns. `next_cursor` is an opaque string while `has_more` is true; send it back as `cursor` for the next page.\n\nStrictly DB: only comments the crawler already collected appear, and an account with none answers an empty list.","x-dashboard-cost":"$0.0005","x-example-query":{"profile_ids":"6","limit":"50"},"security":[{"bearerAuth":[]}],"parameters":[{"name":"profile_ids","in":"query","required":true,"description":"Comma-separated profile ids, up to 100.","example":"6","schema":{"type":"string","maxLength":2000,"example":"6"}},{"name":"since","in":"query","required":false,"description":"ISO-8601 lower bound on the comment time.","schema":{"type":"string","maxLength":500}},{"name":"cursor","in":"query","required":false,"description":"Opaque `next_cursor` from the previous page.","schema":{"type":"string","maxLength":500}},{"name":"limit","in":"query","required":false,"description":"Comments per page.","schema":{"type":"integer","minimum":1,"maximum":200,"default":50},"examples":{"default":{"value":50,"x-disabled":true}}}],"responses":{"200":{"description":"Success. The example is a captured response; long lists are truncated.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":true},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"comments":[{"comment_id":"17868470907658100","author":"kartiknayak3623","author_id":"73859776049","author_verified":false,"text":"😍😍","likes":0,"replies":null,"posted_at":"2026-10-10T06:01:17+00:00","is_reply":false,"post":{"ig_post_id":"3955764706547590026","shortcode":"DblswrEy-OK","caption":"Go inside @gracieabrams’ world ❤️🎶\n\nThe singer-songwriter shares the creative process behind her new album “Daughter from Hell” –  nature, dancing and the quiet in between. \n\n“Sometimes it can be surprising how strange and out-of-body the songwriting process can be – that an idea can come fully formed just like that, and five seconds prior it didn’t exist,” says Gracie. “Self-doubt is a theme in lots of my songs, but I’m learning to trust myself more and more as I grow up.” 💫","posted_at":"2026-08-03T19:07:27+00:00","is_video":true,"image_url":"https://f005.backblazeb2.com/file/influencer-dev/staging/crawler/instagram_post/11.webp","image_cached":true,"author":"instagram","profile_id":6}},{"comment_id":"18228394927326925","author":"usa.trupm.donald","author_id":"79953098316","author_verified":false,"text":"علیرضا طلیسچی بهنام بانی . شهرام و سالار عقیلی .ساسی.معین.ابی .نازین و نسی موزیک .مهران مدیری .ارون افشار.آرش .ماکان بند .امو بند .شجریان .گوگوش.اهنگ های ایرانی بهترینن در جهان بهتر از آمریکایی ها .زنده باد هالزی و سلنا گومز","likes":1,"replies":null,"posted_at":"2026-10-10T02:40:11+00:00","is_reply":false,"post":{"ig_post_id":"3955764706547590026","shortcode":"DblswrEy-OK","caption":"Go inside @gracieabrams’ world ❤️🎶\n\nThe singer-songwriter shares the creative process behind her new album “Daughter from Hell” –  nature, dancing and the quiet in between. \n\n“Sometimes it can be surprising how strange and out-of-body the songwriting process can be – that an idea can come fully formed just like that, and five seconds prior it didn’t exist,” says Gracie. “Self-doubt is a theme in lots of my songs, but I’m learning to trust myself more and more as I grow up.” 💫","posted_at":"2026-08-03T19:07:27+00:00","is_video":true,"image_url":"https://f005.backblazeb2.com/file/influencer-dev/staging/crawler/instagram_post/11.webp","image_cached":true,"author":"instagram","profile_id":6}},{"comment_id":"17933316750142770","author":"teresup","author_id":"27122230960","author_verified":false,"text":"@instagram why do you protect predators on this platform and disregard the people being harassed and exploited by predators? Is it the same reason Zuck and his pediatrician wife were photographed at a secret dinner with Epstein in the mid 2010s?","likes":0,"replies":null,"posted_at":"2026-10-09T17:08:17+00:00","is_reply":false,"post":{"ig_post_id":"3955764706547590026","shortcode":"DblswrEy-OK","caption":"Go inside @gracieabrams’ world ❤️🎶\n\nThe singer-songwriter shares the creative process behind her new album “Daughter from Hell” –  nature, dancing and the quiet in between. \n\n“Sometimes it can be surprising how strange and out-of-body the songwriting process can be – that an idea can come fully formed just like that, and five seconds prior it didn’t exist,” says Gracie. “Self-doubt is a theme in lots of my songs, but I’m learning to trust myself more and more as I grow up.” 💫","posted_at":"2026-08-03T19:07:27+00:00","is_video":true,"image_url":"https://f005.backblazeb2.com/file/influencer-dev/staging/crawler/instagram_post/11.webp","image_cached":true,"author":"instagram","profile_id":6}}],"next_cursor":"WzU1NSwiMjAyNi0wOS0xMFQyMzo0ODozOSswMDowMCJd","has_more":true},"meta":{"cost":"$0.0005","balance":"$474.5803","request_id":"req_35d3521c4d7b4c475eddc705647f0120"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/instagram/web_profile_info":{"get":{"tags":["Instagram"],"operationId":"igWebProfileInfo","summary":"web_profile_info","x-dashboard-cost":"$0.0005","x-example-query":{"handle":"instagram"},"description":"Wraps the logged-out profile reads: `doc_id PolarisProfilePageContentQuery` by `ig_id` when given, else the logged-out GraphQL profile by handle. Returns `Profile` under `data`; with `get_raw=true` returns the upstream JSON.\n\nUnknown, unsupported, and repeated query parameters return 400 before acquisition or billing.\n\nThe example response is the crawler's own projection of a synthetic upstream document into `Profile`, not a live capture.","security":[{"bearerAuth":[]}],"parameters":[{"name":"handle","in":"query","required":true,"description":"Instagram account handle (a leading `@` is accepted). On the operations whose upstream call takes the numeric account id, the crawler resolves it; a handle it has never seen costs one extra anonymous profile read.","example":"instagram","schema":{"type":"string"}},{"name":"username","in":"query","required":false,"deprecated":true,"description":"The old name of `handle`, read as the same value with no end date. New code should send `handle`. Sending both returns 400.","schema":{"type":"string"}},{"name":"ig_id","in":"query","required":false,"description":"Optional numeric account id of `handle`. With it the profile is read by id, which adds the business and creator flags, the category and the full-size profile picture. If the id no longer names this handle, the profile is read by handle.","schema":{"type":"string"}},{"name":"cached","in":"query","required":false,"description":"`auto` (default) serves a read saved within the last 24 hours for these exact arguments, otherwise fetches. `cache_only` never contacts Instagram (404 `not_cached` when nothing is saved, whatever its age). `live` always fetches. Anything else is a `400`. A saved read is an earlier answer of this operation for the same arguments; an account in the profile library (`/v1/instagram/profile`) is not one until this operation has read it.","schema":{"type":"string","enum":["auto","cache_only","live"],"default":"auto"},"examples":{"default":{"value":"auto","x-disabled":true}}},{"name":"get_raw","in":"query","required":false,"description":"`true` returns the upstream JSON exactly as Instagram answered it instead of the normalized `Profile`.","schema":{"type":"boolean","default":false},"examples":{"default":{"value":false,"x-disabled":true}}}],"responses":{"200":{"description":"`Profile` under `data`; with `get_raw=true` the upstream JSON.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"anyOf":[{"$ref":"#/components/schemas/Profile"},{"type":"object","additionalProperties":true}],"description":"`Profile`, or the upstream JSON when `get_raw=true`."},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"id":"787132","username":"natgeo","full_name":"National Geographic","biography":"Step into wonder and find your inner explorer with National Geographic 🌎","followers":268179647,"following":195,"posts":null,"is_verified":true,"is_private":false,"avatar_url":"https://scontent.cdninstagram.com/v/t51.82787-19/683576066_18653628823019133_9051036240972105113_n.jpg?_nc_cat=1&ig_cache_key=GAKLvih9nsRnYEVCAJlFVLiBvZt9bmNDAQAB0j-ccb7-5&ccb=7-5&_nc_sid=669407&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLnd3dy40MDAuQzMifQ%3D%3D&_nc_ohc=JlZ4a1nsmOgQ7kNvwGvpUHK&_nc_oc=AdoKGhWUYdfWRDi-GwdOxHXvelIArMpzPvWngBPU3dAsxTOCTjNS3hDEOHGtyuomW9g&_nc_zt=24&_nc_ht=scontent.cdninstagram.com&_nc_gid=Me_kquLubYefuzpE5poOrg&_nc_ss=7ba8c&oh=00_AQRX2OKCa9jK7l43NJmuoAUcwVSkmRkieXVwWZ-GzRHtug&oe=6AF648AB","external_url":"http://visitstore.bio/natgeo","links":[{"url":"http://visitstore.bio/natgeo","title":null},{"url":"https://ngmdomsubs.nationalgeographic.com/servlet/OrdersGateway?cds_mag_code=NGM&cds_page_id=283562&cds_response_key=I5FX10002","title":"Subscribe Here!"}],"category":null,"business_category":null,"is_business":true,"is_professional":true,"business_email":null,"business_phone":null,"business_address":null,"pronouns":[],"highlight_reel_count":null,"has_clips":true,"is_recently_joined":null,"fbid":"17841400573960012","extra":{}},"meta":{"source":"live","fetched_at":"2026-11-08T11:50:52Z","cost":"$0.0005","balance":"$424.2956","request_id":"req_39a77b3c6c69b6e856bb309bf9ee2505"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"403":{"description":"Instagram does not show this account to logged-out readers: it is private, hidden or restricted, or it no longer exists. Retrying will not change the answer until the account changes. You are not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"account_unavailable","message":"Instagram account @nike_private is private: its timeline answered the empty shell and the logged-out profile says is_private. You are not charged.","request_id":"req_5c10900e919bc7a3ff79b7501d582b4c"}}}}},"404":{"description":"`cached=cache_only` found nothing saved for these arguments (`not_cached`; call again with `cached=auto` to fetch it), or the account, post, highlight, or location does not exist (`not_found`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_cached","message":"no saved instagram/web_profile_info read for 'instagram'. cached=cache_only never fetches, so call again with cached=auto to fetch it. You are not charged.","request_id":"req_5c10900e919bc7a3ff79b7501d582b4c"}}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/instagram/user_feed":{"get":{"tags":["Instagram"],"operationId":"igUserFeed","summary":"user_feed","x-dashboard-cost":"$0.0005/12, $0.0100/signed-in page","x-example-query":{"handle":"instagram","max_pages":"1"},"description":"Wraps `GET /api/v1/feed/user/{username}/username/?count&max_id`. With max_pages=1, returns `Page[Post]` under `data`; with `get_raw=true` returns the upstream JSON.\n\nThe default request creates a durable job (202). Use max_pages=1 for one synchronous Page response (200). Poll status_url, then read results_url with its opaque cursor. Acquisition stops at the first of since, max_pages, or exhaustion. Jobs continue after disconnects. Result responses are bounded to 3 MiB; this does not limit the crawl. An output unit above that byte budget fails the job before billing; results return 413. The selected raw or normalized mode never changes automatically. Supply Idempotency-Key to recover a lost submission response; reuse it with the same inputs.\n\nUnknown, unsupported, and repeated query parameters return 400 before acquisition or billing.\n\nThe example response is the crawler's own projection of a synthetic upstream document into `Page[Post]`, not a live capture.\n\nBilling: $0.0005 per 12 unique returned items, rounded up to a minimum of one billing unit. That price holds for a page read logged out. A page read through one of our signed-in Instagram accounts costs $0.0100 per page instead. A call with no cursor reads page 1 logged out, and so does a call with the cursor that call returned. A job reads every page, page 1 included, through a signed-in account, and so does a call with a cursor from a job. Each entry of `pages` says `signed_in`, and a `get_raw=true` answer counts them in `signed_in_pages`. Jobs settle once after successful completion. Submission, polling and repeat downloads are free. Insufficient funds return 402 with no result data until a top-up covers the full charge.","security":[{"bearerAuth":[]}],"parameters":[{"name":"handle","in":"query","required":true,"description":"Instagram account handle (a leading `@` is accepted). On the operations whose upstream call takes the numeric account id, the crawler resolves it; a handle it has never seen costs one extra anonymous profile read.","example":"instagram","schema":{"type":"string"}},{"name":"username","in":"query","required":false,"deprecated":true,"description":"The old name of `handle`, read as the same value with no end date. New code should send `handle`. Sending both returns 400.","schema":{"type":"string"}},{"name":"since","in":"query","required":false,"description":"Stop at this date. `2025-09-21` means midnight UTC (2025-09-21T00:00:00Z). Datetimes must use RFC3339 with a timezone, for example `2025-09-21T09:00:00+09:00`. `365d` means 365 days before submission. Invalid calendar dates return 400. With max_pages, the first boundary reached stops the walk. since alone creates a job.","schema":{"type":"string"},"examples":{"default":{"value":"2025-09-21","x-disabled":true},"date":{"value":"2025-09-21","x-disabled":true},"datetime":{"value":"2025-09-21T00:00:00Z","x-disabled":true},"duration":{"value":"365d","x-disabled":true}}},{"name":"max_pages","in":"query","required":false,"example":1,"description":"Maximum pages to fetch. -1 walks until exhaustion or since with no page cap, and must be written. Omitted, since alone bounds the walk; with neither, the job stops after 10 pages. Any positive integer is accepted. 1 returns one page synchronously with HTTP 200; any other value creates a durable job with HTTP 202.","schema":{"type":"integer","anyOf":[{"enum":[-1]},{"minimum":1}]}},{"name":"cursor","in":"query","required":false,"description":"Opaque next_cursor from an earlier acquisition of this operation, also with `get_raw=true`. A native Instagram max_id or end_cursor from a raw page answers 400. Result download cursors belong to the results route.","schema":{"type":"string","minLength":1}},{"name":"page_size","in":"query","required":false,"description":"Native count, default 12. Instagram controls the returned count. Billed per 12 unique returned items.","schema":{"type":"integer","default":12,"minimum":1},"examples":{"default":{"value":12,"x-disabled":true}}},{"name":"cached","in":"query","required":false,"description":"`auto` (default) serves a read saved within the last 24 hours for these exact arguments, otherwise fetches. `cache_only` never contacts Instagram (404 `not_cached` when nothing is saved, whatever its age). `live` always fetches. Anything else is a `400`. A saved read is an earlier answer of this operation for the same arguments; an account in the profile library (`/v1/instagram/profile`) is not one until this operation has read it. `cache_only` reads one saved page per request: omit `max_pages` or pass 1, and continue with `next_cursor`.","schema":{"type":"string","enum":["auto","cache_only","live"],"default":"auto"},"examples":{"default":{"value":"auto","x-disabled":true}}},{"name":"get_raw","in":"query","required":false,"description":"`true` returns the upstream JSON exactly as Instagram answered it instead of the normalized `Page[Post]`.","schema":{"type":"boolean","default":false},"examples":{"default":{"value":false,"x-disabled":true}}},{"name":"Idempotency-Key","in":"header","required":false,"description":"Reuse this key with the same inputs to recover a lost job submission. A different input with the same key returns 409.","schema":{"type":"string","minLength":1,"maxLength":200}}],"responses":{"200":{"description":"`Page[Post]` under `data`; with `get_raw=true` the upstream JSON.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"anyOf":[{"type":"object","required":["items","pages","next_cursor","has_more","stop_reason","coverage"],"properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/Post"},"description":"`Post` of every page walked, in page order."},"pages":{"type":"array","items":{"$ref":"#/components/schemas/PageRead"},"description":"One entry per page walked."},"next_cursor":{"type":"string","nullable":true,"description":"Opaque; pass back as `cursor` to continue."},"has_more":{"type":"boolean","description":"True exactly when `next_cursor` is set."},"stop_reason":{"type":"string","enum":["pages","since","exhausted","cursor_stalled","repeated_content","deadline","blocked","caught_up"],"description":"Why the walk stopped. `pages`: the page budget is spent and `next_cursor` continues it. `deadline`: the call ran out of time before its next page; `next_cursor` continues it. `since`: a whole page was older than `since`. `exhausted`: Instagram reported the end. `cursor_stalled`: Instagram claimed more but repeated or omitted its cursor. `repeated_content`: a page held only items already seen. `blocked`: Instagram refused a later page; `next_cursor` is the page it refused. `caught_up`: the walk reached the newest post an earlier read of the feed returned; only watch passes the crawler runs for itself stop this way."},"coverage":{"$ref":"#/components/schemas/Coverage"}}},{"type":"object","required":["pages","next_cursor","has_more","stop_reason","signed_in_pages"],"description":"`get_raw=true`: every native page walked, exactly as Instagram answered it, plus the opaque `next_cursor` and `stop_reason` of the walk.","properties":{"pages":{"type":"array","items":{"type":"object","additionalProperties":true,"required":["items"],"properties":{"items":{"type":"array","items":{"type":"object","additionalProperties":true}},"more_available":{"type":"boolean"},"next_max_id":{"type":"string","nullable":true}}},"description":"One native page per page walked, upstream bytes unchanged."},"next_cursor":{"type":"string","nullable":true,"description":"Opaque; pass back as `cursor`."},"has_more":{"type":"boolean","description":"True exactly when `next_cursor` is set."},"stop_reason":{"type":"string","enum":["pages","since","exhausted","cursor_stalled","repeated_content","deadline","blocked","caught_up"],"description":"Why the walk stopped. `pages`: the page budget is spent and `next_cursor` continues it. `deadline`: the call ran out of time before its next page; `next_cursor` continues it. `since`: a whole page was older than `since`. `exhausted`: Instagram reported the end. `cursor_stalled`: Instagram claimed more but repeated or omitted its cursor. `repeated_content`: a page held only items already seen. `blocked`: Instagram refused a later page; `next_cursor` is the page it refused. `caught_up`: the walk reached the newest post an earlier read of the feed returned; only watch passes the crawler runs for itself stop this way."},"signed_in_pages":{"type":"integer","description":"How many of the pages one of our signed-in Instagram accounts read; each bills the signed-in page price."}}}],"description":"`Page[Post]`, or the upstream JSON when `get_raw=true`."},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"items":[{"id":"4017311023166285121","shortcode":"DfAWxdIFmVB","taken_at":"2026-10-27T17:06:54+00:00","kind":"video","product_type":"clips","caption":"Even a moment’s rest on Everest can come with a reminder of just how unpredictable the mountain can be.\n\nFrom Oscar®-winning filmmakers @chaivasarhelyi and @jimmychin, EVEREST: THE OTHER SIDE, only in theaters and IMAX worldwide on October 30.","hashtags":[],"mentions":["chaivasarhelyi","jimmychin"],"accessibility_caption":null,"likes":null,"comments":null,"views":null,"counts_hidden":null,"comments_disabled":null,"is_pinned":null,"is_paid_partnership":null,"owner":{"id":"787132","username":"natgeo","full_name":null,"is_verified":null,"is_private":null,"avatar_url":null,"latest_story_at":null,"extra":{}},"coauthors":[],"sponsors":[],"tagged":[],"location":null,"audio":null,"thumbnail_url":"https://scontent.cdninstagram.com/v/t51.82787-15/865525088_18712762651019133_8954025122327073428_n.jpg?stp=dst-jpg_e35_s640x640_tt6&_nc_cat=109&ccb=7-5&_nc_sid=18de74&efg=eyJlZmdfdGFnIjoiQ0xJUFMuYmVzdF9pbWFnZV91cmxnZW4uQzMifQ%3D%3D&_nc_ohc=eWucRzrr6NcQ7kNvwG6-T7Z&_nc_oc=AdouNy8ozdoks48renkPJec33JzVBcCtj5aVhirSxKVsyBQNlmkYKzftOfV-bo8dNE8&_nc_zt=23&_nc_ht=scontent.cdninstagram.com&_nc_gid=AewD8YwipWsZ_NslzIwb5A&_nc_ss=7b289&oh=00_AQRvrcIlBVSlcCNj6ypIsZ6Qf3OOxlleHDZBuou8OLM1-w&oe=6AF64278","video_duration":null,"media":[{"kind":"video","url":"https://scontent.cdninstagram.com/v/t51.82787-15/865525088_18712762651019133_8954025122327073428_n.jpg?stp=dst-jpg_e35_s640x640_tt6&_nc_cat=109&ccb=7-5&_nc_sid=18de74&efg=eyJlZmdfdGFnIjoiQ0xJUFMuYmVzdF9pbWFnZV91cmxnZW4uQzMifQ%3D%3D&_nc_ohc=eWucRzrr6NcQ7kNvwG6-T7Z&_nc_oc=AdouNy8ozdoks48renkPJec33JzVBcCtj5aVhirSxKVsyBQNlmkYKzftOfV-bo8dNE8&_nc_zt=23&_nc_ht=scontent.cdninstagram.com&_nc_gid=AewD8YwipWsZ_NslzIwb5A&_nc_ss=7b289&oh=00_AQRvrcIlBVSlcCNj6ypIsZ6Qf3OOxlleHDZBuou8OLM1-w&oe=6AF64278","width":null,"height":null,"duration":null}],"media_urls":["https://scontent.cdninstagram.com/v/t51.82787-15/865525088_18712762651019133_8954025122327073428_n.jpg?stp=dst-jpg_e35_s640x640_tt6&_nc_cat=109&ccb=7-5&_nc_sid=18de74&efg=eyJlZmdfdGFnIjoiQ0xJUFMuYmVzdF9pbWFnZV91cmxnZW4uQzMifQ%3D%3D&_nc_ohc=eWucRzrr6NcQ7kNvwG6-T7Z&_nc_oc=AdouNy8ozdoks48renkPJec33JzVBcCtj5aVhirSxKVsyBQNlmkYKzftOfV-bo8dNE8&_nc_zt=23&_nc_ht=scontent.cdninstagram.com&_nc_gid=AewD8YwipWsZ_NslzIwb5A&_nc_ss=7b289&oh=00_AQRvrcIlBVSlcCNj6ypIsZ6Qf3OOxlleHDZBuou8OLM1-w&oe=6AF64278"],"extra":{}},{"id":"4012207125530714429","shortcode":"DeuOR-CjKE9","taken_at":"2026-10-20T16:06:22+00:00","kind":"image","product_type":"feed","caption":"Some of the best reasons to travel in 2027 are far from the usual destinations. 🌎\n\nNational Geographic’s picks for Best of the World 2027 are here and features 25 destinations across six continents. \n\nWhether you're drawn to places steeped in history or the thrill of exploring the wild, there's no shortage of experiences worth planning a trip around. \n\nFind your next adventure and see our full #BestOfTheWorld 2027 guide at the link in bio. \n\nPhotograph by Thomas Ekström","hashtags":["BestOfTheWorld"],"mentions":[],"accessibility_caption":null,"likes":null,"comments":null,"views":null,"counts_hidden":null,"comments_disabled":null,"is_pinned":null,"is_paid_partnership":null,"owner":{"id":"787132","username":"natgeo","full_name":null,"is_verified":null,"is_private":null,"avatar_url":null,"latest_story_at":null,"extra":{}},"coauthors":[],"sponsors":[],"tagged":[],"location":null,"audio":null,"thumbnail_url":"https://scontent.cdninstagram.com/v/t51.82787-15/858921974_18710195065019133_277441153414192961_n.jpg?stp=dst-jpg_e35_s640x640_tt6&_nc_cat=109&ccb=7-5&_nc_sid=18de74&efg=eyJlZmdfdGFnIjoiRkVFRC5iZXN0X2ltYWdlX3VybGdlbi5DMyJ9&_nc_ohc=qTbjQjhs0_oQ7kNvwGE9fY6&_nc_oc=AdpogO0VeYu36zuS4ZDJ_JKDUziaIDXehQlt4oeCRWtM95JErFudusVFe01s13hyqno&_nc_zt=23&_nc_ht=scontent.cdninstagram.com&_nc_gid=AewD8YwipWsZ_NslzIwb5A&_nc_ss=7b289&oh=00_AQTsNMdFimjcapdPhsEKlv3tt8fC482TW5Ovm8CW_99E9A&oe=6AF64E1E","video_duration":null,"media":[{"kind":"image","url":"https://scontent.cdninstagram.com/v/t51.82787-15/858921974_18710195065019133_277441153414192961_n.jpg?stp=dst-jpg_e35_s640x640_tt6&_nc_cat=109&ccb=7-5&_nc_sid=18de74&efg=eyJlZmdfdGFnIjoiRkVFRC5iZXN0X2ltYWdlX3VybGdlbi5DMyJ9&_nc_ohc=qTbjQjhs0_oQ7kNvwGE9fY6&_nc_oc=AdpogO0VeYu36zuS4ZDJ_JKDUziaIDXehQlt4oeCRWtM95JErFudusVFe01s13hyqno&_nc_zt=23&_nc_ht=scontent.cdninstagram.com&_nc_gid=AewD8YwipWsZ_NslzIwb5A&_nc_ss=7b289&oh=00_AQTsNMdFimjcapdPhsEKlv3tt8fC482TW5Ovm8CW_99E9A&oe=6AF64E1E","width":null,"height":null,"duration":null}],"media_urls":["https://scontent.cdninstagram.com/v/t51.82787-15/858921974_18710195065019133_277441153414192961_n.jpg?stp=dst-jpg_e35_s640x640_tt6&_nc_cat=109&ccb=7-5&_nc_sid=18de74&efg=eyJlZmdfdGFnIjoiRkVFRC5iZXN0X2ltYWdlX3VybGdlbi5DMyJ9&_nc_ohc=qTbjQjhs0_oQ7kNvwGE9fY6&_nc_oc=AdpogO0VeYu36zuS4ZDJ_JKDUziaIDXehQlt4oeCRWtM95JErFudusVFe01s13hyqno&_nc_zt=23&_nc_ht=scontent.cdninstagram.com&_nc_gid=AewD8YwipWsZ_NslzIwb5A&_nc_ss=7b289&oh=00_AQTsNMdFimjcapdPhsEKlv3tt8fC482TW5Ovm8CW_99E9A&oe=6AF64E1E"],"extra":{}},{"id":"4008597565992995700","shortcode":"DehZj9wggt0","taken_at":"2026-10-15T16:34:49+00:00","kind":"video","product_type":"clips","caption":"Keeping up with a pack of hunting wolves is just another day at the office for @bertiegregory and his team.\n\n#WolvesUpClose with Bertie Gregory premieres Friday, November 6 at 8/7c on National Geographic. Streaming on @DisneyPlus and @hulu.","hashtags":["WolvesUpClose"],"mentions":["bertiegregory","disneyplus","hulu."],"accessibility_caption":null,"likes":null,"comments":null,"views":null,"counts_hidden":null,"comments_disabled":null,"is_pinned":null,"is_paid_partnership":null,"owner":{"id":"787132","username":"natgeo","full_name":null,"is_verified":null,"is_private":null,"avatar_url":null,"latest_story_at":null,"extra":{}},"coauthors":[],"sponsors":[],"tagged":[],"location":null,"audio":null,"thumbnail_url":"https://scontent.cdninstagram.com/v/t51.82787-15/849098148_18708313780019133_730867734770692515_n.jpg?stp=dst-jpg_e35_s640x640_tt6&_nc_cat=111&ccb=7-5&_nc_sid=18de74&efg=eyJlZmdfdGFnIjoiQ0xJUFMuYmVzdF9pbWFnZV91cmxnZW4uQzMifQ%3D%3D&_nc_ohc=ZPBTL0-CXowQ7kNvwFc4Hd3&_nc_oc=AdoZwkJGhiL1T4wRci-K1fVjVFzDmKRsSMIaO2jRAIK5LP1iH__6dtAc_7AVo9K6vt4&_nc_zt=23&_nc_ht=scontent.cdninstagram.com&_nc_gid=AewD8YwipWsZ_NslzIwb5A&_nc_ss=7b289&oh=00_AQQj6odtM8K1SLXBz_KfS-dFkBSQxj-833efbT04qHfKWQ&oe=6AF6390C","video_duration":null,"media":[{"kind":"video","url":"https://scontent.cdninstagram.com/v/t51.82787-15/849098148_18708313780019133_730867734770692515_n.jpg?stp=dst-jpg_e35_s640x640_tt6&_nc_cat=111&ccb=7-5&_nc_sid=18de74&efg=eyJlZmdfdGFnIjoiQ0xJUFMuYmVzdF9pbWFnZV91cmxnZW4uQzMifQ%3D%3D&_nc_ohc=ZPBTL0-CXowQ7kNvwFc4Hd3&_nc_oc=AdoZwkJGhiL1T4wRci-K1fVjVFzDmKRsSMIaO2jRAIK5LP1iH__6dtAc_7AVo9K6vt4&_nc_zt=23&_nc_ht=scontent.cdninstagram.com&_nc_gid=AewD8YwipWsZ_NslzIwb5A&_nc_ss=7b289&oh=00_AQQj6odtM8K1SLXBz_KfS-dFkBSQxj-833efbT04qHfKWQ&oe=6AF6390C","width":null,"height":null,"duration":null}],"media_urls":["https://scontent.cdninstagram.com/v/t51.82787-15/849098148_18708313780019133_730867734770692515_n.jpg?stp=dst-jpg_e35_s640x640_tt6&_nc_cat=111&ccb=7-5&_nc_sid=18de74&efg=eyJlZmdfdGFnIjoiQ0xJUFMuYmVzdF9pbWFnZV91cmxnZW4uQzMifQ%3D%3D&_nc_ohc=ZPBTL0-CXowQ7kNvwFc4Hd3&_nc_oc=AdoZwkJGhiL1T4wRci-K1fVjVFzDmKRsSMIaO2jRAIK5LP1iH__6dtAc_7AVo9K6vt4&_nc_zt=23&_nc_ht=scontent.cdninstagram.com&_nc_gid=AewD8YwipWsZ_NslzIwb5A&_nc_ss=7b289&oh=00_AQQj6odtM8K1SLXBz_KfS-dFkBSQxj-833efbT04qHfKWQ&oe=6AF6390C"],"extra":{}},{"id":"4025373921246423567","shortcode":"DfdAEEIA6oP","taken_at":"2026-11-07T20:06:27+00:00","kind":"video","product_type":"clips","caption":"The ancient Egyptians didn't perfect their pyramid designs overnight. Pharaoh Sneferu experimented with new ways of building these monumental tombs, helping establish the smooth-sided design that later became synonymous with ancient Egypt.\n\n#LostTreasuresOfEgypt is now streaming on @DisneyPlus.","hashtags":["LostTreasuresOfEgypt"],"mentions":["disneyplus."],"accessibility_caption":null,"likes":null,"comments":null,"views":null,"counts_hidden":null,"comments_disabled":null,"is_pinned":null,"is_paid_partnership":null,"owner":{"id":"787132","username":"natgeo","full_name":null,"is_verified":null,"is_private":null,"avatar_url":null,"latest_story_at":null,"extra":{}},"coauthors":[],"sponsors":[],"tagged":[],"location":null,"audio":null,"thumbnail_url":"https://scontent.cdninstagram.com/v/t51.82787-15/890161470_18716818873019133_1718752048026244606_n.jpg?stp=dst-jpg_e35_s640x640_tt6&_nc_cat=1&ccb=7-5&_nc_sid=18de74&efg=eyJlZmdfdGFnIjoiQ0xJUFMuYmVzdF9pbWFnZV91cmxnZW4uQzMifQ%3D%3D&_nc_ohc=JDsatrkTThEQ7kNvwE4IYSj&_nc_oc=Adpf39YJkGV4K2pKUdeKgOOASPaVRXGnhdl_50fItTRzx2N8NAO5KxTSc-Q1ZtDAKpI&_nc_zt=23&_nc_ht=scontent.cdninstagram.com&_nc_gid=AewD8YwipWsZ_NslzIwb5A&_nc_ss=7b289&oh=00_AQTfPt-A89mIKZuer6koshuwFmE3QGXa9cueot6WiM6Srg&oe=6AF61A10","video_duration":null,"media":[{"kind":"video","url":"https://scontent.cdninstagram.com/v/t51.82787-15/890161470_18716818873019133_1718752048026244606_n.jpg?stp=dst-jpg_e35_s640x640_tt6&_nc_cat=1&ccb=7-5&_nc_sid=18de74&efg=eyJlZmdfdGFnIjoiQ0xJUFMuYmVzdF9pbWFnZV91cmxnZW4uQzMifQ%3D%3D&_nc_ohc=JDsatrkTThEQ7kNvwE4IYSj&_nc_oc=Adpf39YJkGV4K2pKUdeKgOOASPaVRXGnhdl_50fItTRzx2N8NAO5KxTSc-Q1ZtDAKpI&_nc_zt=23&_nc_ht=scontent.cdninstagram.com&_nc_gid=AewD8YwipWsZ_NslzIwb5A&_nc_ss=7b289&oh=00_AQTfPt-A89mIKZuer6koshuwFmE3QGXa9cueot6WiM6Srg&oe=6AF61A10","width":null,"height":null,"duration":null}],"media_urls":["https://scontent.cdninstagram.com/v/t51.82787-15/890161470_18716818873019133_1718752048026244606_n.jpg?stp=dst-jpg_e35_s640x640_tt6&_nc_cat=1&ccb=7-5&_nc_sid=18de74&efg=eyJlZmdfdGFnIjoiQ0xJUFMuYmVzdF9pbWFnZV91cmxnZW4uQzMifQ%3D%3D&_nc_ohc=JDsatrkTThEQ7kNvwE4IYSj&_nc_oc=Adpf39YJkGV4K2pKUdeKgOOASPaVRXGnhdl_50fItTRzx2N8NAO5KxTSc-Q1ZtDAKpI&_nc_zt=23&_nc_ht=scontent.cdninstagram.com&_nc_gid=AewD8YwipWsZ_NslzIwb5A&_nc_ss=7b289&oh=00_AQTfPt-A89mIKZuer6koshuwFmE3QGXa9cueot6WiM6Srg&oe=6AF61A10"],"extra":{}},{"id":"4024876871938388552","shortcode":"DfbPDC4krJI","taken_at":"2026-11-07T03:38:54+00:00","kind":"video","product_type":"clips","caption":"Presented by National Geographic Society in partnership with @Rolex. \n\nOur oceans cover more than 70% of our planet, but they don't exist in isolation. Now, National Geographic and Rolex Perpetual Planet Explorers are undertaking groundbreaking expeditions to better understand how our oceans are responding to climate change and to reimagine them as a single entity.\n\nRolex and The National Geographic Society are partnering on select science-based expeditions to explore, study, and document change in the planet’s unique regions. #PerpetualPlanet.\n\nNarrated by @auliicravalho, #ExpeditionSavingOurSeas premieres November 13 at 9/8c on @natgeotv. Streaming next day on @DisneyPlus and @hulu.","hashtags":["PerpetualPlanet","ExpeditionSavingOurSeas"],"mentions":["rolex.","auliicravalho","natgeotv.","disneyplus","hulu."],"accessibility_caption":null,"likes":null,"comments":null,"views":null,"counts_hidden":null,"comments_disabled":null,"is_pinned":null,"is_paid_partnership":null,"owner":{"id":"18091046","username":"natgeotv","full_name":null,"is_verified":null,"is_private":null,"avatar_url":null,"latest_story_at":null,"extra":{}},"coauthors":[{"id":"787132","username":"natgeo","full_name":null,"is_verified":null,"is_private":null,"avatar_url":null,"latest_story_at":null,"extra":{}}],"sponsors":[],"tagged":[],"location":null,"audio":null,"thumbnail_url":"https://scontent.cdninstagram.com/v/t51.82787-15/888234117_18652501882043047_4019983575257048247_n.jpg?stp=dst-jpg_e35_s640x640_tt6&_nc_cat=1&ccb=7-5&_nc_sid=18de74&efg=eyJlZmdfdGFnIjoiQ0xJUFMuYmVzdF9pbWFnZV91cmxnZW4uQzMifQ%3D%3D&_nc_ohc=xovbyBaEeWoQ7kNvwE8EC1X&_nc_oc=Adpsn-oGave8FY6kzIwqsrkkeWec24j6uToewmmrkLFGDHL6Q_U2BZjHjOKkhwIStT4&_nc_zt=23&_nc_ht=scontent.cdninstagram.com&_nc_gid=AewD8YwipWsZ_NslzIwb5A&_nc_ss=7b289&oh=00_AQSMa6r0eUYQWeMsht7QjY1ZIMjP5iQ3mFxT1Ya1Y9C-KA&oe=6AF64ECD","video_duration":null,"media":[{"kind":"video","url":"https://scontent.cdninstagram.com/v/t51.82787-15/888234117_18652501882043047_4019983575257048247_n.jpg?stp=dst-jpg_e35_s640x640_tt6&_nc_cat=1&ccb=7-5&_nc_sid=18de74&efg=eyJlZmdfdGFnIjoiQ0xJUFMuYmVzdF9pbWFnZV91cmxnZW4uQzMifQ%3D%3D&_nc_ohc=xovbyBaEeWoQ7kNvwE8EC1X&_nc_oc=Adpsn-oGave8FY6kzIwqsrkkeWec24j6uToewmmrkLFGDHL6Q_U2BZjHjOKkhwIStT4&_nc_zt=23&_nc_ht=scontent.cdninstagram.com&_nc_gid=AewD8YwipWsZ_NslzIwb5A&_nc_ss=7b289&oh=00_AQSMa6r0eUYQWeMsht7QjY1ZIMjP5iQ3mFxT1Ya1Y9C-KA&oe=6AF64ECD","width":null,"height":null,"duration":null}],"media_urls":["https://scontent.cdninstagram.com/v/t51.82787-15/888234117_18652501882043047_4019983575257048247_n.jpg?stp=dst-jpg_e35_s640x640_tt6&_nc_cat=1&ccb=7-5&_nc_sid=18de74&efg=eyJlZmdfdGFnIjoiQ0xJUFMuYmVzdF9pbWFnZV91cmxnZW4uQzMifQ%3D%3D&_nc_ohc=xovbyBaEeWoQ7kNvwE8EC1X&_nc_oc=Adpsn-oGave8FY6kzIwqsrkkeWec24j6uToewmmrkLFGDHL6Q_U2BZjHjOKkhwIStT4&_nc_zt=23&_nc_ht=scontent.cdninstagram.com&_nc_gid=AewD8YwipWsZ_NslzIwb5A&_nc_ss=7b289&oh=00_AQSMa6r0eUYQWeMsht7QjY1ZIMjP5iQ3mFxT1Ya1Y9C-KA&oe=6AF64ECD"],"extra":{}},{"id":"4024784204432119856","shortcode":"Dfa5-jix5gw","taken_at":"2026-11-07T00:34:47+00:00","kind":"video","product_type":"clips","caption":"From harsh conditions to rival predators, these wolves face danger at every turn. But one of their greatest struggles may also be the simplest: finding enough food to survive.\n\n#WolvesUpClose with @bertiegregory is now streaming on @DisneyPlus and @hulu.","hashtags":["WolvesUpClose"],"mentions":["bertiegregory","disneyplus","hulu."],"accessibility_caption":null,"likes":null,"comments":null,"views":null,"counts_hidden":null,"comments_disabled":null,"is_pinned":null,"is_paid_partnership":null,"owner":{"id":"787132","username":"natgeo","full_name":null,"is_verified":null,"is_private":null,"avatar_url":null,"latest_story_at":null,"extra":{}},"coauthors":[],"sponsors":[],"tagged":[],"location":null,"audio":null,"thumbnail_url":"https://scontent.cdninstagram.com/v/t51.82787-15/888458173_18716743837019133_2210754818807639947_n.jpg?stp=dst-jpg_e35_s640x640_tt6&_nc_cat=1&ccb=7-5&_nc_sid=18de74&efg=eyJlZmdfdGFnIjoiQ0xJUFMuYmVzdF9pbWFnZV91cmxnZW4uQzMifQ%3D%3D&_nc_ohc=pyjJs6cFF4UQ7kNvwFHSgss&_nc_oc=AdpKvdRTlfqmMsL6LSH5gnNFfwOJa-8hxMK8eSMNF9kAZjuEWwmyzEOGZsf1R9bX6lU&_nc_zt=23&_nc_ht=scontent.cdninstagram.com&_nc_gid=AewD8YwipWsZ_NslzIwb5A&_nc_ss=7b289&oh=00_AQTJCVNPxXvhIoL7k6_Qf1_-A7jVsZfJCUW6QOe57Rh5jQ&oe=6AF62BA0","video_duration":null,"media":[{"kind":"video","url":"https://scontent.cdninstagram.com/v/t51.82787-15/888458173_18716743837019133_2210754818807639947_n.jpg?stp=dst-jpg_e35_s640x640_tt6&_nc_cat=1&ccb=7-5&_nc_sid=18de74&efg=eyJlZmdfdGFnIjoiQ0xJUFMuYmVzdF9pbWFnZV91cmxnZW4uQzMifQ%3D%3D&_nc_ohc=pyjJs6cFF4UQ7kNvwFHSgss&_nc_oc=AdpKvdRTlfqmMsL6LSH5gnNFfwOJa-8hxMK8eSMNF9kAZjuEWwmyzEOGZsf1R9bX6lU&_nc_zt=23&_nc_ht=scontent.cdninstagram.com&_nc_gid=AewD8YwipWsZ_NslzIwb5A&_nc_ss=7b289&oh=00_AQTJCVNPxXvhIoL7k6_Qf1_-A7jVsZfJCUW6QOe57Rh5jQ&oe=6AF62BA0","width":null,"height":null,"duration":null}],"media_urls":["https://scontent.cdninstagram.com/v/t51.82787-15/888458173_18716743837019133_2210754818807639947_n.jpg?stp=dst-jpg_e35_s640x640_tt6&_nc_cat=1&ccb=7-5&_nc_sid=18de74&efg=eyJlZmdfdGFnIjoiQ0xJUFMuYmVzdF9pbWFnZV91cmxnZW4uQzMifQ%3D%3D&_nc_ohc=pyjJs6cFF4UQ7kNvwFHSgss&_nc_oc=AdpKvdRTlfqmMsL6LSH5gnNFfwOJa-8hxMK8eSMNF9kAZjuEWwmyzEOGZsf1R9bX6lU&_nc_zt=23&_nc_ht=scontent.cdninstagram.com&_nc_gid=AewD8YwipWsZ_NslzIwb5A&_nc_ss=7b289&oh=00_AQTJCVNPxXvhIoL7k6_Qf1_-A7jVsZfJCUW6QOe57Rh5jQ&oe=6AF62BA0"],"extra":{}},{"id":"4024591949004495747","shortcode":"DfaOQ3uT1uD","taken_at":"2026-11-06T18:12:48+00:00","kind":"video","product_type":"clips","caption":"Climbing Everest takes incredible determination. Capturing it on film adds a whole new challenge.\n\nFrom Oscar®-winning filmmakers @chaivasarhelyi and @jimmychin, Everest: The Other Side, now playing only in theaters and IMAX worldwide.","hashtags":[],"mentions":["chaivasarhelyi","jimmychin"],"accessibility_caption":null,"likes":null,"comments":null,"views":null,"counts_hidden":null,"comments_disabled":null,"is_pinned":null,"is_paid_partnership":null,"owner":{"id":"787132","username":"natgeo","full_name":null,"is_verified":null,"is_private":null,"avatar_url":null,"latest_story_at":null,"extra":{}},"coauthors":[],"sponsors":[],"tagged":[],"location":null,"audio":null,"thumbnail_url":"https://scontent.cdninstagram.com/v/t51.82787-15/887454673_18716474734019133_3459169919382917498_n.jpg?stp=dst-jpg_e35_s640x640_tt6&_nc_cat=103&ccb=7-5&_nc_sid=18de74&efg=eyJlZmdfdGFnIjoiQ0xJUFMuYmVzdF9pbWFnZV91cmxnZW4uQzMifQ%3D%3D&_nc_ohc=2WMwm29xtdoQ7kNvwHLRvG9&_nc_oc=Adpn8ED2ZEjr6bEAVu8Jar2yt9A_ruR7UJKmXBtyrhrMsDVk3YK3AncxRsJ455Z64BE&_nc_zt=23&_nc_ht=scontent.cdninstagram.com&_nc_gid=AewD8YwipWsZ_NslzIwb5A&_nc_ss=7b289&oh=00_AQSx1NMNR4SQZsVtYdXcEp_zCPcRsmPmvkrQ2FiJnelPmQ&oe=6AF638F0","video_duration":null,"media":[{"kind":"video","url":"https://scontent.cdninstagram.com/v/t51.82787-15/887454673_18716474734019133_3459169919382917498_n.jpg?stp=dst-jpg_e35_s640x640_tt6&_nc_cat=103&ccb=7-5&_nc_sid=18de74&efg=eyJlZmdfdGFnIjoiQ0xJUFMuYmVzdF9pbWFnZV91cmxnZW4uQzMifQ%3D%3D&_nc_ohc=2WMwm29xtdoQ7kNvwHLRvG9&_nc_oc=Adpn8ED2ZEjr6bEAVu8Jar2yt9A_ruR7UJKmXBtyrhrMsDVk3YK3AncxRsJ455Z64BE&_nc_zt=23&_nc_ht=scontent.cdninstagram.com&_nc_gid=AewD8YwipWsZ_NslzIwb5A&_nc_ss=7b289&oh=00_AQSx1NMNR4SQZsVtYdXcEp_zCPcRsmPmvkrQ2FiJnelPmQ&oe=6AF638F0","width":null,"height":null,"duration":null}],"media_urls":["https://scontent.cdninstagram.com/v/t51.82787-15/887454673_18716474734019133_3459169919382917498_n.jpg?stp=dst-jpg_e35_s640x640_tt6&_nc_cat=103&ccb=7-5&_nc_sid=18de74&efg=eyJlZmdfdGFnIjoiQ0xJUFMuYmVzdF9pbWFnZV91cmxnZW4uQzMifQ%3D%3D&_nc_ohc=2WMwm29xtdoQ7kNvwHLRvG9&_nc_oc=Adpn8ED2ZEjr6bEAVu8Jar2yt9A_ruR7UJKmXBtyrhrMsDVk3YK3AncxRsJ455Z64BE&_nc_zt=23&_nc_ht=scontent.cdninstagram.com&_nc_gid=AewD8YwipWsZ_NslzIwb5A&_nc_ss=7b289&oh=00_AQSx1NMNR4SQZsVtYdXcEp_zCPcRsmPmvkrQ2FiJnelPmQ&oe=6AF638F0"],"extra":{}},{"id":"4023937519539390770","shortcode":"DfX5dqygwky","taken_at":"2026-11-05T20:32:34+00:00","kind":"video","product_type":"clips","caption":"A spectacle of nature, the northern lights can take on a variety of colors.\n\n#SecretsOfThePenguins is streaming on @DisneyPlus","hashtags":["SecretsOfThePenguins"],"mentions":["disneyplus"],"accessibility_caption":null,"likes":null,"comments":null,"views":null,"counts_hidden":null,"comments_disabled":null,"is_pinned":null,"is_paid_partnership":null,"owner":{"id":"787132","username":"natgeo","full_name":null,"is_verified":null,"is_private":null,"avatar_url":null,"latest_story_at":null,"extra":{}},"coauthors":[],"sponsors":[],"tagged":[],"location":null,"audio":null,"thumbnail_url":"https://scontent.cdninstagram.com/v/t51.82787-15/890616619_18716160643019133_2194959239334842996_n.jpg?stp=dst-jpg_e35_s640x640_tt6&_nc_cat=100&ccb=7-5&_nc_sid=18de74&efg=eyJlZmdfdGFnIjoiQ0xJUFMuYmVzdF9pbWFnZV91cmxnZW4uQzMifQ%3D%3D&_nc_ohc=if_CUm_hINoQ7kNvwFA2fVV&_nc_oc=Adqpw8gJ-TyL7SF4bx1yPKKNPiQU1Js57BfbNHN_eJKOUPwq1ReXXcBDhjmneDUiFYc&_nc_zt=23&_nc_ht=scontent.cdninstagram.com&_nc_gid=AewD8YwipWsZ_NslzIwb5A&_nc_ss=7b289&oh=00_AQR05wv8LOTyh9q8xZpcnDY-xlHil90lt73vnF4Vm4G1Ag&oe=6AF619AF","video_duration":null,"media":[{"kind":"video","url":"https://scontent.cdninstagram.com/v/t51.82787-15/890616619_18716160643019133_2194959239334842996_n.jpg?stp=dst-jpg_e35_s640x640_tt6&_nc_cat=100&ccb=7-5&_nc_sid=18de74&efg=eyJlZmdfdGFnIjoiQ0xJUFMuYmVzdF9pbWFnZV91cmxnZW4uQzMifQ%3D%3D&_nc_ohc=if_CUm_hINoQ7kNvwFA2fVV&_nc_oc=Adqpw8gJ-TyL7SF4bx1yPKKNPiQU1Js57BfbNHN_eJKOUPwq1ReXXcBDhjmneDUiFYc&_nc_zt=23&_nc_ht=scontent.cdninstagram.com&_nc_gid=AewD8YwipWsZ_NslzIwb5A&_nc_ss=7b289&oh=00_AQR05wv8LOTyh9q8xZpcnDY-xlHil90lt73vnF4Vm4G1Ag&oe=6AF619AF","width":null,"height":null,"duration":null}],"media_urls":["https://scontent.cdninstagram.com/v/t51.82787-15/890616619_18716160643019133_2194959239334842996_n.jpg?stp=dst-jpg_e35_s640x640_tt6&_nc_cat=100&ccb=7-5&_nc_sid=18de74&efg=eyJlZmdfdGFnIjoiQ0xJUFMuYmVzdF9pbWFnZV91cmxnZW4uQzMifQ%3D%3D&_nc_ohc=if_CUm_hINoQ7kNvwFA2fVV&_nc_oc=Adqpw8gJ-TyL7SF4bx1yPKKNPiQU1Js57BfbNHN_eJKOUPwq1ReXXcBDhjmneDUiFYc&_nc_zt=23&_nc_ht=scontent.cdninstagram.com&_nc_gid=AewD8YwipWsZ_NslzIwb5A&_nc_ss=7b289&oh=00_AQR05wv8LOTyh9q8xZpcnDY-xlHil90lt73vnF4Vm4G1Ag&oe=6AF619AF"],"extra":{}},{"id":"4022807145326573303","shortcode":"DfT4cjxF_b3","taken_at":"2026-11-04T07:06:43+00:00","kind":"image","product_type":"feed","caption":"The Antarctic climate may be harsh, but this huddle of emperor penguins makes it look like a cozy affair.\n\nPhotograph by Frank Kazukaitis","hashtags":[],"mentions":[],"accessibility_caption":null,"likes":null,"comments":null,"views":null,"counts_hidden":null,"comments_disabled":null,"is_pinned":null,"is_paid_partnership":null,"owner":{"id":"787132","username":"natgeo","full_name":null,"is_verified":null,"is_private":null,"avatar_url":null,"latest_story_at":null,"extra":{}},"coauthors":[],"sponsors":[],"tagged":[],"location":null,"audio":null,"thumbnail_url":"https://scontent.cdninstagram.com/v/t51.82787-15/889977404_18715578586019133_378692361415586386_n.jpg?stp=dst-jpg_e35_s640x640_tt6&_nc_cat=108&ccb=7-5&_nc_sid=18de74&efg=eyJlZmdfdGFnIjoiRkVFRC5iZXN0X2ltYWdlX3VybGdlbi5DMyJ9&_nc_ohc=TV0pfDJT0DQQ7kNvwH0Eb18&_nc_oc=AdrFwTWhBo1By6BqVOpmff4z18G4SWgW73WN7mzpoUK2wnzjA5eYYKagIFvRBGh6VcI&_nc_zt=23&_nc_ht=scontent.cdninstagram.com&_nc_gid=AewD8YwipWsZ_NslzIwb5A&_nc_ss=7b289&oh=00_AQSwwla8i4wD20lgVt4BWPYxvtye8hgZ2qiSryQKnt_Y8Q&oe=6AF64AAD","video_duration":null,"media":[{"kind":"image","url":"https://scontent.cdninstagram.com/v/t51.82787-15/889977404_18715578586019133_378692361415586386_n.jpg?stp=dst-jpg_e35_s640x640_tt6&_nc_cat=108&ccb=7-5&_nc_sid=18de74&efg=eyJlZmdfdGFnIjoiRkVFRC5iZXN0X2ltYWdlX3VybGdlbi5DMyJ9&_nc_ohc=TV0pfDJT0DQQ7kNvwH0Eb18&_nc_oc=AdrFwTWhBo1By6BqVOpmff4z18G4SWgW73WN7mzpoUK2wnzjA5eYYKagIFvRBGh6VcI&_nc_zt=23&_nc_ht=scontent.cdninstagram.com&_nc_gid=AewD8YwipWsZ_NslzIwb5A&_nc_ss=7b289&oh=00_AQSwwla8i4wD20lgVt4BWPYxvtye8hgZ2qiSryQKnt_Y8Q&oe=6AF64AAD","width":null,"height":null,"duration":null}],"media_urls":["https://scontent.cdninstagram.com/v/t51.82787-15/889977404_18715578586019133_378692361415586386_n.jpg?stp=dst-jpg_e35_s640x640_tt6&_nc_cat=108&ccb=7-5&_nc_sid=18de74&efg=eyJlZmdfdGFnIjoiRkVFRC5iZXN0X2ltYWdlX3VybGdlbi5DMyJ9&_nc_ohc=TV0pfDJT0DQQ7kNvwH0Eb18&_nc_oc=AdrFwTWhBo1By6BqVOpmff4z18G4SWgW73WN7mzpoUK2wnzjA5eYYKagIFvRBGh6VcI&_nc_zt=23&_nc_ht=scontent.cdninstagram.com&_nc_gid=AewD8YwipWsZ_NslzIwb5A&_nc_ss=7b289&oh=00_AQSwwla8i4wD20lgVt4BWPYxvtye8hgZ2qiSryQKnt_Y8Q&oe=6AF64AAD"],"extra":{}},{"id":"4022519540978119025","shortcode":"DfS3DXWEXFx","taken_at":"2026-11-03T21:35:18+00:00","kind":"carousel","product_type":"carousel_container","caption":"Extreme heat is becoming a fact of life in more parts of the world, with serious implications for pregnant women and their babies.\n\nHundreds of studies have linked high heat exposure to adverse birth outcomes, but scientists are still trying to figure out just how hot is too hot. A recent study in Sydney is putting that question to the test, using a climate chamber that can reach 104°F (40°C) to determine when pregnant women can no longer safely regulate their core temperature. Finding that limit matters as heat exposure increases, particularly in places like Palau, where women and their babies face an average of 77 heat-risk days a year—and staying cool can come at a cost many families can’t afford.\n\nLearn more at the link in bio.\n\nPhotographs by @nicholesobecki","hashtags":[],"mentions":["nicholesobecki"],"accessibility_caption":null,"likes":null,"comments":null,"views":null,"counts_hidden":null,"comments_disabled":null,"is_pinned":null,"is_paid_partnership":null,"owner":{"id":"787132","username":"natgeo","full_name":null,"is_verified":null,"is_private":null,"avatar_url":null,"latest_story_at":null,"extra":{}},"coauthors":[],"sponsors":[],"tagged":[],"location":null,"audio":null,"thumbnail_url":"https://scontent.cdninstagram.com/v/t51.71878-15/873874124_1149446364721343_1676263963223151588_n.jpg?stp=dst-jpg_e35_s640x640_tt6&_nc_cat=109&ccb=7-5&_nc_sid=18de74&efg=eyJlZmdfdGFnIjoiQ0FST1VTRUxfSVRFTS5iZXN0X2ltYWdlX3VybGdlbi5DMyJ9&_nc_ohc=LDxy-yWjnW0Q7kNvwH8Qrc1&_nc_oc=Adpt39ZG66jB4WzBHUX9HLqmglKsPmk5Jcjs4rXcLc5J-3Pld5x0zX3Ab6BWv-9W7MU&_nc_zt=23&_nc_ht=scontent.cdninstagram.com&_nc_gid=AewD8YwipWsZ_NslzIwb5A&_nc_ss=7b289&oh=00_AQRJgDMJqpzWAfAO2UCjRDlhv-JgGEfajnhVyiD67Hma0Q&oe=6AF61A87","video_duration":null,"media":[{"kind":"image","url":"https://scontent.cdninstagram.com/v/t51.71878-15/873874124_1149446364721343_1676263963223151588_n.jpg?stp=dst-jpg_e35_s640x640_tt6&_nc_cat=109&ccb=7-5&_nc_sid=18de74&efg=eyJlZmdfdGFnIjoiQ0FST1VTRUxfSVRFTS5iZXN0X2ltYWdlX3VybGdlbi5DMyJ9&_nc_ohc=LDxy-yWjnW0Q7kNvwH8Qrc1&_nc_oc=Adpt39ZG66jB4WzBHUX9HLqmglKsPmk5Jcjs4rXcLc5J-3Pld5x0zX3Ab6BWv-9W7MU&_nc_zt=23&_nc_ht=scontent.cdninstagram.com&_nc_gid=AewD8YwipWsZ_NslzIwb5A&_nc_ss=7b289&oh=00_AQRJgDMJqpzWAfAO2UCjRDlhv-JgGEfajnhVyiD67Hma0Q&oe=6AF61A87","width":null,"height":null,"duration":null}],"media_urls":["https://scontent.cdninstagram.com/v/t51.71878-15/873874124_1149446364721343_1676263963223151588_n.jpg?stp=dst-jpg_e35_s640x640_tt6&_nc_cat=109&ccb=7-5&_nc_sid=18de74&efg=eyJlZmdfdGFnIjoiQ0FST1VTRUxfSVRFTS5iZXN0X2ltYWdlX3VybGdlbi5DMyJ9&_nc_ohc=LDxy-yWjnW0Q7kNvwH8Qrc1&_nc_oc=Adpt39ZG66jB4WzBHUX9HLqmglKsPmk5Jcjs4rXcLc5J-3Pld5x0zX3Ab6BWv-9W7MU&_nc_zt=23&_nc_ht=scontent.cdninstagram.com&_nc_gid=AewD8YwipWsZ_NslzIwb5A&_nc_ss=7b289&oh=00_AQRJgDMJqpzWAfAO2UCjRDlhv-JgGEfajnhVyiD67Hma0Q&oe=6AF61A87"],"extra":{}},{"id":"4022542910187864835","shortcode":"DfS8Xbng4MD","taken_at":"2026-11-03T22:21:44+00:00","kind":"video","product_type":"clips","caption":"Cascading more than 2,500 feet (762 meters), Gocta waterfall, near the village of Cocachimba in northern Peru, is one of the world’s tallest waterfalls. It's just one of the incredible sights that visitors can discover in northern Peru, a region gaining further interest thanks to the archaeological work underway at the nearby ruins of Kuélap.\n\nNat Geo’s annual #BestOfTheWorld guide contains the most exciting, meaningful, and one-of-a-kind travel experiences for 2027. See the full list and plan your next adventure at the link in bio.\n\nVideo by @cesar_rodriguezb","hashtags":["BestOfTheWorld"],"mentions":["cesar_rodriguezb"],"accessibility_caption":null,"likes":null,"comments":null,"views":null,"counts_hidden":null,"comments_disabled":null,"is_pinned":null,"is_paid_partnership":null,"owner":{"id":"787132","username":"natgeo","full_name":null,"is_verified":null,"is_private":null,"avatar_url":null,"latest_story_at":null,"extra":{}},"coauthors":[],"sponsors":[],"tagged":[],"location":null,"audio":null,"thumbnail_url":"https://scontent.cdninstagram.com/v/t51.82787-15/883375032_18715453234019133_4302528589435037654_n.jpg?stp=dst-jpg_e35_s640x640_tt6&_nc_cat=108&ccb=7-5&_nc_sid=18de74&efg=eyJlZmdfdGFnIjoiQ0xJUFMuYmVzdF9pbWFnZV91cmxnZW4uQzMifQ%3D%3D&_nc_ohc=E2J9PWqugBYQ7kNvwFDEFmc&_nc_oc=Adrq3ADWMJfAyqiqZzUkTKJIrz5aZjqa1ARbJCe4kBeTs4st7MPiGg8w3T9OYxYDkRs&_nc_zt=23&_nc_ht=scontent.cdninstagram.com&_nc_gid=AewD8YwipWsZ_NslzIwb5A&_nc_ss=7b289&oh=00_AQTsah4Mk_tbwvxcisJmJB__X_hZrighTo13AGnQzy6euw&oe=6AF61CE2","video_duration":null,"media":[{"kind":"video","url":"https://scontent.cdninstagram.com/v/t51.82787-15/883375032_18715453234019133_4302528589435037654_n.jpg?stp=dst-jpg_e35_s640x640_tt6&_nc_cat=108&ccb=7-5&_nc_sid=18de74&efg=eyJlZmdfdGFnIjoiQ0xJUFMuYmVzdF9pbWFnZV91cmxnZW4uQzMifQ%3D%3D&_nc_ohc=E2J9PWqugBYQ7kNvwFDEFmc&_nc_oc=Adrq3ADWMJfAyqiqZzUkTKJIrz5aZjqa1ARbJCe4kBeTs4st7MPiGg8w3T9OYxYDkRs&_nc_zt=23&_nc_ht=scontent.cdninstagram.com&_nc_gid=AewD8YwipWsZ_NslzIwb5A&_nc_ss=7b289&oh=00_AQTsah4Mk_tbwvxcisJmJB__X_hZrighTo13AGnQzy6euw&oe=6AF61CE2","width":null,"height":null,"duration":null}],"media_urls":["https://scontent.cdninstagram.com/v/t51.82787-15/883375032_18715453234019133_4302528589435037654_n.jpg?stp=dst-jpg_e35_s640x640_tt6&_nc_cat=108&ccb=7-5&_nc_sid=18de74&efg=eyJlZmdfdGFnIjoiQ0xJUFMuYmVzdF9pbWFnZV91cmxnZW4uQzMifQ%3D%3D&_nc_ohc=E2J9PWqugBYQ7kNvwFDEFmc&_nc_oc=Adrq3ADWMJfAyqiqZzUkTKJIrz5aZjqa1ARbJCe4kBeTs4st7MPiGg8w3T9OYxYDkRs&_nc_zt=23&_nc_ht=scontent.cdninstagram.com&_nc_gid=AewD8YwipWsZ_NslzIwb5A&_nc_ss=7b289&oh=00_AQTsah4Mk_tbwvxcisJmJB__X_hZrighTo13AGnQzy6euw&oe=6AF61CE2"],"extra":{}},{"id":"4022502291199611995","shortcode":"DfSzIWPJdRb","taken_at":"2026-11-03T21:01:02+00:00","kind":"video","product_type":"clips","caption":"Ready for liftoff? National Geographic Light-Up Air Rockets can soar up to 100 ft, turning your backyard into a launch pad for sky-high fun. 🚀\n\nAvailable now on Amazon at the link in bio.","hashtags":[],"mentions":[],"accessibility_caption":null,"likes":null,"comments":null,"views":null,"counts_hidden":null,"comments_disabled":null,"is_pinned":null,"is_paid_partnership":null,"owner":{"id":"68012770661","username":"natgeofamily","full_name":null,"is_verified":null,"is_private":null,"avatar_url":null,"latest_story_at":null,"extra":{}},"coauthors":[{"id":"787132","username":"natgeo","full_name":null,"is_verified":null,"is_private":null,"avatar_url":null,"latest_story_at":null,"extra":{}}],"sponsors":[],"tagged":[],"location":null,"audio":null,"thumbnail_url":"https://scontent.cdninstagram.com/v/t51.82787-15/885294831_17958552222266662_8321410699709196462_n.jpg?stp=dst-jpg_e35_s640x640_tt6&_nc_cat=106&ccb=7-5&_nc_sid=18de74&efg=eyJlZmdfdGFnIjoiQ0xJUFMuYmVzdF9pbWFnZV91cmxnZW4uQzMifQ%3D%3D&_nc_ohc=n08O9dDsmtoQ7kNvwFtUDd4&_nc_oc=Adpkn0wy_8Kc8WDoLHC9-qs4JMmDMWtZoRbYdEzDSF0vpkGyoUpmZ3yOcXl5AeQOkgM&_nc_zt=23&_nc_ht=scontent.cdninstagram.com&_nc_gid=AewD8YwipWsZ_NslzIwb5A&_nc_ss=7b289&oh=00_AQSmqRV4AhCfpQBVlgmphaT2hqcRjdHOGc4ZThycnYKNhA&oe=6AF63F22","video_duration":null,"media":[{"kind":"video","url":"https://scontent.cdninstagram.com/v/t51.82787-15/885294831_17958552222266662_8321410699709196462_n.jpg?stp=dst-jpg_e35_s640x640_tt6&_nc_cat=106&ccb=7-5&_nc_sid=18de74&efg=eyJlZmdfdGFnIjoiQ0xJUFMuYmVzdF9pbWFnZV91cmxnZW4uQzMifQ%3D%3D&_nc_ohc=n08O9dDsmtoQ7kNvwFtUDd4&_nc_oc=Adpkn0wy_8Kc8WDoLHC9-qs4JMmDMWtZoRbYdEzDSF0vpkGyoUpmZ3yOcXl5AeQOkgM&_nc_zt=23&_nc_ht=scontent.cdninstagram.com&_nc_gid=AewD8YwipWsZ_NslzIwb5A&_nc_ss=7b289&oh=00_AQSmqRV4AhCfpQBVlgmphaT2hqcRjdHOGc4ZThycnYKNhA&oe=6AF63F22","width":null,"height":null,"duration":null}],"media_urls":["https://scontent.cdninstagram.com/v/t51.82787-15/885294831_17958552222266662_8321410699709196462_n.jpg?stp=dst-jpg_e35_s640x640_tt6&_nc_cat=106&ccb=7-5&_nc_sid=18de74&efg=eyJlZmdfdGFnIjoiQ0xJUFMuYmVzdF9pbWFnZV91cmxnZW4uQzMifQ%3D%3D&_nc_ohc=n08O9dDsmtoQ7kNvwFtUDd4&_nc_oc=Adpkn0wy_8Kc8WDoLHC9-qs4JMmDMWtZoRbYdEzDSF0vpkGyoUpmZ3yOcXl5AeQOkgM&_nc_zt=23&_nc_ht=scontent.cdninstagram.com&_nc_gid=AewD8YwipWsZ_NslzIwb5A&_nc_ss=7b289&oh=00_AQSmqRV4AhCfpQBVlgmphaT2hqcRjdHOGc4ZThycnYKNhA&oe=6AF63F22"],"extra":{}}],"pages":[{"cursor":null,"fetched_at":"2026-09-09T07:00:00+00:00","count":12,"signed_in":false}],"next_cursor":"eyJtYXhfaWQiOiJ0aW1lbGluZTpBUUhUTFlGalItdGdaVW1nM0pBTm15bTNReE41MkY1UXZvZG1DV3VxU29LRFhjYkg4MkVuQXhXXzR0QjRhZjJuS1JLUjUwR1QyNGVKWm9QNHBFUVN0ZE1zWEEiLCJvcCI6InVzZXJfZmVlZCJ9","has_more":true,"stop_reason":"pages","coverage":{"since":null,"oldest_at":"2026-10-15T16:34:49+00:00","since_reached":false}},"meta":{"source":"live","fetched_at":"2026-11-08T11:51:24Z","cost":"$0.0005","balance":"$424.2951","request_id":"req_6908bc75cc8f4166af167e75456da892"}}}}},"202":{"description":"Durable job accepted. No completed-result charge. Save batch_id; poll status_url. Retry submission with the same Idempotency-Key after a lost response. An account may have five queued, running or payment-required jobs. A sixth new job returns 429 rate_limited. Matching idempotent replays still work at the limit. Ready and failed jobs release their slots; pages within a job remain unbounded. This is a synthetic contract example, not a live capture.","x-example-provenance":"synthetic-contract","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","required":["batch_id","status","status_url","results_url","cost","item_count","error","retry_at","total","done_count","failed_count","created_at","started_at","finished_at"],"properties":{"batch_id":{"type":"string"},"status":{"type":"string","enum":["queued","running","payment_required","ready","failed"]},"status_url":{"type":"string"},"results_url":{"type":"string"},"cost":{"type":"string"},"item_count":{"type":"integer","nullable":true},"error":{"type":"string","nullable":true,"description":"Null unless failed. A failed target carries its own code; incomplete_result appears only when it has none and pages of the result are missing. profile_not_found, post_not_found, upstream_not_found or not_found: the target does not exist or is not visible. not_visible: The account exists, but its posts are not visible to logged-out readers (private, restricted, or hidden by Instagram). Retrying will not change the result until the account changes. not_cached: cached=cache_only found no saved read. incomplete_result: pages of the result are missing. temporarily_unavailable: the target could not be read for now (no capacity, a pause or repeated refusals); retry later with a new job. result_item_too_large: one result unit exceeds the delivery budget. result_snapshot_missing or result_snapshot_corrupt: the crawler could not serve the retained result of a paid job, and its charge is refunded; if the crawler serves it again, a later results read returns it and charges the job again. crawler_submit_400, crawler_submit_404 or crawler_submit_422: the crawl service refused the job request. crawler_job_failed: any other failure; the same job is not expected to succeed if resubmitted. cancelled: the job was cancelled with POST /v1/jobs/{job_id}/cancel. No failed job costs anything: only result_snapshot_missing and result_snapshot_corrupt follow a charge, and that charge is refunded."},"retry_at":{"type":"string","format":"date-time","nullable":true,"description":"Null unless the job failed temporarily_unavailable because a crawl route was closed for every caller. Then it is when the route opens again, and the response carries the same time as a Retry-After header in seconds. Submit a new job after it."},"total":{"type":"integer","description":"Targets in the job. A job submitted through a /v1 route has one."},"done_count":{"type":"integer","description":"Targets the crawler finished."},"failed_count":{"type":"integer","description":"Targets that failed."},"created_at":{"type":"string","format":"date-time","description":"When the job was submitted."},"started_at":{"type":"string","format":"date-time","nullable":true,"description":"When the crawler started the job. Null until it starts."},"finished_at":{"type":"string","format":"date-time","nullable":true,"description":"When the job finished or failed. Null while it is queued or running."}}},"meta":{"type":"object","required":["cost","request_id"],"properties":{"cost":{"type":"string","example":"$0.0000"},"request_id":{"type":"string"}}}}},"example":{"data":{"batch_id":"job_7641d5f0-717d-4b70-a2f1-f58d846d7242","status":"queued","status_url":"/v1/jobs/job_7641d5f0-717d-4b70-a2f1-f58d846d7242","results_url":"/v1/jobs/job_7641d5f0-717d-4b70-a2f1-f58d846d7242/results","cost":"$0.0000","item_count":null,"error":null,"retry_at":null,"total":1,"done_count":0,"failed_count":0,"created_at":"2026-10-12T12:56:17.403Z","started_at":null,"finished_at":null},"meta":{"cost":"$0.0000","request_id":"req_job_example"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"403":{"description":"Instagram does not show this account to logged-out readers: it is private, hidden or restricted, or it no longer exists. Retrying will not change the answer until the account changes. You are not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"account_unavailable","message":"Instagram account @nike_private is private: its timeline answered the empty shell and the logged-out profile says is_private. You are not charged.","request_id":"req_5c10900e919bc7a3ff79b7501d582b4c"}}}}},"404":{"description":"`cached=cache_only` found nothing saved for these arguments (`not_cached`; call again with `cached=auto` to fetch it), or the account, post, highlight, or location does not exist (`not_found`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_cached","message":"no saved instagram/web_profile_info read for 'instagram'. cached=cache_only never fetches, so call again with cached=auto to fetch it. You are not charged.","request_id":"req_5c10900e919bc7a3ff79b7501d582b4c"}}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/instagram/highlights_tray":{"get":{"tags":["Instagram"],"operationId":"igHighlightsTray","summary":"highlights_tray","x-dashboard-cost":"$0.0005","x-example-query":{"handle":"instagram","max_highlights_to_fetch_on_pagination":"100"},"description":"Wraps `doc_id PolarisLoggedOutDesktopWWWProfileRootContentQuery (lox_highlights_connection, first 10)`. Returns `Highlight[]` under `data`; with `get_raw=true` returns the upstream JSON.\n\nUnknown, unsupported, and repeated query parameters return 400 before acquisition or billing.\n\nThe example response is the crawler's own projection of a synthetic upstream document into `Highlight[]`, not a live capture.","security":[{"bearerAuth":[]}],"parameters":[{"name":"handle","in":"query","required":true,"description":"Instagram account handle (a leading `@` is accepted). On the operations whose upstream call takes the numeric account id, the crawler resolves it; a handle it has never seen costs one extra anonymous profile read.","example":"instagram","schema":{"type":"string"}},{"name":"max_highlights_to_fetch_on_pagination","in":"query","required":false,"description":"Native list size, a positive integer. Instagram controls the returned count. Defaults to 100 when omitted; omission is forwarded unchanged.","schema":{"type":"integer","default":100,"minimum":1,"maximum":9007199254740991},"examples":{"default":{"value":100,"x-disabled":true}}},{"name":"cached","in":"query","required":false,"description":"`auto` (default) serves a read saved within the last 24 hours for these exact arguments, otherwise fetches. `cache_only` never contacts Instagram (404 `not_cached` when nothing is saved, whatever its age). `live` always fetches. Anything else is a `400`. A saved read is an earlier answer of this operation for the same arguments; an account in the profile library (`/v1/instagram/profile`) is not one until this operation has read it.","schema":{"type":"string","enum":["auto","cache_only","live"],"default":"auto"},"examples":{"default":{"value":"auto","x-disabled":true}}},{"name":"get_raw","in":"query","required":false,"description":"`true` returns the upstream JSON exactly as Instagram answered it instead of the normalized `Highlight[]`.","schema":{"type":"boolean","default":false},"examples":{"default":{"value":false,"x-disabled":true}}}],"responses":{"200":{"description":"`Highlight[]` under `data`; with `get_raw=true` the upstream JSON.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"anyOf":[{"type":"array","items":{"$ref":"#/components/schemas/Highlight"}},{"type":"object","additionalProperties":true}],"description":"`Highlight[]`, or the upstream JSON when `get_raw=true`."},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":[{"id":"18223279177302854","title":"close friends","cover_url":"https://scontent.cdninstagram.com/close-friends.jpg","items":null,"created_at":null,"owner":{"id":"25025320","username":"instagram","full_name":"Instagram","is_verified":true,"is_private":false,"avatar_url":"https://scontent.cdninstagram.com/avatar.jpg","latest_story_at":null,"extra":{}},"stories":[]},{"id":"18612622252018257","title":"🎤🎶🎸","cover_url":"https://scontent.cdninstagram.com/second.jpg","items":null,"created_at":null,"owner":{"id":"25025320","username":"instagram","full_name":"Instagram","is_verified":true,"is_private":false,"avatar_url":"https://scontent.cdninstagram.com/avatar.jpg","latest_story_at":null,"extra":{}},"stories":[]}],"meta":{"source":"live","fetched_at":"2026-09-09T03:10:22Z","cost":"$0.0005","balance":"$0.3777","request_id":"req_f1abb41157ca15c565d48a90bacef554"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"403":{"description":"Instagram does not show this account to logged-out readers: it is private, hidden or restricted, or it no longer exists. Retrying will not change the answer until the account changes. You are not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"account_unavailable","message":"Instagram account @nike_private is private: its timeline answered the empty shell and the logged-out profile says is_private. You are not charged.","request_id":"req_5c10900e919bc7a3ff79b7501d582b4c"}}}}},"404":{"description":"`cached=cache_only` found nothing saved for these arguments (`not_cached`; call again with `cached=auto` to fetch it), or the account, post, highlight, or location does not exist (`not_found`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_cached","message":"no saved instagram/web_profile_info read for 'instagram'. cached=cache_only never fetches, so call again with cached=auto to fetch it. You are not charged.","request_id":"req_5c10900e919bc7a3ff79b7501d582b4c"}}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/instagram/post_comments":{"get":{"tags":["Instagram"],"operationId":"igPostComments","summary":"post_comments","x-dashboard-cost":"$0.0005","x-example-query":{"media_id":"3955764706547590026","max_pages":"1"},"description":"Wraps `doc_id PolarisLoggedOutDesktopWWWPostCommentsPaginationQuery (first, after)`. With max_pages=1, returns `Page[Comment]` under `data`; with `get_raw=true` returns the upstream JSON.\n\nThe default request creates a durable job (202). Use max_pages=1 for one synchronous Page response (200). Poll status_url, then read results_url with its opaque cursor. Acquisition stops at the first of since, max_pages, or exhaustion. Jobs continue after disconnects. Result responses are bounded to 3 MiB; this does not limit the crawl. An output unit above that byte budget fails the job before billing; results return 413. The selected raw or normalized mode never changes automatically. Supply Idempotency-Key to recover a lost submission response; reuse it with the same inputs.\n\nUnknown, unsupported, and repeated query parameters return 400 before acquisition or billing.\n\nThe example response is the crawler's own projection of a synthetic upstream document into `Page[Comment]`, not a live capture.","security":[{"bearerAuth":[]}],"parameters":[{"name":"media_id","in":"query","required":true,"description":"Numeric media id (the post pk). A post shortcode is accepted and converted.","example":"3955764706547590026","schema":{"type":"string"}},{"name":"since","in":"query","required":false,"description":"Stop at this date. `2025-09-21` means midnight UTC (2025-09-21T00:00:00Z). Datetimes must use RFC3339 with a timezone, for example `2025-09-21T09:00:00+09:00`. `365d` means 365 days before submission. Invalid calendar dates return 400. With max_pages, the first boundary reached stops the walk. since alone creates a job.","schema":{"type":"string"},"examples":{"default":{"value":"2025-09-21","x-disabled":true},"date":{"value":"2025-09-21","x-disabled":true},"datetime":{"value":"2025-09-21T00:00:00Z","x-disabled":true},"duration":{"value":"365d","x-disabled":true}}},{"name":"max_pages","in":"query","required":false,"example":1,"description":"Maximum pages to fetch. -1 walks until exhaustion or since with no page cap, and must be written. Omitted, since alone bounds the walk; with neither, the job stops after 10 pages. Any positive integer is accepted. 1 returns one page synchronously with HTTP 200; any other value creates a durable job with HTTP 202.","schema":{"type":"integer","anyOf":[{"enum":[-1]},{"minimum":1}]}},{"name":"cursor","in":"query","required":false,"description":"Opaque next_cursor from an earlier acquisition of this operation, also with `get_raw=true`. A native Instagram max_id or end_cursor from a raw page answers 400. Result download cursors belong to the results route.","schema":{"type":"string","minLength":1}},{"name":"page_size","in":"query","required":false,"description":"Native first, default 24. Instagram controls the returned count.","schema":{"type":"integer","default":24,"minimum":1},"examples":{"default":{"value":24,"x-disabled":true}}},{"name":"cached","in":"query","required":false,"description":"`auto` (default) serves a read saved within the last 24 hours for these exact arguments, otherwise fetches. `cache_only` never contacts Instagram (404 `not_cached` when nothing is saved, whatever its age). `live` always fetches. Anything else is a `400`. A saved read is an earlier answer of this operation for the same arguments; an account in the profile library (`/v1/instagram/profile`) is not one until this operation has read it. `cache_only` reads one saved page per request: omit `max_pages` or pass 1, and continue with `next_cursor`.","schema":{"type":"string","enum":["auto","cache_only","live"],"default":"auto"},"examples":{"default":{"value":"auto","x-disabled":true}}},{"name":"get_raw","in":"query","required":false,"description":"`true` returns the upstream JSON exactly as Instagram answered it instead of the normalized `Page[Comment]`.","schema":{"type":"boolean","default":false},"examples":{"default":{"value":false,"x-disabled":true}}},{"name":"Idempotency-Key","in":"header","required":false,"description":"Reuse this key with the same inputs to recover a lost job submission. A different input with the same key returns 409.","schema":{"type":"string","minLength":1,"maxLength":200}}],"responses":{"200":{"description":"`Page[Comment]` under `data`; with `get_raw=true` the upstream JSON.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"anyOf":[{"type":"object","required":["items","pages","next_cursor","has_more","stop_reason","coverage"],"properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/Comment"},"description":"`Comment` of every page walked, in page order."},"pages":{"type":"array","items":{"$ref":"#/components/schemas/PageRead"},"description":"One entry per page walked."},"next_cursor":{"type":"string","nullable":true,"description":"Opaque; pass back as `cursor` to continue."},"has_more":{"type":"boolean","description":"True exactly when `next_cursor` is set."},"stop_reason":{"type":"string","enum":["pages","since","exhausted","cursor_stalled","repeated_content","deadline","blocked","caught_up"],"description":"Why the walk stopped. `pages`: the page budget is spent and `next_cursor` continues it. `deadline`: the call ran out of time before its next page; `next_cursor` continues it. `since`: a whole page was older than `since`. `exhausted`: Instagram reported the end. `cursor_stalled`: Instagram claimed more but repeated or omitted its cursor. `repeated_content`: a page held only items already seen. `blocked`: Instagram refused a later page; `next_cursor` is the page it refused. `caught_up`: the walk reached the newest post an earlier read of the feed returned; only watch passes the crawler runs for itself stop this way."},"coverage":{"$ref":"#/components/schemas/Coverage"}}},{"type":"object","required":["pages","next_cursor","has_more","stop_reason","signed_in_pages"],"description":"`get_raw=true`: every native page walked, exactly as Instagram answered it, plus the opaque `next_cursor` and `stop_reason` of the walk.","properties":{"pages":{"type":"array","items":{"type":"object","additionalProperties":true},"description":"One native page per page walked, upstream bytes unchanged."},"next_cursor":{"type":"string","nullable":true,"description":"Opaque; pass back as `cursor`."},"has_more":{"type":"boolean","description":"True exactly when `next_cursor` is set."},"stop_reason":{"type":"string","enum":["pages","since","exhausted","cursor_stalled","repeated_content","deadline","blocked","caught_up"],"description":"Why the walk stopped. `pages`: the page budget is spent and `next_cursor` continues it. `deadline`: the call ran out of time before its next page; `next_cursor` continues it. `since`: a whole page was older than `since`. `exhausted`: Instagram reported the end. `cursor_stalled`: Instagram claimed more but repeated or omitted its cursor. `repeated_content`: a page held only items already seen. `blocked`: Instagram refused a later page; `next_cursor` is the page it refused. `caught_up`: the walk reached the newest post an earlier read of the feed returned; only watch passes the crawler runs for itself stop this way."},"signed_in_pages":{"type":"integer","description":"How many of the pages one of our signed-in Instagram accounts read; each bills the signed-in page price."}}}],"description":"`Page[Comment]`, or the upstream JSON when `get_raw=true`."},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"items":[{"id":"18000000000000001","text":"nice","created_at":"2025-09-04T15:35:00+00:00","likes":5,"replies":null,"liked_by_owner":null,"owner":{"id":"111","username":"fan_one","full_name":"Fan One","is_verified":false,"is_private":false,"avatar_url":"https://scontent.cdninstagram.com/fan.jpg","latest_story_at":null,"extra":{}},"extra":{}}],"pages":[{"cursor":null,"fetched_at":"2026-09-09T07:00:00+00:00","count":1,"signed_in":false}],"next_cursor":"eyJhZnRlciI6IlFWRkMuLi4iLCJvcCI6InBvc3RfY29tbWVudHMifQ","has_more":true,"stop_reason":"pages","coverage":{"since":null,"oldest_at":"2025-09-04T15:35:00+00:00","since_reached":false}},"meta":{"source":"live","fetched_at":"2026-09-09T03:10:22Z","cost":"$0.0005","balance":"$0.3777","request_id":"req_f1abb41157ca15c565d48a90bacef554"}}}}},"202":{"description":"Durable job accepted. No completed-result charge. Save batch_id; poll status_url. Retry submission with the same Idempotency-Key after a lost response. An account may have five queued, running or payment-required jobs. A sixth new job returns 429 rate_limited. Matching idempotent replays still work at the limit. Ready and failed jobs release their slots; pages within a job remain unbounded. This is a synthetic contract example, not a live capture.","x-example-provenance":"synthetic-contract","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","required":["batch_id","status","status_url","results_url","cost","item_count","error","retry_at","total","done_count","failed_count","created_at","started_at","finished_at"],"properties":{"batch_id":{"type":"string"},"status":{"type":"string","enum":["queued","running","payment_required","ready","failed"]},"status_url":{"type":"string"},"results_url":{"type":"string"},"cost":{"type":"string"},"item_count":{"type":"integer","nullable":true},"error":{"type":"string","nullable":true,"description":"Null unless failed. A failed target carries its own code; incomplete_result appears only when it has none and pages of the result are missing. profile_not_found, post_not_found, upstream_not_found or not_found: the target does not exist or is not visible. not_visible: The account exists, but its posts are not visible to logged-out readers (private, restricted, or hidden by Instagram). Retrying will not change the result until the account changes. not_cached: cached=cache_only found no saved read. incomplete_result: pages of the result are missing. temporarily_unavailable: the target could not be read for now (no capacity, a pause or repeated refusals); retry later with a new job. result_item_too_large: one result unit exceeds the delivery budget. result_snapshot_missing or result_snapshot_corrupt: the crawler could not serve the retained result of a paid job, and its charge is refunded; if the crawler serves it again, a later results read returns it and charges the job again. crawler_submit_400, crawler_submit_404 or crawler_submit_422: the crawl service refused the job request. crawler_job_failed: any other failure; the same job is not expected to succeed if resubmitted. cancelled: the job was cancelled with POST /v1/jobs/{job_id}/cancel. No failed job costs anything: only result_snapshot_missing and result_snapshot_corrupt follow a charge, and that charge is refunded."},"retry_at":{"type":"string","format":"date-time","nullable":true,"description":"Null unless the job failed temporarily_unavailable because a crawl route was closed for every caller. Then it is when the route opens again, and the response carries the same time as a Retry-After header in seconds. Submit a new job after it."},"total":{"type":"integer","description":"Targets in the job. A job submitted through a /v1 route has one."},"done_count":{"type":"integer","description":"Targets the crawler finished."},"failed_count":{"type":"integer","description":"Targets that failed."},"created_at":{"type":"string","format":"date-time","description":"When the job was submitted."},"started_at":{"type":"string","format":"date-time","nullable":true,"description":"When the crawler started the job. Null until it starts."},"finished_at":{"type":"string","format":"date-time","nullable":true,"description":"When the job finished or failed. Null while it is queued or running."}}},"meta":{"type":"object","required":["cost","request_id"],"properties":{"cost":{"type":"string","example":"$0.0000"},"request_id":{"type":"string"}}}}},"example":{"data":{"batch_id":"job_7641d5f0-717d-4b70-a2f1-f58d846d7242","status":"queued","status_url":"/v1/jobs/job_7641d5f0-717d-4b70-a2f1-f58d846d7242","results_url":"/v1/jobs/job_7641d5f0-717d-4b70-a2f1-f58d846d7242/results","cost":"$0.0000","item_count":null,"error":null,"retry_at":null,"total":1,"done_count":0,"failed_count":0,"created_at":"2026-10-12T12:56:17.403Z","started_at":null,"finished_at":null},"meta":{"cost":"$0.0000","request_id":"req_job_example"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"403":{"description":"Instagram does not show this account to logged-out readers: it is private, hidden or restricted, or it no longer exists. Retrying will not change the answer until the account changes. You are not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"account_unavailable","message":"Instagram account @nike_private is private: its timeline answered the empty shell and the logged-out profile says is_private. You are not charged.","request_id":"req_5c10900e919bc7a3ff79b7501d582b4c"}}}}},"404":{"description":"`cached=cache_only` found nothing saved for these arguments (`not_cached`; call again with `cached=auto` to fetch it), or the account, post, highlight, or location does not exist (`not_found`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_cached","message":"no saved instagram/web_profile_info read for 'instagram'. cached=cache_only never fetches, so call again with cached=auto to fetch it. You are not charged.","request_id":"req_5c10900e919bc7a3ff79b7501d582b4c"}}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/instagram/related_accounts":{"get":{"tags":["Instagram"],"operationId":"igRelatedAccounts","summary":"related_accounts","x-dashboard-cost":"$0.0005","x-example-query":{"handle":"instagram"},"description":"Wraps `doc_id PolarisAYMLFollowChainingListLoggedOutQuery (owner_id)`. Returns `Account[]` under `data`; with `get_raw=true` returns the upstream JSON.\n\nUnknown, unsupported, and repeated query parameters return 400 before acquisition or billing.\n\nThe example response is the crawler's own projection of a synthetic upstream document into `Account[]`, not a live capture.","security":[{"bearerAuth":[]}],"parameters":[{"name":"handle","in":"query","required":true,"description":"Instagram account handle (a leading `@` is accepted). On the operations whose upstream call takes the numeric account id, the crawler resolves it; a handle it has never seen costs one extra anonymous profile read.","example":"instagram","schema":{"type":"string"}},{"name":"cached","in":"query","required":false,"description":"`auto` (default) serves a read saved within the last 24 hours for these exact arguments, otherwise fetches. `cache_only` never contacts Instagram (404 `not_cached` when nothing is saved, whatever its age). `live` always fetches. Anything else is a `400`. A saved read is an earlier answer of this operation for the same arguments; an account in the profile library (`/v1/instagram/profile`) is not one until this operation has read it.","schema":{"type":"string","enum":["auto","cache_only","live"],"default":"auto"},"examples":{"default":{"value":"auto","x-disabled":true}}},{"name":"get_raw","in":"query","required":false,"description":"`true` returns the upstream JSON exactly as Instagram answered it instead of the normalized `Account[]`.","schema":{"type":"boolean","default":false},"examples":{"default":{"value":false,"x-disabled":true}}}],"responses":{"200":{"description":"`Account[]` under `data`; with `get_raw=true` the upstream JSON.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"anyOf":[{"type":"array","items":{"$ref":"#/components/schemas/Account"}},{"type":"object","additionalProperties":true}],"description":"`Account[]`, or the upstream JSON when `get_raw=true`."},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":[{"id":"7719696","username":"nike","full_name":"Nike","is_verified":true,"is_private":false,"avatar_url":"https://scontent.cdninstagram.com/nike.jpg","latest_story_at":null,"extra":{}}],"meta":{"source":"live","fetched_at":"2026-09-09T03:10:22Z","cost":"$0.0005","balance":"$0.3777","request_id":"req_f1abb41157ca15c565d48a90bacef554"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"403":{"description":"Instagram does not show this account to logged-out readers: it is private, hidden or restricted, or it no longer exists. Retrying will not change the answer until the account changes. You are not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"account_unavailable","message":"Instagram account @nike_private is private: its timeline answered the empty shell and the logged-out profile says is_private. You are not charged.","request_id":"req_5c10900e919bc7a3ff79b7501d582b4c"}}}}},"404":{"description":"`cached=cache_only` found nothing saved for these arguments (`not_cached`; call again with `cached=auto` to fetch it), or the account, post, highlight, or location does not exist (`not_found`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_cached","message":"no saved instagram/web_profile_info read for 'instagram'. cached=cache_only never fetches, so call again with cached=auto to fetch it. You are not charged.","request_id":"req_5c10900e919bc7a3ff79b7501d582b4c"}}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/instagram/post":{"get":{"tags":["Instagram"],"operationId":"igPost","summary":"post","x-dashboard-cost":"$0.0005","x-example-query":{"shortcode":"DblswrEy-OK"},"description":"Wraps `GET /p/{shortcode}/`. Returns `Post` under `data`; the upstream document is an HTML page, so `get_raw` is not available.\n\nUnknown, unsupported, and repeated query parameters return 400 before acquisition or billing.\n\nThe example response is the crawler's own projection of a synthetic upstream document into `Post`, not a live capture.","security":[{"bearerAuth":[]}],"parameters":[{"name":"shortcode","in":"query","required":true,"description":"Post shortcode, the `X` in `instagram.com/p/X/`.","example":"DblswrEy-OK","schema":{"type":"string"}},{"name":"cached","in":"query","required":false,"description":"`auto` (default) serves a read saved within the last 24 hours for these exact arguments, otherwise fetches. `cache_only` never contacts Instagram (404 `not_cached` when nothing is saved, whatever its age). `live` always fetches. Anything else is a `400`. A saved read is an earlier answer of this operation for the same arguments; an account in the profile library (`/v1/instagram/profile`) is not one until this operation has read it.","schema":{"type":"string","enum":["auto","cache_only","live"],"default":"auto"},"examples":{"default":{"value":"auto","x-disabled":true}}},{"name":"get_raw","in":"query","required":false,"description":"Not available on this operation: the upstream document is an HTML page, and `true` answers 400. The default `false` returns the normalized type.","schema":{"type":"boolean","default":false},"examples":{"default":{"value":false,"x-disabled":true}}}],"responses":{"200":{"description":"`Post` under `data`.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/Post"},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"id":"3955764706547590026","shortcode":"DblswrEy-OK","taken_at":"2025-09-04T15:33:20+00:00","kind":"video","product_type":null,"caption":"a reel","hashtags":[],"mentions":[],"accessibility_caption":null,"likes":50000,"comments":420,"views":1200000,"counts_hidden":null,"comments_disabled":null,"is_pinned":null,"is_paid_partnership":null,"owner":{"id":"25025320","username":"instagram","full_name":"Instagram","is_verified":true,"is_private":false,"avatar_url":"https://scontent.cdninstagram.com/ig_150.jpg","latest_story_at":null,"extra":{}},"coauthors":[],"sponsors":[],"tagged":[{"id":"257850377","username":"gracieabrams","full_name":"Gracie Abrams","is_verified":true,"is_private":null,"avatar_url":"https://scontent.cdninstagram.com/gracieabrams_150.jpg","latest_story_at":null,"extra":{}}],"location":null,"audio":null,"thumbnail_url":"https://scontent.cdninstagram.com/reel.jpg","video_duration":null,"media":[{"kind":"video","url":"https://scontent.cdninstagram.com/reel.mp4","width":null,"height":null,"duration":null}],"media_urls":["https://scontent.cdninstagram.com/reel.mp4"],"extra":{}},"meta":{"source":"live","fetched_at":"2026-09-09T03:10:22Z","cost":"$0.0005","balance":"$0.7892","request_id":"req_1b3d1468acec3665079289a41d6de64c"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"403":{"description":"Instagram does not show this account to logged-out readers: it is private, hidden or restricted, or it no longer exists. Retrying will not change the answer until the account changes. You are not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"account_unavailable","message":"Instagram account @nike_private is private: its timeline answered the empty shell and the logged-out profile says is_private. You are not charged.","request_id":"req_5c10900e919bc7a3ff79b7501d582b4c"}}}}},"404":{"description":"`cached=cache_only` found nothing saved for these arguments (`not_cached`; call again with `cached=auto` to fetch it), or the account, post, highlight, or location does not exist (`not_found`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_cached","message":"no saved instagram/web_profile_info read for 'instagram'. cached=cache_only never fetches, so call again with cached=auto to fetch it. You are not charged.","request_id":"req_5c10900e919bc7a3ff79b7501d582b4c"}}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/instagram/highlight":{"get":{"tags":["Instagram"],"operationId":"igHighlight","summary":"highlight","x-dashboard-cost":"$0.0100","x-example-query":{"highlight_id":"18223279177302854"},"description":"Wraps `GET /stories/highlights/{id}/`. Returns `Highlight` under `data`; the upstream document is an HTML page, so `get_raw` is not available.\n\nUnknown, unsupported, and repeated query parameters return 400 before acquisition or billing.\n\nThe example response is the crawler's own projection of a synthetic upstream document into `Highlight`, not a live capture.\n\nBilling: $0.0100 per call. This read spends one of our signed-in Instagram accounts, so it costs more than a logged-out read.","security":[{"bearerAuth":[]}],"parameters":[{"name":"highlight_id","in":"query","required":true,"description":"Numeric highlight id from `highlights_tray`.","example":"18223279177302854","schema":{"type":"string"}},{"name":"cached","in":"query","required":false,"description":"`auto` (default) serves a read saved within the last 24 hours for these exact arguments, otherwise fetches. `cache_only` never contacts Instagram (404 `not_cached` when nothing is saved, whatever its age). `live` always fetches. Anything else is a `400`. A saved read is an earlier answer of this operation for the same arguments; an account in the profile library (`/v1/instagram/profile`) is not one until this operation has read it.","schema":{"type":"string","enum":["auto","cache_only","live"],"default":"auto"},"examples":{"default":{"value":"auto","x-disabled":true}}},{"name":"get_raw","in":"query","required":false,"description":"Not available on this operation: the upstream document is an HTML page, and `true` answers 400. The default `false` returns the normalized type.","schema":{"type":"boolean","default":false},"examples":{"default":{"value":false,"x-disabled":true}}}],"responses":{"200":{"description":"`Highlight` under `data`.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/Highlight"},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"id":"18612622252018257","title":"Current","cover_url":"https://scontent.cdninstagram.com/cover.jpg","items":1,"created_at":null,"owner":{"id":"25025320","username":"instagram","full_name":"Instagram","is_verified":true,"is_private":false,"avatar_url":"https://scontent.cdninstagram.com/ig_150.jpg","latest_story_at":null,"extra":{}},"stories":[{"id":"3700000000000000011","taken_at":"2025-09-04T15:33:20+00:00","kind":"video","media_url":"https://scontent.cdninstagram.com/3700000000000000011.mp4","expires_at":null,"video_duration":null,"mentions":[],"link":null}]},"meta":{"source":"live","fetched_at":"2026-09-09T03:10:22Z","cost":"$0.0005","balance":"$0.3777","request_id":"req_f1abb41157ca15c565d48a90bacef554"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"403":{"description":"Instagram does not show this account to logged-out readers: it is private, hidden or restricted, or it no longer exists. Retrying will not change the answer until the account changes. You are not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"account_unavailable","message":"Instagram account @nike_private is private: its timeline answered the empty shell and the logged-out profile says is_private. You are not charged.","request_id":"req_5c10900e919bc7a3ff79b7501d582b4c"}}}}},"404":{"description":"`cached=cache_only` found nothing saved for these arguments (`not_cached`; call again with `cached=auto` to fetch it), or the account, post, highlight, or location does not exist (`not_found`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_cached","message":"no saved instagram/web_profile_info read for 'instagram'. cached=cache_only never fetches, so call again with cached=auto to fetch it. You are not charged.","request_id":"req_5c10900e919bc7a3ff79b7501d582b4c"}}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"description":"`capacity_exhausted` means every logged-in reader this request may use is busy or waiting for a session opening; retry after the `Retry-After` delay. `billing_unavailable` means billing could not be confirmed, so no data was returned. You are not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"capacity_exhausted","message":"No logged-in reader is free for this read right now. Retry after 25 s. You are not charged.","request_id":"req_7000ca2bd5c1397eb9c085d00761758e"}}}}},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/instagram/embed":{"get":{"tags":["Instagram"],"operationId":"igEmbed","summary":"embed","x-dashboard-cost":"$0.0005","x-example-query":{"handle":"instagram"},"description":"Wraps `GET /{username}/embed/`. Returns `Profile` under `data`; the upstream document is an HTML page, so `get_raw` is not available.\n\nUnknown, unsupported, and repeated query parameters return 400 before acquisition or billing.\n\nThe example response is the crawler's own projection of a synthetic upstream document into `Profile`, not a live capture.","security":[{"bearerAuth":[]}],"parameters":[{"name":"handle","in":"query","required":true,"description":"Instagram account handle (a leading `@` is accepted). On the operations whose upstream call takes the numeric account id, the crawler resolves it; a handle it has never seen costs one extra anonymous profile read.","example":"instagram","schema":{"type":"string"}},{"name":"username","in":"query","required":false,"deprecated":true,"description":"The old name of `handle`, read as the same value with no end date. New code should send `handle`. Sending both returns 400.","schema":{"type":"string"}},{"name":"cached","in":"query","required":false,"description":"`auto` (default) serves a read saved within the last 24 hours for these exact arguments, otherwise fetches. `cache_only` never contacts Instagram (404 `not_cached` when nothing is saved, whatever its age). `live` always fetches. Anything else is a `400`. A saved read is an earlier answer of this operation for the same arguments; an account in the profile library (`/v1/instagram/profile`) is not one until this operation has read it.","schema":{"type":"string","enum":["auto","cache_only","live"],"default":"auto"},"examples":{"default":{"value":"auto","x-disabled":true}}},{"name":"get_raw","in":"query","required":false,"description":"Not available on this operation: the upstream document is an HTML page, and `true` answers 400. The default `false` returns the normalized type.","schema":{"type":"boolean","default":false},"examples":{"default":{"value":false,"x-disabled":true}}}],"responses":{"200":{"description":"`Profile` under `data`.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/Profile"},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"id":"25025320","username":"instagram","full_name":"Instagram","biography":null,"followers":686600509,"following":null,"posts":8617,"is_verified":true,"is_private":null,"avatar_url":"https://scontent.cdninstagram.com/v/t51.82787-19/instagram_s100x100.jpg","external_url":null,"links":[],"category":null,"business_category":null,"is_business":null,"is_professional":null,"business_email":null,"business_phone":null,"business_address":null,"pronouns":[],"highlight_reel_count":null,"has_clips":null,"is_recently_joined":null,"fbid":null,"extra":{}},"meta":{"source":"db","fetched_at":"2026-09-09T02:41:09Z","cost":"$0.0005","balance":"$3.3687","request_id":"req_2cd6bdee750f379b0d1525b10c74320b"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"403":{"description":"Instagram does not show this account to logged-out readers: it is private, hidden or restricted, or it no longer exists. Retrying will not change the answer until the account changes. You are not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"account_unavailable","message":"Instagram account @nike_private is private: its timeline answered the empty shell and the logged-out profile says is_private. You are not charged.","request_id":"req_5c10900e919bc7a3ff79b7501d582b4c"}}}}},"404":{"description":"`cached=cache_only` found nothing saved for these arguments (`not_cached`; call again with `cached=auto` to fetch it), or the account, post, highlight, or location does not exist (`not_found`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_cached","message":"no saved instagram/web_profile_info read for 'instagram'. cached=cache_only never fetches, so call again with cached=auto to fetch it. You are not charged.","request_id":"req_5c10900e919bc7a3ff79b7501d582b4c"}}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/instagram/location_info":{"get":{"tags":["Instagram"],"operationId":"igLocationInfo","summary":"location_info","x-dashboard-cost":"$0.0005","x-example-query":{"location_id_str":"1031760084"},"description":"Wraps `GET /explore/locations/{id}/ (preloaded PolarisExploreLocationsContainerQuery)`. Returns `Location` under `data`; the upstream document is an HTML page, so `get_raw` is not available.\n\nUnknown, unsupported, and repeated query parameters return 400 before acquisition or billing.\n\nThe example response is the crawler's own projection of a synthetic upstream document into `Location`, not a live capture.","security":[{"bearerAuth":[]}],"parameters":[{"name":"location_id_str","in":"query","required":true,"description":"Numeric Instagram location id, sent as a string.","example":"1031760084","schema":{"type":"string"}},{"name":"cached","in":"query","required":false,"description":"`auto` (default) serves a read saved within the last 24 hours for these exact arguments, otherwise fetches. `cache_only` never contacts Instagram (404 `not_cached` when nothing is saved, whatever its age). `live` always fetches. Anything else is a `400`. A saved read is an earlier answer of this operation for the same arguments; an account in the profile library (`/v1/instagram/profile`) is not one until this operation has read it.","schema":{"type":"string","enum":["auto","cache_only","live"],"default":"auto"},"examples":{"default":{"value":"auto","x-disabled":true}}},{"name":"get_raw","in":"query","required":false,"description":"Not available on this operation: the upstream document is an HTML page, and `true` answers 400. The default `false` returns the normalized type.","schema":{"type":"boolean","default":false},"examples":{"default":{"value":false,"x-disabled":true}}}],"responses":{"200":{"description":"`Location` under `data`.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/Location"},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"id":"1031760084","name":"Seoul, Korea","slug":null,"lat":37.5665,"lng":126.978,"address":null,"city":null,"phone":null,"website":null,"posts":1234567},"meta":{"source":"live","fetched_at":"2026-09-09T03:10:22Z","cost":"$0.0005","balance":"$0.7872","request_id":"req_fbf3eb8a510aa7659b6e7c7c0ad725a6"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"403":{"description":"Instagram does not show this account to logged-out readers: it is private, hidden or restricted, or it no longer exists. Retrying will not change the answer until the account changes. You are not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"account_unavailable","message":"Instagram account @nike_private is private: its timeline answered the empty shell and the logged-out profile says is_private. You are not charged.","request_id":"req_5c10900e919bc7a3ff79b7501d582b4c"}}}}},"404":{"description":"`cached=cache_only` found nothing saved for these arguments (`not_cached`; call again with `cached=auto` to fetch it), or the account, post, highlight, or location does not exist (`not_found`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_cached","message":"no saved instagram/web_profile_info read for 'instagram'. cached=cache_only never fetches, so call again with cached=auto to fetch it. You are not charged.","request_id":"req_5c10900e919bc7a3ff79b7501d582b4c"}}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/instagram/location_nearby":{"get":{"tags":["Instagram"],"operationId":"igLocationNearby","summary":"location_nearby","x-dashboard-cost":"$0.0005","x-example-query":{"location_id_str":"1031760084"},"description":"Wraps `doc_id PolarisExploreLocationsNearbyTabRootQuery (location_id_str)`. Returns `Location[]` under `data`; with `get_raw=true` returns the upstream JSON.\n\nUnknown, unsupported, and repeated query parameters return 400 before acquisition or billing.\n\nThe example response is the crawler's own projection of a synthetic upstream document into `Location[]`, not a live capture.","security":[{"bearerAuth":[]}],"parameters":[{"name":"location_id_str","in":"query","required":true,"description":"Numeric Instagram location id, sent as a string.","example":"1031760084","schema":{"type":"string"}},{"name":"cached","in":"query","required":false,"description":"`auto` (default) serves a read saved within the last 24 hours for these exact arguments, otherwise fetches. `cache_only` never contacts Instagram (404 `not_cached` when nothing is saved, whatever its age). `live` always fetches. Anything else is a `400`. A saved read is an earlier answer of this operation for the same arguments; an account in the profile library (`/v1/instagram/profile`) is not one until this operation has read it.","schema":{"type":"string","enum":["auto","cache_only","live"],"default":"auto"},"examples":{"default":{"value":"auto","x-disabled":true}}},{"name":"get_raw","in":"query","required":false,"description":"`true` returns the upstream JSON exactly as Instagram answered it instead of the normalized `Location[]`.","schema":{"type":"boolean","default":false},"examples":{"default":{"value":false,"x-disabled":true}}}],"responses":{"200":{"description":"`Location[]` under `data`; with `get_raw=true` the upstream JSON.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"anyOf":[{"type":"array","items":{"$ref":"#/components/schemas/Location"}},{"type":"object","additionalProperties":true}],"description":"`Location[]`, or the upstream JSON when `get_raw=true`."},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":[{"id":"141313492660125","name":"안산 25시광장","slug":"25","lat":37.31207902,"lng":126.8300441,"address":null,"city":null,"phone":null,"website":null,"posts":null}],"meta":{"source":"live","fetched_at":"2026-09-09T03:10:22Z","cost":"$0.0005","balance":"$0.7867","request_id":"req_0914a9a0caf03d1273925ab7b10322e2"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"403":{"description":"Instagram does not show this account to logged-out readers: it is private, hidden or restricted, or it no longer exists. Retrying will not change the answer until the account changes. You are not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"account_unavailable","message":"Instagram account @nike_private is private: its timeline answered the empty shell and the logged-out profile says is_private. You are not charged.","request_id":"req_5c10900e919bc7a3ff79b7501d582b4c"}}}}},"404":{"description":"`cached=cache_only` found nothing saved for these arguments (`not_cached`; call again with `cached=auto` to fetch it), or the account, post, highlight, or location does not exist (`not_found`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_cached","message":"no saved instagram/web_profile_info read for 'instagram'. cached=cache_only never fetches, so call again with cached=auto to fetch it. You are not charged.","request_id":"req_5c10900e919bc7a3ff79b7501d582b4c"}}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/instagram/popular_search":{"get":{"tags":["Instagram"],"operationId":"igPopularSearch","summary":"popular_search","x-dashboard-cost":"$0.0005","x-example-query":{"keyword":"holafly","media_count":"24","related_keywords_count":"100"},"description":"Wraps `doc_id PolarisLoggedOutPopularSearchPageQuery (media_count, related_keywords_count)`. Returns `Keyword` under `data`; with `get_raw=true` returns the upstream JSON.\n\nUnknown, unsupported, and repeated query parameters return 400 before acquisition or billing.\n\nThe example response is the crawler's own projection of a synthetic upstream document into `Keyword`, not a live capture.","security":[{"bearerAuth":[]}],"parameters":[{"name":"keyword","in":"query","required":true,"description":"Search keyword.","example":"holafly","schema":{"type":"string"}},{"name":"media_count","in":"query","required":false,"description":"Native list size, a positive integer. Instagram controls the returned count. Defaults to 24 when omitted; omission is forwarded unchanged.","schema":{"type":"integer","default":24,"minimum":1,"maximum":9007199254740991},"examples":{"default":{"value":24,"x-disabled":true}}},{"name":"related_keywords_count","in":"query","required":false,"description":"Native list size, a positive integer. Instagram controls the returned count. Defaults to 100 when omitted; omission is forwarded unchanged.","schema":{"type":"integer","default":100,"minimum":1,"maximum":9007199254740991},"examples":{"default":{"value":100,"x-disabled":true}}},{"name":"cached","in":"query","required":false,"description":"`auto` (default) serves a read saved within the last 24 hours for these exact arguments, otherwise fetches. `cache_only` never contacts Instagram (404 `not_cached` when nothing is saved, whatever its age). `live` always fetches. Anything else is a `400`. A saved read is an earlier answer of this operation for the same arguments; an account in the profile library (`/v1/instagram/profile`) is not one until this operation has read it.","schema":{"type":"string","enum":["auto","cache_only","live"],"default":"auto"},"examples":{"default":{"value":"auto","x-disabled":true}}},{"name":"get_raw","in":"query","required":false,"description":"`true` returns the upstream JSON exactly as Instagram answered it instead of the normalized `Keyword`.","schema":{"type":"boolean","default":false},"examples":{"default":{"value":false,"x-disabled":true}}}],"responses":{"200":{"description":"`Keyword` under `data`; with `get_raw=true` the upstream JSON.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"anyOf":[{"$ref":"#/components/schemas/Keyword"},{"type":"object","additionalProperties":true}],"description":"`Keyword`, or the upstream JSON when `get_raw=true`."},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"keyword":"holafly","description":"Holafly is an eSIM provider.","description_sources":["https://holafly.com"],"related":["esim","travel sim"],"posts":[{"id":"3700000000000000021","shortcode":"DpS1","taken_at":null,"kind":"video","product_type":null,"caption":"holafly esim","hashtags":[],"mentions":[],"accessibility_caption":null,"likes":null,"comments":null,"views":4321,"counts_hidden":null,"comments_disabled":null,"is_pinned":null,"is_paid_partnership":null,"owner":{"id":"555","username":"traveler","full_name":null,"is_verified":false,"is_private":null,"avatar_url":"https://scontent.cdninstagram.com/t.jpg","latest_story_at":null,"extra":{}},"coauthors":[],"sponsors":[],"tagged":[],"location":null,"audio":null,"thumbnail_url":"https://scontent.cdninstagram.com/p1.jpg","video_duration":null,"media":[{"kind":"video","url":"https://scontent.cdninstagram.com/p1.mp4","width":null,"height":null,"duration":null}],"media_urls":["https://scontent.cdninstagram.com/p1.mp4"],"extra":{}}]},"meta":{"source":"live","fetched_at":"2026-09-09T03:10:22Z","cost":"$0.0005","balance":"$0.3777","request_id":"req_f1abb41157ca15c565d48a90bacef554"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"403":{"description":"Instagram does not show this account to logged-out readers: it is private, hidden or restricted, or it no longer exists. Retrying will not change the answer until the account changes. You are not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"account_unavailable","message":"Instagram account @nike_private is private: its timeline answered the empty shell and the logged-out profile says is_private. You are not charged.","request_id":"req_5c10900e919bc7a3ff79b7501d582b4c"}}}}},"404":{"description":"`cached=cache_only` found nothing saved for these arguments (`not_cached`; call again with `cached=auto` to fetch it), or the account, post, highlight, or location does not exist (`not_found`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_cached","message":"no saved instagram/web_profile_info read for 'instagram'. cached=cache_only never fetches, so call again with cached=auto to fetch it. You are not charged.","request_id":"req_5c10900e919bc7a3ff79b7501d582b4c"}}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/instagram/popular_search_media":{"get":{"tags":["Instagram"],"operationId":"igPopularSearchMedia","summary":"popular_search_media","x-dashboard-cost":"$0.0005","x-example-query":{"keyword":"holafly","max_pages":"1"},"description":"Wraps `doc_id PolarisLoggedOutDesktopWWWPopularSearchPagePaginationQuery (media_count, after)`. With max_pages=1, returns `Page[Post]` under `data`; with `get_raw=true` returns the upstream JSON.\n\nThe default request creates a durable job (202). Use max_pages=1 for one synchronous Page response (200). Poll status_url, then read results_url with its opaque cursor. Acquisition stops at the first of since, max_pages, or exhaustion. Jobs continue after disconnects. Result responses are bounded to 3 MiB; this does not limit the crawl. An output unit above that byte budget fails the job before billing; results return 413. The selected raw or normalized mode never changes automatically. Supply Idempotency-Key to recover a lost submission response; reuse it with the same inputs.\n\nUnknown, unsupported, and repeated query parameters return 400 before acquisition or billing.\n\nThe example response is the crawler's own projection of a synthetic upstream document into `Page[Post]`, not a live capture.","security":[{"bearerAuth":[]}],"parameters":[{"name":"keyword","in":"query","required":true,"description":"Search keyword.","example":"holafly","schema":{"type":"string"}},{"name":"since","in":"query","required":false,"description":"Not accepted on this operation: its items carry no timestamp, so since returns 400 before billing.","schema":{"type":"string"}},{"name":"max_pages","in":"query","required":false,"example":1,"description":"Maximum pages to fetch. -1 walks until exhaustion or since with no page cap, and must be written. Omitted, since alone bounds the walk; with neither, the job stops after 10 pages. Any positive integer is accepted. 1 returns one page synchronously with HTTP 200; any other value creates a durable job with HTTP 202.","schema":{"type":"integer","anyOf":[{"enum":[-1]},{"minimum":1}]}},{"name":"cursor","in":"query","required":false,"description":"Opaque next_cursor from an earlier acquisition of this operation, also with `get_raw=true`. A native Instagram max_id or end_cursor from a raw page answers 400. Result download cursors belong to the results route.","schema":{"type":"string","minLength":1}},{"name":"page_size","in":"query","required":false,"description":"Native media_count, default 100. Instagram controls the returned count.","schema":{"type":"integer","default":100,"minimum":1,"maximum":100},"examples":{"default":{"value":100,"x-disabled":true}}},{"name":"cached","in":"query","required":false,"description":"`auto` (default) serves a read saved within the last 24 hours for these exact arguments, otherwise fetches. `cache_only` never contacts Instagram (404 `not_cached` when nothing is saved, whatever its age). `live` always fetches. Anything else is a `400`. A saved read is an earlier answer of this operation for the same arguments; an account in the profile library (`/v1/instagram/profile`) is not one until this operation has read it. `cache_only` reads one saved page per request: omit `max_pages` or pass 1, and continue with `next_cursor`.","schema":{"type":"string","enum":["auto","cache_only","live"],"default":"auto"},"examples":{"default":{"value":"auto","x-disabled":true}}},{"name":"get_raw","in":"query","required":false,"description":"`true` returns the upstream JSON exactly as Instagram answered it instead of the normalized `Page[Post]`.","schema":{"type":"boolean","default":false},"examples":{"default":{"value":false,"x-disabled":true}}},{"name":"Idempotency-Key","in":"header","required":false,"description":"Reuse this key with the same inputs to recover a lost job submission. A different input with the same key returns 409.","schema":{"type":"string","minLength":1,"maxLength":200}}],"responses":{"200":{"description":"`Page[Post]` under `data`; with `get_raw=true` the upstream JSON.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"anyOf":[{"type":"object","required":["items","pages","next_cursor","has_more","stop_reason","coverage"],"properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/Post"},"description":"`Post` of every page walked, in page order."},"pages":{"type":"array","items":{"$ref":"#/components/schemas/PageRead"},"description":"One entry per page walked."},"next_cursor":{"type":"string","nullable":true,"description":"Opaque; pass back as `cursor` to continue."},"has_more":{"type":"boolean","description":"True exactly when `next_cursor` is set."},"stop_reason":{"type":"string","enum":["pages","since","exhausted","cursor_stalled","repeated_content","deadline","blocked","caught_up"],"description":"Why the walk stopped. `pages`: the page budget is spent and `next_cursor` continues it. `deadline`: the call ran out of time before its next page; `next_cursor` continues it. `since`: a whole page was older than `since`. `exhausted`: Instagram reported the end. `cursor_stalled`: Instagram claimed more but repeated or omitted its cursor. `repeated_content`: a page held only items already seen. `blocked`: Instagram refused a later page; `next_cursor` is the page it refused. `caught_up`: the walk reached the newest post an earlier read of the feed returned; only watch passes the crawler runs for itself stop this way."},"coverage":{"$ref":"#/components/schemas/Coverage"}}},{"type":"object","required":["pages","next_cursor","has_more","stop_reason","signed_in_pages"],"description":"`get_raw=true`: every native page walked, exactly as Instagram answered it, plus the opaque `next_cursor` and `stop_reason` of the walk.","properties":{"pages":{"type":"array","items":{"type":"object","additionalProperties":true},"description":"One native page per page walked, upstream bytes unchanged."},"next_cursor":{"type":"string","nullable":true,"description":"Opaque; pass back as `cursor`."},"has_more":{"type":"boolean","description":"True exactly when `next_cursor` is set."},"stop_reason":{"type":"string","enum":["pages","since","exhausted","cursor_stalled","repeated_content","deadline","blocked","caught_up"],"description":"Why the walk stopped. `pages`: the page budget is spent and `next_cursor` continues it. `deadline`: the call ran out of time before its next page; `next_cursor` continues it. `since`: a whole page was older than `since`. `exhausted`: Instagram reported the end. `cursor_stalled`: Instagram claimed more but repeated or omitted its cursor. `repeated_content`: a page held only items already seen. `blocked`: Instagram refused a later page; `next_cursor` is the page it refused. `caught_up`: the walk reached the newest post an earlier read of the feed returned; only watch passes the crawler runs for itself stop this way."},"signed_in_pages":{"type":"integer","description":"How many of the pages one of our signed-in Instagram accounts read; each bills the signed-in page price."}}}],"description":"`Page[Post]`, or the upstream JSON when `get_raw=true`."},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"items":[{"id":"3700000000000000021","shortcode":"DpS1","taken_at":null,"kind":"video","product_type":null,"caption":"holafly esim","hashtags":[],"mentions":[],"accessibility_caption":null,"likes":null,"comments":null,"views":4321,"counts_hidden":null,"comments_disabled":null,"is_pinned":null,"is_paid_partnership":null,"owner":{"id":"555","username":"traveler","full_name":null,"is_verified":false,"is_private":null,"avatar_url":"https://scontent.cdninstagram.com/t.jpg","latest_story_at":null,"extra":{}},"coauthors":[],"sponsors":[],"tagged":[],"location":null,"audio":null,"thumbnail_url":"https://scontent.cdninstagram.com/p1.jpg","video_duration":null,"media":[{"kind":"video","url":"https://scontent.cdninstagram.com/p1.mp4","width":null,"height":null,"duration":null}],"media_urls":["https://scontent.cdninstagram.com/p1.mp4"],"extra":{}}],"pages":[{"cursor":null,"fetched_at":"2026-09-09T07:00:00+00:00","count":1,"signed_in":false}],"next_cursor":"eyJhZnRlciI6ImMyNCIsIm9wIjoicG9wdWxhcl9zZWFyY2hfbWVkaWEifQ","has_more":true,"stop_reason":"pages","coverage":{"since":null,"oldest_at":null,"since_reached":false}},"meta":{"source":"live","fetched_at":"2026-09-09T03:10:22Z","cost":"$0.0005","balance":"$3.3697","request_id":"req_f60bd4f9c3c30535aea61803642fb257"}}}}},"202":{"description":"Durable job accepted. No completed-result charge. Save batch_id; poll status_url. Retry submission with the same Idempotency-Key after a lost response. An account may have five queued, running or payment-required jobs. A sixth new job returns 429 rate_limited. Matching idempotent replays still work at the limit. Ready and failed jobs release their slots; pages within a job remain unbounded. This is a synthetic contract example, not a live capture.","x-example-provenance":"synthetic-contract","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","required":["batch_id","status","status_url","results_url","cost","item_count","error","retry_at","total","done_count","failed_count","created_at","started_at","finished_at"],"properties":{"batch_id":{"type":"string"},"status":{"type":"string","enum":["queued","running","payment_required","ready","failed"]},"status_url":{"type":"string"},"results_url":{"type":"string"},"cost":{"type":"string"},"item_count":{"type":"integer","nullable":true},"error":{"type":"string","nullable":true,"description":"Null unless failed. A failed target carries its own code; incomplete_result appears only when it has none and pages of the result are missing. profile_not_found, post_not_found, upstream_not_found or not_found: the target does not exist or is not visible. not_visible: The account exists, but its posts are not visible to logged-out readers (private, restricted, or hidden by Instagram). Retrying will not change the result until the account changes. not_cached: cached=cache_only found no saved read. incomplete_result: pages of the result are missing. temporarily_unavailable: the target could not be read for now (no capacity, a pause or repeated refusals); retry later with a new job. result_item_too_large: one result unit exceeds the delivery budget. result_snapshot_missing or result_snapshot_corrupt: the crawler could not serve the retained result of a paid job, and its charge is refunded; if the crawler serves it again, a later results read returns it and charges the job again. crawler_submit_400, crawler_submit_404 or crawler_submit_422: the crawl service refused the job request. crawler_job_failed: any other failure; the same job is not expected to succeed if resubmitted. cancelled: the job was cancelled with POST /v1/jobs/{job_id}/cancel. No failed job costs anything: only result_snapshot_missing and result_snapshot_corrupt follow a charge, and that charge is refunded."},"retry_at":{"type":"string","format":"date-time","nullable":true,"description":"Null unless the job failed temporarily_unavailable because a crawl route was closed for every caller. Then it is when the route opens again, and the response carries the same time as a Retry-After header in seconds. Submit a new job after it."},"total":{"type":"integer","description":"Targets in the job. A job submitted through a /v1 route has one."},"done_count":{"type":"integer","description":"Targets the crawler finished."},"failed_count":{"type":"integer","description":"Targets that failed."},"created_at":{"type":"string","format":"date-time","description":"When the job was submitted."},"started_at":{"type":"string","format":"date-time","nullable":true,"description":"When the crawler started the job. Null until it starts."},"finished_at":{"type":"string","format":"date-time","nullable":true,"description":"When the job finished or failed. Null while it is queued or running."}}},"meta":{"type":"object","required":["cost","request_id"],"properties":{"cost":{"type":"string","example":"$0.0000"},"request_id":{"type":"string"}}}}},"example":{"data":{"batch_id":"job_7641d5f0-717d-4b70-a2f1-f58d846d7242","status":"queued","status_url":"/v1/jobs/job_7641d5f0-717d-4b70-a2f1-f58d846d7242","results_url":"/v1/jobs/job_7641d5f0-717d-4b70-a2f1-f58d846d7242/results","cost":"$0.0000","item_count":null,"error":null,"retry_at":null,"total":1,"done_count":0,"failed_count":0,"created_at":"2026-10-12T12:56:17.403Z","started_at":null,"finished_at":null},"meta":{"cost":"$0.0000","request_id":"req_job_example"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"403":{"description":"Instagram does not show this account to logged-out readers: it is private, hidden or restricted, or it no longer exists. Retrying will not change the answer until the account changes. You are not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"account_unavailable","message":"Instagram account @nike_private is private: its timeline answered the empty shell and the logged-out profile says is_private. You are not charged.","request_id":"req_5c10900e919bc7a3ff79b7501d582b4c"}}}}},"404":{"description":"`cached=cache_only` found nothing saved for these arguments (`not_cached`; call again with `cached=auto` to fetch it), or the account, post, highlight, or location does not exist (`not_found`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_cached","message":"no saved instagram/web_profile_info read for 'instagram'. cached=cache_only never fetches, so call again with cached=auto to fetch it. You are not charged.","request_id":"req_5c10900e919bc7a3ff79b7501d582b4c"}}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/instagram/loggedout_profile":{"get":{"tags":["Instagram"],"operationId":"igLoggedoutProfile","summary":"loggedout_profile","x-dashboard-cost":"$0.0005","x-example-query":{"handle":"instagram"},"description":"Wraps `doc_id PolarisLoggedOutDesktopWWWProfileRootContentQuery`. Returns `Profile` under `data`; with `get_raw=true` returns the upstream JSON.\n\nUnknown, unsupported, and repeated query parameters return 400 before acquisition or billing.\n\nThe example response is the crawler's own projection of a synthetic upstream document into `Profile`, not a live capture.","security":[{"bearerAuth":[]}],"parameters":[{"name":"handle","in":"query","required":true,"description":"Instagram account handle (a leading `@` is accepted). On the operations whose upstream call takes the numeric account id, the crawler resolves it; a handle it has never seen costs one extra anonymous profile read.","example":"instagram","schema":{"type":"string"}},{"name":"username","in":"query","required":false,"deprecated":true,"description":"The old name of `handle`, read as the same value with no end date. New code should send `handle`. Sending both returns 400.","schema":{"type":"string"}},{"name":"cached","in":"query","required":false,"description":"`auto` (default) serves a read saved within the last 24 hours for these exact arguments, otherwise fetches. `cache_only` never contacts Instagram (404 `not_cached` when nothing is saved, whatever its age). `live` always fetches. Anything else is a `400`. A saved read is an earlier answer of this operation for the same arguments; an account in the profile library (`/v1/instagram/profile`) is not one until this operation has read it.","schema":{"type":"string","enum":["auto","cache_only","live"],"default":"auto"},"examples":{"default":{"value":"auto","x-disabled":true}}},{"name":"get_raw","in":"query","required":false,"description":"`true` returns the upstream JSON exactly as Instagram answered it instead of the normalized `Profile`.","schema":{"type":"boolean","default":false},"examples":{"default":{"value":false,"x-disabled":true}}}],"responses":{"200":{"description":"`Profile` under `data`; with `get_raw=true` the upstream JSON.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"anyOf":[{"$ref":"#/components/schemas/Profile"},{"type":"object","additionalProperties":true}],"description":"`Profile`, or the upstream JSON when `get_raw=true`."},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"id":"25025320","username":"instagram","full_name":"Instagram","biography":"Discover what's new on Instagram","followers":685818061,"following":269,"posts":null,"is_verified":true,"is_private":false,"avatar_url":"https://scontent.cdninstagram.com/ig_150.jpg","external_url":"http://help.instagram.com","links":[{"url":"http://help.instagram.com","title":null}],"category":"Community","business_category":null,"is_business":null,"is_professional":null,"business_email":null,"business_phone":null,"business_address":null,"pronouns":[],"highlight_reel_count":null,"has_clips":null,"is_recently_joined":null,"fbid":"17841400039600391","extra":{}},"meta":{"source":"db","fetched_at":"2026-09-09T02:41:09Z","cost":"$0.0005","balance":"$0.3787","request_id":"req_10144054a5d1b55ba3263e7e1c6f5b70"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"403":{"description":"Instagram does not show this account to logged-out readers: it is private, hidden or restricted, or it no longer exists. Retrying will not change the answer until the account changes. You are not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"account_unavailable","message":"Instagram account @nike_private is private: its timeline answered the empty shell and the logged-out profile says is_private. You are not charged.","request_id":"req_5c10900e919bc7a3ff79b7501d582b4c"}}}}},"404":{"description":"`cached=cache_only` found nothing saved for these arguments (`not_cached`; call again with `cached=auto` to fetch it), or the account, post, highlight, or location does not exist (`not_found`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_cached","message":"no saved instagram/web_profile_info read for 'instagram'. cached=cache_only never fetches, so call again with cached=auto to fetch it. You are not charged.","request_id":"req_5c10900e919bc7a3ff79b7501d582b4c"}}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/instagram/loggedout_timeline":{"get":{"tags":["Instagram"],"operationId":"igLoggedoutTimeline","summary":"loggedout_timeline","x-dashboard-cost":"$0.0005","x-example-query":{"handle":"instagram","max_pages":"1"},"description":"Wraps `doc_id PolarisLoggedOutDesktopWWWProfilePostsTabContentQuery (first, after)`. With max_pages=1, returns `Page[Post]` under `data`; with `get_raw=true` returns the upstream JSON.\n\nThe default request creates a durable job (202). Use max_pages=1 for one synchronous Page response (200). Poll status_url, then read results_url with its opaque cursor. Acquisition stops at the first of since, max_pages, or exhaustion. Jobs continue after disconnects. Result responses are bounded to 3 MiB; this does not limit the crawl. An output unit above that byte budget fails the job before billing; results return 413. The selected raw or normalized mode never changes automatically. Supply Idempotency-Key to recover a lost submission response; reuse it with the same inputs.\n\nUnknown, unsupported, and repeated query parameters return 400 before acquisition or billing.\n\nThe example response is the crawler's own projection of a synthetic upstream document into `Page[Post]`, not a live capture.","security":[{"bearerAuth":[]}],"parameters":[{"name":"handle","in":"query","required":true,"description":"Instagram account handle (a leading `@` is accepted). On the operations whose upstream call takes the numeric account id, the crawler resolves it; a handle it has never seen costs one extra anonymous profile read.","example":"instagram","schema":{"type":"string"}},{"name":"username","in":"query","required":false,"deprecated":true,"description":"The old name of `handle`, read as the same value with no end date. New code should send `handle`. Sending both returns 400.","schema":{"type":"string"}},{"name":"since","in":"query","required":false,"description":"Not accepted on this operation: its items carry no timestamp, so since returns 400 before billing.","schema":{"type":"string"}},{"name":"max_pages","in":"query","required":false,"example":1,"description":"Maximum pages to fetch. -1 walks until exhaustion or since with no page cap, and must be written. Omitted, since alone bounds the walk; with neither, the job stops after 10 pages. Any positive integer is accepted. 1 returns one page synchronously with HTTP 200; any other value creates a durable job with HTTP 202.","schema":{"type":"integer","anyOf":[{"enum":[-1]},{"minimum":1}]}},{"name":"cursor","in":"query","required":false,"description":"Opaque next_cursor from an earlier acquisition of this operation, also with `get_raw=true`. A native Instagram max_id or end_cursor from a raw page answers 400. Result download cursors belong to the results route.","schema":{"type":"string","minLength":1}},{"name":"page_size","in":"query","required":false,"description":"Native first, default 12. Instagram controls the returned count.","schema":{"type":"integer","default":12,"minimum":1},"examples":{"default":{"value":12,"x-disabled":true}}},{"name":"cached","in":"query","required":false,"description":"`auto` (default) serves a read saved within the last 24 hours for these exact arguments, otherwise fetches. `cache_only` never contacts Instagram (404 `not_cached` when nothing is saved, whatever its age). `live` always fetches. Anything else is a `400`. A saved read is an earlier answer of this operation for the same arguments; an account in the profile library (`/v1/instagram/profile`) is not one until this operation has read it. `cache_only` reads one saved page per request: omit `max_pages` or pass 1, and continue with `next_cursor`.","schema":{"type":"string","enum":["auto","cache_only","live"],"default":"auto"},"examples":{"default":{"value":"auto","x-disabled":true}}},{"name":"get_raw","in":"query","required":false,"description":"`true` returns the upstream JSON exactly as Instagram answered it instead of the normalized `Page[Post]`.","schema":{"type":"boolean","default":false},"examples":{"default":{"value":false,"x-disabled":true}}},{"name":"Idempotency-Key","in":"header","required":false,"description":"Reuse this key with the same inputs to recover a lost job submission. A different input with the same key returns 409.","schema":{"type":"string","minLength":1,"maxLength":200}}],"responses":{"200":{"description":"`Page[Post]` under `data`; with `get_raw=true` the upstream JSON.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"anyOf":[{"type":"object","required":["items","pages","next_cursor","has_more","stop_reason","coverage"],"properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/Post"},"description":"`Post` of every page walked, in page order."},"pages":{"type":"array","items":{"$ref":"#/components/schemas/PageRead"},"description":"One entry per page walked."},"next_cursor":{"type":"string","nullable":true,"description":"Opaque; pass back as `cursor` to continue."},"has_more":{"type":"boolean","description":"True exactly when `next_cursor` is set."},"stop_reason":{"type":"string","enum":["pages","since","exhausted","cursor_stalled","repeated_content","deadline","blocked","caught_up"],"description":"Why the walk stopped. `pages`: the page budget is spent and `next_cursor` continues it. `deadline`: the call ran out of time before its next page; `next_cursor` continues it. `since`: a whole page was older than `since`. `exhausted`: Instagram reported the end. `cursor_stalled`: Instagram claimed more but repeated or omitted its cursor. `repeated_content`: a page held only items already seen. `blocked`: Instagram refused a later page; `next_cursor` is the page it refused. `caught_up`: the walk reached the newest post an earlier read of the feed returned; only watch passes the crawler runs for itself stop this way."},"coverage":{"$ref":"#/components/schemas/Coverage"}}},{"type":"object","required":["pages","next_cursor","has_more","stop_reason","signed_in_pages"],"description":"`get_raw=true`: every native page walked, exactly as Instagram answered it, plus the opaque `next_cursor` and `stop_reason` of the walk.","properties":{"pages":{"type":"array","items":{"type":"object","additionalProperties":true},"description":"One native page per page walked, upstream bytes unchanged."},"next_cursor":{"type":"string","nullable":true,"description":"Opaque; pass back as `cursor`."},"has_more":{"type":"boolean","description":"True exactly when `next_cursor` is set."},"stop_reason":{"type":"string","enum":["pages","since","exhausted","cursor_stalled","repeated_content","deadline","blocked","caught_up"],"description":"Why the walk stopped. `pages`: the page budget is spent and `next_cursor` continues it. `deadline`: the call ran out of time before its next page; `next_cursor` continues it. `since`: a whole page was older than `since`. `exhausted`: Instagram reported the end. `cursor_stalled`: Instagram claimed more but repeated or omitted its cursor. `repeated_content`: a page held only items already seen. `blocked`: Instagram refused a later page; `next_cursor` is the page it refused. `caught_up`: the walk reached the newest post an earlier read of the feed returned; only watch passes the crawler runs for itself stop this way."},"signed_in_pages":{"type":"integer","description":"How many of the pages one of our signed-in Instagram accounts read; each bills the signed-in page price."}}}],"description":"`Page[Post]`, or the upstream JSON when `get_raw=true`."},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"items":[{"id":"3700000000000000031","shortcode":"DlT1","taken_at":null,"kind":"image","product_type":"feed","caption":"detector","hashtags":[],"mentions":[],"accessibility_caption":null,"likes":null,"comments":null,"views":null,"counts_hidden":null,"comments_disabled":null,"is_pinned":null,"is_paid_partnership":null,"owner":{"id":"25025320","username":"instagram","full_name":null,"is_verified":null,"is_private":null,"avatar_url":null,"latest_story_at":null,"extra":{}},"coauthors":[],"sponsors":[],"tagged":[],"location":null,"audio":null,"thumbnail_url":"https://scontent.cdninstagram.com/d1.jpg","video_duration":null,"media":[{"kind":"image","url":"https://scontent.cdninstagram.com/d1.jpg","width":null,"height":null,"duration":null}],"media_urls":["https://scontent.cdninstagram.com/d1.jpg"],"extra":{}}],"pages":[{"cursor":null,"fetched_at":"2026-09-09T07:00:00+00:00","count":1,"signed_in":false}],"next_cursor":"eyJhZnRlciI6IjM3MDAwMDAwMDAwMDAwMDAwMzEiLCJvcCI6ImxvZ2dlZG91dF90aW1lbGluZSJ9","has_more":true,"stop_reason":"pages","coverage":{"since":null,"oldest_at":null,"since_reached":false}},"meta":{"source":"live","fetched_at":"2026-09-09T03:10:22Z","cost":"$0.0005","balance":"$0.3777","request_id":"req_f1abb41157ca15c565d48a90bacef554"}}}}},"202":{"description":"Durable job accepted. No completed-result charge. Save batch_id; poll status_url. Retry submission with the same Idempotency-Key after a lost response. An account may have five queued, running or payment-required jobs. A sixth new job returns 429 rate_limited. Matching idempotent replays still work at the limit. Ready and failed jobs release their slots; pages within a job remain unbounded. This is a synthetic contract example, not a live capture.","x-example-provenance":"synthetic-contract","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","required":["batch_id","status","status_url","results_url","cost","item_count","error","retry_at","total","done_count","failed_count","created_at","started_at","finished_at"],"properties":{"batch_id":{"type":"string"},"status":{"type":"string","enum":["queued","running","payment_required","ready","failed"]},"status_url":{"type":"string"},"results_url":{"type":"string"},"cost":{"type":"string"},"item_count":{"type":"integer","nullable":true},"error":{"type":"string","nullable":true,"description":"Null unless failed. A failed target carries its own code; incomplete_result appears only when it has none and pages of the result are missing. profile_not_found, post_not_found, upstream_not_found or not_found: the target does not exist or is not visible. not_visible: The account exists, but its posts are not visible to logged-out readers (private, restricted, or hidden by Instagram). Retrying will not change the result until the account changes. not_cached: cached=cache_only found no saved read. incomplete_result: pages of the result are missing. temporarily_unavailable: the target could not be read for now (no capacity, a pause or repeated refusals); retry later with a new job. result_item_too_large: one result unit exceeds the delivery budget. result_snapshot_missing or result_snapshot_corrupt: the crawler could not serve the retained result of a paid job, and its charge is refunded; if the crawler serves it again, a later results read returns it and charges the job again. crawler_submit_400, crawler_submit_404 or crawler_submit_422: the crawl service refused the job request. crawler_job_failed: any other failure; the same job is not expected to succeed if resubmitted. cancelled: the job was cancelled with POST /v1/jobs/{job_id}/cancel. No failed job costs anything: only result_snapshot_missing and result_snapshot_corrupt follow a charge, and that charge is refunded."},"retry_at":{"type":"string","format":"date-time","nullable":true,"description":"Null unless the job failed temporarily_unavailable because a crawl route was closed for every caller. Then it is when the route opens again, and the response carries the same time as a Retry-After header in seconds. Submit a new job after it."},"total":{"type":"integer","description":"Targets in the job. A job submitted through a /v1 route has one."},"done_count":{"type":"integer","description":"Targets the crawler finished."},"failed_count":{"type":"integer","description":"Targets that failed."},"created_at":{"type":"string","format":"date-time","description":"When the job was submitted."},"started_at":{"type":"string","format":"date-time","nullable":true,"description":"When the crawler started the job. Null until it starts."},"finished_at":{"type":"string","format":"date-time","nullable":true,"description":"When the job finished or failed. Null while it is queued or running."}}},"meta":{"type":"object","required":["cost","request_id"],"properties":{"cost":{"type":"string","example":"$0.0000"},"request_id":{"type":"string"}}}}},"example":{"data":{"batch_id":"job_7641d5f0-717d-4b70-a2f1-f58d846d7242","status":"queued","status_url":"/v1/jobs/job_7641d5f0-717d-4b70-a2f1-f58d846d7242","results_url":"/v1/jobs/job_7641d5f0-717d-4b70-a2f1-f58d846d7242/results","cost":"$0.0000","item_count":null,"error":null,"retry_at":null,"total":1,"done_count":0,"failed_count":0,"created_at":"2026-10-12T12:56:17.403Z","started_at":null,"finished_at":null},"meta":{"cost":"$0.0000","request_id":"req_job_example"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"403":{"description":"Instagram does not show this account to logged-out readers: it is private, hidden or restricted, or it no longer exists. Retrying will not change the answer until the account changes. You are not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"account_unavailable","message":"Instagram account @nike_private is private: its timeline answered the empty shell and the logged-out profile says is_private. You are not charged.","request_id":"req_5c10900e919bc7a3ff79b7501d582b4c"}}}}},"404":{"description":"`cached=cache_only` found nothing saved for these arguments (`not_cached`; call again with `cached=auto` to fetch it), or the account, post, highlight, or location does not exist (`not_found`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_cached","message":"no saved instagram/web_profile_info read for 'instagram'. cached=cache_only never fetches, so call again with cached=auto to fetch it. You are not charged.","request_id":"req_5c10900e919bc7a3ff79b7501d582b4c"}}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/instagram/usertags_feed":{"get":{"tags":["Instagram"],"operationId":"igUsertagsFeed","summary":"usertags_feed (tagged media)","x-dashboard-cost":"$0.0100/page","x-example-query":{"handle":"nike","max_pages":"1"},"description":"Wraps `GET /api/v1/usertags/{id}/feed/?max_id&count`. With max_pages=1, returns `Page[Post]` under `data`; with `get_raw=true` returns the upstream JSON.\n\nTagged media: posts where the requested account is tagged, not posts it published.\n\nThe default request creates a durable job (202). Use max_pages=1 for one synchronous Page response (200). Poll status_url, then read results_url with its opaque cursor. Acquisition stops at the first of since, max_pages, or exhaustion. Jobs continue after disconnects. Result responses are bounded to 3 MiB; this does not limit the crawl. An output unit above that byte budget fails the job before billing; results return 413. The selected raw or normalized mode never changes automatically. Supply Idempotency-Key to recover a lost submission response; reuse it with the same inputs.\n\nUnknown, unsupported, and repeated query parameters return 400 before acquisition or billing.\n\nThe example response is the crawler's own projection of a synthetic upstream document into `Page[Post]`, not a live capture.\n\nBilling: $0.0100 per page of 21 unique returned items, rounded up to a minimum of one page. This read spends one of our signed-in Instagram accounts, so it costs more than a logged-out read. Jobs settle once after successful completion. Submission, polling and repeat downloads are free. Insufficient funds return 402 with no result data until a top-up covers the full charge.","security":[{"bearerAuth":[]}],"parameters":[{"name":"handle","in":"query","required":true,"description":"Instagram account handle (a leading `@` is accepted). On the operations whose upstream call takes the numeric account id, the crawler resolves it; a handle it has never seen costs one extra anonymous profile read.","example":"nike","schema":{"type":"string"}},{"name":"since","in":"query","required":false,"description":"Stop at this date. `2025-09-21` means midnight UTC (2025-09-21T00:00:00Z). Datetimes must use RFC3339 with a timezone, for example `2025-09-21T09:00:00+09:00`. `365d` means 365 days before submission. Invalid calendar dates return 400. With max_pages, the first boundary reached stops the walk. since alone creates a job.","schema":{"type":"string"},"examples":{"default":{"value":"2025-09-21","x-disabled":true},"date":{"value":"2025-09-21","x-disabled":true},"datetime":{"value":"2025-09-21T00:00:00Z","x-disabled":true},"duration":{"value":"365d","x-disabled":true}}},{"name":"max_pages","in":"query","required":false,"example":1,"description":"Maximum pages to fetch. -1 walks until exhaustion or since with no page cap, and must be written. Omitted, since alone bounds the walk; with neither, the job stops after 10 pages. Any positive integer is accepted. 1 returns one page synchronously with HTTP 200; any other value creates a durable job with HTTP 202.","schema":{"type":"integer","anyOf":[{"enum":[-1]},{"minimum":1}]}},{"name":"cursor","in":"query","required":false,"description":"Opaque next_cursor from an earlier acquisition of this operation, also with `get_raw=true`. A native Instagram max_id or end_cursor from a raw page answers 400. Result download cursors belong to the results route.","schema":{"type":"string","minLength":1}},{"name":"page_size","in":"query","required":false,"description":"Native count, default 21. Instagram controls the returned count. Billed per 21 unique returned items.","schema":{"type":"integer","default":21,"minimum":1},"examples":{"default":{"value":21,"x-disabled":true}}},{"name":"cached","in":"query","required":false,"description":"`auto` (default) serves a read saved within the last 24 hours for these exact arguments, otherwise fetches. `cache_only` never contacts Instagram (404 `not_cached` when nothing is saved, whatever its age). `live` always fetches. Anything else is a `400`. A saved read is an earlier answer of this operation for the same arguments; an account in the profile library (`/v1/instagram/profile`) is not one until this operation has read it. `cache_only` reads one saved page per request: omit `max_pages` or pass 1, and continue with `next_cursor`.","schema":{"type":"string","enum":["auto","cache_only","live"],"default":"auto"},"examples":{"default":{"value":"auto","x-disabled":true}}},{"name":"get_raw","in":"query","required":false,"description":"`true` returns the upstream JSON exactly as Instagram answered it instead of the normalized `Page[Post]`.","schema":{"type":"boolean","default":false},"examples":{"default":{"value":false,"x-disabled":true}}},{"name":"Idempotency-Key","in":"header","required":false,"description":"Reuse this key with the same inputs to recover a lost job submission. A different input with the same key returns 409.","schema":{"type":"string","minLength":1,"maxLength":200}}],"responses":{"200":{"description":"`Page[Post]` under `data`; with `get_raw=true` the upstream JSON.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"anyOf":[{"type":"object","required":["items","pages","next_cursor","has_more","stop_reason","coverage"],"properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/Post"},"description":"`Post` of every page walked, in page order."},"pages":{"type":"array","items":{"$ref":"#/components/schemas/PageRead"},"description":"One entry per page walked."},"next_cursor":{"type":"string","nullable":true,"description":"Opaque; pass back as `cursor` to continue."},"has_more":{"type":"boolean","description":"True exactly when `next_cursor` is set."},"stop_reason":{"type":"string","enum":["pages","since","exhausted","cursor_stalled","repeated_content","deadline","blocked","caught_up"],"description":"Why the walk stopped. `pages`: the page budget is spent and `next_cursor` continues it. `deadline`: the call ran out of time before its next page; `next_cursor` continues it. `since`: a whole page was older than `since`. `exhausted`: Instagram reported the end. `cursor_stalled`: Instagram claimed more but repeated or omitted its cursor. `repeated_content`: a page held only items already seen. `blocked`: Instagram refused a later page; `next_cursor` is the page it refused. `caught_up`: the walk reached the newest post an earlier read of the feed returned; only watch passes the crawler runs for itself stop this way."},"coverage":{"$ref":"#/components/schemas/Coverage"}}},{"type":"object","required":["pages","next_cursor","has_more","stop_reason","signed_in_pages"],"description":"`get_raw=true`: every native page walked, exactly as Instagram answered it, plus the opaque `next_cursor` and `stop_reason` of the walk.","properties":{"pages":{"type":"array","items":{"type":"object","additionalProperties":true,"required":["items"],"properties":{"items":{"type":"array","items":{"type":"object","additionalProperties":true}},"more_available":{"type":"boolean"},"next_max_id":{"type":"string","nullable":true}}},"description":"One native page per page walked, upstream bytes unchanged."},"next_cursor":{"type":"string","nullable":true,"description":"Opaque; pass back as `cursor`."},"has_more":{"type":"boolean","description":"True exactly when `next_cursor` is set."},"stop_reason":{"type":"string","enum":["pages","since","exhausted","cursor_stalled","repeated_content","deadline","blocked","caught_up"],"description":"Why the walk stopped. `pages`: the page budget is spent and `next_cursor` continues it. `deadline`: the call ran out of time before its next page; `next_cursor` continues it. `since`: a whole page was older than `since`. `exhausted`: Instagram reported the end. `cursor_stalled`: Instagram claimed more but repeated or omitted its cursor. `repeated_content`: a page held only items already seen. `blocked`: Instagram refused a later page; `next_cursor` is the page it refused. `caught_up`: the walk reached the newest post an earlier read of the feed returned; only watch passes the crawler runs for itself stop this way."},"signed_in_pages":{"type":"integer","description":"How many of the pages one of our signed-in Instagram accounts read; each bills the signed-in page price."}}}],"description":"`Page[Post]`, or the upstream JSON when `get_raw=true`."},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"items":[{"id":"3700000000000000041","shortcode":"DuT1","taken_at":"2026-09-01T10:00:00+00:00","kind":"image","product_type":null,"caption":"wearing nike","hashtags":[],"mentions":[],"accessibility_caption":null,"likes":10,"comments":2,"views":null,"counts_hidden":null,"comments_disabled":null,"is_pinned":null,"is_paid_partnership":null,"owner":{"id":"888","username":"runner","full_name":"Runner","is_verified":false,"is_private":false,"avatar_url":"https://scontent.cdninstagram.com/r.jpg","latest_story_at":null,"extra":{}},"coauthors":[],"sponsors":[],"tagged":[{"id":"7719696","username":"nike","full_name":"Nike","is_verified":null,"is_private":null,"avatar_url":null,"latest_story_at":null,"extra":{}}],"location":null,"audio":null,"thumbnail_url":"https://scontent.cdninstagram.com/u1.jpg","video_duration":null,"media":[{"kind":"image","url":"https://scontent.cdninstagram.com/u1.jpg","width":1080,"height":1080,"duration":null}],"media_urls":["https://scontent.cdninstagram.com/u1.jpg"],"extra":{}}],"pages":[{"cursor":null,"fetched_at":"2026-09-09T07:00:00+00:00","count":1,"signed_in":true}],"next_cursor":"eyJtYXhfaWQiOiIzNzAwMDAwMDAwMDAwMDAwMDQxXzg4OCIsIm9wIjoidXNlcnRhZ3NfZmVlZCJ9","has_more":true,"stop_reason":"pages","coverage":{"since":null,"oldest_at":"2026-09-01T10:00:00+00:00","since_reached":false}},"meta":{"source":"live","fetched_at":"2026-09-09T03:10:22Z","cost":"$0.0005","balance":"$0.7887","request_id":"req_1693c5a57ec93d14f6b5ad7674f42159"}}}}},"202":{"description":"Durable job accepted. No completed-result charge. Save batch_id; poll status_url. Retry submission with the same Idempotency-Key after a lost response. An account may have five queued, running or payment-required jobs. A sixth new job returns 429 rate_limited. Matching idempotent replays still work at the limit. Ready and failed jobs release their slots; pages within a job remain unbounded. This is a synthetic contract example, not a live capture.","x-example-provenance":"synthetic-contract","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","required":["batch_id","status","status_url","results_url","cost","item_count","error","retry_at","total","done_count","failed_count","created_at","started_at","finished_at"],"properties":{"batch_id":{"type":"string"},"status":{"type":"string","enum":["queued","running","payment_required","ready","failed"]},"status_url":{"type":"string"},"results_url":{"type":"string"},"cost":{"type":"string"},"item_count":{"type":"integer","nullable":true},"error":{"type":"string","nullable":true,"description":"Null unless failed. A failed target carries its own code; incomplete_result appears only when it has none and pages of the result are missing. profile_not_found, post_not_found, upstream_not_found or not_found: the target does not exist or is not visible. not_visible: The account exists, but its posts are not visible to logged-out readers (private, restricted, or hidden by Instagram). Retrying will not change the result until the account changes. not_cached: cached=cache_only found no saved read. incomplete_result: pages of the result are missing. temporarily_unavailable: the target could not be read for now (no capacity, a pause or repeated refusals); retry later with a new job. result_item_too_large: one result unit exceeds the delivery budget. result_snapshot_missing or result_snapshot_corrupt: the crawler could not serve the retained result of a paid job, and its charge is refunded; if the crawler serves it again, a later results read returns it and charges the job again. crawler_submit_400, crawler_submit_404 or crawler_submit_422: the crawl service refused the job request. crawler_job_failed: any other failure; the same job is not expected to succeed if resubmitted. cancelled: the job was cancelled with POST /v1/jobs/{job_id}/cancel. No failed job costs anything: only result_snapshot_missing and result_snapshot_corrupt follow a charge, and that charge is refunded."},"retry_at":{"type":"string","format":"date-time","nullable":true,"description":"Null unless the job failed temporarily_unavailable because a crawl route was closed for every caller. Then it is when the route opens again, and the response carries the same time as a Retry-After header in seconds. Submit a new job after it."},"total":{"type":"integer","description":"Targets in the job. A job submitted through a /v1 route has one."},"done_count":{"type":"integer","description":"Targets the crawler finished."},"failed_count":{"type":"integer","description":"Targets that failed."},"created_at":{"type":"string","format":"date-time","description":"When the job was submitted."},"started_at":{"type":"string","format":"date-time","nullable":true,"description":"When the crawler started the job. Null until it starts."},"finished_at":{"type":"string","format":"date-time","nullable":true,"description":"When the job finished or failed. Null while it is queued or running."}}},"meta":{"type":"object","required":["cost","request_id"],"properties":{"cost":{"type":"string","example":"$0.0000"},"request_id":{"type":"string"}}}}},"example":{"data":{"batch_id":"job_7641d5f0-717d-4b70-a2f1-f58d846d7242","status":"queued","status_url":"/v1/jobs/job_7641d5f0-717d-4b70-a2f1-f58d846d7242","results_url":"/v1/jobs/job_7641d5f0-717d-4b70-a2f1-f58d846d7242/results","cost":"$0.0000","item_count":null,"error":null,"retry_at":null,"total":1,"done_count":0,"failed_count":0,"created_at":"2026-10-12T12:56:17.403Z","started_at":null,"finished_at":null},"meta":{"cost":"$0.0000","request_id":"req_job_example"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"403":{"description":"Instagram does not show this account to logged-out readers: it is private, hidden or restricted, or it no longer exists. Retrying will not change the answer until the account changes. You are not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"account_unavailable","message":"Instagram account @nike_private is private: its timeline answered the empty shell and the logged-out profile says is_private. You are not charged.","request_id":"req_5c10900e919bc7a3ff79b7501d582b4c"}}}}},"404":{"description":"`cached=cache_only` found nothing saved for these arguments (`not_cached`; call again with `cached=auto` to fetch it), or the account, post, highlight, or location does not exist (`not_found`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_cached","message":"no saved instagram/web_profile_info read for 'instagram'. cached=cache_only never fetches, so call again with cached=auto to fetch it. You are not charged.","request_id":"req_5c10900e919bc7a3ff79b7501d582b4c"}}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"description":"`capacity_exhausted` means every logged-in reader this request may use is busy or waiting for a session opening; retry after the `Retry-After` delay. `billing_unavailable` means billing could not be confirmed, so no data was returned. You are not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"capacity_exhausted","message":"No logged-in reader is free for this read right now. Retry after 25 s. You are not charged.","request_id":"req_7000ca2bd5c1397eb9c085d00761758e"}}}}},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/instagram/followers":{"get":{"tags":["Instagram"],"operationId":"igFollowers","summary":"followers","x-dashboard-cost":"$0.0100/page","x-example-query":{"handle":"instagram","max_pages":"1"},"description":"Wraps `GET /api/v1/friendships/{id}/followers/?count&max_id&rank_token`. With max_pages=1, returns `Page[Account]` under `data`; with `get_raw=true` returns the upstream JSON.\n\nThe default request creates a durable job (202). Use max_pages=1 for one synchronous Page response (200). Poll status_url, then read results_url with its opaque cursor. Acquisition stops at the first of since, max_pages, or exhaustion. Jobs continue after disconnects. Result responses are bounded to 3 MiB; this does not limit the crawl. An output unit above that byte budget fails the job before billing; results return 413. The selected raw or normalized mode never changes automatically. Supply Idempotency-Key to recover a lost submission response; reuse it with the same inputs.\n\nDaily page limit: a walk stays on the one logged-in reader that served its first page, and each reader reads at most 19 following and followers pages (about 950 accounts) in any 24 hours. A page past that answers 429 `daily_page_limit` with `Retry-After` in seconds and no charge; call again after that delay with the same cursor to resume where the walk stopped. A walk with no cursor starts on a reader with pages left, so read many accounts side by side instead of one long list at a time.\n\nUnknown, unsupported, and repeated query parameters return 400 before acquisition or billing.\n\nThe example response is the crawler's own projection of a synthetic upstream document into `Page[Account]`, not a live capture.\n\nBilling: $0.0100 per page of 50 unique returned items, rounded up to a minimum of one page. This read spends one of our signed-in Instagram accounts, so it costs more than a logged-out read. Jobs settle once after successful completion. Submission, polling and repeat downloads are free. Insufficient funds return 402 with no result data until a top-up covers the full charge.","security":[{"bearerAuth":[]}],"parameters":[{"name":"handle","in":"query","required":true,"description":"Instagram account handle (a leading `@` is accepted). On the operations whose upstream call takes the numeric account id, the crawler resolves it; a handle it has never seen costs one extra anonymous profile read.","example":"instagram","schema":{"type":"string"}},{"name":"since","in":"query","required":false,"description":"Not accepted on this operation: its items carry no timestamp, so since returns 400 before billing.","schema":{"type":"string"}},{"name":"max_pages","in":"query","required":false,"example":1,"description":"Maximum pages to fetch. -1 walks until exhaustion or since with no page cap, and must be written. Omitted, since alone bounds the walk; with neither, the job stops after 10 pages. Any positive integer is accepted. 1 returns one page synchronously with HTTP 200; any other value creates a durable job with HTTP 202.","schema":{"type":"integer","anyOf":[{"enum":[-1]},{"minimum":1}]}},{"name":"cursor","in":"query","required":false,"description":"Opaque next_cursor from an earlier acquisition of this operation, also with `get_raw=true`. A native Instagram max_id or end_cursor from a raw page answers 400. Result download cursors belong to the results route.","schema":{"type":"string","minLength":1}},{"name":"page_size","in":"query","required":false,"description":"Native count, default 50. Instagram controls the returned count. Billed per 50 unique returned items.","schema":{"type":"integer","default":50,"minimum":1},"examples":{"default":{"value":50,"x-disabled":true}}},{"name":"cached","in":"query","required":false,"description":"`auto` (default) serves a read saved within the last 24 hours for these exact arguments, otherwise fetches. `cache_only` never contacts Instagram (404 `not_cached` when nothing is saved, whatever its age). `live` always fetches. Anything else is a `400`. A saved read is an earlier answer of this operation for the same arguments; an account in the profile library (`/v1/instagram/profile`) is not one until this operation has read it. `cache_only` reads one saved page per request: omit `max_pages` or pass 1, and continue with `next_cursor`.","schema":{"type":"string","enum":["auto","cache_only","live"],"default":"auto"},"examples":{"default":{"value":"auto","x-disabled":true}}},{"name":"get_raw","in":"query","required":false,"description":"`true` returns the upstream JSON exactly as Instagram answered it instead of the normalized `Page[Account]`.","schema":{"type":"boolean","default":false},"examples":{"default":{"value":false,"x-disabled":true}}},{"name":"Idempotency-Key","in":"header","required":false,"description":"Reuse this key with the same inputs to recover a lost job submission. A different input with the same key returns 409.","schema":{"type":"string","minLength":1,"maxLength":200}}],"responses":{"200":{"description":"`Page[Account]` under `data`; with `get_raw=true` the upstream JSON.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"anyOf":[{"type":"object","required":["items","pages","next_cursor","has_more","stop_reason","coverage"],"properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/Account"},"description":"`Account` of every page walked, in page order."},"pages":{"type":"array","items":{"$ref":"#/components/schemas/PageRead"},"description":"One entry per page walked."},"next_cursor":{"type":"string","nullable":true,"description":"Opaque; pass back as `cursor` to continue."},"has_more":{"type":"boolean","description":"True exactly when `next_cursor` is set."},"stop_reason":{"type":"string","enum":["pages","since","exhausted","cursor_stalled","repeated_content","deadline","blocked","caught_up"],"description":"Why the walk stopped. `pages`: the page budget is spent and `next_cursor` continues it. `deadline`: the call ran out of time before its next page; `next_cursor` continues it. `since`: a whole page was older than `since`. `exhausted`: Instagram reported the end. `cursor_stalled`: Instagram claimed more but repeated or omitted its cursor. `repeated_content`: a page held only items already seen. `blocked`: Instagram refused a later page; `next_cursor` is the page it refused. `caught_up`: the walk reached the newest post an earlier read of the feed returned; only watch passes the crawler runs for itself stop this way."},"coverage":{"$ref":"#/components/schemas/Coverage"}}},{"type":"object","required":["pages","next_cursor","has_more","stop_reason","signed_in_pages"],"description":"`get_raw=true`: every native page walked, exactly as Instagram answered it, plus the opaque `next_cursor` and `stop_reason` of the walk.","properties":{"pages":{"type":"array","items":{"type":"object","additionalProperties":true,"required":["users"],"properties":{"users":{"type":"array","items":{"type":"object","additionalProperties":true}},"next_max_id":{"type":"string","nullable":true}}},"description":"One native page per page walked, upstream bytes unchanged."},"next_cursor":{"type":"string","nullable":true,"description":"Opaque; pass back as `cursor`."},"has_more":{"type":"boolean","description":"True exactly when `next_cursor` is set."},"stop_reason":{"type":"string","enum":["pages","since","exhausted","cursor_stalled","repeated_content","deadline","blocked","caught_up"],"description":"Why the walk stopped. `pages`: the page budget is spent and `next_cursor` continues it. `deadline`: the call ran out of time before its next page; `next_cursor` continues it. `since`: a whole page was older than `since`. `exhausted`: Instagram reported the end. `cursor_stalled`: Instagram claimed more but repeated or omitted its cursor. `repeated_content`: a page held only items already seen. `blocked`: Instagram refused a later page; `next_cursor` is the page it refused. `caught_up`: the walk reached the newest post an earlier read of the feed returned; only watch passes the crawler runs for itself stop this way."},"signed_in_pages":{"type":"integer","description":"How many of the pages one of our signed-in Instagram accounts read; each bills the signed-in page price."}}}],"description":"`Page[Account]`, or the upstream JSON when `get_raw=true`."},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"items":[{"id":"999","username":"follower_one","full_name":"F One","is_verified":false,"is_private":true,"avatar_url":"https://scontent.cdninstagram.com/f1.jpg","latest_story_at":null,"extra":{}}],"pages":[{"cursor":null,"fetched_at":"2026-09-09T07:00:00+00:00","count":1,"signed_in":true}],"next_cursor":"eyJtYXhfaWQiOiJyYW5rLXBhZ2UtMiIsIm9wIjoiZm9sbG93ZXJzIiwicmFua190b2tlbiI6IjNmMGFjMzkxLTc2OTItNTgyYi04MWVhLWU1MWI2YTQ2YjcyOSJ9","has_more":true,"stop_reason":"pages","coverage":{"since":null,"oldest_at":null,"since_reached":false}},"meta":{"source":"live","fetched_at":"2026-09-09T03:10:22Z","cost":"$0.0020","balance":"$0.7847","request_id":"req_33529fda5671a3be8e3bc3adfb19b9bc"}}}}},"202":{"description":"Durable job accepted. No completed-result charge. Save batch_id; poll status_url. Retry submission with the same Idempotency-Key after a lost response. An account may have five queued, running or payment-required jobs. A sixth new job returns 429 rate_limited. Matching idempotent replays still work at the limit. Ready and failed jobs release their slots; pages within a job remain unbounded. This is a synthetic contract example, not a live capture.","x-example-provenance":"synthetic-contract","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","required":["batch_id","status","status_url","results_url","cost","item_count","error","retry_at","total","done_count","failed_count","created_at","started_at","finished_at"],"properties":{"batch_id":{"type":"string"},"status":{"type":"string","enum":["queued","running","payment_required","ready","failed"]},"status_url":{"type":"string"},"results_url":{"type":"string"},"cost":{"type":"string"},"item_count":{"type":"integer","nullable":true},"error":{"type":"string","nullable":true,"description":"Null unless failed. A failed target carries its own code; incomplete_result appears only when it has none and pages of the result are missing. profile_not_found, post_not_found, upstream_not_found or not_found: the target does not exist or is not visible. not_visible: The account exists, but its posts are not visible to logged-out readers (private, restricted, or hidden by Instagram). Retrying will not change the result until the account changes. not_cached: cached=cache_only found no saved read. incomplete_result: pages of the result are missing. temporarily_unavailable: the target could not be read for now (no capacity, a pause or repeated refusals); retry later with a new job. result_item_too_large: one result unit exceeds the delivery budget. result_snapshot_missing or result_snapshot_corrupt: the crawler could not serve the retained result of a paid job, and its charge is refunded; if the crawler serves it again, a later results read returns it and charges the job again. crawler_submit_400, crawler_submit_404 or crawler_submit_422: the crawl service refused the job request. crawler_job_failed: any other failure; the same job is not expected to succeed if resubmitted. cancelled: the job was cancelled with POST /v1/jobs/{job_id}/cancel. No failed job costs anything: only result_snapshot_missing and result_snapshot_corrupt follow a charge, and that charge is refunded."},"retry_at":{"type":"string","format":"date-time","nullable":true,"description":"Null unless the job failed temporarily_unavailable because a crawl route was closed for every caller. Then it is when the route opens again, and the response carries the same time as a Retry-After header in seconds. Submit a new job after it."},"total":{"type":"integer","description":"Targets in the job. A job submitted through a /v1 route has one."},"done_count":{"type":"integer","description":"Targets the crawler finished."},"failed_count":{"type":"integer","description":"Targets that failed."},"created_at":{"type":"string","format":"date-time","description":"When the job was submitted."},"started_at":{"type":"string","format":"date-time","nullable":true,"description":"When the crawler started the job. Null until it starts."},"finished_at":{"type":"string","format":"date-time","nullable":true,"description":"When the job finished or failed. Null while it is queued or running."}}},"meta":{"type":"object","required":["cost","request_id"],"properties":{"cost":{"type":"string","example":"$0.0000"},"request_id":{"type":"string"}}}}},"example":{"data":{"batch_id":"job_7641d5f0-717d-4b70-a2f1-f58d846d7242","status":"queued","status_url":"/v1/jobs/job_7641d5f0-717d-4b70-a2f1-f58d846d7242","results_url":"/v1/jobs/job_7641d5f0-717d-4b70-a2f1-f58d846d7242/results","cost":"$0.0000","item_count":null,"error":null,"retry_at":null,"total":1,"done_count":0,"failed_count":0,"created_at":"2026-10-12T12:56:17.403Z","started_at":null,"finished_at":null},"meta":{"cost":"$0.0000","request_id":"req_job_example"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"403":{"description":"Instagram does not show this account to logged-out readers: it is private, hidden or restricted, or it no longer exists. Retrying will not change the answer until the account changes. You are not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"account_unavailable","message":"Instagram account @nike_private is private: its timeline answered the empty shell and the logged-out profile says is_private. You are not charged.","request_id":"req_5c10900e919bc7a3ff79b7501d582b4c"}}}}},"404":{"description":"`cached=cache_only` found nothing saved for these arguments (`not_cached`; call again with `cached=auto` to fetch it), or the account, post, highlight, or location does not exist (`not_found`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_cached","message":"no saved instagram/web_profile_info read for 'instagram'. cached=cache_only never fetches, so call again with cached=auto to fetch it. You are not charged.","request_id":"req_5c10900e919bc7a3ff79b7501d582b4c"}}}}},"429":{"description":"`daily_page_limit` means the logged-in reader this cursor is pinned to has read its following and followers pages for the last 24 hours; call again with the same cursor after the `Retry-After` delay in seconds. `rate_limit_exceeded` means your organization's request limit was reached, and `rate_limited` that Instagram rate-limited this read; retry after the `Retry-After` delay. You are not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"daily_page_limit","message":"The Instagram reader this cursor is pinned to has used its daily page limit for following and followers. Retry after 3600 s with the same cursor. You are not charged.","request_id":"req_42c1f5a0d3b94e7f8a6c2b1d0e9f8a7b"}}}}},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"description":"`capacity_exhausted` means every logged-in reader this request may use is busy or waiting for a session opening; retry after the `Retry-After` delay. `billing_unavailable` means billing could not be confirmed, so no data was returned. You are not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"capacity_exhausted","message":"No logged-in reader is free for this read right now. Retry after 25 s. You are not charged.","request_id":"req_7000ca2bd5c1397eb9c085d00761758e"}}}}},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/instagram/following":{"get":{"tags":["Instagram"],"operationId":"igFollowing","summary":"following","x-dashboard-cost":"$0.0100/page","x-example-query":{"handle":"instagram","max_pages":"1"},"description":"Wraps `GET /api/v1/friendships/{id}/following/?count&max_id&rank_token`. With max_pages=1, returns `Page[Account]` under `data`; with `get_raw=true` returns the upstream JSON.\n\nThe default request creates a durable job (202). Use max_pages=1 for one synchronous Page response (200). Poll status_url, then read results_url with its opaque cursor. Acquisition stops at the first of since, max_pages, or exhaustion. Jobs continue after disconnects. Result responses are bounded to 3 MiB; this does not limit the crawl. An output unit above that byte budget fails the job before billing; results return 413. The selected raw or normalized mode never changes automatically. Supply Idempotency-Key to recover a lost submission response; reuse it with the same inputs.\n\nDaily page limit: a walk stays on the one logged-in reader that served its first page, and each reader reads at most 19 following and followers pages (about 950 accounts) in any 24 hours. A page past that answers 429 `daily_page_limit` with `Retry-After` in seconds and no charge; call again after that delay with the same cursor to resume where the walk stopped. A walk with no cursor starts on a reader with pages left, so read many accounts side by side instead of one long list at a time.\n\nUnknown, unsupported, and repeated query parameters return 400 before acquisition or billing.\n\nThe example response is the crawler's own projection of a synthetic upstream document into `Page[Account]`, not a live capture.\n\nBilling: $0.0100 per page of 50 unique returned items, rounded up to a minimum of one page. This read spends one of our signed-in Instagram accounts, so it costs more than a logged-out read. Jobs settle once after successful completion. Submission, polling and repeat downloads are free. Insufficient funds return 402 with no result data until a top-up covers the full charge.","security":[{"bearerAuth":[]}],"parameters":[{"name":"handle","in":"query","required":true,"description":"Instagram account handle (a leading `@` is accepted). On the operations whose upstream call takes the numeric account id, the crawler resolves it; a handle it has never seen costs one extra anonymous profile read.","example":"instagram","schema":{"type":"string"}},{"name":"since","in":"query","required":false,"description":"Not accepted on this operation: its items carry no timestamp, so since returns 400 before billing.","schema":{"type":"string"}},{"name":"max_pages","in":"query","required":false,"example":1,"description":"Maximum pages to fetch. -1 walks until exhaustion or since with no page cap, and must be written. Omitted, since alone bounds the walk; with neither, the job stops after 10 pages. Any positive integer is accepted. 1 returns one page synchronously with HTTP 200; any other value creates a durable job with HTTP 202.","schema":{"type":"integer","anyOf":[{"enum":[-1]},{"minimum":1}]}},{"name":"cursor","in":"query","required":false,"description":"Opaque next_cursor from an earlier acquisition of this operation, also with `get_raw=true`. A native Instagram max_id or end_cursor from a raw page answers 400. Result download cursors belong to the results route.","schema":{"type":"string","minLength":1}},{"name":"page_size","in":"query","required":false,"description":"Native count, default 50. Instagram controls the returned count. Billed per 50 unique returned items.","schema":{"type":"integer","default":50,"minimum":1},"examples":{"default":{"value":50,"x-disabled":true}}},{"name":"cached","in":"query","required":false,"description":"`auto` (default) serves a read saved within the last 24 hours for these exact arguments, otherwise fetches. `cache_only` never contacts Instagram (404 `not_cached` when nothing is saved, whatever its age). `live` always fetches. Anything else is a `400`. A saved read is an earlier answer of this operation for the same arguments; an account in the profile library (`/v1/instagram/profile`) is not one until this operation has read it. `cache_only` reads one saved page per request: omit `max_pages` or pass 1, and continue with `next_cursor`.","schema":{"type":"string","enum":["auto","cache_only","live"],"default":"auto"},"examples":{"default":{"value":"auto","x-disabled":true}}},{"name":"get_raw","in":"query","required":false,"description":"`true` returns the upstream JSON exactly as Instagram answered it instead of the normalized `Page[Account]`.","schema":{"type":"boolean","default":false},"examples":{"default":{"value":false,"x-disabled":true}}},{"name":"Idempotency-Key","in":"header","required":false,"description":"Reuse this key with the same inputs to recover a lost job submission. A different input with the same key returns 409.","schema":{"type":"string","minLength":1,"maxLength":200}}],"responses":{"200":{"description":"`Page[Account]` under `data`; with `get_raw=true` the upstream JSON.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"anyOf":[{"type":"object","required":["items","pages","next_cursor","has_more","stop_reason","coverage"],"properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/Account"},"description":"`Account` of every page walked, in page order."},"pages":{"type":"array","items":{"$ref":"#/components/schemas/PageRead"},"description":"One entry per page walked."},"next_cursor":{"type":"string","nullable":true,"description":"Opaque; pass back as `cursor` to continue."},"has_more":{"type":"boolean","description":"True exactly when `next_cursor` is set."},"stop_reason":{"type":"string","enum":["pages","since","exhausted","cursor_stalled","repeated_content","deadline","blocked","caught_up"],"description":"Why the walk stopped. `pages`: the page budget is spent and `next_cursor` continues it. `deadline`: the call ran out of time before its next page; `next_cursor` continues it. `since`: a whole page was older than `since`. `exhausted`: Instagram reported the end. `cursor_stalled`: Instagram claimed more but repeated or omitted its cursor. `repeated_content`: a page held only items already seen. `blocked`: Instagram refused a later page; `next_cursor` is the page it refused. `caught_up`: the walk reached the newest post an earlier read of the feed returned; only watch passes the crawler runs for itself stop this way."},"coverage":{"$ref":"#/components/schemas/Coverage"}}},{"type":"object","required":["pages","next_cursor","has_more","stop_reason","signed_in_pages"],"description":"`get_raw=true`: every native page walked, exactly as Instagram answered it, plus the opaque `next_cursor` and `stop_reason` of the walk.","properties":{"pages":{"type":"array","items":{"type":"object","additionalProperties":true,"required":["users"],"properties":{"users":{"type":"array","items":{"type":"object","additionalProperties":true}},"next_max_id":{"type":"string","nullable":true}}},"description":"One native page per page walked, upstream bytes unchanged."},"next_cursor":{"type":"string","nullable":true,"description":"Opaque; pass back as `cursor`."},"has_more":{"type":"boolean","description":"True exactly when `next_cursor` is set."},"stop_reason":{"type":"string","enum":["pages","since","exhausted","cursor_stalled","repeated_content","deadline","blocked","caught_up"],"description":"Why the walk stopped. `pages`: the page budget is spent and `next_cursor` continues it. `deadline`: the call ran out of time before its next page; `next_cursor` continues it. `since`: a whole page was older than `since`. `exhausted`: Instagram reported the end. `cursor_stalled`: Instagram claimed more but repeated or omitted its cursor. `repeated_content`: a page held only items already seen. `blocked`: Instagram refused a later page; `next_cursor` is the page it refused. `caught_up`: the walk reached the newest post an earlier read of the feed returned; only watch passes the crawler runs for itself stop this way."},"signed_in_pages":{"type":"integer","description":"How many of the pages one of our signed-in Instagram accounts read; each bills the signed-in page price."}}}],"description":"`Page[Account]`, or the upstream JSON when `get_raw=true`."},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"items":[{"id":"7719696","username":"nike","full_name":"Nike","is_verified":true,"is_private":false,"avatar_url":"https://scontent.cdninstagram.com/nike.jpg","latest_story_at":null,"extra":{}}],"pages":[{"cursor":null,"fetched_at":"2026-09-09T07:00:00+00:00","count":1,"signed_in":true}],"next_cursor":null,"has_more":false,"stop_reason":"exhausted","coverage":{"since":null,"oldest_at":null,"since_reached":false}},"meta":{"source":"live","fetched_at":"2026-09-09T03:10:22Z","cost":"$0.0020","balance":"$0.7827","request_id":"req_d06f94a5dd729b7f1de830597426c2a2"}}}}},"202":{"description":"Durable job accepted. No completed-result charge. Save batch_id; poll status_url. Retry submission with the same Idempotency-Key after a lost response. An account may have five queued, running or payment-required jobs. A sixth new job returns 429 rate_limited. Matching idempotent replays still work at the limit. Ready and failed jobs release their slots; pages within a job remain unbounded. This is a synthetic contract example, not a live capture.","x-example-provenance":"synthetic-contract","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","required":["batch_id","status","status_url","results_url","cost","item_count","error","retry_at","total","done_count","failed_count","created_at","started_at","finished_at"],"properties":{"batch_id":{"type":"string"},"status":{"type":"string","enum":["queued","running","payment_required","ready","failed"]},"status_url":{"type":"string"},"results_url":{"type":"string"},"cost":{"type":"string"},"item_count":{"type":"integer","nullable":true},"error":{"type":"string","nullable":true,"description":"Null unless failed. A failed target carries its own code; incomplete_result appears only when it has none and pages of the result are missing. profile_not_found, post_not_found, upstream_not_found or not_found: the target does not exist or is not visible. not_visible: The account exists, but its posts are not visible to logged-out readers (private, restricted, or hidden by Instagram). Retrying will not change the result until the account changes. not_cached: cached=cache_only found no saved read. incomplete_result: pages of the result are missing. temporarily_unavailable: the target could not be read for now (no capacity, a pause or repeated refusals); retry later with a new job. result_item_too_large: one result unit exceeds the delivery budget. result_snapshot_missing or result_snapshot_corrupt: the crawler could not serve the retained result of a paid job, and its charge is refunded; if the crawler serves it again, a later results read returns it and charges the job again. crawler_submit_400, crawler_submit_404 or crawler_submit_422: the crawl service refused the job request. crawler_job_failed: any other failure; the same job is not expected to succeed if resubmitted. cancelled: the job was cancelled with POST /v1/jobs/{job_id}/cancel. No failed job costs anything: only result_snapshot_missing and result_snapshot_corrupt follow a charge, and that charge is refunded."},"retry_at":{"type":"string","format":"date-time","nullable":true,"description":"Null unless the job failed temporarily_unavailable because a crawl route was closed for every caller. Then it is when the route opens again, and the response carries the same time as a Retry-After header in seconds. Submit a new job after it."},"total":{"type":"integer","description":"Targets in the job. A job submitted through a /v1 route has one."},"done_count":{"type":"integer","description":"Targets the crawler finished."},"failed_count":{"type":"integer","description":"Targets that failed."},"created_at":{"type":"string","format":"date-time","description":"When the job was submitted."},"started_at":{"type":"string","format":"date-time","nullable":true,"description":"When the crawler started the job. Null until it starts."},"finished_at":{"type":"string","format":"date-time","nullable":true,"description":"When the job finished or failed. Null while it is queued or running."}}},"meta":{"type":"object","required":["cost","request_id"],"properties":{"cost":{"type":"string","example":"$0.0000"},"request_id":{"type":"string"}}}}},"example":{"data":{"batch_id":"job_7641d5f0-717d-4b70-a2f1-f58d846d7242","status":"queued","status_url":"/v1/jobs/job_7641d5f0-717d-4b70-a2f1-f58d846d7242","results_url":"/v1/jobs/job_7641d5f0-717d-4b70-a2f1-f58d846d7242/results","cost":"$0.0000","item_count":null,"error":null,"retry_at":null,"total":1,"done_count":0,"failed_count":0,"created_at":"2026-10-12T12:56:17.403Z","started_at":null,"finished_at":null},"meta":{"cost":"$0.0000","request_id":"req_job_example"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"403":{"description":"Instagram does not show this account to logged-out readers: it is private, hidden or restricted, or it no longer exists. Retrying will not change the answer until the account changes. You are not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"account_unavailable","message":"Instagram account @nike_private is private: its timeline answered the empty shell and the logged-out profile says is_private. You are not charged.","request_id":"req_5c10900e919bc7a3ff79b7501d582b4c"}}}}},"404":{"description":"`cached=cache_only` found nothing saved for these arguments (`not_cached`; call again with `cached=auto` to fetch it), or the account, post, highlight, or location does not exist (`not_found`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_cached","message":"no saved instagram/web_profile_info read for 'instagram'. cached=cache_only never fetches, so call again with cached=auto to fetch it. You are not charged.","request_id":"req_5c10900e919bc7a3ff79b7501d582b4c"}}}}},"429":{"description":"`daily_page_limit` means the logged-in reader this cursor is pinned to has read its following and followers pages for the last 24 hours; call again with the same cursor after the `Retry-After` delay in seconds. `rate_limit_exceeded` means your organization's request limit was reached, and `rate_limited` that Instagram rate-limited this read; retry after the `Retry-After` delay. You are not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"daily_page_limit","message":"The Instagram reader this cursor is pinned to has used its daily page limit for following and followers. Retry after 3600 s with the same cursor. You are not charged.","request_id":"req_42c1f5a0d3b94e7f8a6c2b1d0e9f8a7b"}}}}},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"description":"`capacity_exhausted` means every logged-in reader this request may use is busy or waiting for a session opening; retry after the `Retry-After` delay. `billing_unavailable` means billing could not be confirmed, so no data was returned. You are not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"capacity_exhausted","message":"No logged-in reader is free for this read right now. Retry after 25 s. You are not charged.","request_id":"req_7000ca2bd5c1397eb9c085d00761758e"}}}}},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/instagram/story":{"get":{"tags":["Instagram"],"operationId":"igStory","summary":"story","x-dashboard-cost":"$0.0100","x-example-query":{"handle":"instagram"},"description":"Wraps `GET /api/v1/feed/user/{id}/story/`. Returns `Story[]` under `data`; with `get_raw=true` returns the upstream JSON.\n\nUnknown, unsupported, and repeated query parameters return 400 before acquisition or billing.\n\nThe example response is the crawler's own projection of a synthetic upstream document into `Story[]`, not a live capture.\n\nBilling: $0.0100 per call. This read spends one of our signed-in Instagram accounts, so it costs more than a logged-out read.","security":[{"bearerAuth":[]}],"parameters":[{"name":"handle","in":"query","required":true,"description":"Instagram account handle (a leading `@` is accepted). On the operations whose upstream call takes the numeric account id, the crawler resolves it; a handle it has never seen costs one extra anonymous profile read.","example":"instagram","schema":{"type":"string"}},{"name":"cached","in":"query","required":false,"description":"`auto` (default) serves a read saved within the last 24 hours for these exact arguments, otherwise fetches. `cache_only` never contacts Instagram (404 `not_cached` when nothing is saved, whatever its age). `live` always fetches. Anything else is a `400`. A saved read is an earlier answer of this operation for the same arguments; an account in the profile library (`/v1/instagram/profile`) is not one until this operation has read it.","schema":{"type":"string","enum":["auto","cache_only","live"],"default":"auto"},"examples":{"default":{"value":"auto","x-disabled":true}}},{"name":"get_raw","in":"query","required":false,"description":"`true` returns the upstream JSON exactly as Instagram answered it instead of the normalized `Story[]`.","schema":{"type":"boolean","default":false},"examples":{"default":{"value":false,"x-disabled":true}}}],"responses":{"200":{"description":"`Story[]` under `data`; with `get_raw=true` the upstream JSON.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"anyOf":[{"type":"array","items":{"$ref":"#/components/schemas/Story"}},{"type":"object","additionalProperties":true}],"description":"`Story[]`, or the upstream JSON when `get_raw=true`."},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":[{"id":"3700000000000000051","taken_at":"2025-09-04T15:33:20+00:00","kind":"video","media_url":"https://scontent.cdninstagram.com/s1.mp4","expires_at":"2025-09-05T15:33:20+00:00","video_duration":null,"mentions":[],"link":null}],"meta":{"source":"live","fetched_at":"2026-09-09T03:10:22Z","cost":"$0.0020","balance":"$0.3777","request_id":"req_f1abb41157ca15c565d48a90bacef554"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"403":{"description":"Instagram does not show this account to logged-out readers: it is private, hidden or restricted, or it no longer exists. Retrying will not change the answer until the account changes. You are not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"account_unavailable","message":"Instagram account @nike_private is private: its timeline answered the empty shell and the logged-out profile says is_private. You are not charged.","request_id":"req_5c10900e919bc7a3ff79b7501d582b4c"}}}}},"404":{"description":"`cached=cache_only` found nothing saved for these arguments (`not_cached`; call again with `cached=auto` to fetch it), or the account, post, highlight, or location does not exist (`not_found`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_cached","message":"no saved instagram/web_profile_info read for 'instagram'. cached=cache_only never fetches, so call again with cached=auto to fetch it. You are not charged.","request_id":"req_5c10900e919bc7a3ff79b7501d582b4c"}}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"description":"`capacity_exhausted` means every logged-in reader this request may use is busy or waiting for a session opening; retry after the `Retry-After` delay. `billing_unavailable` means billing could not be confirmed, so no data was returned. You are not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"capacity_exhausted","message":"No logged-in reader is free for this read right now. Retry after 25 s. You are not charged.","request_id":"req_7000ca2bd5c1397eb9c085d00761758e"}}}}},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/instagram/likers":{"get":{"tags":["Instagram"],"operationId":"igLikers","summary":"likers","x-dashboard-cost":"$0.0100","x-example-query":{"media_id":"3955764706547590026"},"description":"Wraps `GET /api/v1/media/{id}/likers/`. Returns `Account[]` under `data`; with `get_raw=true` returns the upstream JSON.\n\nUnknown, unsupported, and repeated query parameters return 400 before acquisition or billing.\n\nThe example response is the crawler's own projection of a synthetic upstream document into `Account[]`, not a live capture.\n\nBilling: $0.0100 per call. This read spends one of our signed-in Instagram accounts, so it costs more than a logged-out read.","security":[{"bearerAuth":[]}],"parameters":[{"name":"media_id","in":"query","required":true,"description":"Numeric media id (the post pk). A post shortcode is accepted and converted.","example":"3955764706547590026","schema":{"type":"string"}},{"name":"cached","in":"query","required":false,"description":"`auto` (default) serves a read saved within the last 24 hours for these exact arguments, otherwise fetches. `cache_only` never contacts Instagram (404 `not_cached` when nothing is saved, whatever its age). `live` always fetches. Anything else is a `400`. A saved read is an earlier answer of this operation for the same arguments; an account in the profile library (`/v1/instagram/profile`) is not one until this operation has read it.","schema":{"type":"string","enum":["auto","cache_only","live"],"default":"auto"},"examples":{"default":{"value":"auto","x-disabled":true}}},{"name":"get_raw","in":"query","required":false,"description":"`true` returns the upstream JSON exactly as Instagram answered it instead of the normalized `Account[]`.","schema":{"type":"boolean","default":false},"examples":{"default":{"value":false,"x-disabled":true}}}],"responses":{"200":{"description":"`Account[]` under `data`; with `get_raw=true` the upstream JSON.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"anyOf":[{"type":"array","items":{"$ref":"#/components/schemas/Account"}},{"type":"object","additionalProperties":true}],"description":"`Account[]`, or the upstream JSON when `get_raw=true`."},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":[{"id":"777","username":"liker_one","full_name":"L One","is_verified":false,"is_private":false,"avatar_url":"https://scontent.cdninstagram.com/l1.jpg","latest_story_at":null,"extra":{}}],"meta":{"source":"live","fetched_at":"2026-09-09T03:10:22Z","cost":"$0.0020","balance":"$0.3777","request_id":"req_f1abb41157ca15c565d48a90bacef554"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"403":{"description":"Instagram does not show this account to logged-out readers: it is private, hidden or restricted, or it no longer exists. Retrying will not change the answer until the account changes. You are not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"account_unavailable","message":"Instagram account @nike_private is private: its timeline answered the empty shell and the logged-out profile says is_private. You are not charged.","request_id":"req_5c10900e919bc7a3ff79b7501d582b4c"}}}}},"404":{"description":"`cached=cache_only` found nothing saved for these arguments (`not_cached`; call again with `cached=auto` to fetch it), or the account, post, highlight, or location does not exist (`not_found`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_cached","message":"no saved instagram/web_profile_info read for 'instagram'. cached=cache_only never fetches, so call again with cached=auto to fetch it. You are not charged.","request_id":"req_5c10900e919bc7a3ff79b7501d582b4c"}}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"description":"`capacity_exhausted` means every logged-in reader this request may use is busy or waiting for a session opening; retry after the `Retry-After` delay. `billing_unavailable` means billing could not be confirmed, so no data was returned. You are not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"capacity_exhausted","message":"No logged-in reader is free for this read right now. Retry after 25 s. You are not charged.","request_id":"req_7000ca2bd5c1397eb9c085d00761758e"}}}}},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/instagram/about":{"get":{"tags":["Instagram"],"operationId":"igAbout","summary":"about","x-dashboard-cost":"$0.0100","x-example-query":{"handle":"instagram"},"description":"Wraps `POST bloks about_this_account`. Returns `About` under `data`; with `get_raw=true` returns the upstream JSON.\n\nUnknown, unsupported, and repeated query parameters return 400 before acquisition or billing.\n\nThe example response is the crawler's own projection of a synthetic upstream document into `About`, not a live capture.\n\nBilling: $0.0100 per call. This read spends one of our signed-in Instagram accounts, so it costs more than a logged-out read.","security":[{"bearerAuth":[]}],"parameters":[{"name":"handle","in":"query","required":true,"description":"Instagram account handle (a leading `@` is accepted). On the operations whose upstream call takes the numeric account id, the crawler resolves it; a handle it has never seen costs one extra anonymous profile read.","example":"instagram","schema":{"type":"string"}},{"name":"cached","in":"query","required":false,"description":"`auto` (default) serves a read saved within the last 24 hours for these exact arguments, otherwise fetches. `cache_only` never contacts Instagram (404 `not_cached` when nothing is saved, whatever its age). `live` always fetches. Anything else is a `400`. A saved read is an earlier answer of this operation for the same arguments; an account in the profile library (`/v1/instagram/profile`) is not one until this operation has read it.","schema":{"type":"string","enum":["auto","cache_only","live"],"default":"auto"},"examples":{"default":{"value":"auto","x-disabled":true}}},{"name":"get_raw","in":"query","required":false,"description":"`true` returns the upstream JSON exactly as Instagram answered it instead of the normalized `About`.","schema":{"type":"boolean","default":false},"examples":{"default":{"value":false,"x-disabled":true}}}],"responses":{"200":{"description":"`About` under `data`; with `get_raw=true` the upstream JSON.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"anyOf":[{"$ref":"#/components/schemas/About"},{"type":"object","additionalProperties":true}],"description":"`About`, or the upstream JSON when `get_raw=true`."},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"date_joined":"February 2012","country":"United States","former_usernames":[],"former_username_count":0,"runs_ads":null},"meta":{"source":"live","fetched_at":"2026-09-09T03:10:22Z","cost":"$0.0020","balance":"$0.3777","request_id":"req_f1abb41157ca15c565d48a90bacef554"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"403":{"description":"Instagram does not show this account to logged-out readers: it is private, hidden or restricted, or it no longer exists. Retrying will not change the answer until the account changes. You are not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"account_unavailable","message":"Instagram account @nike_private is private: its timeline answered the empty shell and the logged-out profile says is_private. You are not charged.","request_id":"req_5c10900e919bc7a3ff79b7501d582b4c"}}}}},"404":{"description":"`cached=cache_only` found nothing saved for these arguments (`not_cached`; call again with `cached=auto` to fetch it), or the account, post, highlight, or location does not exist (`not_found`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_cached","message":"no saved instagram/web_profile_info read for 'instagram'. cached=cache_only never fetches, so call again with cached=auto to fetch it. You are not charged.","request_id":"req_5c10900e919bc7a3ff79b7501d582b4c"}}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"description":"`capacity_exhausted` means every logged-in reader this request may use is busy or waiting for a session opening; retry after the `Retry-After` delay. `billing_unavailable` means billing could not be confirmed, so no data was returned. You are not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"capacity_exhausted","message":"No logged-in reader is free for this read right now. Retry after 25 s. You are not charged.","request_id":"req_7000ca2bd5c1397eb9c085d00761758e"}}}}},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/jobs/{job_id}":{"get":{"tags":["Crawl jobs"],"operationId":"crawlJobStatus","summary":"Crawl job status","security":[{"bearerAuth":[]}],"description":"Owner-checked job status. Submission and polls cost zero. Crawler execution continues after disconnects. Successful completion charges once before results become available. Failed jobs never charge. A completed job waiting for funds returns 402; after top-up, settlement retries within 60 seconds.","parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string"},"example":"job_7641d5f0-717d-4b70-a2f1-f58d846d7242"}],"responses":{"200":{"description":"Current job state. cost is the total job charge, while meta.cost is zero for this poll. This is a synthetic contract example, not a live capture.","x-example-provenance":"synthetic-contract","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","required":["batch_id","status","status_url","results_url","cost","item_count","error","retry_at","total","done_count","failed_count","created_at","started_at","finished_at"],"properties":{"batch_id":{"type":"string"},"status":{"type":"string","enum":["queued","running","payment_required","ready","failed"]},"status_url":{"type":"string"},"results_url":{"type":"string"},"cost":{"type":"string"},"item_count":{"type":"integer","nullable":true},"error":{"type":"string","nullable":true,"description":"Null unless failed. A failed target carries its own code; incomplete_result appears only when it has none and pages of the result are missing. profile_not_found, post_not_found, upstream_not_found or not_found: the target does not exist or is not visible. not_visible: The account exists, but its posts are not visible to logged-out readers (private, restricted, or hidden by Instagram). Retrying will not change the result until the account changes. not_cached: cached=cache_only found no saved read. incomplete_result: pages of the result are missing. temporarily_unavailable: the target could not be read for now (no capacity, a pause or repeated refusals); retry later with a new job. result_item_too_large: one result unit exceeds the delivery budget. result_snapshot_missing or result_snapshot_corrupt: the crawler could not serve the retained result of a paid job, and its charge is refunded; if the crawler serves it again, a later results read returns it and charges the job again. crawler_submit_400, crawler_submit_404 or crawler_submit_422: the crawl service refused the job request. crawler_job_failed: any other failure; the same job is not expected to succeed if resubmitted. cancelled: the job was cancelled with POST /v1/jobs/{job_id}/cancel. No failed job costs anything: only result_snapshot_missing and result_snapshot_corrupt follow a charge, and that charge is refunded."},"retry_at":{"type":"string","format":"date-time","nullable":true,"description":"Null unless the job failed temporarily_unavailable because a crawl route was closed for every caller. Then it is when the route opens again, and the response carries the same time as a Retry-After header in seconds. Submit a new job after it."},"total":{"type":"integer","description":"Targets in the job. A job submitted through a /v1 route has one."},"done_count":{"type":"integer","description":"Targets the crawler finished."},"failed_count":{"type":"integer","description":"Targets that failed."},"created_at":{"type":"string","format":"date-time","description":"When the job was submitted."},"started_at":{"type":"string","format":"date-time","nullable":true,"description":"When the crawler started the job. Null until it starts."},"finished_at":{"type":"string","format":"date-time","nullable":true,"description":"When the job finished or failed. Null while it is queued or running."}}},"meta":{"type":"object","required":["cost","request_id"],"properties":{"cost":{"type":"string","example":"$0.0000"},"request_id":{"type":"string"}}}}},"example":{"data":{"batch_id":"job_7641d5f0-717d-4b70-a2f1-f58d846d7242","status":"ready","status_url":"/v1/jobs/job_7641d5f0-717d-4b70-a2f1-f58d846d7242","results_url":"/v1/jobs/job_7641d5f0-717d-4b70-a2f1-f58d846d7242/results","cost":"$0.0005","item_count":0,"error":null,"retry_at":null,"total":1,"done_count":1,"failed_count":0,"created_at":"2026-10-12T12:56:17.403Z","started_at":"2026-10-12T12:57:46.766Z","finished_at":"2026-10-12T12:57:56.936Z"},"meta":{"cost":"$0.0000","request_id":"req_job_example"}}}},"headers":{"Retry-After":{"description":"Seconds until the closed crawl route opens again, the same time as retry_at. Sent only when retry_at is set.","schema":{"type":"integer","minimum":0}}}},"400":{"description":"Invalid cursor or query parameters."},"401":{"description":"Invalid or revoked API key."},"402":{"description":"The full job charge exceeds the balance. Top up at https://api.virev.ai/settings/billing, then poll again. No result data is returned before settlement."},"404":{"description":"Job does not exist or belongs to another account."},"503":{"description":"Job service unavailable. Retry without a second charge."}}}},"/v1/jobs/{job_id}/results":{"get":{"tags":["Crawl jobs"],"operationId":"crawlJobResults","summary":"Crawl job results","security":[{"bearerAuth":[]}],"description":"Read paid results in responses bounded to 3 MiB. Send next_cursor to this route until complete is true. Download cursors differ from acquisition cursors. Each response may contain part of a target. Retries and repeated downloads never charge again. Before billing, the crawler confirms that each output unit fits 3 MiB in the selected raw or normalized mode. An oversized unit fails the job with result_item_too_large; results return 413 without a charge. Modes never switch automatically. If the crawler confirms that a retained snapshot is missing or corrupt after billing, the usage charge is reversed once and the job becomes failed. A later results read that finds the result again restores the job to ready and charges it again at the same price, or answers 402 when the balance cannot pay. Temporary store/network errors, invalid cursors and pending result preparation do not reverse charges. A failed reversal returns 503 billing_unavailable; retry the same result request. Results stay on the crawler and no unbounded aggregate crosses the portal.","parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string"},"example":"job_7641d5f0-717d-4b70-a2f1-f58d846d7242"},{"name":"cursor","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"One bounded result delivery page. This is a synthetic contract example, not a live capture.","x-example-provenance":"synthetic-contract","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","required":["batch_id","results","next_cursor","complete"],"properties":{"batch_id":{"type":"string"},"next_cursor":{"type":"string","nullable":true},"complete":{"type":"boolean"},"results":{"type":"array","items":{"type":"object","required":["index","operation","args","status"],"properties":{"index":{"type":"integer"},"operation":{"type":"string"},"args":{"type":"object","additionalProperties":true},"status":{"type":"string","enum":["done"]},"items":{"type":"array","description":"Normalized unique items, present unless get_raw was true at submission.","items":{"type":"object","additionalProperties":true}},"pages":{"type":"array","description":"Native pages, present when get_raw was true at submission.","items":{}}}}}}},"meta":{"type":"object","required":["cost","request_id"],"properties":{"cost":{"type":"string","example":"$0.0000"},"request_id":{"type":"string"}}}}},"example":{"data":{"batch_id":"job_7641d5f0-717d-4b70-a2f1-f58d846d7242","results":[{"index":0,"operation":"user_feed","args":{"handle":"nike"},"status":"done","items":[]}],"next_cursor":null,"complete":true},"meta":{"cost":"$0.0000","request_id":"req_job_example"}}}}},"202":{"description":"Durable job accepted. No completed-result charge. Save batch_id; poll status_url. Retry submission with the same Idempotency-Key after a lost response. An account may have five queued, running or payment-required jobs. A sixth new job returns 429 rate_limited. Matching idempotent replays still work at the limit. Ready and failed jobs release their slots; pages within a job remain unbounded. This is a synthetic contract example, not a live capture.","x-example-provenance":"synthetic-contract","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","required":["batch_id","status","status_url","results_url","cost","item_count","error","retry_at","total","done_count","failed_count","created_at","started_at","finished_at"],"properties":{"batch_id":{"type":"string"},"status":{"type":"string","enum":["queued","running","payment_required","ready","failed"]},"status_url":{"type":"string"},"results_url":{"type":"string"},"cost":{"type":"string"},"item_count":{"type":"integer","nullable":true},"error":{"type":"string","nullable":true,"description":"Null unless failed. A failed target carries its own code; incomplete_result appears only when it has none and pages of the result are missing. profile_not_found, post_not_found, upstream_not_found or not_found: the target does not exist or is not visible. not_visible: The account exists, but its posts are not visible to logged-out readers (private, restricted, or hidden by Instagram). Retrying will not change the result until the account changes. not_cached: cached=cache_only found no saved read. incomplete_result: pages of the result are missing. temporarily_unavailable: the target could not be read for now (no capacity, a pause or repeated refusals); retry later with a new job. result_item_too_large: one result unit exceeds the delivery budget. result_snapshot_missing or result_snapshot_corrupt: the crawler could not serve the retained result of a paid job, and its charge is refunded; if the crawler serves it again, a later results read returns it and charges the job again. crawler_submit_400, crawler_submit_404 or crawler_submit_422: the crawl service refused the job request. crawler_job_failed: any other failure; the same job is not expected to succeed if resubmitted. cancelled: the job was cancelled with POST /v1/jobs/{job_id}/cancel. No failed job costs anything: only result_snapshot_missing and result_snapshot_corrupt follow a charge, and that charge is refunded."},"retry_at":{"type":"string","format":"date-time","nullable":true,"description":"Null unless the job failed temporarily_unavailable because a crawl route was closed for every caller. Then it is when the route opens again, and the response carries the same time as a Retry-After header in seconds. Submit a new job after it."},"total":{"type":"integer","description":"Targets in the job. A job submitted through a /v1 route has one."},"done_count":{"type":"integer","description":"Targets the crawler finished."},"failed_count":{"type":"integer","description":"Targets that failed."},"created_at":{"type":"string","format":"date-time","description":"When the job was submitted."},"started_at":{"type":"string","format":"date-time","nullable":true,"description":"When the crawler started the job. Null until it starts."},"finished_at":{"type":"string","format":"date-time","nullable":true,"description":"When the job finished or failed. Null while it is queued or running."}}},"meta":{"type":"object","required":["cost","request_id"],"properties":{"cost":{"type":"string","example":"$0.0000"},"request_id":{"type":"string"}}}}},"example":{"data":{"batch_id":"job_7641d5f0-717d-4b70-a2f1-f58d846d7242","status":"queued","status_url":"/v1/jobs/job_7641d5f0-717d-4b70-a2f1-f58d846d7242","results_url":"/v1/jobs/job_7641d5f0-717d-4b70-a2f1-f58d846d7242/results","cost":"$0.0000","item_count":null,"error":null,"retry_at":null,"total":1,"done_count":0,"failed_count":0,"created_at":"2026-10-12T12:56:17.403Z","started_at":null,"finished_at":null},"meta":{"cost":"$0.0000","request_id":"req_job_example"}}}}},"400":{"description":"Invalid cursor or query parameters."},"401":{"description":"Invalid or revoked API key."},"402":{"description":"The full job charge exceeds the balance. Top up at https://api.virev.ai/settings/billing, then poll again. No result data is returned before settlement."},"404":{"description":"Job does not exist or belongs to another account."},"409":{"description":"result_snapshot_missing or result_snapshot_corrupt: retained-data loss triggers one reversal of the paid charge, and a later read that finds the result again charges it again. result_preparation_required: retry later; this temporary condition does not reverse charges. job_cancelled: the job was cancelled with POST /v1/jobs/{job_id}/cancel, so it has no results and costs nothing."},"413":{"description":"A result unit exceeds the byte budget for the selected mode. The job failed before billing."},"502":{"description":"The crawler job failed. No charge was made."},"503":{"description":"temporarily_unavailable: the job failed because a crawl route was closed for every caller. Retry-After gives the seconds until it opens again; submit a new job then. No charge was made. Without Retry-After, 503 means the job service was unavailable; retry without a second charge.","headers":{"Retry-After":{"description":"Seconds until the closed crawl route opens again, the same time as retry_at. Sent only when retry_at is set.","schema":{"type":"integer","minimum":0}}}}}}},"/v1/jobs/{job_id}/cancel":{"post":{"tags":["Crawl jobs"],"operationId":"crawlJobCancel","summary":"Cancel a crawl job","x-dashboard-cost":"free","security":[{"bearerAuth":[]}],"description":"Stops a queued, running or payment-required job and marks it failed with error `cancelled`. A cancelled job is never charged, and its partial results are not delivered. Repeating the call returns the same answer. A job that already finished answers 409 `job_finished`.","parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string"},"example":"job_7641d5f0-717d-4b70-a2f1-f58d846d7242"}],"responses":{"200":{"description":"The cancelled job. This is a synthetic contract example, not a live capture.","x-example-provenance":"synthetic-contract","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","description":"The job object that GET /v1/jobs/{job_id} returns, after the cancel.","additionalProperties":true,"required":["batch_id","status","status_url","results_url","cost","item_count","error"],"properties":{"batch_id":{"type":"string"},"status":{"type":"string","enum":["failed"]},"status_url":{"type":"string"},"results_url":{"type":"string"},"cost":{"type":"string"},"item_count":{"type":"integer","nullable":true},"error":{"type":"string","enum":["cancelled"]}}},"meta":{"type":"object","required":["cost","request_id"],"properties":{"cost":{"type":"string","example":"$0.0000"},"request_id":{"type":"string"}}}}},"example":{"data":{"batch_id":"job_7641d5f0-717d-4b70-a2f1-f58d846d7242","status":"failed","status_url":"/v1/jobs/job_7641d5f0-717d-4b70-a2f1-f58d846d7242","results_url":"/v1/jobs/job_7641d5f0-717d-4b70-a2f1-f58d846d7242/results","cost":"$0.0000","item_count":null,"error":"cancelled"},"meta":{"cost":"$0.0000","request_id":"req_job_example"}}}}},"401":{"description":"Invalid or revoked API key."},"404":{"description":"Job does not exist or belongs to another account."},"409":{"description":"`job_finished`: the job was already ready or failed."},"503":{"description":"Job service unavailable. Retry the cancel; it is safe to repeat."}}}},"/v1/jobs/platforms":{"get":{"tags":["Crawl jobs"],"operationId":"crawlPlatforms","summary":"Supported platforms","x-dashboard-cost":"free","description":"The networks we store, each with how profiles are acquired (`autonomous` or `authorized_required`), its discovery modes, its content family, and what it supports: authoritative profiles, recent and deep content, comments, archive and media. Free.","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"The platform list.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":true},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"platforms":[{"slug":"instagram","profile_acquisition":"autonomous","discovery":["related"],"content_family":"post","capabilities":{"authoritative_profile":true,"recent_content":true,"deep_content":true,"comments":false,"archive":true,"media":true}},{"slug":"tiktok","profile_acquisition":"autonomous","discovery":["related"],"content_family":"video","capabilities":{"authoritative_profile":true,"recent_content":true,"deep_content":true,"comments":false,"archive":true,"media":true}},{"slug":"youtube","profile_acquisition":"autonomous","discovery":["related"],"content_family":"video","capabilities":{"authoritative_profile":true,"recent_content":true,"deep_content":true,"comments":false,"archive":true,"media":true}},{"slug":"linkedin","profile_acquisition":"autonomous","discovery":["related"],"content_family":"post","capabilities":{"authoritative_profile":true,"recent_content":true,"deep_content":false,"comments":false,"archive":true,"media":true}},{"slug":"facebook","profile_acquisition":"autonomous","discovery":["related"],"content_family":"post","capabilities":{"authoritative_profile":true,"recent_content":true,"deep_content":false,"comments":true,"archive":true,"media":true}},{"slug":"xiaohongshu","profile_acquisition":"authorized_required","discovery":["explore"],"content_family":"post","capabilities":{"authoritative_profile":false,"recent_content":false,"deep_content":false,"comments":false,"archive":true,"media":true}},{"slug":"douyin","profile_acquisition":"autonomous","discovery":["manifest"],"content_family":"video","capabilities":{"authoritative_profile":true,"recent_content":true,"deep_content":false,"comments":false,"archive":true,"media":true}}]},"meta":{"cost":"$0.0000","balance":"$9.9995","request_id":"req_8b0d9a22c9ca14afd2427eded7859b92"}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"502":{"$ref":"#/components/responses/UpstreamError"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/intelligence/profile/visual-enrich":{"post":{"tags":["Intelligence"],"operationId":"intelVisualEnrich","summary":"Profile visual enrichment","x-dashboard-cost":"$0.05","description":"Renders an Instagram account’s stored profile header and recent post grid as one JPEG and classifies it with a vision model: entity type, account role, niche and sub-niches, country, language, commercial intent, brand safety, and a visual read of the grid (format mix, aesthetic, palette, content pillars). The answer also carries the JPEG the model saw in `data.image_base64` and the token counts. The result is returned, not stored. An account we do not store is a `404` and is not billed. The example image is truncated.","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["username"],"properties":{"username":{"type":"string","maxLength":200},"limit":{"type":"integer","minimum":0,"default":12,"description":"Grid tiles to draw."},"header":{"type":"boolean","default":true},"tile_meta":{"type":"boolean","default":true},"captions":{"type":"boolean","default":false,"description":"Draw captions into the image."},"captions_text":{"type":"boolean","default":true,"description":"Send captions to the model as text."},"attach_image":{"type":"boolean","default":true,"description":"Send the image to the model."}}},"example":{"username":"natgeo","limit":4}}}},"responses":{"200":{"description":"The classification and the image it read.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":true},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"username":"natgeo","missing_cdn":0,"result":{"entity_type":"media","account_role":"media","primary_niche":"outdoors","sub_niches":["wildlife","nature documentary","conservation","science education","cultural exploration"],"gender":"unknown","age_range":null,"country":"United States","primary_language":"English","tagline":"Step into wonder and find your inner explorer with National Geographic.","bio_summary":"National Geographic’s official media account, sharing exploration, wildlife, nature, science, culture, and conservation stories.","content_summary":"Professional documentary photography and video focused on wildlife behavior, endangered species, conservation projects, natural phenomena, global traditions, health science, and promotion of National Geographic programming.","commercial_intent":"fully_commercial","brand_safety":"safe","visual":{"content_format_mix":"mixed","visual_aesthetic":["nature-documentary","cinematic","editorial","high-detail","earthy"],"face_presence":"mixed","production_quality":"professional","grid_consistency_score":8,"grid_consistency_note":"The grid is unified by polished documentary imagery and close, story-driven framing, while subjects and colors vary across wildlife and culture.","dominant_palette":["#151816","#785E44","#6E7A69","#9DC7D5","#D28EB1"],"content_pillars":["wildlife encounters","animal conservation","cultural traditions","marine nature","field reporting"],"brand_collab_evidence":false,"visual_hook_style":"Dramatic animal close-ups, action moments, vivid cultural imagery, and human-animal interaction, with occasional short headline overlays.","thumbnail_text_usage":"some"}},"input_tokens":3602,"output_tokens":701,"duration_ms":23200,"image_base64":"/9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAAMCAgMCAgMDAwMEAwMEBQgFBQQEBQoHBwYIDAoMDAsKCwsNDhIQDQ4RDgsLEBYQERMUFRUV..."},"meta":{"cost":"$0.0500","balance":"$9.9995","request_id":"req_4cf60b0b3436e5075ca6078201c8f6c0"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"404":{"description":"The account is not in the tracked corpus.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/creators/profiles/refresh":{"post":{"tags":["Creator Search"],"operationId":"creatorsRefresh","summary":"Refresh a profile","x-dashboard-cost":"$0.0005","description":"Queues a fresh crawl of one stored profile. `requested: true` means this call queued it and bills $0.0005. `requested: false` is free: a crawl was already queued (`state: pending`), or the account is known not to exist (`state: unavailable`). Poll `/v1/creators/profiles/refresh-status` until `refresh_pending` is false, then read the fresh copy with `/v1/creators/profile`.","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["username"],"properties":{"platform":{"type":"string","enum":["instagram","tiktok","youtube"],"default":"instagram"},"username":{"type":"string","minLength":1,"maxLength":200}}},"example":{"platform":"instagram","username":"nasa"}}}},"responses":{"200":{"description":"Whether a crawl was queued.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":true},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"platform":"instagram","username":"nasa","state":"pending","requested":true,"via":"direct"},"meta":{"cost":"$0.0005","balance":"$9.9995","request_id":"req_2eae4fd7f814aa3ca6c5fb17d79b2239"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/douyin/stored/profile":{"get":{"tags":["Douyin"],"operationId":"douyinStoredProfile","summary":"Douyin stored profile","x-dashboard-cost":"$0.0005","description":"A stored Douyin profile: name, bio, follower, following, post and like counts, and when we last read it. Strictly DB: a profile we never stored is a `404`, never a crawl. Read a fresh one with `/v1/douyin/user_profile`.","security":[{"bearerAuth":[]}],"parameters":[{"name":"q","in":"query","required":true,"description":"A Douyin `sec_uid`, or the `https://www.douyin.com/user/{sec_uid}` profile URL.","example":"MS4wLjABAAAArDVBosPJF3eIWVEFp0szuJ-e1V_-rK0ieJeWwpE77E8","schema":{"type":"string","maxLength":256,"example":"MS4wLjABAAAArDVBosPJF3eIWVEFp0szuJ-e1V_-rK0ieJeWwpE77E8"}}],"responses":{"200":{"description":"The stored profile.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":true},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"id":864,"profile_id":1103045,"sec_uid":"MS4wLjABAAAAeAtiuDqxppdblJF1MyQ2HzxypXQMBcWZlY77xvyKDQE","uid":"624113651560254","unique_id":"77879yu","full_name":"未落流星","biography":"蓝天白云 要天天开心哦","profile_pic_url":"https://cdn.example.com/crawler/douyin_account/864.webp","followers":11845,"following":558,"posts_count":419,"total_favorited":563413,"favoriting_count":0,"is_verified":false,"is_private":false,"first_scraped_at":"2026-07-16T08:55:39.374912Z","last_scraped_at":"2026-07-26T09:55:12.012821Z","scrape_count":4},"meta":{"cost":"$0.0005","balance":"$9.9995","request_id":"req_b8cccc2387a977115746f6848e011ae4"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"404":{"description":"The profile is not stored.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/douyin/stored/profile/posts":{"get":{"tags":["Douyin"],"operationId":"douyinStoredProfilePosts","summary":"Douyin stored posts","x-dashboard-cost":"$0.0005","description":"One page of a stored Douyin profile’s posts, newest first, with counts, caption, cover and video. Pass `next_cursor` back as `cursor` for the next page; `has_more` is true exactly when it is set. Flat price per page. Strictly DB: a profile we never stored is a `404`, never a crawl.","security":[{"bearerAuth":[]}],"parameters":[{"name":"q","in":"query","required":true,"description":"A Douyin `sec_uid`, or the `https://www.douyin.com/user/{sec_uid}` profile URL.","example":"MS4wLjABAAAArDVBosPJF3eIWVEFp0szuJ-e1V_-rK0ieJeWwpE77E8","schema":{"type":"string","maxLength":256,"example":"MS4wLjABAAAArDVBosPJF3eIWVEFp0szuJ-e1V_-rK0ieJeWwpE77E8"}},{"name":"limit","in":"query","required":false,"description":"Posts per page.","schema":{"type":"integer","minimum":1,"maximum":100,"default":30},"examples":{"default":{"value":30,"x-disabled":true}}},{"name":"cursor","in":"query","required":false,"description":"The `next_cursor` of the previous page.","schema":{"type":"string"}}],"responses":{"200":{"description":"One page of stored posts.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","required":["posts","next_cursor","has_more"],"properties":{"posts":{"type":"array","items":{"type":"object","additionalProperties":true}},"next_cursor":{"type":"string","nullable":true,"description":"Opaque; pass back as `cursor`."},"has_more":{"type":"boolean","description":"True exactly when `next_cursor` is set."}}},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"posts":[{"id":23694,"aweme_id":"7664234621622282225","caption":"主播玩原神投入的状态就是如此 #原神cos #兔娘","likes":167,"comments":8,"shares":77,"collected":33,"posted_at":"2026-07-19T13:44:40Z","cover_url":"https://api.virev.ai/v1/media/douyin_video/23694/video_thumbnail","play_url":"https://api.virev.ai/v1/media/douyin_video/23694/video","image_urls":[],"duration_ms":11355,"width":720,"height":1280,"video_bytes":1779411,"aweme_type":0,"is_video":true,"plays":null}],"next_cursor":"WzIzNjk0LCIyMDI2LTA3LTE5VDEzOjQ0OjQwKzAwOjAwIl0","has_more":true},"meta":{"cost":"$0.0005","balance":"$9.9995","request_id":"req_aefdd36f17e1fb189f3ac1c2ac1dba81"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"404":{"description":"The profile is not stored.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/douyin/stored/post/comments":{"get":{"tags":["Douyin"],"operationId":"douyinStoredPostComments","summary":"Douyin stored comments","x-dashboard-cost":"$0.0005","description":"The comments stored for one Douyin video, in the order they were stored, with each commenter’s uid, sec_uid, nickname and region (`ip_label`). Pass `next_cursor` back as `cursor` for the next page; `has_more` is true exactly when it is set. Flat price per page. Strictly DB: comments collect through `/v1/douyin/comment_list`, and a video with neither a stored read nor a stored comment is a `404`, never a crawl.","security":[{"bearerAuth":[]}],"parameters":[{"name":"q","in":"query","required":true,"description":"A Douyin video (aweme) id, or the `https://www.douyin.com/video/{aweme_id}` URL.","example":"7626744113161170259","schema":{"type":"string","maxLength":256,"example":"7626744113161170259"}},{"name":"cursor","in":"query","required":false,"description":"The `next_cursor` of the previous page.","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Comments per page.","schema":{"type":"integer","minimum":1,"maximum":200,"default":50},"examples":{"default":{"value":50,"x-disabled":true}}}],"responses":{"200":{"description":"One page of stored comments.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","required":["post","comments","stored_total","next_cursor","has_more"],"properties":{"post":{"type":"object","properties":{"aweme_id":{"type":"string"}}},"comments":{"type":"array","items":{"type":"object","additionalProperties":true}},"stored_total":{"type":"integer","description":"Comments stored for the video."},"next_cursor":{"type":"string","nullable":true,"description":"Opaque; pass back as `cursor`."},"has_more":{"type":"boolean","description":"True exactly when `next_cursor` is set."}}},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"post":{"aweme_id":"7626744113161170259"},"comments":[{"douyin_comment_id":"7626917599154668346","author_uid":"107784388189","author_sec_uid":"MS4wLjABAAAAARWGYL5dehexhDWxcxqzPnaQFe8xeFnyt32Hwha9ngQ","author_unique_id":null,"author_nickname":"永恒დ","text":"我们这的gay就是比我们想象中的要多，我朋友下载小蓝打开定位发现附近都是！","like_count":1628,"reply_count":23,"liked_by_author":false,"ip_label":"山东","parent_comment_id":null,"posted_at":"2026-04-10T00:15:37Z"}],"stored_total":2,"next_cursor":"Wzdd","has_more":true},"meta":{"cost":"$0.0005","balance":"$9.9995","request_id":"req_b7687ad63e59bb6099e6ae4feefa4f98"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"404":{"description":"Neither the video nor any of its comments is stored.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/meta_ads/stored/advertiser/ads":{"get":{"tags":["Meta Ads"],"operationId":"maStoredAdvertiserAds","summary":"Stored advertiser's ads","description":"One tracked advertiser's stored ads as `Post`s, running ads first and then the newest start. Pass `next_cursor` back as `cursor` while `has_more` is true; `active_only=true` lists only running ads. The answer also carries the advertiser as an `Account`.\n\nStrictly DB: this reads what the crawler already stored and never crawls. An advertiser we never stored is a `404` and is not billed. Read fresh ads with `/v1/meta_ads/company_ads`.","x-dashboard-cost":"$0.0005","x-example-query":{"page_id":"15087023444","limit":"2"},"security":[{"bearerAuth":[]}],"parameters":[{"name":"page_id","in":"query","required":true,"description":"The numeric Facebook Page id of a tracked advertiser.","example":"15087023444","schema":{"type":"string","maxLength":40,"example":"15087023444"}},{"name":"limit","in":"query","required":false,"description":"Ads per page.","schema":{"type":"integer","minimum":1,"maximum":100,"default":30},"examples":{"default":{"value":30,"x-disabled":true}}},{"name":"active_only","in":"query","required":false,"description":"`true` lists only running ads.","schema":{"type":"boolean","default":false},"examples":{"default":{"value":false,"x-disabled":true}}},{"name":"cursor","in":"query","required":false,"description":"`next_cursor` from the previous page.","schema":{"type":"string","maxLength":300}}],"responses":{"200":{"description":"Success. The example is a captured response; long lists are truncated.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":true},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"advertiser":{"id":"15087023444","username":"nike","full_name":"Nike","is_verified":null,"is_private":false,"avatar_url":"https://api.virev.ai/v1/media/meta_advertiser/15087023444/profile_pic?e=1793750400&s=98b4bdad4fd7074de644339239015e70","latest_story_at":null,"extra":{"category":"Sportswear Store","likes":39494438,"is_deleted":false,"url":"https://www.facebook.com/nike"}},"items":[{"id":"1476143881043704","shortcode":null,"taken_at":"2026-10-23T07:00:00+00:00","kind":"carousel","product_type":"DPA","caption":"Get the gear that goes hard on and off the field.","hashtags":[],"mentions":[],"accessibility_caption":null,"likes":null,"comments":null,"views":null,"counts_hidden":null,"comments_disabled":null,"is_pinned":null,"is_paid_partnership":false,"owner":{"id":"15087023444","username":"nike","full_name":"Nike","is_verified":null,"is_private":false,"avatar_url":"https://api.virev.ai/v1/media/meta_advertiser/15087023444/profile_pic?e=1793750400&s=98b4bdad4fd7074de644339239015e70","latest_story_at":null,"extra":{"category":"Sportswear Store","likes":39494438,"is_deleted":false,"url":"https://www.facebook.com/nike"}},"coauthors":[],"sponsors":[],"tagged":[],"location":null,"audio":null,"thumbnail_url":"https://api.virev.ai/v1/media/meta_ad_creative/4407/creative?e=1793750400&s=b5fe69728cf5cce311c8723c83a61107","video_duration":null,"media":[{"kind":"image","url":"https://api.virev.ai/v1/media/meta_ad_creative/4407/creative?e=1793750400&s=b5fe69728cf5cce311c8723c83a61107","width":null,"height":null,"duration":null},{"kind":"image","url":"https://api.virev.ai/v1/media/meta_ad_creative/4408/creative?e=1793750400&s=53cbbe4d84e633f6ee5d3af20cfdfcd1","width":null,"height":null,"duration":null},{"kind":"image","url":"https://api.virev.ai/v1/media/meta_ad_creative/4409/creative?e=1793750400&s=413d351393d9d36507b651045f84a6b7","width":null,"height":null,"duration":null},{"kind":"image","url":"https://api.virev.ai/v1/media/meta_ad_creative/4410/creative?e=1793750400&s=e69040b92b23489c9927dc7a1f2f5a39","width":null,"height":null,"duration":null},{"kind":"image","url":"https://api.virev.ai/v1/media/meta_ad_creative/4411/creative?e=1793750400&s=a6b3227e1625dc5d430189fd3d11bf51","width":null,"height":null,"duration":null},{"kind":"image","url":"https://api.virev.ai/v1/media/meta_ad_creative/4412/creative?e=1793750400&s=5b9fd748430e20658d388d15a6e75787","width":null,"height":null,"duration":null}],"media_urls":["https://api.virev.ai/v1/media/meta_ad_creative/4407/creative?e=1793750400&s=b5fe69728cf5cce311c8723c83a61107","https://api.virev.ai/v1/media/meta_ad_creative/4408/creative?e=1793750400&s=53cbbe4d84e633f6ee5d3af20cfdfcd1","https://api.virev.ai/v1/media/meta_ad_creative/4409/creative?e=1793750400&s=413d351393d9d36507b651045f84a6b7","https://api.virev.ai/v1/media/meta_ad_creative/4410/creative?e=1793750400&s=e69040b92b23489c9927dc7a1f2f5a39","https://api.virev.ai/v1/media/meta_ad_creative/4411/creative?e=1793750400&s=a6b3227e1625dc5d430189fd3d11bf51","https://api.virev.ai/v1/media/meta_ad_creative/4412/creative?e=1793750400&s=5b9fd748430e20658d388d15a6e75787"],"extra":{"url":"https://www.facebook.com/ads/library/?id=1476143881043704","is_active":true,"end_date":"2026-10-27T07:00:00+00:00","title":"{{product.name}}","link_caption":"NIKE.COM","link_url":"https://www.nike.com/","link_domain":"nike.com","cta_type":"SHOP_NOW","cta_text":"Shop now","collation_id":null,"collation_count":null,"publisher_platforms":["facebook","instagram"],"countries":[],"categories":["UNKNOWN"],"currency":null}},{"id":"1120113070497516","shortcode":null,"taken_at":"2026-10-23T07:00:00+00:00","kind":"carousel","product_type":"DPA","caption":"Get the gear not afraid to put in the work.","hashtags":[],"mentions":[],"accessibility_caption":null,"likes":null,"comments":null,"views":null,"counts_hidden":null,"comments_disabled":null,"is_pinned":null,"is_paid_partnership":false,"owner":{"id":"15087023444","username":"nike","full_name":"Nike","is_verified":null,"is_private":false,"avatar_url":"https://api.virev.ai/v1/media/meta_advertiser/15087023444/profile_pic?e=1793750400&s=98b4bdad4fd7074de644339239015e70","latest_story_at":null,"extra":{"category":"Sportswear Store","likes":39494438,"is_deleted":false,"url":"https://www.facebook.com/nike"}},"coauthors":[],"sponsors":[],"tagged":[],"location":null,"audio":null,"thumbnail_url":"https://api.virev.ai/v1/media/meta_ad_creative/4395/creative?e=1793750400&s=c7ccfb5a4aaefaeddfb3b504498e7a70","video_duration":null,"media":[{"kind":"image","url":"https://api.virev.ai/v1/media/meta_ad_creative/4395/creative?e=1793750400&s=c7ccfb5a4aaefaeddfb3b504498e7a70","width":null,"height":null,"duration":null},{"kind":"image","url":"https://api.virev.ai/v1/media/meta_ad_creative/4396/creative?e=1793750400&s=ddb11cc45f38f4745e4ffec542e6b3fa","width":null,"height":null,"duration":null},{"kind":"image","url":"https://api.virev.ai/v1/media/meta_ad_creative/4397/creative?e=1793750400&s=4f9840c411c5fbfc47f4a11f41784cc8","width":null,"height":null,"duration":null},{"kind":"image","url":"https://api.virev.ai/v1/media/meta_ad_creative/4398/creative?e=1793750400&s=86919620b50697941970700f7cf95366","width":null,"height":null,"duration":null},{"kind":"image","url":"https://api.virev.ai/v1/media/meta_ad_creative/4399/creative?e=1793750400&s=d19a0a18f7b01b5a743adf9ecc2a6e1b","width":null,"height":null,"duration":null},{"kind":"image","url":"https://api.virev.ai/v1/media/meta_ad_creative/4400/creative?e=1793750400&s=cc391cd7c8320e92d28642c40833d564","width":null,"height":null,"duration":null}],"media_urls":["https://api.virev.ai/v1/media/meta_ad_creative/4395/creative?e=1793750400&s=c7ccfb5a4aaefaeddfb3b504498e7a70","https://api.virev.ai/v1/media/meta_ad_creative/4396/creative?e=1793750400&s=ddb11cc45f38f4745e4ffec542e6b3fa","https://api.virev.ai/v1/media/meta_ad_creative/4397/creative?e=1793750400&s=4f9840c411c5fbfc47f4a11f41784cc8","https://api.virev.ai/v1/media/meta_ad_creative/4398/creative?e=1793750400&s=86919620b50697941970700f7cf95366","https://api.virev.ai/v1/media/meta_ad_creative/4399/creative?e=1793750400&s=d19a0a18f7b01b5a743adf9ecc2a6e1b","https://api.virev.ai/v1/media/meta_ad_creative/4400/creative?e=1793750400&s=cc391cd7c8320e92d28642c40833d564"],"extra":{"url":"https://www.facebook.com/ads/library/?id=1120113070497516","is_active":true,"end_date":"2026-10-27T07:00:00+00:00","title":"{{product.name}}","link_caption":"NIKE.COM","link_url":"https://www.nike.com/","link_domain":"nike.com","cta_type":"SHOP_NOW","cta_text":"Shop now","collation_id":null,"collation_count":null,"publisher_platforms":["facebook","instagram"],"countries":[],"categories":["UNKNOWN"],"currency":null}}],"next_cursor":"W3RydWUsIjIwMjYtMTAtMjNUMDc6MDA6MDArMDA6MDAiLCIxMTIwMTEzMDcwNDk3NTE2Il0","has_more":true},"meta":{"cost":"$0.0005","balance":"$49.9895","request_id":"req_e3ecdc90108dc8d1c45f61acf4d1d3e3"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"404":{"description":"Advertiser not tracked. You are not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/meta_ads/company_ads":{"get":{"tags":["Meta Ads"],"operationId":"maCompanyAds","summary":"company_ads","x-dashboard-cost":"$0.0025","x-example-query":{"page_id":"15087023444","max_pages":"1"},"description":"The ads one advertiser (a Facebook Page) runs or ran, up to 30 a page in the Ad Library's order. Find a `page_id` with `/v1/meta_ads/search_companies`. Returns `Page[Post]` under `data`, read from the Ad Library as a signed-out guest.\n\nThe default request creates a durable job (202). Use max_pages=1 for one synchronous Page response (200). Poll status_url, then read results_url with its opaque cursor. Acquisition stops at the first of max_pages or exhaustion. Jobs continue after disconnects. Result responses are bounded to 3 MiB; this does not limit the crawl. Supply Idempotency-Key to recover a lost submission response; reuse it with the same inputs. The Ad Library sets every page’s size (up to 30 ads) and answers in its own ranked order, so there is no `page_size` and no `since`. An answer carries `next_cursor` and `has_more` when the Ad Library holds more ads.\n\nAn ad answers as a `Post`: the copy is `caption`, the start is `taken_at`, `likes`, `comments` and `views` are null because the Ad Library shows no engagement, and Ad Library facts (the library URL, `is_active`, `end_date`, the CTA, the link, `publisher_platforms`, `countries`) sit under `extra`. An advertiser answers as an `Account`, with Page likes under `extra.likes`. Unknown, unsupported, and repeated query parameters return 400 before acquisition or billing.\n\nBilling: $0.0025 per call; a job bills it once when it completes. A failed read is not charged.","security":[{"bearerAuth":[]}],"parameters":[{"name":"page_id","in":"query","required":true,"description":"The advertiser's numeric Facebook Page id, `id` of a `/v1/meta_ads/search_companies` answer.","example":"15087023444","schema":{"type":"string"}},{"name":"country","in":"query","required":false,"description":"A two-letter country code, or `ALL`; omitted is `US`.","schema":{"type":"string","pattern":"^([A-Za-z]{2}|ALL)$"}},{"name":"status","in":"query","required":false,"description":"Which ads: `ALL` (the default), `ACTIVE` or `INACTIVE`.","schema":{"type":"string","enum":["ALL","ACTIVE","INACTIVE"]}},{"name":"media_type","in":"query","required":false,"description":"Only ads of this media type; omitted is `ALL`.","schema":{"type":"string","enum":["ALL","IMAGE","VIDEO","MEME","IMAGE_AND_MEME","NONE"]}},{"name":"sort_by","in":"query","required":false,"description":"The Ad Library's order; only `relevancy_monthly_grouped`, its default, is observed.","schema":{"type":"string","enum":["relevancy_monthly_grouped"]}},{"name":"since","in":"query","required":false,"description":"Not accepted on this operation: its items carry no timestamp, so since returns 400 before billing.","schema":{"type":"string"}},{"name":"max_pages","in":"query","required":false,"example":1,"description":"Maximum pages to fetch. -1 walks until exhaustion or since with no page cap, and must be written. Omitted, since alone bounds the walk; with neither, the job stops after 10 pages. Any positive integer is accepted. 1 returns one page synchronously with HTTP 200; any other value creates a durable job with HTTP 202.","schema":{"type":"integer","anyOf":[{"enum":[-1]},{"minimum":1}]}},{"name":"cursor","in":"query","required":false,"description":"Opaque next_cursor from an earlier answer of this operation, also with `get_raw=true`. A native Meta Ads cursor from a raw page answers 400. Result download cursors belong to the results route.","schema":{"type":"string","minLength":1}},{"name":"cached","in":"query","required":false,"description":"`auto` (default) serves a read saved within the last 24 hours for these exact arguments, otherwise fetches. `cache_only` never contacts Meta Ads (404 `not_cached` when nothing is saved, whatever its age). `live` always fetches. Anything else is a `400`. `cache_only` reads one saved page per request: omit `max_pages` or pass 1, and continue with `next_cursor`.","schema":{"type":"string","enum":["auto","cache_only","live"],"default":"auto"},"examples":{"default":{"value":"auto","x-disabled":true}}},{"name":"get_raw","in":"query","required":false,"description":"`true` returns the upstream JSON exactly as Meta Ads answered it instead of the normalized `Page[Post]`.","schema":{"type":"boolean","default":false},"examples":{"default":{"value":false,"x-disabled":true}}},{"name":"Idempotency-Key","in":"header","required":false,"description":"Reuse this key with the same inputs to recover a lost job submission. A different input with the same key returns 409.","schema":{"type":"string","minLength":1,"maxLength":200}}],"responses":{"200":{"description":"`Page[Post]` under `data`.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","required":["items","pages","next_cursor","has_more","stop_reason","coverage"],"properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/Post"},"description":"`Post` of every page walked, in page order."},"pages":{"type":"array","items":{"$ref":"#/components/schemas/PageRead"},"description":"One entry per page walked."},"next_cursor":{"type":"string","nullable":true,"description":"Opaque; pass back as `cursor` to continue."},"has_more":{"type":"boolean","description":"True when `next_cursor` is set, and when the walk stopped `cursor_stalled` on a page that said more results exist but gave no cursor to send back."},"stop_reason":{"type":"string","enum":["pages","since","exhausted","cursor_stalled","repeated_content","deadline","blocked","caught_up"],"description":"Why the walk stopped. `pages`: the page budget is spent and `next_cursor` continues it. `deadline`: the call ran out of time before its next page; `next_cursor` continues it. `since`: a whole page was older than `since`. `exhausted`: Meta Ads reported the end. `cursor_stalled`: Meta Ads claimed more but repeated or omitted its cursor. `repeated_content`: a page held only items already seen. `blocked`: Meta Ads refused a later page; `next_cursor` is the page it refused. `caught_up`: only watch passes the crawler runs for itself stop this way."},"coverage":{"$ref":"#/components/schemas/Coverage"}}},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"items":[{"id":"161966936869658","shortcode":null,"taken_at":"2023-08-15T07:00:00+00:00","kind":"carousel","product_type":"DPA","caption":"Entra a Nike.com y encuentra actualizaciones semanales de producto con envío gratis.","hashtags":[],"mentions":[],"accessibility_caption":null,"likes":null,"comments":null,"views":null,"counts_hidden":null,"comments_disabled":null,"is_pinned":null,"is_paid_partnership":false,"owner":{"id":"15087023444","username":"nike","full_name":"Nike","is_verified":null,"is_private":false,"avatar_url":"https://scontent-poa1-1.xx.fbcdn.net/v/t39.35426-6/158865320_451391649310335_3058302462343549918_n.jpg?stp=dst-jpg_s60x60_tt6&_nc_cat=109&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=5iBoCN_lZt4Q7kNvwGs2eKu&_nc_oc=AdqvDJ6TzV3YPGUrgn_QBXdmt-S5SjeNiJW-jcMjgIdTLBMF5W7Lok39_9P_oS-R5rM&_nc_zt=14&_nc_ht=scontent-poa1-1.xx&_nc_gid=y9fsp-OjBlgjh2czCwHc9A&_nc_ss=7b289&oh=00_AQQVnk2MTcLegLefnyyyXTDhkZXcupkrrD3rliiC-UJ34w&oe=6AE6FBDB","latest_story_at":null,"extra":{"category":"Sportswear","likes":39494361,"is_deleted":false,"url":"https://www.facebook.com/nike"}},"coauthors":[],"sponsors":[],"tagged":[],"location":null,"audio":null,"thumbnail_url":"https://scontent-poa1-1.xx.fbcdn.net/v/t39.35426-6/367963819_652036496870561_3033983014718682847_n.jpg?_nc_cat=107&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=xMavf1VqVhYQ7kNvwG0Sj1f&_nc_oc=AdriB8yRkGGkP4uCeG_9Q9Py-AY8iv8jXocpoJCKknzc2a-FIAZxMmSHIEpdTDwqlbA&_nc_zt=14&_nc_ht=scontent-poa1-1.xx&_nc_gid=y9fsp-OjBlgjh2czCwHc9A&_nc_ss=7b289&oh=00_AQTBKBzTWwNUZk27zgLwIeowqqKQfxQLpKhzNW6l0doYrQ&oe=6AE7139A","video_duration":null,"media":[{"kind":"image","url":"https://scontent-poa1-1.xx.fbcdn.net/v/t39.35426-6/367963819_652036496870561_3033983014718682847_n.jpg?_nc_cat=107&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=xMavf1VqVhYQ7kNvwG0Sj1f&_nc_oc=AdriB8yRkGGkP4uCeG_9Q9Py-AY8iv8jXocpoJCKknzc2a-FIAZxMmSHIEpdTDwqlbA&_nc_zt=14&_nc_ht=scontent-poa1-1.xx&_nc_gid=y9fsp-OjBlgjh2czCwHc9A&_nc_ss=7b289&oh=00_AQTBKBzTWwNUZk27zgLwIeowqqKQfxQLpKhzNW6l0doYrQ&oe=6AE7139A","width":null,"height":null,"duration":null},{"kind":"image","url":"https://scontent-poa1-1.xx.fbcdn.net/v/t39.35426-6/367742785_847403300215960_2275630920962394846_n.jpg?_nc_cat=103&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=exMqM5kN9M4Q7kNvwFKXf8z&_nc_oc=AdqwKs19geQQt-r0-S6Udb9ogG1MHWcOED_CuKjfZAfeKS8MUWdR63YhCJrFVcT3CI0&_nc_zt=14&_nc_ht=scontent-poa1-1.xx&_nc_gid=y9fsp-OjBlgjh2czCwHc9A&_nc_ss=7b289&oh=00_AQRppSj20MKSetjaJutD-aGlxEH5cHjVLrW4NM5OIBpOng&oe=6AE711DF","width":null,"height":null,"duration":null},{"kind":"image","url":"https://scontent-poa1-1.xx.fbcdn.net/v/t39.35426-6/367982880_6403678943084737_2372495901824734164_n.jpg?_nc_cat=105&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=k7FKAmkj9usQ7kNvwFvl-nS&_nc_oc=AdoLFVPKIZbRQlZ0VrPMI_ORv-oTTSOnmg4hCaHLckReIh7mNsUdNEIJly2_lb26a90&_nc_zt=14&_nc_ht=scontent-poa1-1.xx&_nc_gid=y9fsp-OjBlgjh2czCwHc9A&_nc_ss=7b289&oh=00_AQRl_eVUFYJC3Ow7pBTi_h1osZrpy-CqUijkVAQBJSUHVA&oe=6AE71370","width":null,"height":null,"duration":null},{"kind":"image","url":"https://scontent-poa1-1.xx.fbcdn.net/v/t39.35426-6/367047967_607783308209677_5484532650414513812_n.jpg?_nc_cat=108&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=o7qSooHaE7gQ7kNvwH7SWLA&_nc_oc=AdqwF3OmwpiKkOkjhDh6BkSFqd44Jkj8QF8CGtU_dVN8ySVSr2O2M-F9IWUsm8P90Fk&_nc_zt=14&_nc_ht=scontent-poa1-1.xx&_nc_gid=y9fsp-OjBlgjh2czCwHc9A&_nc_ss=7b289&oh=00_AQR8vL9GNoL9TYzh95Jn4k4iyEEDYCRdbkKhBalZHcyoMA&oe=6AE6FF2C","width":null,"height":null,"duration":null},{"kind":"image","url":"https://scontent-poa1-1.xx.fbcdn.net/v/t39.35426-6/367750235_981618649557195_7119924792787874591_n.jpg?_nc_cat=102&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=CXanSAHduLwQ7kNvwGOkvLN&_nc_oc=AdqXbLc5YZZZAlHE_vDAuLEqi0d1KlRJ1gz4Cjyomch76W8Yw0MavDoGoIgZpqI5GJk&_nc_zt=14&_nc_ht=scontent-poa1-1.xx&_nc_gid=y9fsp-OjBlgjh2czCwHc9A&_nc_ss=7b289&oh=00_AQSC94H9US8lgF_myAXNi8iiggW1vnQDSmNMOCDDNJrmhw&oe=6AE6F657","width":null,"height":null,"duration":null},{"kind":"image","url":"https://scontent-poa1-1.xx.fbcdn.net/v/t39.35426-6/367693224_1243588693706245_2909314498320683993_n.jpg?_nc_cat=105&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=go3cAn0EBRQQ7kNvwFvV7yq&_nc_oc=AdpOuRauQ4vpd3w_RTPwmL92cMY_dcrIr0YdpD_pIu7r4BStOJtLXXt_NfL-l1lvZrQ&_nc_zt=14&_nc_ht=scontent-poa1-1.xx&_nc_gid=y9fsp-OjBlgjh2czCwHc9A&_nc_ss=7b289&oh=00_AQQgv1FwULl6_DIOudcOna5JK8rv7GgkujXY4wR9PLCtmg&oe=6AE6E5A1","width":null,"height":null,"duration":null}],"media_urls":["https://scontent-poa1-1.xx.fbcdn.net/v/t39.35426-6/367963819_652036496870561_3033983014718682847_n.jpg?_nc_cat=107&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=xMavf1VqVhYQ7kNvwG0Sj1f&_nc_oc=AdriB8yRkGGkP4uCeG_9Q9Py-AY8iv8jXocpoJCKknzc2a-FIAZxMmSHIEpdTDwqlbA&_nc_zt=14&_nc_ht=scontent-poa1-1.xx&_nc_gid=y9fsp-OjBlgjh2czCwHc9A&_nc_ss=7b289&oh=00_AQTBKBzTWwNUZk27zgLwIeowqqKQfxQLpKhzNW6l0doYrQ&oe=6AE7139A","https://scontent-poa1-1.xx.fbcdn.net/v/t39.35426-6/367742785_847403300215960_2275630920962394846_n.jpg?_nc_cat=103&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=exMqM5kN9M4Q7kNvwFKXf8z&_nc_oc=AdqwKs19geQQt-r0-S6Udb9ogG1MHWcOED_CuKjfZAfeKS8MUWdR63YhCJrFVcT3CI0&_nc_zt=14&_nc_ht=scontent-poa1-1.xx&_nc_gid=y9fsp-OjBlgjh2czCwHc9A&_nc_ss=7b289&oh=00_AQRppSj20MKSetjaJutD-aGlxEH5cHjVLrW4NM5OIBpOng&oe=6AE711DF","https://scontent-poa1-1.xx.fbcdn.net/v/t39.35426-6/367982880_6403678943084737_2372495901824734164_n.jpg?_nc_cat=105&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=k7FKAmkj9usQ7kNvwFvl-nS&_nc_oc=AdoLFVPKIZbRQlZ0VrPMI_ORv-oTTSOnmg4hCaHLckReIh7mNsUdNEIJly2_lb26a90&_nc_zt=14&_nc_ht=scontent-poa1-1.xx&_nc_gid=y9fsp-OjBlgjh2czCwHc9A&_nc_ss=7b289&oh=00_AQRl_eVUFYJC3Ow7pBTi_h1osZrpy-CqUijkVAQBJSUHVA&oe=6AE71370","https://scontent-poa1-1.xx.fbcdn.net/v/t39.35426-6/367047967_607783308209677_5484532650414513812_n.jpg?_nc_cat=108&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=o7qSooHaE7gQ7kNvwH7SWLA&_nc_oc=AdqwF3OmwpiKkOkjhDh6BkSFqd44Jkj8QF8CGtU_dVN8ySVSr2O2M-F9IWUsm8P90Fk&_nc_zt=14&_nc_ht=scontent-poa1-1.xx&_nc_gid=y9fsp-OjBlgjh2czCwHc9A&_nc_ss=7b289&oh=00_AQR8vL9GNoL9TYzh95Jn4k4iyEEDYCRdbkKhBalZHcyoMA&oe=6AE6FF2C","https://scontent-poa1-1.xx.fbcdn.net/v/t39.35426-6/367750235_981618649557195_7119924792787874591_n.jpg?_nc_cat=102&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=CXanSAHduLwQ7kNvwGOkvLN&_nc_oc=AdqXbLc5YZZZAlHE_vDAuLEqi0d1KlRJ1gz4Cjyomch76W8Yw0MavDoGoIgZpqI5GJk&_nc_zt=14&_nc_ht=scontent-poa1-1.xx&_nc_gid=y9fsp-OjBlgjh2czCwHc9A&_nc_ss=7b289&oh=00_AQSC94H9US8lgF_myAXNi8iiggW1vnQDSmNMOCDDNJrmhw&oe=6AE6F657","https://scontent-poa1-1.xx.fbcdn.net/v/t39.35426-6/367693224_1243588693706245_2909314498320683993_n.jpg?_nc_cat=105&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=go3cAn0EBRQQ7kNvwFvV7yq&_nc_oc=AdpOuRauQ4vpd3w_RTPwmL92cMY_dcrIr0YdpD_pIu7r4BStOJtLXXt_NfL-l1lvZrQ&_nc_zt=14&_nc_ht=scontent-poa1-1.xx&_nc_gid=y9fsp-OjBlgjh2czCwHc9A&_nc_ss=7b289&oh=00_AQQgv1FwULl6_DIOudcOna5JK8rv7GgkujXY4wR9PLCtmg&oe=6AE6E5A1"],"extra":{"url":"https://www.facebook.com/ads/library/?id=161966936869658","is_active":false,"end_date":"2026-03-30T07:00:00+00:00","title":"{{product.name}}","link_caption":"nike.com/mx","link_url":"https://ad.doubleclick.net/ddm/trackclk/N8893.2410306FACEBOOKADS/B30448992.373431644;dc_trk_aid=564542764;dc_trk_cid=196659869;dc_lat=;dc_rdid=;tag_for_child_directed_treatment=;tfua=;ltd=;dc_tdv=1","link_domain":"ad.doubleclick.net","cta_type":"SHOP_NOW","cta_text":"Shop now","collation_id":null,"collation_count":null,"publisher_platforms":["facebook","instagram","audience_network","messenger"],"countries":[],"categories":["UNKNOWN"],"currency":null}},{"id":"1568367420362553","shortcode":null,"taken_at":"2023-08-15T07:00:00+00:00","kind":"carousel","product_type":"DPA","caption":"Entra a Nike.com y encuentra actualizaciones semanales de producto con envío gratis.","hashtags":[],"mentions":[],"accessibility_caption":null,"likes":null,"comments":null,"views":null,"counts_hidden":null,"comments_disabled":null,"is_pinned":null,"is_paid_partnership":false,"owner":{"id":"15087023444","username":"nike","full_name":"Nike","is_verified":null,"is_private":false,"avatar_url":"https://scontent-poa1-1.xx.fbcdn.net/v/t39.35426-6/158865320_451391649310335_3058302462343549918_n.jpg?stp=dst-jpg_s60x60_tt6&_nc_cat=109&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=5iBoCN_lZt4Q7kNvwGs2eKu&_nc_oc=AdqvDJ6TzV3YPGUrgn_QBXdmt-S5SjeNiJW-jcMjgIdTLBMF5W7Lok39_9P_oS-R5rM&_nc_zt=14&_nc_ht=scontent-poa1-1.xx&_nc_gid=y9fsp-OjBlgjh2czCwHc9A&_nc_ss=7b289&oh=00_AQQVnk2MTcLegLefnyyyXTDhkZXcupkrrD3rliiC-UJ34w&oe=6AE6FBDB","latest_story_at":null,"extra":{"category":"Sportswear","likes":39494361,"is_deleted":false,"url":"https://www.facebook.com/nike"}},"coauthors":[],"sponsors":[],"tagged":[],"location":null,"audio":null,"thumbnail_url":"https://scontent-poa1-1.xx.fbcdn.net/v/t39.35426-6/366718874_993579578550513_268301341999985937_n.jpg?_nc_cat=107&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=bQ28IZ-aeKoQ7kNvwH2K6aW&_nc_oc=Adq7dShBnlNSKc0-b3_IJroLl6MhiVZl5w_X3STBI0VI32-CR3VDYgyneryfYDK7_Zg&_nc_zt=14&_nc_ht=scontent-poa1-1.xx&_nc_gid=y9fsp-OjBlgjh2czCwHc9A&_nc_ss=7b289&oh=00_AQSZXr1tLqzkHnHd2uU15gyOWc_z5jtFNotHgWHVLdgwFw&oe=6AE6E20B","video_duration":null,"media":[{"kind":"image","url":"https://scontent-poa1-1.xx.fbcdn.net/v/t39.35426-6/366718874_993579578550513_268301341999985937_n.jpg?_nc_cat=107&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=bQ28IZ-aeKoQ7kNvwH2K6aW&_nc_oc=Adq7dShBnlNSKc0-b3_IJroLl6MhiVZl5w_X3STBI0VI32-CR3VDYgyneryfYDK7_Zg&_nc_zt=14&_nc_ht=scontent-poa1-1.xx&_nc_gid=y9fsp-OjBlgjh2czCwHc9A&_nc_ss=7b289&oh=00_AQSZXr1tLqzkHnHd2uU15gyOWc_z5jtFNotHgWHVLdgwFw&oe=6AE6E20B","width":null,"height":null,"duration":null},{"kind":"image","url":"https://scontent-poa1-1.xx.fbcdn.net/v/t39.35426-6/367713450_111500178710988_8942041339678852021_n.jpg?_nc_cat=106&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=UPabnVg8LbEQ7kNvwH28bBY&_nc_oc=AdrNdUYRnhqxZdAYUh4if8pVk2U5FhBVWI5lGW8jNwcjYPI0hpbE9GeMWKT-CHL8j0k&_nc_zt=14&_nc_ht=scontent-poa1-1.xx&_nc_gid=y9fsp-OjBlgjh2czCwHc9A&_nc_ss=7b289&oh=00_AQQZXM_QLt-wV5EZHbMLpVFKqgYROKIa7Hpq0-NN9WBmPw&oe=6AE70FDA","width":null,"height":null,"duration":null},{"kind":"image","url":"https://scontent-poa1-1.xx.fbcdn.net/v/t39.35426-6/366720169_275300341882728_5940567011916220043_n.jpg?_nc_cat=108&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=p33nT506yVEQ7kNvwEWBhGo&_nc_oc=AdouojOREOqHY-zQuimjZ0Xxku-C0-vLvzgImxHNELXVMSjUfdGQyDe1vjFzDXNbBkU&_nc_zt=14&_nc_ht=scontent-poa1-1.xx&_nc_gid=y9fsp-OjBlgjh2czCwHc9A&_nc_ss=7b289&oh=00_AQQToL1cSik8iDpf-lMG1-FInLpXEzMO4iefA6gwom8v6A&oe=6AE6F789","width":null,"height":null,"duration":null},{"kind":"image","url":"https://scontent-poa1-1.xx.fbcdn.net/v/t39.35426-6/366811709_1069036807810808_2806477120541032751_n.jpg?_nc_cat=108&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=8naOCYzMTesQ7kNvwEjoEUK&_nc_oc=AdqH64Jn3XwF0dPBIvVB6lyengIsV_NJfoTdEsPI54qrBiRtDCuXXmOpyGpWG6pFH0I&_nc_zt=14&_nc_ht=scontent-poa1-1.xx&_nc_gid=y9fsp-OjBlgjh2czCwHc9A&_nc_ss=7b289&oh=00_AQQsZyD9EuKtJBNWQZ6JkWroS_A89B0F2Fs92FDd2ll20Q&oe=6AE6F694","width":null,"height":null,"duration":null},{"kind":"image","url":"https://scontent-poa1-1.xx.fbcdn.net/v/t39.35426-6/366707555_1378767059520346_7092404070242286790_n.jpg?_nc_cat=111&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=4P3rxQXcj8YQ7kNvwEOran5&_nc_oc=AdrwkBKt3KyH5SxCI7eqc2sFl7ZfqjpdCUfZb2CrE30GX9cSER8KpLSU0h5pjxsd4k4&_nc_zt=14&_nc_ht=scontent-poa1-1.xx&_nc_gid=y9fsp-OjBlgjh2czCwHc9A&_nc_ss=7b289&oh=00_AQQtkZnJnUn6K4aYiowJCFYmFOWEuxHtpZoScWqEn_vWnw&oe=6AE6E509","width":null,"height":null,"duration":null},{"kind":"image","url":"https://scontent-poa1-1.xx.fbcdn.net/v/t39.35426-6/368009228_1944647362559666_7560626559737051152_n.jpg?_nc_cat=110&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=HdgK6hDhzZsQ7kNvwGB6np2&_nc_oc=AdoAKKN34zo2aqsujExNtwmvfYkPb9r-QT4FkmFYZscXRemxUJiSXZt9pCTsf2vZVqE&_nc_zt=14&_nc_ht=scontent-poa1-1.xx&_nc_gid=y9fsp-OjBlgjh2czCwHc9A&_nc_ss=7b289&oh=00_AQR99UR5VQmT6iPermMOWdi0KIVZsIG2ABsUl3w45RaBMQ&oe=6AE6DED9","width":null,"height":null,"duration":null}],"media_urls":["https://scontent-poa1-1.xx.fbcdn.net/v/t39.35426-6/366718874_993579578550513_268301341999985937_n.jpg?_nc_cat=107&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=bQ28IZ-aeKoQ7kNvwH2K6aW&_nc_oc=Adq7dShBnlNSKc0-b3_IJroLl6MhiVZl5w_X3STBI0VI32-CR3VDYgyneryfYDK7_Zg&_nc_zt=14&_nc_ht=scontent-poa1-1.xx&_nc_gid=y9fsp-OjBlgjh2czCwHc9A&_nc_ss=7b289&oh=00_AQSZXr1tLqzkHnHd2uU15gyOWc_z5jtFNotHgWHVLdgwFw&oe=6AE6E20B","https://scontent-poa1-1.xx.fbcdn.net/v/t39.35426-6/367713450_111500178710988_8942041339678852021_n.jpg?_nc_cat=106&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=UPabnVg8LbEQ7kNvwH28bBY&_nc_oc=AdrNdUYRnhqxZdAYUh4if8pVk2U5FhBVWI5lGW8jNwcjYPI0hpbE9GeMWKT-CHL8j0k&_nc_zt=14&_nc_ht=scontent-poa1-1.xx&_nc_gid=y9fsp-OjBlgjh2czCwHc9A&_nc_ss=7b289&oh=00_AQQZXM_QLt-wV5EZHbMLpVFKqgYROKIa7Hpq0-NN9WBmPw&oe=6AE70FDA","https://scontent-poa1-1.xx.fbcdn.net/v/t39.35426-6/366720169_275300341882728_5940567011916220043_n.jpg?_nc_cat=108&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=p33nT506yVEQ7kNvwEWBhGo&_nc_oc=AdouojOREOqHY-zQuimjZ0Xxku-C0-vLvzgImxHNELXVMSjUfdGQyDe1vjFzDXNbBkU&_nc_zt=14&_nc_ht=scontent-poa1-1.xx&_nc_gid=y9fsp-OjBlgjh2czCwHc9A&_nc_ss=7b289&oh=00_AQQToL1cSik8iDpf-lMG1-FInLpXEzMO4iefA6gwom8v6A&oe=6AE6F789","https://scontent-poa1-1.xx.fbcdn.net/v/t39.35426-6/366811709_1069036807810808_2806477120541032751_n.jpg?_nc_cat=108&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=8naOCYzMTesQ7kNvwEjoEUK&_nc_oc=AdqH64Jn3XwF0dPBIvVB6lyengIsV_NJfoTdEsPI54qrBiRtDCuXXmOpyGpWG6pFH0I&_nc_zt=14&_nc_ht=scontent-poa1-1.xx&_nc_gid=y9fsp-OjBlgjh2czCwHc9A&_nc_ss=7b289&oh=00_AQQsZyD9EuKtJBNWQZ6JkWroS_A89B0F2Fs92FDd2ll20Q&oe=6AE6F694","https://scontent-poa1-1.xx.fbcdn.net/v/t39.35426-6/366707555_1378767059520346_7092404070242286790_n.jpg?_nc_cat=111&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=4P3rxQXcj8YQ7kNvwEOran5&_nc_oc=AdrwkBKt3KyH5SxCI7eqc2sFl7ZfqjpdCUfZb2CrE30GX9cSER8KpLSU0h5pjxsd4k4&_nc_zt=14&_nc_ht=scontent-poa1-1.xx&_nc_gid=y9fsp-OjBlgjh2czCwHc9A&_nc_ss=7b289&oh=00_AQQtkZnJnUn6K4aYiowJCFYmFOWEuxHtpZoScWqEn_vWnw&oe=6AE6E509","https://scontent-poa1-1.xx.fbcdn.net/v/t39.35426-6/368009228_1944647362559666_7560626559737051152_n.jpg?_nc_cat=110&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=HdgK6hDhzZsQ7kNvwGB6np2&_nc_oc=AdoAKKN34zo2aqsujExNtwmvfYkPb9r-QT4FkmFYZscXRemxUJiSXZt9pCTsf2vZVqE&_nc_zt=14&_nc_ht=scontent-poa1-1.xx&_nc_gid=y9fsp-OjBlgjh2czCwHc9A&_nc_ss=7b289&oh=00_AQR99UR5VQmT6iPermMOWdi0KIVZsIG2ABsUl3w45RaBMQ&oe=6AE6DED9"],"extra":{"url":"https://www.facebook.com/ads/library/?id=1568367420362553","is_active":false,"end_date":"2026-03-30T07:00:00+00:00","title":"{{product.name}}","link_caption":"nike.com/mx","link_url":"https://ad.doubleclick.net/ddm/trackclk/N8893.2410306FACEBOOKADS/B30448992.373431644;dc_trk_aid=564542764;dc_trk_cid=196659869;dc_lat=;dc_rdid=;tag_for_child_directed_treatment=;tfua=;ltd=;dc_tdv=1","link_domain":"ad.doubleclick.net","cta_type":"SHOP_NOW","cta_text":"Shop now","collation_id":null,"collation_count":null,"publisher_platforms":["facebook","instagram","audience_network","messenger"],"countries":[],"categories":["UNKNOWN"],"currency":null}}],"pages":[{"cursor":null,"fetched_at":"2026-10-27T22:38:37.872549+00:00","count":10}],"next_cursor":"eyJjdXJzb3IiOiJBUUhUWFJfVGpJMllGQVIxNHFxTXlEdlVINnpKX01oWkFhMmx0Z0k5eUZpNmVkQTEzc0QyLTNIa3dKNjlBTGlTVGdmcyIsIm9wIjoiY29tcGFueV9hZHMifQ","has_more":true,"stop_reason":"pages","coverage":{"since":null,"oldest_at":null,"since_reached":false}},"meta":{"source":"live","fetched_at":"2026-10-27T22:38:37.872549+00:00","cost":"$0.0025","balance":"$49.9950","request_id":"req_96ae9fb8754f7663f05887e4cf68e4d7"}}}}},"202":{"description":"Durable job accepted. No completed-result charge. Save batch_id; poll status_url. Retry submission with the same Idempotency-Key after a lost response. An account may have five queued, running or payment-required jobs. A sixth new job returns 429 rate_limited. Matching idempotent replays still work at the limit. Ready and failed jobs release their slots; pages within a job remain unbounded. This is a synthetic contract example, not a live capture.","x-example-provenance":"synthetic-contract","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","required":["batch_id","status","status_url","results_url","cost","item_count","error","retry_at","total","done_count","failed_count","created_at","started_at","finished_at"],"properties":{"batch_id":{"type":"string"},"status":{"type":"string","enum":["queued","running","payment_required","ready","failed"]},"status_url":{"type":"string"},"results_url":{"type":"string"},"cost":{"type":"string"},"item_count":{"type":"integer","nullable":true},"error":{"type":"string","nullable":true,"description":"Null unless failed. A failed target carries its own code; incomplete_result appears only when it has none and pages of the result are missing. profile_not_found, post_not_found, upstream_not_found or not_found: the target does not exist or is not visible. not_visible: The account exists, but its posts are not visible to logged-out readers (private, restricted, or hidden by Instagram). Retrying will not change the result until the account changes. not_cached: cached=cache_only found no saved read. incomplete_result: pages of the result are missing. temporarily_unavailable: the target could not be read for now (no capacity, a pause or repeated refusals); retry later with a new job. result_item_too_large: one result unit exceeds the delivery budget. result_snapshot_missing or result_snapshot_corrupt: the crawler could not serve the retained result of a paid job, and its charge is refunded; if the crawler serves it again, a later results read returns it and charges the job again. crawler_submit_400, crawler_submit_404 or crawler_submit_422: the crawl service refused the job request. crawler_job_failed: any other failure; the same job is not expected to succeed if resubmitted. cancelled: the job was cancelled with POST /v1/jobs/{job_id}/cancel. No failed job costs anything: only result_snapshot_missing and result_snapshot_corrupt follow a charge, and that charge is refunded."},"retry_at":{"type":"string","format":"date-time","nullable":true,"description":"Null unless the job failed temporarily_unavailable because a crawl route was closed for every caller. Then it is when the route opens again, and the response carries the same time as a Retry-After header in seconds. Submit a new job after it."},"total":{"type":"integer","description":"Targets in the job. A job submitted through a /v1 route has one."},"done_count":{"type":"integer","description":"Targets the crawler finished."},"failed_count":{"type":"integer","description":"Targets that failed."},"created_at":{"type":"string","format":"date-time","description":"When the job was submitted."},"started_at":{"type":"string","format":"date-time","nullable":true,"description":"When the crawler started the job. Null until it starts."},"finished_at":{"type":"string","format":"date-time","nullable":true,"description":"When the job finished or failed. Null while it is queued or running."}}},"meta":{"type":"object","required":["cost","request_id"],"properties":{"cost":{"type":"string","example":"$0.0000"},"request_id":{"type":"string"}}}}},"example":{"data":{"batch_id":"job_7641d5f0-717d-4b70-a2f1-f58d846d7242","status":"queued","status_url":"/v1/jobs/job_7641d5f0-717d-4b70-a2f1-f58d846d7242","results_url":"/v1/jobs/job_7641d5f0-717d-4b70-a2f1-f58d846d7242/results","cost":"$0.0000","item_count":null,"error":null,"retry_at":null,"total":1,"done_count":0,"failed_count":0,"created_at":"2026-10-12T12:56:17.403Z","started_at":null,"finished_at":null},"meta":{"cost":"$0.0000","request_id":"req_job_example"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"404":{"description":"`cached=cache_only` found nothing saved for these arguments (`not_cached`; call again with `cached=auto` to fetch it), or the Meta Ads account or item does not exist (`not_found`). You are not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_cached","message":"no saved meta_ads/company_ads read for '15087023444'. cached=cache_only never fetches, so call again with cached=auto to fetch it. You are not charged.","request_id":"req_5c10900e919bc7a3ff79b7501d582b4c"}}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/meta_ads/search_ads":{"get":{"tags":["Meta Ads"],"operationId":"maSearchAds","summary":"search_ads","x-dashboard-cost":"$0.0025","x-example-query":{"query":"running shoes","max_pages":"1"},"description":"The Ad Library keyword search over ad copy, up to 30 ads a page, across every advertiser. Returns `Page[Post]` under `data`, read from the Ad Library as a signed-out guest.\n\nThe default request creates a durable job (202). Use max_pages=1 for one synchronous Page response (200). Poll status_url, then read results_url with its opaque cursor. Acquisition stops at the first of max_pages or exhaustion. Jobs continue after disconnects. Result responses are bounded to 3 MiB; this does not limit the crawl. Supply Idempotency-Key to recover a lost submission response; reuse it with the same inputs. The Ad Library sets every page’s size (up to 30 ads) and answers in its own ranked order, so there is no `page_size` and no `since`. An answer carries `next_cursor` and `has_more` when the Ad Library holds more ads.\n\nAn ad answers as a `Post`: the copy is `caption`, the start is `taken_at`, `likes`, `comments` and `views` are null because the Ad Library shows no engagement, and Ad Library facts (the library URL, `is_active`, `end_date`, the CTA, the link, `publisher_platforms`, `countries`) sit under `extra`. An advertiser answers as an `Account`, with Page likes under `extra.likes`. Unknown, unsupported, and repeated query parameters return 400 before acquisition or billing.\n\nBilling: $0.0025 per call; a job bills it once when it completes. A failed read is not charged.","security":[{"bearerAuth":[]}],"parameters":[{"name":"query","in":"query","required":true,"description":"The words to search for, up to 500 characters.","example":"running shoes","schema":{"type":"string"}},{"name":"country","in":"query","required":false,"description":"A two-letter country code, or `ALL`; omitted is `US`.","schema":{"type":"string","pattern":"^([A-Za-z]{2}|ALL)$"}},{"name":"status","in":"query","required":false,"description":"Which ads: `ALL` (the default), `ACTIVE` or `INACTIVE`.","schema":{"type":"string","enum":["ALL","ACTIVE","INACTIVE"]}},{"name":"media_type","in":"query","required":false,"description":"Only ads of this media type; omitted is `ALL`.","schema":{"type":"string","enum":["ALL","IMAGE","VIDEO","MEME","IMAGE_AND_MEME","NONE"]}},{"name":"sort_by","in":"query","required":false,"description":"The Ad Library's order; only `relevancy_monthly_grouped`, its default, is observed.","schema":{"type":"string","enum":["relevancy_monthly_grouped"]}},{"name":"since","in":"query","required":false,"description":"Not accepted on this operation: its items carry no timestamp, so since returns 400 before billing.","schema":{"type":"string"}},{"name":"max_pages","in":"query","required":false,"example":1,"description":"Maximum pages to fetch. -1 walks until exhaustion or since with no page cap, and must be written. Omitted, since alone bounds the walk; with neither, the job stops after 10 pages. Any positive integer is accepted. 1 returns one page synchronously with HTTP 200; any other value creates a durable job with HTTP 202.","schema":{"type":"integer","anyOf":[{"enum":[-1]},{"minimum":1}]}},{"name":"cursor","in":"query","required":false,"description":"Opaque next_cursor from an earlier answer of this operation, also with `get_raw=true`. A native Meta Ads cursor from a raw page answers 400. Result download cursors belong to the results route.","schema":{"type":"string","minLength":1}},{"name":"cached","in":"query","required":false,"description":"`auto` (default) serves a read saved within the last 24 hours for these exact arguments, otherwise fetches. `cache_only` never contacts Meta Ads (404 `not_cached` when nothing is saved, whatever its age). `live` always fetches. Anything else is a `400`. `cache_only` reads one saved page per request: omit `max_pages` or pass 1, and continue with `next_cursor`.","schema":{"type":"string","enum":["auto","cache_only","live"],"default":"auto"},"examples":{"default":{"value":"auto","x-disabled":true}}},{"name":"get_raw","in":"query","required":false,"description":"`true` returns the upstream JSON exactly as Meta Ads answered it instead of the normalized `Page[Post]`.","schema":{"type":"boolean","default":false},"examples":{"default":{"value":false,"x-disabled":true}}},{"name":"Idempotency-Key","in":"header","required":false,"description":"Reuse this key with the same inputs to recover a lost job submission. A different input with the same key returns 409.","schema":{"type":"string","minLength":1,"maxLength":200}}],"responses":{"200":{"description":"`Page[Post]` under `data`.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","required":["items","pages","next_cursor","has_more","stop_reason","coverage"],"properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/Post"},"description":"`Post` of every page walked, in page order."},"pages":{"type":"array","items":{"$ref":"#/components/schemas/PageRead"},"description":"One entry per page walked."},"next_cursor":{"type":"string","nullable":true,"description":"Opaque; pass back as `cursor` to continue."},"has_more":{"type":"boolean","description":"True when `next_cursor` is set, and when the walk stopped `cursor_stalled` on a page that said more results exist but gave no cursor to send back."},"stop_reason":{"type":"string","enum":["pages","since","exhausted","cursor_stalled","repeated_content","deadline","blocked","caught_up"],"description":"Why the walk stopped. `pages`: the page budget is spent and `next_cursor` continues it. `deadline`: the call ran out of time before its next page; `next_cursor` continues it. `since`: a whole page was older than `since`. `exhausted`: Meta Ads reported the end. `cursor_stalled`: Meta Ads claimed more but repeated or omitted its cursor. `repeated_content`: a page held only items already seen. `blocked`: Meta Ads refused a later page; `next_cursor` is the page it refused. `caught_up`: only watch passes the crawler runs for itself stop this way."},"coverage":{"$ref":"#/components/schemas/Coverage"}}},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"items":[{"id":"866569929827744","shortcode":null,"taken_at":"2026-06-01T07:00:00+00:00","kind":"image","product_type":"IMAGE","caption":"I watched a man in a Carhartt jacket put back a gallon of milk at the gas station because the total at the pump had already eaten what he came in with.\n\nHe didn't argue.\n\nHe just nodded at the clerk like they'd already had the conversation a hundred times.\n\nI was standing two people behind him, holding a bag of dog food and a quart of motor oil for our Buick, and I watched him slide that milk back into the cooler with the kind of care a man uses when he's pretending nothing is wrong.\n\nHe set it in the same spot. He turned the label so it faced out, the way you'd put a book back on a library shelf.\n\nThen he walked out into the lot. He sat in his truck for a long minute before he started the engine. The truck was clean. Older, but clean. A man who took care of his things.\n\nI knew that man.\n\nI didn't know his name. But I knew him. I'd been married to a version of him for forty-one years.\n\nMy name is Maggie. I'm sixty-four. I drove a school bus in our county for twenty-six years and I retired last spring because my back finally said enough. My husband is Frank. He's sixty-seven. He spent his whole working life as a union electrician, climbing into the rafters of grain elevators in February and pulling new wire through finished homes in July. He has hands the size of dinner plates and a laugh that used to fill the kitchen.\n\nI'm not a doctor. I'm not anything fancy. I'm just a wife who has sat across from the same man at the same kitchen table every morning for four decades and I notice things.\n\nI notice when his eggs get cold because he's too tired to lift the fork. I notice when his thumb shakes for half a second before it stops. I notice when he holds the coffee mug differently than he used to.\n\nI noticed the day his hands stopped wrapping all the way around the mug.\n\nIt was a Tuesday in March, three years ago.\n\nHe didn't say anything. I didn't say anything. But I saw it. The mug was the same mug. His hands were not the same hands.\n\nYou don't get to be married to a man for forty-one years and miss something like that.\n\nI'm going to tell you a story.\n\nI'm going to tell you about Frank and what I watched happen to him, and what I finally figured out after I stopped trusting people in white coats more than my own eyes.\n\nI'm telling you because the man in the Carhartt jacket at the gas station could have been Frank.\n\nIt could have been your husband.\n\nIt could have been you.\n\nAnd I don't want you to wait as long as we did.\n\nFrank and I met at a wedding in 1983. Mutual cousins. He had a mustache then. I had a perm. We danced one slow song and he stepped on my foot and apologized seven times and I knew before the song was over.\n\nWe were married eight months later in a Lutheran church in our hometown and he was wearing the same suit his father wore in 1958.\n\nHe went straight from high school into the apprentice program at the local union hall. By the time he was thirty he was the man they sent up on the worst calls. Frozen substations. Lightning damage at three in the morning. The bad jobs.\n\nHe could read a wiring diagram the way some people read the newspaper.\n\nHe came home from work every night smelling like burned dust and coffee, and he'd kiss me on the cheek before he washed his hands, and he'd ask what I'd put in the slow cooker.\n\nThat was our life.\n\nWe raised two kids in a house he wired himself. Our son David is a county sheriff's deputy two towns over. Our daughter Karen teaches third grade and has two boys of her own. The youngest, our grandson Toby, just turned two.\n\nToby is the whole reason I'm writing this.\n\nI have to start before the trouble started, because if I don't, you won't understand what I mean when I say my husband used to be a different man.\n\nWhen Frank turned fifty-five, he could still throw a fifty pound bag of feed onto the back of the truck without making a sound. He could shovel the driveway after a foot of snow and come in pink-cheeked and ready for breakfast.\n\nHe worked through the day, came home, ate, watched a few innings of the Cardinals game, and walked the dog before bed.\n\nHe never sat still.\n\nHe fixed our neighbor's broken porch light for free. He drove our nephew to baseball practice when our brother-in-law was working nights. He kept a list of widows in town and once a week he'd swing by one of their houses and ask if they needed anything moved, lifted, or fixed.\n\nThat's who he was.\n\nI am telling you all this not because I want you to be impressed by my husband. I want you to picture him clearly. Because the man I just described is not the man who set our grandson back down on the floor at Easter.\n\nThe slide started slow.\n\nIt always does. That's part of why I missed it for so long. If a man falls off a cliff, you see it. If a man walks down a long, slow hill for nine years, you don't notice he's at the bottom until you turn around and look up.\n\nI'm going to walk you through those nine years.\n\nI'm going to tell you what I saw every year. Some of it is small. Some of it is the kind of thing a person might dismiss. But put together, it's a map. And I want you to have the map, in case you're standing on one of the steps right now and don't know it.\n\nYear one was 2016.\n\nFrank was fifty-eight.\n\nHe had his yearly physical in February. Our family doctor at the time was a man named Dr. Henley. Older, kind, talked slow. He told Frank his numbers were \"the best in the county.\" Said it twice. Said Frank could be a poster on the wall.\n\nFrank's only complaint that year was that his left calf cramped at night. Not bad. Just enough to wake him up some nights.\n\nDr. Henley said to drink more water. Eat a banana before bed. The pills can do that sometimes, he said. Nothing to worry about.\n\nFrank had been on Lipitor for two years at that point. He started taking it after a routine check turned up a borderline reading. His own father had died of a heart attack at sixty-six. So Frank took the pill. He was disciplined about it. He took it with breakfast. Every morning. Forty milligrams.\n\nThat was year one.\n\nJust a little cramp. Just a banana before bed.\n\nYear two was 2017.\n\nFrank started skipping his second cup of coffee.\n\nFor thirty-five years, Frank drank three cups of coffee in the morning. Black. No sugar. He poured the second one before he'd finished the first. It was a rhythm, like a metronome.\n\nIn the summer of 2017, he started leaving the second cup half-finished.\n\nI asked him about it. He said his stomach felt off. He said maybe he'd been pushing himself too hard.\n\nHe had not been pushing himself too hard. He had been pulling fewer overtime shifts that year because he said he was tired by Wednesday. He'd never been tired by Wednesday in his life.\n\nDr. Henley's appointment that year went the same as the year before.\n\n\"Your numbers are wonderful, Frank. Whatever you're doing, keep doing it.\"\n\nI sat in the corner of the exam room. I always went with Frank. He said he liked the company. The truth was, I'd started going because I wanted to hear what the doctor said with my own ears.\n\nI asked Dr. Henley about the cramps and the tiredness.\n\nHe said, \"Some of that's just being fifty-nine. Some of that is muscles. We can switch to a different statin if it gets bad, but the numbers are too good to fuss with right now.\"\n\nThe numbers were too good to fuss with right now.\n\nI wrote that down in a little notebook I started keeping. I have the notebook in front of me as I write this.\n\nYear three was 2018.\n\nFrank turned sixty.\n\nWe threw him a party in the backyard. Our daughter Karen brought a sheet cake from the grocery store. Our son David grilled brats. Frank stood in the corner of the yard with our brother-in-law Dale and talked about nothing for an hour.\n\nAfter everyone left, Frank sat down in his recliner. He didn't get up for two hours. He fell asleep with his shoes on.\n\nThat was new.\n\nFrank had never been a man who napped. He used to make fun of his own father for napping.\n\nThat fall, he stopped going up on the roof to clean the gutters. He hired a kid from down the street to do it. Twenty dollars. Frank said it was time to start letting younger men do that kind of work.\n\nI think now that he stopped going up on the roof because he didn't trust his legs.\n\nHe never told me that. He wouldn't have.\n\nYear four was 2019.\n\nFrank started forgetting things.\n\nLittle things at first. Where he set his keys. The name of an actor in an old western. Whether he'd already taken his pill that morning.\n\nHe started leaving notes for himself on the counter. \"Took Lipitor 6:40 AM.\" \"Trash out Tuesday.\" \"Karen called.\"\n\nHe'd never needed notes before.\n\nI bought him a pill organizer. The kind with seven little compartments. He used it without comment.\n\nIn June of 2019 he forgot our anniversary.\n\nWe'd been married thirty-six years. I came down the stairs that morning and the kitchen was empty. No card on the table. No flowers. No nothing. Frank was on the porch reading the paper.\n\nI didn't say anything. I made coffee.\n\nAround lunchtime he looked up from the paper and his face went pale.\n\n\"Maggie. Oh, Maggie. I'm so sorry.\"\n\nHe drove to the grocery store and came back with flowers and a card and the look on his face was not the look of a man who forgot an anniversary. It was the look of a man who didn't know how he could have forgotten an anniversary. It was scared.\n\nI told him it was fine. I told him I was tired anyway and it didn't matter.\n\nThat night I sat in the bathroom and cried for ten minutes with the fan on so he wouldn't hear.\n\nNot because he forgot. Because I had started to suspect, in some small back room of my mind, that something was wrong with my husband that nobody was naming.\n\nThe appointment with Dr. Henley that year was different.\n\nDr. Henley was retiring at the end of the summer. His replacement was a younger doctor named Dr. Maren. She was maybe forty. Sharp glasses. Soft voice. Smart.\n\nShe read Frank's chart in front of us. She looked at the lipid panel.\n\n\"Mr. Hofstetter, these are some of the best numbers I've seen this month. Whatever you're doing, you should bottle it.\"\n\nI leaned forward in my chair.\n\n\"He's tired all the time. He forgot our anniversary. He can't remember the names of people he's known for thirty years.\"\n\nDr. Maren looked at me with a kind of soft patience that I now understand was the most dangerous look in medicine.\n\n\"That's pretty normal at sixty, Mrs. Hofstetter. Especially in men. We all slow down. Have you thought about whether there might be some depression here? Some grief about retirement coming? Frank, are you sleeping well?\"\n\nFrank said he was.\n\nDr. Maren said if the brain fog kept up, Frank might want to see a therapist.\n\nThat was the first time someone suggested a therapist.\n\nI will tell you it was not the last.\n\nYear five was 2020.\n\nEveryone remembers 2020 for the same reason. I remember it for that reason too. But I also remember it because that was the year Frank stopped carrying our grandson.\n\nOur grandson Toby wasn't born yet that year. I'm talking about our older grandson Ethan, who was four.\n\nEthan would run at Frank with his arms in the air. Grandpa, up. Up, up. Frank used to scoop Ethan up like he weighed nothing.\n\nOne Sunday at our daughter's house, Ethan ran at Frank, and Frank knelt down instead of lifting him. Hugged him at eye level. Made it look like a choice.\n\nI watched.\n\nKaren watched.\n\nKaren didn't say anything to me until we were doing dishes after dinner. She said, quiet, \"Mom, is Dad okay?\"\n\nI told her he was fine.\n\nI lied to my own daughter.\n\nThat spring his hands started to ache. Not pain like a hammer hit them. Pain like the inside of the muscle had a low-grade fever. He'd flex his fingers all day long, opening and closing them like he was trying to wake them up.\n\nHe stopped fixing things around the house.\n\nThat was a big one.\n\nFor forty years, when something broke, Frank fixed it. The garbage disposal. The screen door. The starter on the lawnmower. He didn't call repairmen. He was the repairman.\n\nIn May of 2020 the garbage disposal stopped working. Frank looked at it for about three minutes, said his hands weren't up to it that day, and went and got the phone book.\n\nI stood in the kitchen and watched him pay a man a hundred and ten dollars to fix a thing my husband used to fix in his sleep.\n\nI didn't say a word.\n\nYou don't say a word at moments like that. You file them away. You add them to the notebook.\n\nYear six was 2021.\n\nFrank lost weight.\n\nNot a lot. About fifteen pounds across the year. Enough that his belts had to go in a notch. Enough that I noticed his cheekbones in the bathroom mirror in a way I hadn't before.\n\nHe wasn't trying to lose weight.\n\nHe just didn't seem to want food the way he used to.\n\nHe'd push half his dinner around the plate. He'd say it was good. He'd put the leftovers in the fridge and they'd still be there four days later.\n\nHis skin got thinner. The veins on the backs of his hands stood up like ropes.\n\nIn August of 2021 he had his annual physical with Dr. Maren.\n\nShe measured him. Weighed him. Drew his blood. Listened to his heart.\n\nShe came in with the results and her face was warm and reassuring.\n\n\"Frank, your numbers are excellent. Your LDL is at one twelve. Total cholesterol is one ninety-one. Triglycerides are great. The Lipitor is doing exactly what it's supposed to do. We won't change a thing.\"\n\nI asked her, \"Why is he losing weight?\"\n\nShe said, \"Some men just shrink a little in their sixties. As long as he's eating and the blood work is clean, I wouldn't be alarmed. We can talk about a dietitian if you want.\"\n\nI asked her, \"Why are his hands hurting?\"\n\nShe said, \"There can be some muscle ache with statins, but at his dose, and looking at his numbers, the risk isn't worth changing course. Maybe a heating pad. Maybe some gentle stretching.\"\n\nI asked her, \"Why is he forgetting things?\"\n\nShe said, \"Mrs. Hofstetter, has he considered therapy? Or even just journaling? A lot of men have a hard time with this phase of life. He may need someone to talk to.\"\n\nI sat in the chair. I felt my face get hot.\n\nI said, \"He has me to talk to.\"\n\nShe smiled at me the way doctors smile at people who don't know better.\n\n\"Sometimes a professional can help with what a spouse can't.\"\n\nI'm going to be honest with you. I almost said something I would have regretted.\n\nFrank put his hand on my knee. He has always known how to settle me down with a single touch.\n\nWe walked out of that office and he didn't say anything in the car. We drove the twenty-three minutes home in silence and when we pulled into the driveway he just sat there in the passenger seat looking at his hands.\n\nHe said, \"Maggie. I don't feel like myself.\"\n\nI said, \"I know.\"\n\nHe said, \"But the numbers.\"\n\nI said, \"I know.\"\n\nWe sat in the driveway for a long time.\n\nYear seven was 2022.\n\nThis is the year I started losing him a little.\n\nHis personality changed. Not all at once. In drips.\n\nHe was always a funny man. Dry. Iowa dry. He could deliver a punchline so flat you wouldn't know it was a joke until five seconds after. He'd been like that since I met him.\n\nThe jokes stopped.\n\nHe'd sit in the recliner and watch the news and not say anything. He'd answer questions when I asked them. But he wouldn't start conversations.\n\nHe used to call me from his truck on his way home from work, just to say he was thinking of me. Just to ask what I was making.\n\nThose calls stopped years before, when he retired. But the impulse stayed. He used to text me from the grocery store. Pictures of weird products. A bag of Halloween candy in July. A bird that had landed on a shopping cart.\n\nHe stopped texting that year.\n\nHe just shopped and came home.\n\nIn October of 2022 our grandson Toby was born. Frank cried when he held him. Real crying. Shoulders shaking. He hadn't cried like that since his mother died.\n\nWhen he handed Toby back, his arms were trembling. He had to set the baby down on the couch instead of handing him to Karen.\n\nHe laughed about it. Said his arms were rusty.\n\nKaren laughed too.\n\nI didn't laugh.\n\nI went home that night and I added one more line to the notebook.\n\nYear eight was 2023.\n\nFrank slept fourteen hours a day for most of February.\n\nHe'd go to bed at nine. He'd sleep until eight. He'd come downstairs, eat a half a slice of toast, and fall asleep in the recliner by ten thirty.\n\nHe'd wake up around three in the afternoon, eat soup, and be ready to go back to bed by seven.\n\nI asked him if he was depressed. He said he didn't think so. He said he just felt like his body was running on a battery that wouldn't hold a charge.\n\nThat's how he put it. A battery that wouldn't hold a charge.\n\nI made another appointment with Dr. Maren.\n\nShe listened. She nodded. She took notes.\n\nShe drew his blood.\n\nShe came back with the results.\n\n\"Frank, I have to tell you, your numbers look great. Your cholesterol management is honestly textbook. I wish all my patients were as compliant as you are.\"\n\nI said, \"Dr. Maren. I am not asking about his cholesterol. I am asking about the fact that my husband is sleeping fourteen hours a day.\"\n\nShe said, \"I hear you. I do. But I can only treat what the labs tell me to treat. The labs tell me Frank is doing well. If there were something serious going on, we'd see it in the bloodwork.\"\n\nI said, \"Maybe you're looking at the wrong bloodwork.\"\n\nShe got quiet.\n\nThen she said, very gently, \"Mrs. Hofstetter, I think both of you might benefit from talking to someone. We have a referral list for behavioral health services. There's no shame in it.\"\n\nThat was the third time I'd been told to send my husband to a therapist.\n\nThe third time someone in a white coat had looked at him fading in front of their eyes and suggested I'd been imagining it.\n\nI took the referral list. I folded it. I put it in my purse. I never looked at it again.\n\nWe left.\n\nI drove home with my hands tight on the wheel.\n\nFrank dozed in the passenger seat.\n\nI remember thinking, very clearly: nobody is going to help him. Nobody who is paid to look at his chart is going to look at him.\n\nI didn't know yet what I was going to do about that. But something in me had changed.\n\nYear nine was last year.\n\n2024.\n\nEaster weekend.\n\nKaren and her husband Mark and their two boys came up for the holiday. We dyed eggs at the kitchen table. Ethan, now eight, was the master of the wax crayon. Toby, just under two, mostly ate the wax crayons.\n\nWe had ham. We had scalloped potatoes. Karen brought a cherry pie.\n\nAfter lunch the whole family went out into the yard for pictures.\n\nKaren wanted a picture of Frank and Toby. Just the two of them. Grandfather and grandson.\n\nFrank crouched down and held his arms out. Toby toddled over and grinned that big two-year-old grin.\n\nFrank reached down to pick him up.\n\nI want you to picture this carefully, because I will see it for the rest of my life.\n\nFrank got his hands under Toby's arms.\n\nHe bent his knees.\n\nHe started to lift.\n\nHe got Toby maybe a foot off the ground.\n\nAnd then his arms gave out.\n\nI don't mean he set Toby down. I don't mean he hesitated. I mean his arms shook and his shoulders dropped and he had to set Toby back down on the grass before he dropped him.\n\nToby's face crumpled. He thought he'd done something wrong. He thought Grandpa didn't want to pick him up.\n\nHe cried. Hard. The way only a two-year-old can. He toddled away to find his mother.\n\nFrank stayed crouched in the grass.\n\nHe didn't get up.\n\nHe stayed there for what must have been a full minute, staring at his own hands like they belonged to a stranger.\n\nThen he stood up slowly and said he needed the bathroom.\n\nI watched him walk across the yard.\n\nHis shoulders were rounded forward. His feet didn't lift the way they used to. He looked twenty years older than he was.\n\nHe went inside.\n\nHe went into the downstairs bathroom and shut the door.\n\nI sat in the kitchen at the table where I sat every morning of our marriage and I started a stopwatch on my phone.\n\nI don't know why I did that. I just felt I needed to count something.\n\nHe was in there twenty-two minutes.\n\nWhen he came out his eyes were red. He didn't look at anyone. He went into the living room and sat in his recliner and pretended to watch a basketball game even though it was Easter and there was no basketball on.\n\nI went over and sat on the arm of his chair and put my hand on his shoulder.\n\nHe didn't speak.\n\nHe covered my hand with his.\n\nHis hand was so light.\n\nI wanted to tell you that we sat there for a while and then I figured everything out and saved him.\n\nThat is not how it happened.\n\nWhat happened is that I went to bed that night and I lay in the dark and I made a decision.\n\nI decided that no matter how many doctors told me his numbers were good, I was going to find out what was wrong with my husband.\n\nI didn't know where to start. I'm not a doctor. I drove a school bus. I read paperback mysteries and the newspaper and that was about it.\n\nBut I knew people. I'd lived in this county for sixty years. And I knew that somewhere in this world, there had to be someone who would look at Frank instead of at his chart.\n\nSo that's what I did.\n\nI'm going to tell you what I found.\n\nSome of it I learned in a library. Some of it I learned on a borrowed laptop with my reading glasses pushed up on my forehead at one in the morning. Some of it I learned from a woman at our church who used to work in a hospital pharmacy in Chicago.\n\nI'm going to tell it to you in plain words. Because I am not a doctor. And I want you to understand it the same way I understood it. Not from a textbook. From a kitchen table.\n\nThe first thing I learned is that your body does not just make cholesterol because it's lazy.\n\nYour body makes cholesterol because cholesterol is one of the most important things in your body. Every cell wall uses it. Every hormone needs it. Your brain is loaded with it. When your body makes cholesterol, it's doing a job.\n\nThe body uses a path to make cholesterol. Think of it like a kitchen with a long counter. The body puts a few ingredients on one end of the counter and slides them down. As it slides, the ingredients change. By the time the dough gets to the other end, it has turned into cholesterol.\n\nThat counter has a name. The science books call it the mevalonate pathway.\n\nMost people will never hear that word in their life. I hadn't.\n\nHere's the part that stopped my heart.\n\nThe body uses that same counter to make something else.\n\nIt makes CoQ10.\n\nCoQ10 is not a vitamin in a pill bottle. It is a real thing your body makes on its own. It is the spark plug for every cell in your body. Especially your muscles. Especially your heart muscle. Especially your brain.\n\nYour cells have little engines inside them called mitochondria. They are the power plants. They are what turn food into energy. They are what let you stand up, walk, think, lift a grandson.\n\nThe mitochondria run on CoQ10.\n\nNo CoQ10, no energy. No energy, no strength. No strength, no lifting a two-year-old at Easter.\n\nNow here's what statins do.\n\nStatins shut down that counter.\n\nThey were designed to. That's the whole point. They block the mevalonate pathway so the body makes less cholesterol.\n\nBut they don't shut down just the cholesterol end of the counter.\n\nThey shut down the whole counter.\n\nWhen the counter is shut down, the body can't make CoQ10 either.\n\nThat's not a side effect that the statin labels make a big deal about. It is also not new information. There are studies on it going back over thirty years. There are mainstream cardiology papers that talk about it. You can find it in the regular medical literature if you go looking.\n\nI went looking.\n\nI read until my eyes burned. I went to the library and printed papers and read them at the kitchen table with a highlighter.\n\nThe story was the same in every paper.\n\nWhen CoQ10 gets low, muscles ache. Not always sharp pain. Sometimes a deep tired ache that doesn't go away.\n\nWhen CoQ10 gets low, energy drops. Not regular tired. The kind of tired where you sleep fourteen hours and still feel empty.\n\nWhen CoQ10 gets low, the brain fogs over. The right word stops coming. The names of people you've known forever go missing.\n\nWhen CoQ10 gets low, grip strength drops. Hands stop wrapping around the coffee mug the way they used to.\n\nWhen CoQ10 gets low, weight comes off because the muscle is being slowly starved.\n\nEvery single symptom I had been writing in that little notebook for nine years.\n\nEvery single one.\n\nAnd not one of them would ever show up on a lipid panel.\n\nThe doctor was reading the wrong test.\n\nShe wasn't lying to me. She wasn't being cruel. She was reading the test she was trained to read.\n\nThe test does not measure what was happening to my husband.\n\nIt was like trying to find out if a house has termites by checking the temperature of the kitchen.\n\nI sat at the kitchen table the night I figured it out and I cried so hard the dog came over and put his head on my foot.\n\nI cried because for nine years I had been right.\n\nI cried because for nine years I had been told I was wrong.\n\nI cried because we had wasted nine years.\n\nI want to be clear about something here.\n\nFrank's doctors were not bad people. They were trained the way they were trained. The system rewards them for getting the lipid panel to look a certain way. The system does not reward them for asking why their patient can no longer lift a two-year-old.\n\nThe lipid panel is the report card. The patient is the kid.\n\nThe system has been grading the report card and ignoring the kid.\n\nI had spent nine years assuming that if something serious were wrong, the report card would show it. The report card never showed it. The report card was never going to show it. The report card was not built to.\n\nThe patient was telling me. With his hands. With his sleep. With his weight. With his silence at the dinner table.\n\nI had been reading the wrong page.\n\nThen I got up. I wiped my face. I poured a glass of water. And I started looking for what to do about it.\n\nI want to be careful here. I am not telling you to stop your medicine. I am not a doctor. Frank's eventual decisions about his medication were made between him and a new doctor we eventually found three counties over, a man near retirement who actually listens.\n\nWhat I am telling you is what I learned about supporting the body when the body has been running on empty for years.\n\nThe first thing I learned is that your body needs help putting CoQ10 back. Some people use a CoQ10 supplement. Frank tried that. It helped a little.\n\nBut the help that surprised me most came from a different place.\n\nIt came from tea.\n\nSpecifically, from a kind of tea I had only ever heard of in passing.\n\nOolong.\n\nNow, listen. I am from Iowa. I drink coffee. I have never been a tea person. The closest thing to tea in my house growing up was the bag of Lipton my mother kept for when somebody had a fever.\n\nBut I kept reading.\n\nAnd what I learned about oolong tea is not what you'd expect.\n\nThe leaves of the oolong plant are loaded with things called polyphenols. Think of polyphenols as quiet little workers that go through your body and put out the small fires that the bigger systems can't see.\n\nThere are things in your body called free radicals. They are the trash that gets produced when your cells burn fuel. A few free radicals are normal. Too many free radicals damage the inside of your blood vessels. They damage your muscles. They damage your mitochondria.\n\nPolyphenols are like cleanup crews for free radicals. But not all polyphenols are the same.\n\nThe polyphenols in oolong tea, and especially in the whole-leaf kind, are what the research calls selective. That means they go after the bad free radicals without messing up the good signaling molecules the body needs. They don't carpet-bomb. They aim.\n\nThat mattered to me. Because Frank's body had been carpet-bombed for nine years.\n\nThe oolong leaf also has two specific compounds in it that kept showing up in the papers I read. They are called EGCG and theaflavins. The studies on them are not folk wisdom. They are real studies in real journals on cardiovascular and metabolic health. There are over two thousand peer-reviewed papers on these compounds across green and oolong teas. I am not going to ask you to take my word. You can look. I did.\n\nThe third thing I learned was about a hormone called adiponectin. Adiponectin is what your fat cells send out into the bloodstream to keep the rest of your body humming. Healthy adiponectin levels are linked to healthy cholesterol behavior, healthy blood sugar behavior, and healthy inflammation levels. The oolong tea polyphenols help support healthy adiponectin levels naturally.\n\nIt was starting to add up.\n\nI was looking for something that could help Frank's body do what the medication had been keeping it from doing. Something that worked with the body, not against it. Something that could deliver the polyphenols and the EGCG and the theaflavins consistently.\n\nHere's what I found out next.\n\nMost tea you buy at the grocery store is junk.\n\nI don't mean that to be rude. I mean it factually. The tea bags at most stores are made from broken leaves and tea dust, what the industry calls fannings. Those fannings get crushed and exposed to air for so long that most of the polyphenols are gone before the box even hits the shelf.\n\nThe active compounds in tea are alive when they're whole. When you grind them up and stuff them in a paper bag, they lose their punch.\n\nTo get the real medicine of the leaf, you need whole-leaf tea. Carefully processed. Carefully dried. Carefully packed.\n\nThat kind of tea is hard to find. And I'll tell you, when I first started looking, I almost gave up. Most of what's marketed as oolong is the same fannings just labeled fancier.\n\nI also learned something interesting along the way that I want to share with you.\n\nIn countries where oolong tea is the daily drink — parts of southern China, parts of Taiwan, parts of Japan — heart disease rates are noticeably lower than they are here. The researchers who study this argue about why. Some say it's diet. Some say it's lifestyle. Some say it's the tea itself.\n\nI don't have to win that argument to notice that the same populations drinking real, whole-leaf oolong every day are also the populations not filling the cardiology waiting rooms.\n\nThat was not nothing. That was actually a piece of common sense I had been missing.\n\nThen I found PiPi Tea.\n\nA friend from church sent me a link. Her brother in California had been drinking it for two years for blood pressure and he swore by it. He said it was the only oolong he'd ever had that smelled like a real plant instead of a paper bag.\n\nI went to their website.\n\nIt's right here: https://shop.pipitea.com/ppch/sp\n\nI read every word on that page. I'm a slow reader. I take my time. I had been burned by too many promises in my life to just click and buy.\n\nWhat I read was that PiPi Tea is whole-leaf oolong. Not fannings. Not dust. Whole leaves, hand-rolled, slow-processed, packed in a way that keeps the polyphenols active.\n\nThey explained it the way I needed it explained. The polyphenols are selective antioxidants. They neutralize the free radicals that hurt the body without interfering with the ones the body uses for normal signaling. They are loaded with EGCG and theaflavins. They support healthy adiponectin levels.\n\nIn other words, they go after the actual problem.\n\nNot the number on the chart. The thing under the number.\n\nThey had a guarantee on the page that I read three times to make sure I wasn't misreading it.\n\n90-day money-back guarantee.\n\nNinety days.\n\nI want you to think about that. Lipitor has never come with a money-back guarantee. No medication my husband has ever taken has come with a money-back guarantee. Yet here was a tea company saying if it doesn't work for you in ninety days, you get your money back.\n\nThat's a company that's confident in what they're selling.\n\nI'm a careful person about money. I will tell you we live on a fixed income. I drove a school bus. Frank was a union electrician. We did fine. But we are not in a position to throw money at promises.\n\nThe guarantee made me say yes.\n\nI ordered.\n\nThe tea came in a sealed pouch. The leaves were dark and curled up like little snail shells. They smelled like rain and dried grass and something warm. Nothing like Lipton.\n\nI made the first cup that Tuesday morning at the kitchen table where I'd watched Frank's hands stop wrapping around the mug.\n\nFrank drank it.\n\nHe said it tasted like the woods.\n\nHe drank another cup that afternoon.\n\nThat was week one.\n\nI'm going to tell you what happened over the next two months.\n\nI'm not going to embellish.\n\nI am going to tell you what I saw with my own eyes.\n\nWeek two was small.\n\nFrank slept normally on Sunday night. Eight hours instead of fourteen. He came down to the kitchen on Monday morning and made his own coffee. Two cups. He drank both of them.\n\nI sat across from him and watched him drink the second cup the way he used to.\n\nI did not say anything to him about it. I did not want to put a spotlight on something so small.\n\nBut I held my breath and waited.\n\nBy Wednesday of that week, the deep ache in his hands had eased. He told me without me asking. He said, \"Mag, my fingers feel like fingers again.\"\n\nHe flexed them open and closed in front of me at the breakfast table like a man trying out a new pair of gloves.\n\nI had to look down at my plate so I wouldn't cry into my eggs.\n\nWeek three he started taking the trash out without being asked. He had stopped doing that two years ago. I'd take it out on Tuesday mornings before the truck came. That week, I came down on Tuesday and the cans were already at the curb. Frank was at the kitchen table with the paper and a cup of tea.\n\nHe didn't make a big deal of it. He just said, \"I got it this morning.\"\n\nI sat down across from him.\n\nHe poured me a cup from the kettle.\n\nWe drank it together without speaking. There was nothing to say. There was something to feel.\n\nWeek four.\n\nHe went out to the garage on a Saturday morning and came back inside an hour later with the lawn mower fixed.\n\nHe had not fixed the lawn mower in three years.\n\nHe stood in the kitchen and held up the wrench like it was a trophy. He said, \"I think I remember how to do this.\"\n\nI had to leave the kitchen because I did not want him to see me cry.\n\nWeek five he started reading books again. He has a stack of paperback Westerns from a thrift store in town and they had been sitting on his nightstand untouched for two years. I came up the stairs that Wednesday night and he was sitting up in bed with his reading lamp on and a Louis L'Amour open on his chest.\n\nI leaned in the doorway. I said, \"What chapter?\"\n\nHe said, \"Three. The horse just got loose.\"\n\nI went and brushed my teeth and when I came back he was still reading. He read for forty more minutes before he turned out the light.\n\nHe had not been able to focus that long in three years. The fog used to swallow the words on the page within five minutes.\n\nWeek six.\n\nHe picked up our grandson.\n\nToby ran at him in the front yard with his arms up. Up. Up.\n\nFrank scooped him under his arms and lifted him over his head and Toby squealed.\n\nFrank held him there for maybe ten seconds.\n\nThen he set him back down and crouched and kissed his forehead.\n\nI was sitting on the front steps with a glass of iced tea in my hand and I think I cried so hard the neighbors thought somebody had died.\n\nI'd been waiting for that moment for nine years and I almost didn't believe it when it happened.\n\nBy week seven the brain fog had lifted enough that Frank started doing the crossword again. He used to do the Sunday paper crossword every week of our marriage. He'd stopped doing it in 2021 because the words wouldn't come.\n\nI came down to the kitchen one Sunday morning and he was sitting at the table with his reading glasses on and a pencil in his hand. He looked up at me and he said, \"What's a six letter word for stubborn?\"\n\nI said, \"Maggie.\"\n\nHe laughed. A real laugh. The kind that comes from the belly. The kind I hadn't heard in three years.\n\nThen he wrote \"Maggie\" in the squares as a joke and erased it and went back to working.\n\nI stood there at the counter making my own coffee and I felt my whole chest unclench for the first time in maybe a decade.\n\nThat was the moment I knew. Not at the doctor's office. Not at the lab. At the kitchen table with my husband doing a crossword.\n\nWeek eight.\n\nWe went back to the doctor.\n\nNot Dr. Maren. The new doctor we'd found three counties over. The one who listens.\n\nFrank had his blood drawn at the start of the visit. We waited in the exam room for forty minutes for the results.\n\nThe doctor came in with a single sheet of paper. He sat down on the rolling stool and he looked at Frank.\n\nHe said, \"I have to tell you, Mr. Hofstetter. Your numbers look very good. Your LDL is down. Your triglycerides are down. Your inflammation markers are down. This is a better picture than I'd expect from any of my patients in your situation.\"\n\nI sat in the corner chair.\n\nI asked, very politely, \"What about his weight? His sleep? His memory?\"\n\nThe doctor looked at Frank.\n\n\"How are you doing in those areas?\"\n\nFrank said, \"I feel like myself.\"\n\nThe doctor smiled. Not a salesman smile. A doctor who has been doing this for forty years and has seen something that surprises him, smile.\n\nHe said, \"Whatever you're doing, keep doing it.\"\n\nI almost laughed out loud.\n\nI had heard that line every year for nine years.\n\nThis time, for the first time, it was true.\n\nWe left the office and I called Karen from the car.\n\nI said, \"Your father is back.\"\n\nShe was quiet for a long time.\n\nThen she said, \"I knew something was wrong, Mom. I knew it for years.\"\n\nWe had a long cry on the phone, both of us, the kind of cry that finally lets out something you've been carrying for a long time.\n\nI want to tell you that the rest of our story has been easy.\n\nIt hasn't been. Frank still has bad days. He still has days where his hand shakes a little before it stops. But the slow walk down the hill has stopped, and on most days, he is climbing.\n\nHe carries Toby on his shoulders now.\n\nHe fixed the fence on the south side of the property last weekend.\n\nHe laughs at the news again. Dry. Iowa dry. The way he used to.\n\nI drink PiPi Tea every morning with him at the kitchen table.\n\nHe's drinking the third cup of his life by 8 AM most days.\n\nIf any of this sounds familiar, I want to ask you to do one thing.\n\nI want you to go look at the page where I bought what I bought.\n\nIt's here: https://shop.pipitea.com/ppch/sp\n\nI am not asking you to commit to anything. I am asking you to read the page the way I read it. Take your time. Read it twice if you have to. If you don't feel right about it, walk away. The guarantee is ninety days. Ninety-day money-back guarantee. If it doesn't do anything for the person you love, you get your money back.\n\nThat is more than the pill bottle on your kitchen counter has ever offered.\n\nThe cost of that order was less than what we spent at the gas station the day I saw the man in the Carhartt jacket put back the milk.\n\nThat is the truth.\n\nIt is the truth that nobody talks about. Things keep getting more expensive and what we can do for the people we love keeps getting smaller, and the doctors keep telling us our numbers are great, and the people we love keep fading.\n\nThis was one thing that gave my husband back to me.\n\nI am not promising it will give your husband back to you.\n\nI am promising you that, with the guarantee, you cannot lose money trying.\n\nIf you want to read more, the page is https://shop.pipitea.com/ppch/sp\n\nI'll put it again at the bottom in case you scroll past.\n\nP.S. 1\n\nI want you to know this because I wish someone had told us sooner.\n\nI wasted nine years of my husband's life being polite in doctor's offices. Nine years of nodding when I should have been asking. Nine years of writing in a notebook when I should have been pounding the table.\n\nI am not pounding the table now. I am sitting at my kitchen table writing this to you on a Tuesday afternoon while my husband mows the back lot. I can hear the mower from the open window. Three years ago I could not have heard that sound. He could not have started the engine.\n\nI want you to know that the person you love is still in there. The numbers might be hiding them from you. The doctor might be hiding them from you. Your own polite training to defer to white coats might be hiding them from you.\n\nBut they are still there. And there is a real, ordinary, observable thing you can try.\n\nP.S. 2\n\nHere's a small thing I want you to try in the first week.\n\nWatch the morning.\n\nPick the person you love. Watch them get up tomorrow. Watch them sit at the table. Watch their hands as they hold the cup. Watch their eyes when they look at the paper. Watch how long it takes them to start a sentence.\n\nThen do it again in a week, after they've had this tea every day for seven days.\n\nDon't write it down. Don't make a chart. Just notice.\n\nYou will know if anything is different.\n\nYou know that person better than any doctor will ever know them. You have been watching them for years. You are the expert on them. Trust your own eyes the way I should have trusted mine sooner.\n\nP.S. 3\n\nThe reason I finally agreed to try it was the 90-day money-back guarantee.\n\nPiPi Tea offers it. The statin never did.\n\nI have spent thousands of dollars in my life on medicine, on doctor visits, on co-pays, on prescription bottles that ran out before the month did. Not a single one of them came with a money-back guarantee. Not one. The pharmacy will not give you your money back if your husband stops being able to lift your grandson.\n\nNinety days. 90-day money-back guarantee. If you try this and it does nothing for the person you love, you get your money back. That is the deal.\n\nThe page is https://shop.pipitea.com/ppch/sp\n\nP.S. 4\n\nThey go out of stock.\n\nI've seen it happen. I tried to order a second tin in February and had to wait two weeks because they were sold out. They told me the whole-leaf processing takes time and they don't cut corners just because demand goes up.\n\nThey are available right now.\n\nIf you wait, you may end up where I was in February, watching the shelf and counting days.\n\nThe page is https://shop.pipitea.com/ppch/sp\n\nP.S. 5\n\nI want you to have what I almost lost.\n\nI want you to lift the grandchild. I want you to drink the second cup of coffee. I want your husband to laugh at his own jokes again. Please don't wait the nine years I waited.\n\nhttps://shop.pipitea.com/ppch/sp\n\nMaggie","hashtags":[],"mentions":[],"accessibility_caption":null,"likes":null,"comments":null,"views":null,"counts_hidden":null,"comments_disabled":null,"is_pinned":null,"is_paid_partnership":false,"owner":{"id":"866655706540346","username":null,"full_name":"Cholesterol Relief Community","is_verified":null,"is_private":false,"avatar_url":"https://scontent.fqnv8-1.fna.fbcdn.net/v/t39.35426-6/704801774_1307804184087393_1622247990819069384_n.jpg?stp=dst-jpg_s60x60_tt6&_nc_cat=102&_nc_map=urlgen_bucketless&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=I1ULe3hY4egQ7kNvwHmriqP&_nc_oc=Adp1YCl23UJvRbAD-3twNRfpcsmkddbzSfBdNI1ExLb_F9YPIHGKRXJDeEdrTDInDtQ&_nc_zt=14&_nc_ht=scontent.fqnv8-1.fna&_nc_gid=RfazKM_IsAsG4CeN9210aQ&_nc_ss=7b289&oh=00_AQQF07z7CmZoHJWsC8_Wj-8UwKp2VMS6A4ZC487W43I-TQ&oe=6AE6E95E","latest_story_at":null,"extra":{"category":"Community Center","likes":3227,"is_deleted":false,"url":"https://www.facebook.com/866655706540346"}},"coauthors":[],"sponsors":[],"tagged":[],"location":null,"audio":null,"thumbnail_url":"https://scontent.fqnv8-1.fna.fbcdn.net/v/t39.35426-6/710781895_4357881537807857_1908372834204043877_n.jpg?_nc_cat=103&_nc_map=urlgen_bucketless&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=ksXqHTffZPoQ7kNvwGUTKFA&_nc_oc=AdrHUBxwEjHwEIrQysIEMOaplunGgEhZ9Unl4d4vUq1xLx3BvwsX9f0CLIlF6Z9U7D8&_nc_zt=14&_nc_ht=scontent.fqnv8-1.fna&_nc_gid=RfazKM_IsAsG4CeN9210aQ&_nc_ss=7b289&oh=00_AQQltf3zLycWhvf7dmx-ISQVVnzRJSwx9u38S3QCdzc0sQ&oe=6AE6F22E","video_duration":null,"media":[{"kind":"image","url":"https://scontent.fqnv8-1.fna.fbcdn.net/v/t39.35426-6/710781895_4357881537807857_1908372834204043877_n.jpg?_nc_cat=103&_nc_map=urlgen_bucketless&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=ksXqHTffZPoQ7kNvwGUTKFA&_nc_oc=AdrHUBxwEjHwEIrQysIEMOaplunGgEhZ9Unl4d4vUq1xLx3BvwsX9f0CLIlF6Z9U7D8&_nc_zt=14&_nc_ht=scontent.fqnv8-1.fna&_nc_gid=RfazKM_IsAsG4CeN9210aQ&_nc_ss=7b289&oh=00_AQQltf3zLycWhvf7dmx-ISQVVnzRJSwx9u38S3QCdzc0sQ&oe=6AE6F22E","width":null,"height":null,"duration":null}],"media_urls":["https://scontent.fqnv8-1.fna.fbcdn.net/v/t39.35426-6/710781895_4357881537807857_1908372834204043877_n.jpg?_nc_cat=103&_nc_map=urlgen_bucketless&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=ksXqHTffZPoQ7kNvwGUTKFA&_nc_oc=AdrHUBxwEjHwEIrQysIEMOaplunGgEhZ9Unl4d4vUq1xLx3BvwsX9f0CLIlF6Z9U7D8&_nc_zt=14&_nc_ht=scontent.fqnv8-1.fna&_nc_gid=RfazKM_IsAsG4CeN9210aQ&_nc_ss=7b289&oh=00_AQQltf3zLycWhvf7dmx-ISQVVnzRJSwx9u38S3QCdzc0sQ&oe=6AE6F22E"],"extra":{"url":"https://www.facebook.com/ads/library/?id=866569929827744","is_active":true,"end_date":"2026-10-27T07:00:00+00:00","title":"Natural Relief in Weeks","link_caption":"shop.pipitea.com","link_url":"https://shop.pipitea.com/ppch/sp","link_domain":"shop.pipitea.com","cta_type":"LEARN_MORE","cta_text":"Learn more","collation_id":"1541421164361823","collation_count":1,"publisher_platforms":["facebook","instagram","audience_network","whatsapp","threads"],"countries":[],"categories":["UNKNOWN"],"currency":null}},{"id":"914467831604972","shortcode":null,"taken_at":"2026-05-26T07:00:00+00:00","kind":"image","product_type":"IMAGE","caption":"I have been cutting the same man's hair every three weeks for twenty-six years, and last March he sat down in my chair and asked me, very politely, what my name was.\n\nI have known his wife's birthday since 2003. I cut his son's hair before that boy's voice changed. I gave him a Christmas card every year with my own handwriting on it. He has sat in the same chair, the second one from the door, twelve hundred times, give or take.\n\nLast March, on a Tuesday morning around ten, he came in wearing his usual brown coat and his glasses pushed up on his forehead, and he eased himself down into that chair like he always did. I draped the cape over his shoulders and pumped the foot pedal twice to get him up to my working height. I picked up the comb. He looked at me in the mirror, and his eyes were friendly the way a stranger's eyes are friendly at a gas station when you're both buying coffee.\n\nHe said, \"I'm sorry, I'm having one of those mornings. What's your name again?\"\n\nI told him my name was Ray.\n\nHe said, \"Ray. Right. Ray. I'm Bill.\"\n\nI had been cutting his hair for twenty-six years, and he was introducing himself to me.\n\nI finished the cut. I did not say anything about it. I walked him to the register and rang him up for twenty-two dollars, which is what I have charged him for a haircut for the last seven years, and he paid me in cash like he always did, and he tipped me three dollars like he always did, and he said, \"Thanks, Ray,\" and he walked out the door and got in his Buick and drove the three blocks home.\n\nI stood in the front window of my shop and watched his taillights go up Main Street. Then I walked back to my station, opened the drawer under my clippers, took out a small green notebook I had bought that weekend at the Dollar Tree because some feeling in the back of my head had told me I might need it, and I wrote down the date and what had just happened.\n\nThat was the first entry. I have been writing in that notebook for fourteen months now.\n\nI want to tell you about a man named Bill Hennessey, and what happens when a doctor watches a number and a barber watches a person, and the number says everything is fine and the person is disappearing in front of you.\n\nI want to tell you what I figured out, because I figured it out, eventually. I'm not a doctor. I'm a barber. I am fifty-eight years old and I have been cutting hair in a two-chair shop on Main Street in Greenville, South Carolina, since 1998. I cut my first head of hair when I was nineteen, in my uncle's shop in Spartanburg, and I have been doing it ever since. I have watched this town's necks since the Clinton administration. I know who's eating and who's not. I know who's drinking too much and who quit. I know whose marriage is failing because of how they hold their shoulders. I know who's about to have a baby before the wife does, sometimes, because the husband gets a particular kind of quiet.\n\nA barber knows. People don't think we know, because we're just the guy with the scissors, but we know.\n\nAnd what I am telling you is that I watched Bill Hennessey go away over the course of about seven years, and his doctor told him his cholesterol was perfect the whole time, and the day Bill came into my shop with no pants on, I decided I was going to figure out what nobody else was going to figure out, because nobody else was going to.\n\nThat's what this is about. Stay with me.\n\nBill Hennessey is seventy-one years old. He was born in Greer, South Carolina, in 1953. His daddy worked at the textile mill and his mama taught Sunday school at the Baptist church on Hampton Avenue. He went to Greer High School, then he went into the Army for four years, then he came home and married a woman named Janet who he had known since the eighth grade. He worked at the post office for thirty-eight years. He retired in 2016 as postmaster. He has one daughter, Marie, who is forty-four and lives over in Travelers Rest with her husband and two boys.\n\nBill walked into my shop for the first time in the fall of 1999. He had just moved to Greenville from Greer because Janet got a job at the hospital here. He was forty-six years old. He had a full head of brown hair with a little gray coming in at the temples, and he asked me for a regular short back and sides. He told me he was the new postmaster down at the Augusta Road branch. We talked about the Clemson game while I cut his hair, because it was a Saturday and they had played Florida State the night before, and Clemson had lost by twenty-one.\n\nWhen I finished, he looked in the mirror, and he said, \"Ray, you and me are gonna be friends.\"\n\nHe was right. Every three weeks for twenty-six years. Twelve hundred haircuts. You can do the math.\n\nHere is what I knew about Bill Hennessey before March of last year. He drank his coffee black. He took his eggs over medium with bacon, never sausage. He liked the Steelers because his uncle had played for them in the fifties for one season before he blew out his knee. He read three books a week, mostly history, mostly about the Civil War, and he was full of facts about every battle in Virginia. He could tell you the exact regimental movements at Chancellorsville. He had a way of leaning forward in the chair when he was about to make a point, and his eyes would get small and bright, and he would say, \"Now, here's what most people don't understand about Stonewall Jackson...\" and you knew you were in for ten minutes.\n\nHis wife Janet was a nurse. Pediatrics. He was proud of her in the way that only men of his generation are proud of their wives — quietly, devotedly, never bragging but never missing a chance to mention her either. Janet's birthday is February 18. I have known that since he told me in 2003, when he came in three days before and asked me what I thought he should get her, and I told him he should get her a weekend in Asheville at a bed and breakfast, and he did, and she loved it, and he told me about it for two months afterward.\n\nHis daughter Marie was thirty-one when I met her. She came into the shop one Saturday in 2002 to drop off something for him on her way through town, and Bill introduced us, and he said, \"This is my Marie. She is the best thing I ever did.\" Marie had brown hair like his and she had her mother's eyes, and she shook my hand and called me Mr. Ray and I told her just Ray was fine. She would stop in to say hello once or twice a year after that, if she was passing through.\n\nBill was the kind of man who would tell you what his wife made for dinner. Every visit. Every haircut. He'd sit down in the chair and within about thirty seconds he'd say, \"Janet made pork chops last night, Ray, the kind with the apples. I tell you what.\" Or, \"Janet's got a chicken in the oven for tonight, and she's making her cornbread, and I'm gonna die a happy man.\" He told me about his meals for twenty years. I knew Janet's recipes by reputation. I never ate any of them, but I knew them. The pork chops with apples. The chicken and dumplings she made on Sundays in winter. The peach cobbler she made every Fourth of July with peaches from the orchard out on Highway 14.\n\nHe told me about books he was reading. He told me about the Steelers. He told me about a feud he had with his neighbor over a fence line for about eight months in 2009, and he told me about every step of it, and I had opinions about the fence line by the end of it, and we resolved that fence line together over the course of those eight months, both of us, while I cut his hair.\n\nThat was Bill Hennessey.\n\nThe man who sat in my chair last March and asked me my name was not that man. He had been not-that-man for a long time, and I had been watching it happen, and I will tell you exactly how it happened.\n\nThe first thing I noticed was in the spring of 2018. Bill had just turned sixty-five. He came in for his regular cut, and he sat down, and there was a pause before he started talking about Janet's meals, and I noticed the pause. It was maybe four seconds longer than usual. Four seconds is not much, but I had been listening to this man talk for nineteen years at that point, and I knew his rhythms.\n\nHe eventually said, \"Janet made spaghetti last night.\"\n\nThat was it. No story about the sauce. No mention of whether she had used Italian sausage or ground beef. Just spaghetti.\n\nI asked him what kind. He said, \"Just spaghetti, Ray. With the sauce.\" He waved his hand, like the details didn't matter, which was not a thing Bill Hennessey ever did. The details always mattered.\n\nAbout a month after that he told me his doctor had put him on a cholesterol pill. He said it like it was nothing. He said, \"Doc said my numbers were a little high, so he wrote me up for the Crestor. Janet's been after me about my eating, so I guess this'll keep her quiet.\"\n\nI said, \"You feel okay on it?\"\n\nHe said, \"Sure. Don't feel a thing.\"\n\nThat was 2018.\n\nIn 2019, the thing I noticed was the armrests. Bill had a habit, ever since I'd known him, of resting his hands loosely on the armrests of my chair. Loose hands. Open. The hands of a man who is comfortable. Sometime in the spring of 2019 — I want to say it was April — he started gripping them. Not tight, but tight enough that I noticed. His thumbs would press down on the wood. When he got out of the chair he would push himself up with his arms instead of just standing.\n\nI asked him once, that summer, if his hip was bothering him. He said, \"Oh, you know, it's just getting old. Everything starts to hurt a little.\" That was the first time I ever heard Bill Hennessey use the phrase \"getting old.\" Bill was sixty-six.\n\nHe told me he'd been to the doctor for his physical. He said the doctor had looked at his bloodwork and said his cholesterol was, in his own words, \"perfect.\" LDL was down to one-twenty-something from the one-eighty it had been before the Crestor. Triglycerides were down. The doctor had given him a thumbs up and told him to keep doing what he was doing. Bill was pleased about it.\n\nI didn't say anything. I was a barber. The doctor said his numbers were perfect. Who was I.\n\nIn 2020, with the pandemic and all, I didn't see Bill for a couple of months because we were shut down. When we opened back up in May, he came in, and I noticed two things. The first was that he had lost about fifteen pounds, and not in a good way. His shirt collar was loose on him. His face had gone a little hollow around the cheekbones. The second was that he didn't ask me how I was doing. Bill always asked me how I was doing. It was the second thing out of his mouth after he sat down. \"How you been, Ray?\" Every time. For twenty-one years. That day he just sat down and put his head back against the rest and closed his eyes, and we did the whole cut in silence except for me asking him questions and him answering them in two or three words.\n\nWhen he was paying me at the register, he forgot his wallet. He had to drive home and come back. He apologized about six times. He said, \"I don't know what's wrong with me today, Ray. I had it in my hand.\"\n\nThat summer he told me Janet had taken him to a different doctor, a specialist, because she was worried about him. The specialist had run a full panel. The specialist had looked at his bloodwork and told him his cholesterol was \"exactly where we want it.\" LDL was at one-eighteen. The specialist had told Janet not to worry. Bill quoted the specialist to me. He said, \"He told Janet, 'Mrs. Hennessey, your husband's numbers look like a healthy fifty-year-old's. He's doing great.'\"\n\nJanet had asked the specialist about the weight loss, the tiredness, the forgetting things. The specialist had said, and I am quoting Bill quoting the specialist, \"That's just aging, Mrs. Hennessey. Some of this is normal at his age.\"\n\nBill was sixty-seven that summer. He had run a post office. He had been at his daughter's wedding three years before and given a toast that made everybody cry laughing. He was not a man whose mind was supposed to be aging.\n\nBut the numbers were perfect, so what could anybody say.\n\nIn 2021, the thing I noticed was that he stopped talking about the Steelers. The Steelers played that fall, and I asked him what he thought of their quarterback situation, and he looked at me for a second like I was speaking French. Then he said, \"Oh, the Steelers. Yeah. Yeah, they're doing okay, I think.\" That was it. No analysis. No opinion about the receivers. Bill had once explained the Cover 2 defense to me for the better part of a haircut. That fall he could not have told you who the Steelers were playing on Sunday.\n\nHe also stopped reading. He used to bring books with him sometimes. Just to flip through while he waited if I was running a few minutes behind on the previous customer. That stopped. He started just sitting in one of the waiting chairs with his hands in his lap, looking at nothing.\n\nHe went to his regular checkup in November of 2021. Janet went with him. She told me about it the next time she came in to pick him up from his haircut, because she had started driving him by then. She said the doctor had spent ten minutes looking at his bloodwork and three minutes looking at Bill. The doctor had said his cholesterol was excellent, his triglycerides were excellent, his blood sugar was a little high but nothing to worry about, and that the Crestor was, and this is the phrase she used because the doctor had used it, \"doing exactly what it's supposed to do.\"\n\nJanet had said to the doctor, \"He doesn't seem like himself.\"\n\nThe doctor had said, \"Some cognitive changes are normal at his age.\"\n\nJanet had said, \"He's sixty-eight. He was sharper than me a year ago.\"\n\nThe doctor had said, \"Have you considered that you might be noticing things now because you're around him more, since he retired?\"\n\nJanet told me this in my shop, while Bill was sitting in the waiting chair looking at his hands, and I watched her face while she told me, and I saw her decide right there that she was never going to bring it up with that doctor again. Not because she was satisfied with the answer. Because she was tired.\n\nThat was the doctor's job, I started to realize. The doctor's job was to tell you the numbers were fine. If you came in with a person who was not fine, but the numbers were fine, you went home. That was how the system worked.\n\nIn 2022, Bill stopped telling me what Janet had made for dinner. I want you to understand what that meant. For twenty-three years, the man had told me about every meal his wife had cooked the night before, sometimes about the meal she was planning for that night, sometimes about a meal she had made the week before that he was still thinking about. He had told me about pot roasts and meatloaves and chicken and dumplings and pork chops with apples and cornbread and peach cobbler and biscuits and gravy and ham steaks with red eye and shrimp boils on the porch and oyster stew at Christmas. Twenty-three years.\n\nIn 2022, he stopped.\n\nI noticed it after three or four visits. I started asking. I would say, \"What's Janet cooking these days, Bill?\" And he would say, \"Oh, you know. Same old stuff.\" And he would not name a single thing.\n\nMarie called me on the phone in the summer of 2022. I had never given her my phone number, but she had looked the shop up. She said, \"Mr. Ray, this is Marie, Bill Hennessey's daughter.\"\n\nI said, \"Hi, Marie. Just Ray. Everything okay?\"\n\nShe said, \"I wanted to ask you. You see my dad every three weeks. Is he okay?\"\n\nI sat down in my own chair. I said, \"Marie, I don't know what you're hearing, but no. He is not okay.\"\n\nShe told me she had been worried for a while. She told me Janet had stopped saying anything because Janet was scared. She told me she had taken him to a different doctor, a third one, in Asheville, because Janet had asked her to. The doctor in Asheville had run the same bloodwork. The doctor in Asheville had said his cholesterol was excellent. The doctor in Asheville had said, \"Mr. Hennessey, you're doing great for a man your age. Keep doing what you're doing.\"\n\nMarie had asked, \"But Doctor, he doesn't remember what he had for breakfast. He stopped reading. He forgot my mom's birthday this year, and he has never forgotten her birthday in fifty-one years.\"\n\nThe doctor had said, \"Mrs. Brennan, your father is sixty-nine. Some memory loss is normal at his age. His numbers are pristine. The Crestor is working perfectly. I would not change anything.\"\n\nMarie said to me on the phone, \"Ray, what is happening to my dad?\"\n\nI said, \"Marie. I don't know. But I'll tell you this. I have been cutting hair in this town since 1998, and your dad is the third or fourth person I've watched go like this in the last few years, and every one of them had a doctor telling them their numbers were perfect.\"\n\nThere was a long silence on the line. Then she said, \"Thank you, Ray.\" She said, \"Thank you for telling me the truth.\"\n\nIn 2023, Bill stopped pushing himself up out of the chair. He needed a hand. I gave it to him without making a thing of it. I would just stick my hand down and he would take it and I would help him up like he was an old friend, which he was, and he would say, \"Thank you, Ray,\" and that would be the most words he would say to me that visit, sometimes.\n\nHis hair started thinning out, but not the regular kind of thinning. It was patchy. Some weeks I would cut him and there would be a spot above his right ear that was thinner than it had been three weeks before. I would just blend it. I never mentioned it.\n\nHis skin changed. He got these little brownish spots on his temples that hadn't been there before. His ears looked bigger because his face had gotten thinner. The skin on his neck had gone soft, like it had given up holding itself in place.\n\nI knew the difference between a man aging and a man being eaten from the inside. I had watched both. Bill was not aging. Bill was being eaten.\n\nHis doctor told him, in March of 2023, that his bloodwork was \"honestly enviable for a man of seventy.\" The doctor told him he was a model patient. The doctor told him to keep taking his Crestor and not to change anything.\n\nJanet stopped coming to the shop with Bill. Marie started driving him. She would drop him off, sit in the parking lot for forty-five minutes, and pick him up. She would walk him in and walk him out. She would not stay in the shop because she could not bear to watch.\n\nI would sometimes look out the front window during his haircut and see her in the driver's seat of her Honda, looking at the steering wheel.\n\nThat was 2023.\n\nIn 2024, the year of the pants, I started noticing that he didn't remember which chair was mine. He would come in the door and stop and look at both chairs like he didn't know which one he was supposed to sit in. Tony, who had the other chair — Tony has been with me since 2008 — would say, \"Bill, your boy Ray is over there.\" And Bill would look at me and his eyes would clear for a second and he'd smile and say, \"Oh, Ray. Right.\" And he'd come over and sit down.\n\nHe stopped tipping me. Not on purpose. He just forgot. I never said anything about it, because the man had tipped me three dollars a haircut for twenty-five years, and that meant he had given me a tip on roughly twelve hundred haircuts, which is over three thousand six hundred dollars in tips, and if a man forgets to tip you for a few months after twenty-five years of tipping you, you do not say a word about it. You let it go. That is what you do.\n\nIn February of 2024, he came in for his cut and the conversation went like this. He sat down. I said, \"How you doing, Bill?\" He said, \"Pretty good, Ray, pretty good.\" I said, \"Janet okay?\" He said, \"Oh, Janet. Yeah.\" There was a long pause. I said, \"Anything new?\" He said, \"Not really. Not really.\" That was the entire conversation in the chair that day. About forty seconds of talking spread over a thirty-minute haircut.\n\nHis Crestor was, his doctor had said two months before, \"still doing exactly what it should do.\"\n\nIn March of 2024, on a Friday morning around nine, Bill came in for his haircut. And what happened that morning is what made me start the notebook.\n\nI want to tell you about that Friday in detail, because that Friday is when I stopped being the guy who watches and started being the guy who figures it out. Every word of what I am about to tell you is exactly what happened.\n\nIt was March 22, 2024. It was a Friday. The weather was cool but it was supposed to warm up later. There had been rain the night before, and the gutters out on Main Street were full of leaves and water.\n\nMarie dropped Bill off at the shop at 8:55. I saw her car pull up. I watched her get out of the driver's seat and walk around to the passenger side and open the door for him and offer him her hand. He took it and stepped out. He was wearing his brown coat, the same one he had been wearing all winter, and his black dress shoes that he had owned since 2014, and he had on a button-down dress shirt that I recognized because he had worn it three weeks before to his previous haircut.\n\nHe had not changed his shirt in three weeks.\n\nThat was the first thing I noticed, looking through the front window. But I had noticed things like that before with Bill in the last year. I figured Janet was wearing out and not catching everything. I did not yet realize what I was looking at.\n\nMarie walked him to the door. She caught my eye through the glass and gave me a tight little smile that meant something I couldn't fully read yet. Then she went back to her car and got in and sat there.\n\nBill came in. He stopped just inside the door and looked at the two chairs. Tony was in his chair finishing up a young guy who works at the auto parts store, and I was empty. Tony said, \"Hey, Bill, your boy's over there.\" Bill turned and looked at me. He smiled. He walked over.\n\nHe sat down in my chair. He sat down differently than usual. He sat down without taking off his coat. I usually had him take off the coat first because the cape doesn't hang right over a winter coat. I said, \"Bill, let me take that coat for you.\" He stood up halfway and let me slide the coat off his shoulders.\n\nThat is when I saw that Bill Hennessey was not wearing pants.\n\nHe was wearing boxer shorts. White boxer shorts with little blue diamonds on them. He had on his black dress shoes and his dress socks, pulled up to mid-calf, and his shirt was tucked into the waistband of the boxer shorts, and he had been walking around outside in the cold March air and sitting in his daughter's car and walking into my barber shop, and he was not wearing pants.\n\nI will tell you what happened in my head in the half second after I saw this. I felt my face go hot. I felt my stomach drop. I felt a kind of grief I had not felt since my own daddy died in 2009, which is a particular kind of grief that has nothing to do with the moment you're in. I felt rage at his doctor. I felt rage at the second doctor. I felt rage at the doctor in Asheville. I felt rage at the post office for letting him retire without anyone noticing what was already starting in 2016. I felt a kind of love for Bill Hennessey that was so big it scared me, because I am not a man who feels love for his customers in a way that scares him.\n\nI felt all of that in about half a second. And then I did what I was going to do, which was finish the haircut.\n\nI draped the cape over him. I made sure the cape covered him all the way down to his knees, where it normally fell. I tightened it at the neck. I tilted his head down a little, the way you do, and I said, \"All right, Bill. Same as always?\" And he said, \"Same as always, Ray.\" And I started cutting his hair.\n\nI cut his hair carefully. I did the back first. I did the sides. I did the top last, the way I always did. I was talking to him about nothing the whole time. I was telling him about the weather. I was telling him a story about my nephew who had just bought a truck. I was telling him whatever came out of my mouth. He was nodding along and saying, \"Mhm. Mhm.\" His eyes in the mirror were calm. He had no idea he was not wearing pants.\n\nI made the cut take longer than it needed to. I wanted to give myself time to think. I cleaned up the back of his neck with the straight razor twice when I usually only do it once. I trimmed the eyebrows even though they didn't need it. I asked him if he wanted the ear hair done and he said, \"If you think so, Ray,\" and I said, \"I think so,\" and I did it.\n\nWhile I was doing all of that, I was figuring out how to get Bill out of my shop without anybody seeing he was not wearing pants. Tony was at his chair. Tony's customer was still in the chair, with about ten more minutes to go on a beard trim. The front window of my shop faces Main Street, which has people walking past it all morning. The front door is right at the front of the shop. If I walked Bill out the front door, somebody on the sidewalk was going to see him walking to his daughter's car with no pants on, and Bill Hennessey, postmaster of Greer for the better part of forty years, the man who carried himself with the dignity of a small-town federal employee for his entire adult life, was going to be the guy in Greenville who walked down Main Street in his underwear. And that was going to be his thing for the rest of his life and after he died. And I was not going to let that happen.\n\nThe back of my shop has a door that goes out into a little alley between my building and the one next door, where I keep my trash cans. The alley comes out onto a side street.\n\nI finished the cut. I took my time brushing the loose hair off his neck. I held up the hand mirror and showed him the back, the way I always did, and he nodded the way he always did and said, \"Looks good, Ray.\" I undid the cape, slowly, and gathered it carefully so I held it in front of him as he stood up, blocking the view.\n\nI said, \"Bill, let me grab your coat for you, buddy.\" I went over and got his coat. I held it open and I held it low so it would cover him as he put it on. He shrugged it on. I buttoned the top two buttons myself. The coat came down to about mid-thigh on him.\n\nI said, \"Bill, you know what, I left something out back. Come on out with me for a second.\"\n\nHe said, \"Okay, Ray.\"\n\nI walked him to the back of the shop, my hand on his elbow, like we were old friends taking a walk together, which we were. We went through the little hallway past the bathroom and out the back door into the alley. The alley smelled like the dumpster from the Chinese place on the corner. There were puddles on the ground from the rain.\n\nI closed the back door behind us. I leaned against the brick wall. I pulled out my phone.\n\nI said, \"Bill, you wait right here for me one second, okay? I'm gonna call Marie real quick.\"\n\nHe said, \"Okay, Ray.\"\n\nHe stood in the alley in his coat and his boxer shorts and his dress shoes. He looked perfectly content. He was looking up at a piece of fluff caught in the gutter. He was not cold.\n\nI called Marie.\n\nShe picked up on the first ring. She said, \"Ray?\"\n\nI said, \"Marie, honey, I need you to drive around to the back of the building. He's not wearing pants.\"\n\nThere was a long, long silence.\n\nThen she said, \"Oh my god.\"\n\nThen she said, \"Oh my god, Ray, I'm so sorry. I didn't even — he came down the stairs ready to go. He had his coat on. He always — I just —\"\n\nI said, \"Marie. Marie. It's okay. I got him. He's standing here with me. He's fine. He's calm. He just needs to come home. I want you to drive around to the back. Take the alley off of Pendleton. You'll see us standing here. Pull right up to the door. We'll get him in the car.\"\n\nShe said, \"Okay. Okay. I'm coming. I'm coming right now.\"\n\nI hung up. I put the phone in my pocket. I leaned against the brick wall. I looked at Bill Hennessey standing in the alley in his boxer shorts looking up at the gutter.\n\nI said, \"Bill, you doing okay?\"\n\nHe said, \"I'm good, Ray. Real good.\"\n\nI said, \"Marie's coming around to pick you up here in just a minute. Easier than walking around the front. Okay?\"\n\nHe said, \"Sounds good, Ray.\"\n\nI waited. I felt my eyes go hot. I did not cry. I have not cried since 2009. But I felt my eyes go hot and I felt something break in me, in the alley behind my shop, and I made a decision that I want you to understand.\n\nI decided that I was going to figure out what was wrong with Bill Hennessey. I was not going to trust a doctor to do it. The doctors had told him for six years his numbers were perfect. The numbers were perfect and the man was standing in an alley in his underwear with no idea he was not wearing pants. I was going to figure out the gap between the numbers and the man, and I was going to do it because I owed it to him, because I had been cutting his hair for twenty-six years and he had told me about his wife's pork chops and his Civil War books and his Steelers and his fence line, and now he could not remember my name, and the doctors said his cholesterol was perfect.\n\nMarie pulled up. She got out of the car. She was crying. She had a pair of his sweatpants over her arm. She had grabbed them on the way out the door. She helped him into the back seat. She got the sweatpants on him in the car, sitting beside him in the back seat, while I held the door open from the alley.\n\nShe looked at me. Her face was wet.\n\nShe said, \"Ray, what do I do?\"\n\nI said, \"Marie. You drive him home. You sit with your mama. You give yourself a day. And then you call me. Because I am going to look into something. I have an idea. I'm not promising anything. But I'm going to look. And when I know something, I will call you.\"\n\nShe nodded. She closed the door. She walked around to the driver's side. She got in. She drove away.\n\nI stood in the alley for about five minutes after she left. Then I went back inside. Tony was finishing up his customer. He looked at me when I came in. He said, \"Bill okay?\"\n\nI said, \"Bill is not okay. Bill is in trouble. But he's gonna be okay because I'm gonna figure it out.\"\n\nTony said, \"Ray, what are you gonna figure out? You're a barber.\"\n\nI said, \"Tony, I am the only one looking. So I'm the only one who's gonna find it.\"\n\nThat night I went home and I sat at my kitchen table with my notebook open in front of me, and I started a list of everything I knew about Bill, every change I had watched over six years, and I wrote down a question at the top of the page. I wrote, \"If his numbers are perfect, why is he dying?\"\n\nThat was my question. And the next morning I started looking for the answer.\n\nI want to tell you about Mr. Thuan and Mr. Linh, because they are the first reason I started looking in the direction I started looking.\n\nMr. Thuan and Mr. Linh own the nail salon two doors down from my shop. They have owned it since 2004. Mr. Thuan is seventy-eight. Mr. Linh is seventy-five. They are brothers. They came over from Vietnam in the seventies, after the war, and they ran a couple of restaurants up in Charlotte before they moved down here and opened the salon. They cut my hair sometimes when their wives need them out of the house, which is a joke I have made many times and they always laugh at, and I cut theirs, and we have known each other for twenty-one years.\n\nI want you to understand who Mr. Thuan is at seventy-eight. He runs a nail salon. He still works behind the desk five days a week. He does the books. He drives himself to work in a 2019 Toyota. He plays in a poker game on Thursday nights with three other Vietnamese men at the Buddhist temple on Wade Hampton Boulevard. He reads two newspapers every morning, one in English and one in Vietnamese. He goes fishing every Saturday morning with his grandson out at Lake Hartwell. He remembers everyone's name who walks into his salon. He remembers the names of their kids.\n\nMr. Linh is seventy-five. He runs the front desk on weekends when Mr. Thuan takes off. He is a little quieter than his brother, but he is just as sharp. He won a chess tournament at the Asian American Cultural Society last year. He won it. At seventy-five.\n\nThe morning after Bill came into my shop without pants on, I went next door to the salon. I stopped in before I opened up. Mr. Thuan was sitting at the front desk with his English newspaper in his hands and a cup of tea steaming on the desk in front of him. He always had a cup of tea in front of him. Always. Twenty-one years, and there had always been a cup of tea on the desk.\n\nI sat down across from him. I said, \"Mr. Thuan, I want to ask you a question.\"\n\nHe folded his paper. He smiled. He said, \"Mr. Ray. Of course.\"\n\nI said, \"Mr. Thuan, you are seventy-eight years old. You work five days a week. You read the paper. You remember everyone. You go fishing. You drive yourself.\"\n\nHe said, \"Yes.\"\n\nI said, \"How many people you know your age that are like you?\"\n\nHe thought about it. He said, \"Many. Many people my age. My friends. My brother. The men I play cards with on Thursday. All sharp. All working still, most of us. My friend Mr. Phan still runs his restaurant. He is eighty-three.\"\n\nI said, \"Mr. Thuan, in this town, the white men your age, I am watching them go away. I cut their hair. I have known them for twenty, twenty-five years. They are all on cholesterol pills. Their doctors all tell them they are doing great. And every single one of them is fading. Their wives drive them to the shop. They don't remember my name. They don't remember what they had for breakfast.\"\n\nHe listened to me. He nodded slowly. He picked up his tea and sipped it.\n\nI said, \"Mr. Thuan, what do you do that they don't do?\"\n\nHe looked at me for a long time. Then he tapped the side of his teacup with his finger.\n\nHe said, \"Mr. Ray. We drink tea.\"\n\nI said, \"Tea.\"\n\nHe said, \"Tea. All my life. From a little boy. My mother gave me tea. My grandfather. Every day. All my life. Oolong tea. The men in my country who live to be very old, they all drink the oolong. Always. It is what we do.\"\n\nI said, \"Tea.\"\n\nHe said, \"Yes, Mr. Ray. Tea.\"\n\nI sat there for a minute. I thought about it. I thought about all the cups of tea I had seen on his desk for twenty-one years. I thought about how every time I had ever stopped in the salon, Mr. Linh or Mr. Thuan had offered me a cup of tea, and I had always said no thank you because I was a coffee drinker, and now I was sitting there at fifty-eight years old wondering if maybe coffee was the wrong choice.\n\nI said, \"Mr. Thuan. Could I have a cup of that tea?\"\n\nHe laughed. He got up. He poured me a cup from his pot. He handed it to me. It was warm and the steam came up off it and it smelled like nothing I had ever smelled before. A little earthy. A little sweet. A little something else I couldn't place.\n\nI drank it. It was good.\n\nI said, \"Mr. Thuan, where do you get this?\"\n\nHe said, \"We get from a Vietnamese family in California who has been in the tea business many generations. But you can also get good oolong online now. Many places. The good ones are good.\"\n\nI said, \"Thank you, Mr. Thuan.\"\n\nI went back to my shop. I opened up. I cut hair all day. But I was thinking the whole time.\n\nThat night I went home and I sat at my kitchen table again with my notebook. I wrote at the top of a new page, \"Mr. Thuan = sharp at 78 = drinks oolong tea all his life.\" I wrote underneath, \"Bill = falling apart at 71 = drinks coffee, takes Crestor, sees doctor every 6 months.\"\n\nThen I got out my laptop and I started reading.\n\nI want to tell you what I read, because I am going to lay this out the way I figured it out, step by step, because I think you need to understand it the way I understood it, because once I understood it everything made sense and I had been confused for six years.\n\nThe first thing I learned is that cholesterol — the thing the doctor tests, the LDL number, the thing the Crestor brings down — is not what kills you. I want to repeat that because I had to read it three times before I believed it. Cholesterol itself is not what kills you. Cholesterol is just a fat molecule that is supposed to be floating around in your blood. It is part of how your body works. Every cell in your body needs cholesterol. You need it. Your brain is mostly cholesterol. Your hormones are made from cholesterol. Without cholesterol, you die.\n\nSo why does the doctor want to lower it?\n\nBecause of a thing called plaque. Plaque is what clogs your arteries. Plaque is what causes heart attacks. Plaque has cholesterol in it.\n\nThe doctors decided, decades ago, that if cholesterol is in plaque, then lowering cholesterol must lower plaque. So they invented a drug — the statin, like Crestor — that lowers the cholesterol number. The number goes down. The doctor is happy. The patient gets a thumbs up.\n\nBut here is what they were missing. Here is the thing I read at 11:30 at night in my kitchen in March of last year that made me sit back in my chair and go, \"Oh.\"\n\nIt is not the cholesterol that goes into the plaque. It is the OXIDIZED cholesterol that goes into the plaque.\n\nRegular LDL cholesterol — the kind your body makes on its own, the kind that is supposed to be in your blood — does not stick to your artery walls. It floats by. It does its job. It goes home. It does not cause heart attacks.\n\nIt is only when LDL gets damaged — oxidized — that it becomes sticky. It is only when free radicals attack the LDL particles and oxidize them that they start clinging to the walls of your arteries and forming plaque.\n\nSo the real enemy is not cholesterol. The real enemy is OXIDATION.\n\nAnd here is the part that broke my heart. The statin lowers your cholesterol number. It does not stop the oxidation. The free radicals are still there. They are still attacking. Whatever LDL you have left — and you have to have some, because your body needs it — is still getting oxidized. The plaque is still forming. The damage is still happening.\n\nThe doctor watches the number go down. The doctor is happy. The doctor tells you everything is perfect. Meanwhile, behind the number, the actual process that destroys your arteries is going on unchecked.\n\nIt is like — and this is the comparison I came up with at my kitchen table, and I am going to use it the rest of my life — it is like unplugging the smoke alarm instead of putting out the fire. The alarm stops going off. You think the problem is solved. The house keeps burning.\n\nThat is what the Crestor was doing for Bill. It was unplugging his smoke alarm. The number looked great. The fire was still burning. He was burning. From the inside. For six years.\n\nI read more. I read about what damages your arteries when the oxidation is unchecked. I read about how it affects the small blood vessels first — the tiny ones — and how the smallest blood vessels in your body, the ones that show damage first, are the ones in your brain. The microvasculature. That is the word. The tiny vessels that feed your memory, your reasoning, your sense of who you are. They go first.\n\nI sat back. I thought about Bill forgetting my name. I thought about Bill standing in an alley in his underwear.\n\nI thought, This is what they have been doing to him. The doctors have been watching his cholesterol number and telling him he was fine while the actual mechanism that was destroying his brain went on unaddressed.\n\nThen I read about how to fight oxidation.\n\nYou fight oxidation with antioxidants. Antioxidants are molecules that neutralize free radicals. They donate an electron to the free radical so it doesn't go around stealing electrons from your LDL particles. Antioxidants stop the oxidation.\n\nThe problem is that not all antioxidants are useful. Most of the ones people take in pills — Vitamin C, Vitamin E — get used up too quickly. Or they work in the wrong place. Or they are not selective enough. They neutralize the bad free radicals but also neutralize the good ones your body needs.\n\nThe really good antioxidants — the ones that work in the cardiovascular system, the ones that protect LDL specifically from getting oxidized — are a class of molecules called polyphenols. Polyphenols are found in plants. They are what gives plants their color and their bitterness.\n\nThe richest source of cardiovascular-protective polyphenols, I read that night, is the oolong tea plant. The Camellia sinensis leaf, processed in the half-fermented way that produces oolong specifically, contains a particular combination of polyphenols — including EGCG and theaflavins — that have been studied extensively for cardiovascular support. The polyphenols in oolong tea act as what they call selective antioxidants. They specifically target the destructive free radicals — the hydroxyl radicals, the peroxynitrite — that oxidize LDL. They leave the helpful free radicals alone. They are smart missiles where Vitamin C is a carpet bomb.\n\nThe polyphenols in oolong tea have been studied for cardiovascular support for decades. There are over a thousand papers on it. The populations in the world that drink the most oolong tea — southern China, parts of Vietnam, parts of Japan — have, every study confirms, lower rates of cardiovascular disease, lower rates of cognitive decline in old age, and longer lifespans than populations that don't.\n\nI sat back in my kitchen chair.\n\nI thought, This is Mr. Thuan. This is Mr. Linh. This is Mr. Phan who is eighty-three and still runs a restaurant. They have been drinking the antioxidant for their cardiovascular system for their entire lives. The polyphenols have been protecting their LDL from oxidation for seventy-eight years. The smoke alarm has not been unplugged. The fire has not been burning.\n\nThis is why they are sharp at seventy-eight. This is why their hair is full. This is why they still drive themselves. This is why they remember everyone's names.\n\nThis is what Bill never had.\n\nThen I went looking for a brand. I am not going to make you sit through the two weeks it took me to find one I trusted. I read a lot of websites. I bought a few different ones. I made tea every morning before work. I tasted them. I read the labels. I read about how they processed the leaves. I read reviews from real people.\n\nThe one I settled on is called PiPi Tea.\n\nPiPi Tea is whole-leaf oolong. They do not powder the leaf. They do not use the dust at the bottom of the bag. They do not use stems. They use the whole leaf, processed in the traditional way, so the polyphenols are preserved. Most teas you buy at the grocery store have been so heavily processed that the polyphenol content is a fraction of what it should be. The leaves are broken. The compounds are oxidized in the bag before you ever drink them.\n\nPiPi Tea is processed the way the Vietnamese family that supplies Mr. Thuan processes their tea. Whole leaf. Minimum processing. Maximum polyphenol preservation.\n\nI called Marie. I told her I had figured something out. I told her to come by the shop on her way home from work.\n\nI told her everything I just told you. The oxidation. The smoke alarm. The polyphenols. Mr. Thuan. The oolong. PiPi Tea.\n\nI gave her my own bag, the one I had ordered the previous week and just opened. I told her, \"Marie, this is not a miracle. This is not going to fix everything overnight. I am not telling you to take him off his Crestor. That is between you all and his doctor. What I am telling you is that the Crestor is treating the wrong thing. It is watching the cholesterol number, and the real problem is the oxidation, and the oxidation has not been treated. The polyphenols in this tea are what treats it. The men I know in this town who are seventy-five and eighty and sharp as anything have been drinking this their whole lives. Let your dad start drinking it. Two or three cups a day. See what happens.\"\n\nShe took the bag. She held it in her hands. She said, \"Ray, do you really think this could help him?\"\n\nI said, \"Marie, I have watched this town's necks for twenty-six years. I am telling you what I see. The men who drink this don't end up like your dad. Get him drinking it. Order more for him. Try it for ninety days. PiPi Tea comes with a ninety-day money-back guarantee. If nothing changes in ninety days, you send the rest of it back and you get your money back. You are not risking anything except the time it takes to make a cup of tea.\"\n\nI wrote the URL down for her on a piece of paper. I wrote https://shop.pipitea.com/ppch/sp. I told her she could get more from there.\n\nShe put the bag in her purse. She hugged me. She left.\n\nThat was March 28, 2024.\n\nI am going to tell you what happened over the next twelve weeks, because I want you to understand that this is not something I am making up. This is what I watched, from my chair, every three weeks, as Bill Hennessey came in for his haircuts. I have all of it in my notebook. I am reading from the notebook as I write this.\n\nThe first visit after Marie started him on PiPi Tea was April 12, 2024. Three weeks after the pants. Marie dropped him off and walked him in. She caught my eye from the door and gave me a little look that I read as, \"Maybe.\"\n\nBill sat down in my chair. I draped the cape. I said, \"How you doing, Bill?\" And he said, \"Pretty good, Ray.\" And then he said something I had not heard him say in over a year. He said, \"How you been?\"\n\nThat was it. Three words. \"How you been.\" But I wrote it down in the notebook that night. Because Bill had not asked me how I was doing in fourteen months.\n\nHe didn't have much else to say in the chair that day. But he had asked me how I was doing. That was something.\n\nI cut his hair. When I was done, I helped him up out of the chair, and as I helped him up he said, \"Thanks, Ray.\" Two words. But the \"thanks\" had a little weight in it. A little of the old Bill. The Bill who looked you in the eye when he thanked you.\n\nThe second visit was May 3, 2024. Six weeks in. Marie dropped him off and this time she came in with him and stayed in the waiting chair. I noticed her sitting there. I had not seen her sit in the shop in over a year. She was watching him.\n\nBill sat down. I said, \"How you doing, Bill?\" He said, \"Doing all right, Ray.\" Then he said — and I have this written down — \"Janet made meatloaf last night. The kind with the brown sugar on top. It was real good.\"\n\nHe had not told me what Janet had made for dinner in more than two years.\n\nI almost dropped my comb.\n\nI looked at Marie in the mirror. She was looking at me. She had her hand over her mouth. Her eyes were wet.\n\nI said, \"That sounds real good, Bill.\"\n\nHe said, \"Yeah. She put a little Worcestershire in the brown sugar. First time she's done that. Real good.\"\n\nI cut his hair. He told me a few more things. He told me his grandsons had come over Sunday. He told me one of them had lost a tooth. He told me that his neighbor — the one he had had the fence line fight with in 2009 — had moved away last fall, and there was a new family in the house now, and he didn't know them yet but they had a yellow Lab puppy.\n\nHe had not given me that kind of information in over two years.\n\nMarie walked him out. As they were leaving she squeezed my arm and didn't say anything because if she had tried to say anything she would have cried, and Bill was right there. I just nodded at her.\n\nThat night I wrote in the notebook, \"Six weeks. Meatloaf. The grandsons. The puppy. Something is happening.\"\n\nThe third visit was May 24, 2024. Nine weeks in. Bill walked in by himself.\n\nI want you to read that again. Bill walked into my shop by himself. Marie was not with him. He had driven himself.\n\nHe walked in the door and he saw me and he said, \"Hey, Ray,\" and he came right over to my chair without looking at Tony's chair or hesitating about which one was mine. He sat down. He took off his coat himself before I had to ask. He folded it over his lap. He looked at me in the mirror and he smiled, and his eyes were the eyes of Bill Hennessey.\n\nHe said, \"How you been, Ray? How's the shop?\"\n\nI said, \"Shop is good, Bill. How you been?\"\n\nHe said, \"I've been better than I've been in a while. You know what, I don't know what it is. I've just been feeling better. I'm sleeping better. I've been reading again. I finished a book about Lee at Gettysburg last week, and I have to tell you about it because there's a part about the second day that I had never read about before.\"\n\nHe talked for the entire haircut. He talked about Lee at Gettysburg. He talked about Janet's cooking. He talked about the new family next door with the yellow Lab and how he had introduced himself and the husband worked at the Michelin plant and they had three kids. He talked about the Steelers and how their new quarterback was promising. He talked about a fishing trip he wanted to take with his grandsons this summer.\n\nHe talked for the entire haircut.\n\nWhen I was done I held up the hand mirror. He looked at the back. He said, \"Looks great, Ray. Same as always. Thanks, buddy.\" He stood up out of the chair by himself. He paid me at the register. He counted out the cash himself. He tipped me four dollars instead of three.\n\nHe walked out the door. He got into his Buick. He drove away.\n\nI stood at my register for about a minute and did not move. Tony, in the next chair, said, \"Ray. What just happened.\"\n\nI said, \"Tony. I just got my friend back.\"\n\nThat night I called Marie. I said, \"Marie. He drove himself today. He talked the whole time. He told me about Lee at Gettysburg for ten minutes.\"\n\nShe was quiet for a second. Then she said, \"Ray, he went to the doctor yesterday.\"\n\nI said, \"And.\"\n\nShe said, \"Ray, the doctor pulled up his bloodwork. His cholesterol was still great. The Crestor is doing its thing. But the doctor said — Ray, the doctor said, 'I'm not sure how to explain it, but his other markers are different. His inflammation markers are way down. His glucose is more stable. He looks ten years younger than he did six months ago. What have you been doing?'\"\n\nI said, \"What did you tell him.\"\n\nShe said, \"I told him my dad started drinking oolong tea.\"\n\nI said, \"What did he say.\"\n\nShe said, \"Ray, he said, 'Well. Whatever you're doing, keep doing it.'\"\n\nI laughed. I laughed in my kitchen. I had not laughed like that in a long time.\n\nI said, \"Marie. Did you tell him about the polyphenols and the oxidation.\"\n\nShe said, \"I tried, Ray. I tried. He kind of nodded politely and changed the subject. But he wrote down 'oolong tea' on the chart. He wrote it down.\"\n\nWe hung up. I wrote in the notebook, \"Doctor doesn't know what happened. Inflammation markers down. Glucose more stable. Bill talked the whole haircut. He drove himself. He drove himself. He drove himself.\"\n\nThe fourth visit was June 14, 2024. Twelve weeks in. Bill came in by himself. He was carrying a book — a Civil War book about the cavalry at Brandy Station — and he showed it to me before he sat down. He said, \"Ray, I'm halfway through this and I have to tell you about it.\" And he did.\n\nHe told me Janet had been crying a lot lately, and at first he was worried, but it turned out she had been crying because she said she had her husband back. He said it like he didn't fully understand what she meant. He said, \"I don't know what she means by that, Ray. I was right here the whole time. But she keeps saying that, so I guess that's a good thing.\"\n\nI said, \"Bill, that's a real good thing.\"\n\nI cut his hair. I trimmed his eyebrows. I shaved the back of his neck with the straight razor. He told me about Brandy Station for most of the haircut. He paid me. He tipped me four dollars. He drove himself home.\n\nThat visit, when he left, I went into the back of the shop and I leaned against the wall and I closed my eyes for about five minutes. I had been doing this for twenty-six years. I had never had a customer come back like that.\n\nIt is the most important haircut I have ever given.\n\nI want to talk to you directly now, because the rest of what I am writing is for you.\n\nIf you are reading this and you have a husband or a wife or a parent or a friend who is on a statin and who is fading — fading the way Bill faded, slow, year by year, while the doctor tells you the numbers are perfect — I am asking you to do one thing.\n\nI am asking you to look at the gap between the numbers and the person. I am asking you to trust your eyes.\n\nI am a barber. I am not a doctor. I cannot give you medical advice. I cannot tell you to stop taking a drug your doctor prescribed. I am not going to do that.\n\nWhat I am telling you is what I figured out, on my own, at my kitchen table, with my green notebook, after I watched Bill Hennessey stand in an alley in his underwear. The cholesterol number is not the whole story. The Crestor lowers the number. It does not stop the oxidation. The oxidation is what is destroying the small blood vessels in the brain. The polyphenols in oolong tea, specifically the kind in whole-leaf, properly processed oolong tea, are what stop the oxidation.\n\nPiPi Tea is what I gave Bill's daughter. PiPi Tea is what Bill drinks now, two cups in the morning and one in the afternoon. PiPi Tea is what I drink now, two cups in the morning, while I read the paper at my own kitchen table. PiPi Tea is what Mr. Thuan drinks at seventy-eight while he runs a nail salon and drives himself and plays in his poker game and remembers everyone's names.\n\nIf you want to try it, this is where you get it: https://shop.pipitea.com/ppch/sp\n\nIt comes with a 90-day money-back guarantee. That is ninety days of trying it, and if nothing changes in ninety days, you mail it back and you get your money back. The Crestor never gave anybody a guarantee. The doctor never gave anybody a guarantee. PiPi Tea gives you a guarantee, because they know what is in the bag, and they know what it does.\n\nI am not asking you to take my word for it. I am asking you to try it for ninety days and see for yourself.\n\nP.S. 1\n\nI am a barber. I want you to remember that. I am not selling anything. I do not work for PiPi Tea. I have never met anyone who works there. I am a fifty-eight-year-old man who has been cutting hair on Main Street in Greenville, South Carolina, since 1998, and I am telling you what I figured out because I watched Bill Hennessey go away over six years and nobody else was looking. I have a green notebook full of his haircuts. I have his daughter's phone number in my phone. I see him every three weeks and I watch him get better. That is what I am telling you. If that means something to you, you will know it means something. If it doesn't, you will scroll past. Either way, I have done my part. I have told you what I saw and what I figured out. The rest is up to you.\n\nIf somebody you love is fading, and the doctor keeps telling you their numbers are perfect, please look at the gap. Please trust your eyes. Please do not wait six years like Bill did. The damage is reversible. I have seen it.\n\nP.S. 2\n\nIf you want to know whether something is working, try this. For the first week of drinking the tea, pay attention to one thing only. Your morning energy. The first hour you are awake. How does your head feel. How does your body feel. How clear are you. Don't write anything down. Just notice.\n\nI am not making a medical claim. I am not telling you the tea will fix your energy. I am telling you that the people I know who drink this — Mr. Thuan, Mr. Linh, Mr. Phan, Bill Hennessey, and now me — wake up clearer than they used to. The first hour of the day is different. You will notice it or you won't. If you do, you will know.\n\nTry it for a week. Just notice.\n\nP.S. 3\n\nThe reason I told Bill's daughter Marie to try this — the reason I felt okay handing her my own bag and writing the website down on a piece of paper at my register — is the 90-day money-back guarantee. PiPi Tea offers it. Ninety days is a long time. It is long enough to actually see if something is doing what it is supposed to do. If you try it for ninety days and you do not see any change, you mail it back, and they refund you. You are not out anything except a little time and the cost of a stamp. That is the only reason I had the courage to put it in Marie's hands when she was already heartbroken. I knew she could not lose anything by trying it. Neither can you. Here is where you go: https://shop.pipitea.com/ppch/sp\n\nP.S. 4\n\nI will tell you the one thing I am worried about. PiPi Tea goes out of stock. I have ordered it three times now and twice it was in stock and once I had to wait two weeks because they were sold out. The Vietnamese family that supplies the leaf only harvests it certain times of the year, and the company only sells what they can guarantee is fresh and properly processed. They will not sell you old tea. When they are out, they are out, and you have to wait. As of right now, they are in stock. I checked this morning. If you are going to try it, do it now while you can get it. Here: https://shop.pipitea.com/ppch/sp\n\nP.S. 5\n\nI have been cutting Bill Hennessey's hair for twenty-six years. Last March he sat down in my chair and asked me my name. Last week he sat down in my chair and told me about Lee at Gettysburg for ten minutes. The man came back. Please do not wait six years like we did. Your person is still in there.\n\n— Ray","hashtags":[],"mentions":[],"accessibility_caption":null,"likes":null,"comments":null,"views":null,"counts_hidden":null,"comments_disabled":null,"is_pinned":null,"is_paid_partnership":false,"owner":{"id":"866655706540346","username":null,"full_name":"Cholesterol Relief Community","is_verified":null,"is_private":false,"avatar_url":"https://scontent.fqnv8-1.fna.fbcdn.net/v/t39.35426-6/704801774_1307804184087393_1622247990819069384_n.jpg?stp=dst-jpg_s60x60_tt6&_nc_cat=102&_nc_map=urlgen_bucketless&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=I1ULe3hY4egQ7kNvwHmriqP&_nc_oc=Adp1YCl23UJvRbAD-3twNRfpcsmkddbzSfBdNI1ExLb_F9YPIHGKRXJDeEdrTDInDtQ&_nc_zt=14&_nc_ht=scontent.fqnv8-1.fna&_nc_gid=RfazKM_IsAsG4CeN9210aQ&_nc_ss=7b289&oh=00_AQQF07z7CmZoHJWsC8_Wj-8UwKp2VMS6A4ZC487W43I-TQ&oe=6AE6E95E","latest_story_at":null,"extra":{"category":"Community Center","likes":3227,"is_deleted":false,"url":"https://www.facebook.com/866655706540346"}},"coauthors":[],"sponsors":[],"tagged":[],"location":null,"audio":null,"thumbnail_url":"https://scontent.fqnv8-1.fna.fbcdn.net/v/t39.35426-6/704980248_1477053767527294_3397865044255430814_n.jpg?_nc_cat=108&_nc_map=urlgen_bucketless&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=_y1Bfc_S4nEQ7kNvwFZuszf&_nc_oc=Ado6alzclBzW7m5VxK2OGEGwwQIrRtoAofW_qU6LdE3-f9Te_TtkJib8a0QOW4gdv_8&_nc_zt=14&_nc_ht=scontent.fqnv8-1.fna&_nc_gid=RfazKM_IsAsG4CeN9210aQ&_nc_ss=7b289&oh=00_AQTl5pbStqBGhxOrxRwojcG0wseP0WbRQWP8s_ifkd_wBQ&oe=6AE715D9","video_duration":null,"media":[{"kind":"image","url":"https://scontent.fqnv8-1.fna.fbcdn.net/v/t39.35426-6/704980248_1477053767527294_3397865044255430814_n.jpg?_nc_cat=108&_nc_map=urlgen_bucketless&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=_y1Bfc_S4nEQ7kNvwFZuszf&_nc_oc=Ado6alzclBzW7m5VxK2OGEGwwQIrRtoAofW_qU6LdE3-f9Te_TtkJib8a0QOW4gdv_8&_nc_zt=14&_nc_ht=scontent.fqnv8-1.fna&_nc_gid=RfazKM_IsAsG4CeN9210aQ&_nc_ss=7b289&oh=00_AQTl5pbStqBGhxOrxRwojcG0wseP0WbRQWP8s_ifkd_wBQ&oe=6AE715D9","width":null,"height":null,"duration":null}],"media_urls":["https://scontent.fqnv8-1.fna.fbcdn.net/v/t39.35426-6/704980248_1477053767527294_3397865044255430814_n.jpg?_nc_cat=108&_nc_map=urlgen_bucketless&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=_y1Bfc_S4nEQ7kNvwFZuszf&_nc_oc=Ado6alzclBzW7m5VxK2OGEGwwQIrRtoAofW_qU6LdE3-f9Te_TtkJib8a0QOW4gdv_8&_nc_zt=14&_nc_ht=scontent.fqnv8-1.fna&_nc_gid=RfazKM_IsAsG4CeN9210aQ&_nc_ss=7b289&oh=00_AQTl5pbStqBGhxOrxRwojcG0wseP0WbRQWP8s_ifkd_wBQ&oe=6AE715D9"],"extra":{"url":"https://www.facebook.com/ads/library/?id=914467831604972","is_active":true,"end_date":"2026-10-27T07:00:00+00:00","title":"Natural Relief in Weeks","link_caption":"shop.pipitea.com","link_url":"https://shop.pipitea.com/ppch/sp","link_domain":"shop.pipitea.com","cta_type":"LEARN_MORE","cta_text":"Learn more","collation_id":"1352218446885589","collation_count":2,"publisher_platforms":["facebook","instagram","audience_network","whatsapp","threads"],"countries":[],"categories":["UNKNOWN"],"currency":null}}],"pages":[{"cursor":null,"fetched_at":"2026-10-27T22:38:40.871552+00:00","count":10}],"next_cursor":"eyJjdXJzb3IiOiJBUUhUWUFQMXdiNTg1dmZMUUJMU2tZREZNZjB4UHRmckN0aFBwN3FYLVNFdGxYdXA2b3o0djZsc05SSDhLTF9iT0xGbSIsIm9wIjoic2VhcmNoX2FkcyJ9","has_more":true,"stop_reason":"pages","coverage":{"since":null,"oldest_at":null,"since_reached":false}},"meta":{"source":"live","fetched_at":"2026-10-27T22:38:40.871552+00:00","cost":"$0.0025","balance":"$49.9925","request_id":"req_2282cb1e1502f9fba11d9e36db879406"}}}}},"202":{"description":"Durable job accepted. No completed-result charge. Save batch_id; poll status_url. Retry submission with the same Idempotency-Key after a lost response. An account may have five queued, running or payment-required jobs. A sixth new job returns 429 rate_limited. Matching idempotent replays still work at the limit. Ready and failed jobs release their slots; pages within a job remain unbounded. This is a synthetic contract example, not a live capture.","x-example-provenance":"synthetic-contract","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","required":["batch_id","status","status_url","results_url","cost","item_count","error","retry_at","total","done_count","failed_count","created_at","started_at","finished_at"],"properties":{"batch_id":{"type":"string"},"status":{"type":"string","enum":["queued","running","payment_required","ready","failed"]},"status_url":{"type":"string"},"results_url":{"type":"string"},"cost":{"type":"string"},"item_count":{"type":"integer","nullable":true},"error":{"type":"string","nullable":true,"description":"Null unless failed. A failed target carries its own code; incomplete_result appears only when it has none and pages of the result are missing. profile_not_found, post_not_found, upstream_not_found or not_found: the target does not exist or is not visible. not_visible: The account exists, but its posts are not visible to logged-out readers (private, restricted, or hidden by Instagram). Retrying will not change the result until the account changes. not_cached: cached=cache_only found no saved read. incomplete_result: pages of the result are missing. temporarily_unavailable: the target could not be read for now (no capacity, a pause or repeated refusals); retry later with a new job. result_item_too_large: one result unit exceeds the delivery budget. result_snapshot_missing or result_snapshot_corrupt: the crawler could not serve the retained result of a paid job, and its charge is refunded; if the crawler serves it again, a later results read returns it and charges the job again. crawler_submit_400, crawler_submit_404 or crawler_submit_422: the crawl service refused the job request. crawler_job_failed: any other failure; the same job is not expected to succeed if resubmitted. cancelled: the job was cancelled with POST /v1/jobs/{job_id}/cancel. No failed job costs anything: only result_snapshot_missing and result_snapshot_corrupt follow a charge, and that charge is refunded."},"retry_at":{"type":"string","format":"date-time","nullable":true,"description":"Null unless the job failed temporarily_unavailable because a crawl route was closed for every caller. Then it is when the route opens again, and the response carries the same time as a Retry-After header in seconds. Submit a new job after it."},"total":{"type":"integer","description":"Targets in the job. A job submitted through a /v1 route has one."},"done_count":{"type":"integer","description":"Targets the crawler finished."},"failed_count":{"type":"integer","description":"Targets that failed."},"created_at":{"type":"string","format":"date-time","description":"When the job was submitted."},"started_at":{"type":"string","format":"date-time","nullable":true,"description":"When the crawler started the job. Null until it starts."},"finished_at":{"type":"string","format":"date-time","nullable":true,"description":"When the job finished or failed. Null while it is queued or running."}}},"meta":{"type":"object","required":["cost","request_id"],"properties":{"cost":{"type":"string","example":"$0.0000"},"request_id":{"type":"string"}}}}},"example":{"data":{"batch_id":"job_7641d5f0-717d-4b70-a2f1-f58d846d7242","status":"queued","status_url":"/v1/jobs/job_7641d5f0-717d-4b70-a2f1-f58d846d7242","results_url":"/v1/jobs/job_7641d5f0-717d-4b70-a2f1-f58d846d7242/results","cost":"$0.0000","item_count":null,"error":null,"retry_at":null,"total":1,"done_count":0,"failed_count":0,"created_at":"2026-10-12T12:56:17.403Z","started_at":null,"finished_at":null},"meta":{"cost":"$0.0000","request_id":"req_job_example"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"404":{"description":"`cached=cache_only` found nothing saved for these arguments (`not_cached`; call again with `cached=auto` to fetch it), or the Meta Ads account or item does not exist (`not_found`). You are not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_cached","message":"no saved meta_ads/search_ads read for 'running shoes'. cached=cache_only never fetches, so call again with cached=auto to fetch it. You are not charged.","request_id":"req_5c10900e919bc7a3ff79b7501d582b4c"}}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/meta_ads/search_companies":{"get":{"tags":["Meta Ads"],"operationId":"maSearchCompanies","summary":"search_companies","x-dashboard-cost":"$0.0025","x-example-query":{"query":"Nike"},"description":"The Pages the Ad Library typeahead suggests for a name, each with its `page_id` as `id`; category, Page likes and the Page URL sit under `extra`. Returns `Account[]` under `data`, read from the Ad Library as a signed-out guest.\n\nAn ad answers as a `Post`: the copy is `caption`, the start is `taken_at`, `likes`, `comments` and `views` are null because the Ad Library shows no engagement, and Ad Library facts (the library URL, `is_active`, `end_date`, the CTA, the link, `publisher_platforms`, `countries`) sit under `extra`. An advertiser answers as an `Account`, with Page likes under `extra.likes`. Unknown, unsupported, and repeated query parameters return 400 before acquisition or billing.\n\nBilling: $0.0025 per call. A failed read is not charged.","security":[{"bearerAuth":[]}],"parameters":[{"name":"query","in":"query","required":true,"description":"The words to search for, up to 500 characters.","example":"Nike","schema":{"type":"string"}},{"name":"country","in":"query","required":false,"description":"A two-letter country code, or `ALL`; omitted is `US`.","schema":{"type":"string","pattern":"^([A-Za-z]{2}|ALL)$"}},{"name":"cached","in":"query","required":false,"description":"`auto` (default) serves a read saved within the last 24 hours for these exact arguments, otherwise fetches. `cache_only` never contacts Meta Ads (404 `not_cached` when nothing is saved, whatever its age). `live` always fetches. Anything else is a `400`.","schema":{"type":"string","enum":["auto","cache_only","live"],"default":"auto"},"examples":{"default":{"value":"auto","x-disabled":true}}},{"name":"get_raw","in":"query","required":false,"description":"`true` returns the upstream JSON exactly as Meta Ads answered it instead of the normalized `Account[]`.","schema":{"type":"boolean","default":false},"examples":{"default":{"value":false,"x-disabled":true}}}],"responses":{"200":{"description":"`Account[]` under `data`.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Account"}},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":[{"id":"15087023444","username":"nike","full_name":"Nike","is_verified":null,"is_private":false,"avatar_url":"https://scontent.fudi3-1.fna.fbcdn.net/v/t39.30808-1/284964043_10159903868513445_7696353984967674128_n.jpg?stp=dst-jpg_s100x100_tt6&_nc_cat=1&ccb=1-7&_nc_sid=418b77&_nc_ohc=mvC9EoMOIyUQ7kNvwGXxpu6&_nc_oc=AdqVpocJic-lF4TXAP3N9Q62-1oEwfZYsgnyJMTFMk_ryLExZRjEDo1LVehKUem7INo&_nc_zt=24&_nc_ht=scontent.fudi3-1.fna&_nc_gid=_5_anZCt9_VjupjItm1Mxw&_nc_ss=7b289&oh=00_AQQ9Hha2WCnYANe3l1tlW_o_DjJax1H5NNRS2GgVMjwRTg&oe=6AE70830","latest_story_at":null,"extra":{"category":"Sportswear Store","likes":39494361,"is_deleted":false,"url":"https://www.facebook.com/nike"}},{"id":"51212153078","username":"nikefootball","full_name":"Nike Football","is_verified":null,"is_private":false,"avatar_url":"https://scontent.fudi3-1.fna.fbcdn.net/v/t39.30808-1/387181570_863325755161415_3589774989337788111_n.jpg?stp=dst-jpg_s100x100_tt6&_nc_cat=1&ccb=1-7&_nc_sid=418b77&_nc_ohc=YQ90KaPsflsQ7kNvwHgR1d8&_nc_oc=Ado5qwHnzRJ7U-prH4zaJQC8-sLhlujn1YhdyfubGA_BrCbf8T6yOIe46q-T2CEWj2U&_nc_zt=24&_nc_ht=scontent.fudi3-1.fna&_nc_gid=_5_anZCt9_VjupjItm1Mxw&_nc_ss=7b289&oh=00_AQQouxjbTqHVuCwpqEDvgBcnkBT0uJw9V3cIgCMwLeuv6Q&oe=6AE71005","latest_story_at":null,"extra":{"category":"Product/service","likes":39987860,"is_deleted":false,"url":"https://www.facebook.com/nikefootball"}}],"meta":{"source":"live","fetched_at":"2026-10-27T22:38:34.492357+00:00","cost":"$0.0025","balance":"$49.9975","request_id":"req_c595979a2cd8f459c5ae9fe9dd104000"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"404":{"description":"`cached=cache_only` found nothing saved for these arguments (`not_cached`; call again with `cached=auto` to fetch it), or the Meta Ads account or item does not exist (`not_found`). You are not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_cached","message":"no saved meta_ads/search_companies read for 'Nike'. cached=cache_only never fetches, so call again with cached=auto to fetch it. You are not charged.","request_id":"req_5c10900e919bc7a3ff79b7501d582b4c"}}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/meta_ads/ad":{"get":{"tags":["Meta Ads"],"operationId":"maAd","summary":"ad","x-dashboard-cost":"$0.0025","x-example-query":{"ad_archive_id":"161966936869658"},"description":"One ad by its Ad Library id, read from its advertiser's library page: copy, creatives, run dates, CTA, platforms and countries. An id the library does not answer is a `404`. Returns `Post` under `data`, read from the Ad Library as a signed-out guest.\n\nAn ad answers as a `Post`: the copy is `caption`, the start is `taken_at`, `likes`, `comments` and `views` are null because the Ad Library shows no engagement, and Ad Library facts (the library URL, `is_active`, `end_date`, the CTA, the link, `publisher_platforms`, `countries`) sit under `extra`. An advertiser answers as an `Account`, with Page likes under `extra.likes`. Unknown, unsupported, and repeated query parameters return 400 before acquisition or billing.\n\nBilling: $0.0025 per call. A failed read is not charged.","security":[{"bearerAuth":[]}],"parameters":[{"name":"ad_archive_id","in":"query","required":true,"description":"The numeric Ad Library ad id, `id` of an ad in any Meta Ads answer.","example":"161966936869658","schema":{"type":"string"}},{"name":"cached","in":"query","required":false,"description":"`auto` (default) serves a read saved within the last 24 hours for these exact arguments, otherwise fetches. `cache_only` never contacts Meta Ads (404 `not_cached` when nothing is saved, whatever its age). `live` always fetches. Anything else is a `400`.","schema":{"type":"string","enum":["auto","cache_only","live"],"default":"auto"},"examples":{"default":{"value":"auto","x-disabled":true}}},{"name":"get_raw","in":"query","required":false,"description":"`true` returns the upstream JSON exactly as Meta Ads answered it instead of the normalized `Post`.","schema":{"type":"boolean","default":false},"examples":{"default":{"value":false,"x-disabled":true}}}],"responses":{"200":{"description":"`Post` under `data`.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/Post"},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"id":"161966936869658","shortcode":null,"taken_at":"2023-08-15T07:00:00+00:00","kind":"carousel","product_type":"DPA","caption":"Entra a Nike.com y encuentra actualizaciones semanales de producto con envío gratis.","hashtags":[],"mentions":[],"accessibility_caption":null,"likes":null,"comments":null,"views":null,"counts_hidden":null,"comments_disabled":null,"is_pinned":null,"is_paid_partnership":false,"owner":{"id":"15087023444","username":"nike","full_name":"Nike","is_verified":null,"is_private":false,"avatar_url":"https://scontent.fmvd1-1.fna.fbcdn.net/v/t39.35426-6/367720191_2495585077311562_2373799605258111663_n.jpg?stp=dst-jpg_s60x60_tt6&_nc_cat=104&_nc_map=urlgen_bucketless&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=f-SvlYEYajcQ7kNvwHDTDfP&_nc_oc=AdryLKe_SUKplmiSTqkizCIaNNrnJZNDxQhot7Nao3J6gIuLbdL63qsPVzvq3eUtLw4&_nc_zt=14&_nc_ht=scontent.fmvd1-1.fna&_nc_gid=wBk6ceWSQ5-dWYfJRtd0WA&_nc_ss=7b289&oh=00_AQTYoyXuMQC6YFfCbb0eIdAEQsOizyT8kprJSvo4GXbbmg&oe=6AE70028","latest_story_at":null,"extra":{"category":"Sportswear","likes":39494361,"is_deleted":false,"url":"https://www.facebook.com/nike"}},"coauthors":[],"sponsors":[],"tagged":[],"location":null,"audio":null,"thumbnail_url":"https://scontent.fmvd4-1.fna.fbcdn.net/v/t39.35426-6/367963819_652036496870561_3033983014718682847_n.jpg?_nc_cat=107&_nc_map=urlgen_bucketless&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=xMavf1VqVhYQ7kNvwGbT-NC&_nc_oc=AdpzFwa0zP5UNILQvRqyyrU0taMf2JfmfTP_dpi55YE5cVGQrgiJishLAjW_Zsd987Y&_nc_zt=14&_nc_ht=scontent.fmvd4-1.fna&_nc_gid=wBk6ceWSQ5-dWYfJRtd0WA&_nc_ss=7b289&oh=00_AQRTtYp9CB27uvN2NfrkGxENPyUF1i-MPaNVeH09cyb9zg&oe=6AE7139A","video_duration":null,"media":[{"kind":"image","url":"https://scontent.fmvd4-1.fna.fbcdn.net/v/t39.35426-6/367963819_652036496870561_3033983014718682847_n.jpg?_nc_cat=107&_nc_map=urlgen_bucketless&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=xMavf1VqVhYQ7kNvwGbT-NC&_nc_oc=AdpzFwa0zP5UNILQvRqyyrU0taMf2JfmfTP_dpi55YE5cVGQrgiJishLAjW_Zsd987Y&_nc_zt=14&_nc_ht=scontent.fmvd4-1.fna&_nc_gid=wBk6ceWSQ5-dWYfJRtd0WA&_nc_ss=7b289&oh=00_AQRTtYp9CB27uvN2NfrkGxENPyUF1i-MPaNVeH09cyb9zg&oe=6AE7139A","width":null,"height":null,"duration":null},{"kind":"image","url":"https://scontent.fmvd2-2.fna.fbcdn.net/v/t39.35426-6/367742785_847403300215960_2275630920962394846_n.jpg?_nc_cat=103&_nc_map=urlgen_bucketless&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=exMqM5kN9M4Q7kNvwERoTFW&_nc_oc=AdqFBuA8tFKrwtZUt9FHugzobZLzDI2vspMFtRypI7MN0ehe1_gHzxG3x1OfoXf2BrY&_nc_zt=14&_nc_ht=scontent.fmvd2-2.fna&_nc_gid=wBk6ceWSQ5-dWYfJRtd0WA&_nc_ss=7b289&oh=00_AQTYU2DwT9z3-hJ-kIJySbwkxei7JfTVYjFI5JNQfuzX-g&oe=6AE711DF","width":null,"height":null,"duration":null},{"kind":"image","url":"https://scontent.fmvd3-1.fna.fbcdn.net/v/t39.35426-6/367693224_1243588693706245_2909314498320683993_n.jpg?_nc_cat=105&_nc_map=urlgen_bucketless&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=go3cAn0EBRQQ7kNvwHxRshq&_nc_oc=Adp6F4DhmQ1eUJNKrLOn0gnFAhUoBvoXBd--mfdHO4Ufff-hWXH16gn4dSQxOCo2b54&_nc_zt=14&_nc_ht=scontent.fmvd3-1.fna&_nc_gid=wBk6ceWSQ5-dWYfJRtd0WA&_nc_ss=7b289&oh=00_AQR7-yDdW2-IioeKnuRnK256YHOtfxZmVxe5wyJVoD3Cpw&oe=6AE6E5A1","width":null,"height":null,"duration":null},{"kind":"image","url":"https://scontent.fmvd1-1.fna.fbcdn.net/v/t39.35426-6/367047967_607783308209677_5484532650414513812_n.jpg?_nc_cat=108&_nc_map=urlgen_bucketless&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=o7qSooHaE7gQ7kNvwGerjlE&_nc_oc=AdrvJknWXwh_YpZ7bEU2QNu3XXjaIg9dAyDiyjvEgj9-w_oMHgjWY6qsdCQIFapefzM&_nc_zt=14&_nc_ht=scontent.fmvd1-1.fna&_nc_gid=wBk6ceWSQ5-dWYfJRtd0WA&_nc_ss=7b289&oh=00_AQSVTREB2SYjZwNZdnvMiV-bTyJBqM7S16EeGQRAtDhEOA&oe=6AE6FF2C","width":null,"height":null,"duration":null},{"kind":"image","url":"https://scontent.fmvd2-2.fna.fbcdn.net/v/t39.35426-6/367750235_981618649557195_7119924792787874591_n.jpg?_nc_cat=102&_nc_map=urlgen_bucketless&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=CXanSAHduLwQ7kNvwEKKGV7&_nc_oc=AdoR7Wgld8gUZDSa290PEtCIAcMEc657zSHnZ1NZdJBa_NU3Suy6hSHVxiL9T9NvBdg&_nc_zt=14&_nc_ht=scontent.fmvd2-2.fna&_nc_gid=wBk6ceWSQ5-dWYfJRtd0WA&_nc_ss=7b289&oh=00_AQS_wE3Vw5D6CME99sLtq41HEdJ1qFxI5X6XHtzaA2zv7w&oe=6AE6F657","width":null,"height":null,"duration":null},{"kind":"image","url":"https://scontent.fmvd2-2.fna.fbcdn.net/v/t39.35426-6/367982880_6403678943084737_2372495901824734164_n.jpg?_nc_cat=105&_nc_map=urlgen_bucketless&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=k7FKAmkj9usQ7kNvwG--qY_&_nc_oc=AdqRVqgUB_1Iah694Ogf5wj8fyVPH_PYFJCxxEh3bG1nYPLS5Fk5ajwVPV0JrjhQ4Fk&_nc_zt=14&_nc_ht=scontent.fmvd2-2.fna&_nc_gid=wBk6ceWSQ5-dWYfJRtd0WA&_nc_ss=7b289&oh=00_AQTsdekdTxnlSs6MEYSz4d48Ed1InM2Imf6u_ygaiS12KA&oe=6AE71370","width":null,"height":null,"duration":null}],"media_urls":["https://scontent.fmvd4-1.fna.fbcdn.net/v/t39.35426-6/367963819_652036496870561_3033983014718682847_n.jpg?_nc_cat=107&_nc_map=urlgen_bucketless&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=xMavf1VqVhYQ7kNvwGbT-NC&_nc_oc=AdpzFwa0zP5UNILQvRqyyrU0taMf2JfmfTP_dpi55YE5cVGQrgiJishLAjW_Zsd987Y&_nc_zt=14&_nc_ht=scontent.fmvd4-1.fna&_nc_gid=wBk6ceWSQ5-dWYfJRtd0WA&_nc_ss=7b289&oh=00_AQRTtYp9CB27uvN2NfrkGxENPyUF1i-MPaNVeH09cyb9zg&oe=6AE7139A","https://scontent.fmvd2-2.fna.fbcdn.net/v/t39.35426-6/367742785_847403300215960_2275630920962394846_n.jpg?_nc_cat=103&_nc_map=urlgen_bucketless&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=exMqM5kN9M4Q7kNvwERoTFW&_nc_oc=AdqFBuA8tFKrwtZUt9FHugzobZLzDI2vspMFtRypI7MN0ehe1_gHzxG3x1OfoXf2BrY&_nc_zt=14&_nc_ht=scontent.fmvd2-2.fna&_nc_gid=wBk6ceWSQ5-dWYfJRtd0WA&_nc_ss=7b289&oh=00_AQTYU2DwT9z3-hJ-kIJySbwkxei7JfTVYjFI5JNQfuzX-g&oe=6AE711DF","https://scontent.fmvd3-1.fna.fbcdn.net/v/t39.35426-6/367693224_1243588693706245_2909314498320683993_n.jpg?_nc_cat=105&_nc_map=urlgen_bucketless&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=go3cAn0EBRQQ7kNvwHxRshq&_nc_oc=Adp6F4DhmQ1eUJNKrLOn0gnFAhUoBvoXBd--mfdHO4Ufff-hWXH16gn4dSQxOCo2b54&_nc_zt=14&_nc_ht=scontent.fmvd3-1.fna&_nc_gid=wBk6ceWSQ5-dWYfJRtd0WA&_nc_ss=7b289&oh=00_AQR7-yDdW2-IioeKnuRnK256YHOtfxZmVxe5wyJVoD3Cpw&oe=6AE6E5A1","https://scontent.fmvd1-1.fna.fbcdn.net/v/t39.35426-6/367047967_607783308209677_5484532650414513812_n.jpg?_nc_cat=108&_nc_map=urlgen_bucketless&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=o7qSooHaE7gQ7kNvwGerjlE&_nc_oc=AdrvJknWXwh_YpZ7bEU2QNu3XXjaIg9dAyDiyjvEgj9-w_oMHgjWY6qsdCQIFapefzM&_nc_zt=14&_nc_ht=scontent.fmvd1-1.fna&_nc_gid=wBk6ceWSQ5-dWYfJRtd0WA&_nc_ss=7b289&oh=00_AQSVTREB2SYjZwNZdnvMiV-bTyJBqM7S16EeGQRAtDhEOA&oe=6AE6FF2C","https://scontent.fmvd2-2.fna.fbcdn.net/v/t39.35426-6/367750235_981618649557195_7119924792787874591_n.jpg?_nc_cat=102&_nc_map=urlgen_bucketless&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=CXanSAHduLwQ7kNvwEKKGV7&_nc_oc=AdoR7Wgld8gUZDSa290PEtCIAcMEc657zSHnZ1NZdJBa_NU3Suy6hSHVxiL9T9NvBdg&_nc_zt=14&_nc_ht=scontent.fmvd2-2.fna&_nc_gid=wBk6ceWSQ5-dWYfJRtd0WA&_nc_ss=7b289&oh=00_AQS_wE3Vw5D6CME99sLtq41HEdJ1qFxI5X6XHtzaA2zv7w&oe=6AE6F657","https://scontent.fmvd2-2.fna.fbcdn.net/v/t39.35426-6/367982880_6403678943084737_2372495901824734164_n.jpg?_nc_cat=105&_nc_map=urlgen_bucketless&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=k7FKAmkj9usQ7kNvwG--qY_&_nc_oc=AdqRVqgUB_1Iah694Ogf5wj8fyVPH_PYFJCxxEh3bG1nYPLS5Fk5ajwVPV0JrjhQ4Fk&_nc_zt=14&_nc_ht=scontent.fmvd2-2.fna&_nc_gid=wBk6ceWSQ5-dWYfJRtd0WA&_nc_ss=7b289&oh=00_AQTsdekdTxnlSs6MEYSz4d48Ed1InM2Imf6u_ygaiS12KA&oe=6AE71370"],"extra":{"url":"https://www.facebook.com/ads/library/?id=161966936869658","is_active":false,"end_date":"2026-03-30T07:00:00+00:00","title":"{{product.name}}","link_caption":"nike.com/mx","link_url":"https://ad.doubleclick.net/ddm/trackclk/N8893.2410306FACEBOOKADS/B30448992.373431644;dc_trk_aid=564542764;dc_trk_cid=196659869;dc_lat=;dc_rdid=;tag_for_child_directed_treatment=;tfua=;ltd=;dc_tdv=1","link_domain":"ad.doubleclick.net","cta_type":"SHOP_NOW","cta_text":"Shop now","collation_id":null,"collation_count":null,"publisher_platforms":["facebook","instagram","audience_network","messenger"],"countries":[],"categories":["UNKNOWN"],"currency":null}},"meta":{"source":"live","fetched_at":"2026-10-27T22:38:44.643677+00:00","cost":"$0.0025","balance":"$49.9900","request_id":"req_dbcde0097aa65d16afedd964fb0cb3f6"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"404":{"description":"`cached=cache_only` found nothing saved for these arguments (`not_cached`; call again with `cached=auto` to fetch it), or the Meta Ads account or item does not exist (`not_found`). You are not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_cached","message":"no saved meta_ads/ad read for '161966936869658'. cached=cache_only never fetches, so call again with cached=auto to fetch it. You are not charged.","request_id":"req_5c10900e919bc7a3ff79b7501d582b4c"}}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/instagram/dm/outreach":{"post":{"tags":["Instagram DM"],"operationId":"igDmOutreach","summary":"Send outreach","x-dashboard-cost":"$0.05","description":"Sends one Instagram message to a person. If you already have a conversation with them, the message continues it. Otherwise it starts one. We send from an Instagram account we run for your organization, so you never log in to Instagram.\n\nKeep the `id` from the answer, and pass it to Check conversation to read their replies.\n\nSend a `client_token` with every message. Retrying with the same token never sends twice and costs $0. A message costs $0.05 only when it goes out.","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["to","text"],"properties":{"to":{"type":"string","description":"The person to message: their Instagram handle (`nike` or `@nike`) or their profile link (`https://www.instagram.com/nike/`).","example":"rhino.29941499"},"text":{"type":"string","maxLength":2000,"example":"Yes, we ship to Seoul! Please send your address and we'll get it out this week."},"client_token":{"type":"string","description":"Any text you pick for this message, such as `gifting-oct-02`. Send the same one when you retry, and the person never gets the message twice.","example":"gifting-oct-02"}}},"example":{"to":"rhino.29941499","text":"Yes, we ship to Seoul! Please send your address and we'll get it out this week.","client_token":"gifting-oct-02"}}}},"responses":{"200":{"description":"The conversation with every message, and what happened to this one.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","properties":{"id":{"type":"integer","description":"Pass it to Check conversation.","example":21},"to":{"type":"object","description":"The person you are messaging.","properties":{"handle":{"type":"string","nullable":true,"example":"rhino.29941499"},"user_id":{"type":"string","example":"29826377850"}}},"state":{"type":"string","enum":["open","recipient_blocked","undeliverable","closed"],"description":"`open` takes new messages. `recipient_blocked` and `undeliverable` mean Instagram will not deliver to this person. `closed` means this conversation ended on our side: its messages still read, and Send outreach to the same person starts a new one.","example":"open"},"unanswered":{"type":"integer","description":"Your messages since their last reply.","example":1},"last_sent_at":{"type":"string","nullable":true,"format":"date-time"},"last_reply_at":{"type":"string","nullable":true,"format":"date-time","description":"When they last replied."},"started_at":{"type":"string","nullable":true,"format":"date-time"},"updated_at":{"type":"string","nullable":true,"format":"date-time"},"messages":{"type":"array","description":"Every message, oldest first.","items":{"type":"object","properties":{"id":{"type":"integer","example":87},"direction":{"type":"string","enum":["sent","received"],"description":"`sent` is a message you sent, and `received` is the person’s reply.","example":"sent"},"text":{"type":"string","nullable":true,"example":"Yes, we ship to Seoul! Please send your address and we'll get it out this week."},"status":{"type":"string","description":"Your message’s `status` is one of the `sent.status` values: `sent`, `operation_in_progress` or `delivery_unknown` (we could not confirm delivery, so run Check conversation before you send again), or `sending` while it goes out. A reply is `received`.","example":"sent"},"client_token":{"type":"string","nullable":true,"description":"The client_token you sent it with.","example":"gifting-oct-02"},"sent_at":{"type":"string","nullable":true,"format":"date-time","example":"2026-10-29T20:59:10.678650+00:00"}}}},"sent":{"type":"object","description":"What happened to this message.","properties":{"status":{"type":"string","enum":["sent","operation_in_progress","delivery_unknown"],"description":"`sent`: Instagram took the message. `operation_in_progress`: It is still going out. Run Check conversation in a moment to see where it landed. `delivery_unknown`: We could not confirm delivery. Run Check conversation before you send again, and retry only with the same client_token, so it never goes out twice.","example":"sent"},"delivered":{"type":"boolean","description":"True only when Instagram confirmed it.","example":true},"deduplicated":{"type":"boolean","description":"True when this client_token was already sent, so nothing new went out and this call cost $0.","example":false}}}}},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"id":21,"to":{"handle":"rhino.29941499","user_id":"29826377850"},"state":"open","unanswered":1,"last_sent_at":"2026-10-29T20:59:11.259143+00:00","last_reply_at":"2026-10-29T20:58:35.973000+00:00","started_at":"2026-10-29T20:55:53.540810+00:00","updated_at":"2026-10-29T20:59:11.259134+00:00","messages":[{"id":84,"direction":"sent","text":"Hi! We're Glow Lab, a clean skincare brand. We love your morning routine videos and would like to send you our new Vitamin C serum, with no strings attached. Can we ship it to you?","status":"sent","client_token":"gifting-oct-01","sent_at":"2026-10-29T20:56:29.831581+00:00"},{"id":86,"direction":"received","text":"Hi! Thank you, I'd love to try it. Do you ship to Seoul?","status":"received","client_token":null,"sent_at":"2026-10-29T20:58:35.973000+00:00"},{"id":87,"direction":"sent","text":"Yes, we ship to Seoul! Please send your address and we'll get it out this week.","status":"sent","client_token":"gifting-oct-02","sent_at":"2026-10-29T20:59:10.678650+00:00"}],"sent":{"status":"sent","delivered":true,"deduplicated":false}},"meta":{"cost":"$0.0500","balance":"$2.4238","request_id":"req_1b15280c1eeac2f86a7e7b77c832f1f1"}}}}},"400":{"description":"The body is missing to or text, has a field this call does not take, or to is not a handle or profile link.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"invalid_request","message":"The message text is empty. Put the message in text. Nothing was sent and you are not charged.","request_id":"req_e9f2dca7700139b077ade2a9810e62a9"}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"404":{"description":"Instagram has no account with this handle. Check the spelling in to. Nothing was sent and you are not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"recipient_not_found","message":"Instagram has no account with this handle. Check the spelling in to. Nothing was sent and you are not charged.","request_id":"req_e9f2dca7700139b077ade2a9810e62a9"}}}}},"409":{"description":"This person has not accepted your first message yet, or Instagram paused the account we send this conversation from.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"examples":{"recipient_pending":{"summary":"recipient_pending","value":{"error":{"code":"recipient_pending","message":"This person has not accepted your first message yet, and Instagram allows more messages only after they accept. Nothing was sent and you are not charged. Check the conversation later and send again once they reply.","request_id":"req_e9f2dca7700139b077ade2a9810e62a9"}}},"account_paused":{"summary":"account_paused","value":{"error":{"code":"account_paused","message":"Instagram paused the account we send this conversation from, and the conversation keeps that account, so this person always hears from the same one. Nothing was sent and you are not charged. Send again after the Retry-After seconds, when we check the account again.","request_id":"req_e9f2dca7700139b077ade2a9810e62a9"}}}}}}},"422":{"description":"Instagram will not deliver messages to this person, for example because they blocked the account we send from. Nothing was sent and you are not charged. Do not retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"message_undeliverable","message":"Instagram will not deliver messages to this person, for example because they blocked the account we send from. Nothing was sent and you are not charged. Do not retry.","request_id":"req_e9f2dca7700139b077ade2a9810e62a9"}}}}},"429":{"description":"Over the per-minute limit for your organization, out of messages for today, or Instagram asked us to slow down.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"examples":{"daily_limit_reached":{"summary":"daily_limit_reached","value":{"error":{"code":"daily_limit_reached","message":"Today's messages are used up. Nothing was sent and you are not charged. Try again after the Retry-After seconds, after 00:00 UTC.","request_id":"req_e9f2dca7700139b077ade2a9810e62a9"}}},"rate_limited":{"summary":"rate_limited","value":{"error":{"code":"rate_limited","message":"Instagram asked us to slow down, so nothing was done and you are not charged. Try again after the Retry-After seconds.","request_id":"req_e9f2dca7700139b077ade2a9810e62a9"}}},"rate_limit_exceeded":{"summary":"rate_limit_exceeded","value":{"error":{"code":"rate_limit_exceeded","message":"Rate limit exceeded (100 req/min for your organization, shared by all its keys). Retry after 23s. Request an increase at https://api.virev.ai/dashboard/keys","request_id":"req_e9f2dca7700139b077ade2a9810e62a9"}}}}}}},"503":{"description":"We cannot send right now, or billing could not be confirmed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"examples":{"dm_sending_paused":{"summary":"dm_sending_paused","value":{"error":{"code":"dm_sending_paused","message":"We have no free capacity for this right now. Nothing was sent and you are not charged. Try again later.","request_id":"req_e9f2dca7700139b077ade2a9810e62a9"}}},"try_again_shortly":{"summary":"try_again_shortly","value":{"error":{"code":"try_again_shortly","message":"This conversation is busy on our side for a moment. Nothing was sent and you are not charged. Try again shortly with the same client_token.","request_id":"req_e9f2dca7700139b077ade2a9810e62a9"}}},"upstream_unavailable":{"summary":"upstream_unavailable","value":{"error":{"code":"upstream_unavailable","message":"The DM service is temporarily unavailable, and you are not charged. Try again shortly. Retry a send with the same client_token, so the message never goes out twice.","request_id":"req_e9f2dca7700139b077ade2a9810e62a9"}}},"billing_unavailable":{"summary":"billing_unavailable","value":{"error":{"code":"billing_unavailable","message":"Billing is temporarily unavailable. No data was returned.","request_id":"req_e9f2dca7700139b077ade2a9810e62a9"}}}}}}}}}},"/v1/instagram/dm/conversations/{conversation_id}":{"get":{"tags":["Instagram DM"],"operationId":"igDmConversation","summary":"Check conversation","x-dashboard-cost":"$0.0005","description":"Returns one conversation with every message, oldest first, including the person’s replies.\n\nAdd `refresh=true` to read Instagram for new replies first. That call usually takes 1 to 10 seconds and costs $0.001, so call it when you want to look, not in a tight loop. Without it, you get the saved messages for $0.0005.","security":[{"bearerAuth":[]}],"parameters":[{"name":"conversation_id","in":"path","required":true,"description":"The conversation id from the `id` field of the Send outreach answer.","schema":{"type":"integer","minimum":1},"example":21},{"name":"refresh","in":"query","required":false,"description":"`true` first reads the Instagram inbox and saves the person’s new replies, so this answer shows them. It usually takes 1 to 10 seconds and costs $0.001. Leave it out to read the saved messages for $0.0005, with no Instagram call.","schema":{"type":"boolean","default":false},"examples":{"default":{"value":true,"x-disabled":true}}}],"responses":{"200":{"description":"The conversation with every message.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","properties":{"id":{"type":"integer","description":"Pass it to Check conversation.","example":21},"to":{"type":"object","description":"The person you are messaging.","properties":{"handle":{"type":"string","nullable":true,"example":"rhino.29941499"},"user_id":{"type":"string","example":"29826377850"}}},"state":{"type":"string","enum":["open","recipient_blocked","undeliverable","closed"],"description":"`open` takes new messages. `recipient_blocked` and `undeliverable` mean Instagram will not deliver to this person. `closed` means this conversation ended on our side: its messages still read, and Send outreach to the same person starts a new one.","example":"open"},"unanswered":{"type":"integer","description":"Your messages since their last reply.","example":1},"last_sent_at":{"type":"string","nullable":true,"format":"date-time"},"last_reply_at":{"type":"string","nullable":true,"format":"date-time","description":"When they last replied."},"started_at":{"type":"string","nullable":true,"format":"date-time"},"updated_at":{"type":"string","nullable":true,"format":"date-time"},"messages":{"type":"array","description":"Every message, oldest first.","items":{"type":"object","properties":{"id":{"type":"integer","example":87},"direction":{"type":"string","enum":["sent","received"],"description":"`sent` is a message you sent, and `received` is the person’s reply.","example":"sent"},"text":{"type":"string","nullable":true,"example":"Yes, we ship to Seoul! Please send your address and we'll get it out this week."},"status":{"type":"string","description":"Your message’s `status` is one of the `sent.status` values: `sent`, `operation_in_progress` or `delivery_unknown` (we could not confirm delivery, so run Check conversation before you send again), or `sending` while it goes out. A reply is `received`.","example":"sent"},"client_token":{"type":"string","nullable":true,"description":"The client_token you sent it with.","example":"gifting-oct-02"},"sent_at":{"type":"string","nullable":true,"format":"date-time","example":"2026-10-29T20:59:10.678650+00:00"}}}}}},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"id":21,"to":{"handle":"rhino.29941499","user_id":"29826377850"},"state":"open","unanswered":0,"last_sent_at":"2026-10-29T20:56:30.276728+00:00","last_reply_at":"2026-10-29T20:58:35.973000+00:00","started_at":"2026-10-29T20:55:53.540810+00:00","updated_at":"2026-10-29T20:58:50.598868+00:00","messages":[{"id":84,"direction":"sent","text":"Hi! We're Glow Lab, a clean skincare brand. We love your morning routine videos and would like to send you our new Vitamin C serum, with no strings attached. Can we ship it to you?","status":"sent","client_token":"gifting-oct-01","sent_at":"2026-10-29T20:56:29.831581+00:00"},{"id":86,"direction":"received","text":"Hi! Thank you, I'd love to try it. Do you ship to Seoul?","status":"received","client_token":null,"sent_at":"2026-10-29T20:58:35.973000+00:00"}]},"meta":{"cost":"$0.0010","balance":"$2.4438","request_id":"req_4fe88bd311b577410022869e159875a3"}}}}},"400":{"description":"conversation_id is not a number, or refresh is not true or false.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"invalid_request","message":"refresh must be true or false. You are not charged.","request_id":"req_e9f2dca7700139b077ade2a9810e62a9"}}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"404":{"description":"No conversation with this id belongs to your organization. Use the id from the Send outreach answer. You are not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"conversation_not_found","message":"No conversation with this id belongs to your organization. Use the id from the Send outreach answer. You are not charged.","request_id":"req_e9f2dca7700139b077ade2a9810e62a9"}}}}},"409":{"description":"This conversation is closed, so it can no longer send or check for new replies. Its saved messages still show without refresh=true. To write to this person again, call Send outreach, which starts a new conversation. You are not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"conversation_closed","message":"This conversation is closed, so it can no longer send or check for new replies. Its saved messages still show without refresh=true. To write to this person again, call Send outreach, which starts a new conversation. You are not charged.","request_id":"req_e9f2dca7700139b077ade2a9810e62a9"}}}}},"429":{"description":"Over the per-minute limit for your organization, or, with refresh=true, Instagram asked us to slow down.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"examples":{"rate_limited":{"summary":"rate_limited","value":{"error":{"code":"rate_limited","message":"Instagram asked us to slow down, so nothing was done and you are not charged. Try again after the Retry-After seconds.","request_id":"req_e9f2dca7700139b077ade2a9810e62a9"}}},"rate_limit_exceeded":{"summary":"rate_limit_exceeded","value":{"error":{"code":"rate_limit_exceeded","message":"Rate limit exceeded (100 req/min for your organization, shared by all its keys). Retry after 23s. Request an increase at https://api.virev.ai/dashboard/keys","request_id":"req_e9f2dca7700139b077ade2a9810e62a9"}}}}}}},"503":{"description":"The DM service cannot be reached or is updating, or billing could not be confirmed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"examples":{"upstream_unavailable":{"summary":"upstream_unavailable","value":{"error":{"code":"upstream_unavailable","message":"The DM service is temporarily unavailable, and you are not charged. Try again shortly. Retry a send with the same client_token, so the message never goes out twice.","request_id":"req_e9f2dca7700139b077ade2a9810e62a9"}}},"replies_unavailable":{"summary":"replies_unavailable","value":{"error":{"code":"replies_unavailable","message":"Checking for new replies is broken on our side, and we are fixing it. Saved messages still show without refresh=true. You are not charged.","request_id":"req_e9f2dca7700139b077ade2a9810e62a9"}}},"try_again_shortly":{"summary":"try_again_shortly","value":{"error":{"code":"try_again_shortly","message":"This conversation is busy on our side for a moment. Nothing was sent and you are not charged. Try again shortly with the same client_token.","request_id":"req_e9f2dca7700139b077ade2a9810e62a9"}}},"billing_unavailable":{"summary":"billing_unavailable","value":{"error":{"code":"billing_unavailable","message":"Billing is temporarily unavailable. No data was returned.","request_id":"req_e9f2dca7700139b077ade2a9810e62a9"}}}}}}}}}},"/v1/tiktok/profile":{"get":{"tags":["TikTok"],"operationId":"ttProfile","summary":"Profile","x-dashboard-cost":"$0.0005","description":"A TikTok account profile read model over the tracked corpus: nickname, bio, followers/following, video count, total hearts, verified/private flags, region, and secUid — plus the AI enrichment block when present.\n\nStrictly DB — an account we have never crawled is a `404`, never a crawl. Fetch a fresh profile with `/v1/tiktok/user_detail`.\n\nThe response carries no email or contact block. Find emails with `/v1/contacts/find-from-instagram/fast` or the other `/v1/contacts/find*` paths.","security":[{"bearerAuth":[]}],"parameters":[{"name":"q","in":"query","required":true,"description":"TikTok username, @handle, or `tiktok.com/@handle` URL.","schema":{"type":"string"},"example":"khaby.lame"}],"responses":{"200":{"description":"TikTok profile.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object"},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"id":652,"profile_id":31124,"platform":"tiktok","username":"flighthouse","sec_uid":"MS4wLjABAAAAnEkPI9XFOsqCQsqG7-JvND26SkmF2tHOSrDVR5abC0k","full_name":"flighthouse","biography":"New episodes daily! 🕺\nbusiness@flight.house","profile_pic_url":"https://p16-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/dbf978a5746e203e480ebce90c3d122d~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=9640&refresh_token=7a3cc35b&x-expires=1783792800&x-signature=qxRSzgrYpAs9mGJzkPyaJXnIi9g%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=useast5","followers":28797400,"following":1334,"posts_count":6379,"heart_count":2640783682,"is_verified":true,"is_private":false,"region":null,"last_scraped_at":"2026-07-09T18:01:38.263515Z","enrichment":null},"meta":{"cost":"$0.0005","balance":"$0.7957","request_id":"req_ad3fe5928f965f90b3b7dae6671ce971"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"404":{"description":"Account not in the tracked corpus.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_found","message":"nosuchuser","request_id":"req_5c10900e919bc7a3ff79b7501d582b4c"}}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/tiktok/videos":{"get":{"tags":["TikTok"],"operationId":"ttVideos","summary":"Videos","x-dashboard-cost":"$0.0005","description":"An account's tracked videos, newest first: caption, likes/comments/shares/plays, publish time, video/cover URLs, duration, and music. DB read over the tracked corpus — flat price for up to 100 videos a page. `next_cursor` is null on the last page; send it back as `cursor` for the next one. For a live walk of every video, use `/v1/tiktok/item_list`.","security":[{"bearerAuth":[]}],"parameters":[{"name":"q","in":"query","required":true,"description":"TikTok username, @handle, or `tiktok.com/@handle` URL.","schema":{"type":"string"},"example":"khaby.lame"},{"name":"limit","in":"query","required":false,"description":"How many videos to return (1–100). Flat price regardless of count.","schema":{"type":"integer","default":30,"minimum":1,"maximum":100},"examples":{"default":{"value":30,"x-disabled":true}}},{"name":"cursor","in":"query","required":false,"description":"Opaque `next_cursor` from the previous page.","schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Videos, most recent first.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","required":["videos","next_cursor","has_more"],"properties":{"videos":{"type":"array","items":{"type":"object"}},"next_cursor":{"type":"string","nullable":true,"description":"Opaque; pass back as `cursor`."},"has_more":{"type":"boolean","description":"True exactly when `next_cursor` is set."}}},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"videos":[{"tiktok_video_id":"7514078239745117470","caption":"Hint: The duck is technically a platypus 🤭 @Toni @Brianne Howey #antoniagentry #briannehowey #ginnyandgeorgia #ginnyandgeorgiaseason3 #guesstheshow @Netflix ","likes":186653,"comments":814,"shares":510,"plays":5732193,"posted_at":"2025-06-09T22:21:33Z","video_url":"https://www.tiktok.com/@flighthouse/video/7514078239745117470","cover_url":"https://p19-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/oMfRQE2RU1meiykO1BB7Qt6vABFNEoA1R1DVjE~tplv-photomode-tiktok-play.jpeg?lk3s=b59d6b55&x-expires=1750114800&x-signature=UW4EKVSc2%2F8aLe6XKz34kr2vIpw%3D&shp=b59d6b55&shcp=-","duration":8,"music_title":"Fame is a Gun","music_author":"Addison Rae"},{"tiktok_video_id":"7512557695241555246","caption":"OMW to go binge watch the new season of #ginnyandgeorgia like 🏃‍♀️ @Toni @Brianne Howey #antoniagentry #briannehowey #overcompensating #ginnyandgeorgiaseason3 @Netflix  ","likes":839092,"comments":893,"shares":3243,"plays":9938624,"posted_at":"2025-06-05T20:00:57Z","video_url":"https://www.tiktok.com/@flighthouse/video/7512557695241555246","cover_url":"https://p19-pu-sign-useast8.tiktokcdn-us.com/tos-useast5-p-0068-tx/ooi1IpxfP3jIZkCI09I0JAirGHbBXNwBAC5qBA~tplv-photomode-tiktok-play.jpeg?lk3s=b59d6b55&x-expires=1749848400&x-signature=hn1qpbo8e%2BjEiHv473mGMgnzNUU%3D&shp=b59d6b55&shcp=-","duration":26,"music_title":"Soul Survivor","music_author":"Young Jeezy"}],"next_cursor":null,"has_more":false},"meta":{"cost":"$0.0005","balance":"$0.7952","request_id":"req_2a7080ca40697d71b8a96a154129fa9d"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"404":{"description":"Account not in the tracked corpus.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_found","message":"nosuchuser","request_id":"req_5c10900e919bc7a3ff79b7501d582b4c"}}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/tiktok/stats":{"get":{"tags":["TikTok"],"operationId":"ttStats","summary":"Engagement analytics","x-dashboard-cost":"$0.0010","description":"Engagement analytics over an account's tracked videos: total/avg/max/median plays, avg likes/comments/shares, average engagement rate ((likes+comments+shares)/plays), 90-day posting cadence, and the top 3 videos by plays.\n\nNumbers describe the tracked corpus (`tracked_videos`), not the account's full TikTok history.","security":[{"bearerAuth":[]}],"parameters":[{"name":"q","in":"query","required":true,"description":"TikTok username, @handle, or `tiktok.com/@handle` URL.","schema":{"type":"string"},"example":"khaby.lame"}],"responses":{"200":{"description":"Engagement aggregates.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object"},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"username":"flighthouse","followers":28797400,"tracked_videos":137,"total_plays":580270435,"avg_plays":4235550.6,"max_plays":27680222,"median_plays":2941250,"avg_likes":372109.3,"avg_comments":701.1,"avg_shares":7544.1,"avg_engagement_rate":0.086831,"videos_last_90d":0,"videos_per_week_90d":0,"latest_posted_at":"2025-06-09T22:21:33Z","earliest_posted_at":"2023-11-22T19:06:45Z","top_videos":[{"tiktok_video_id":"7429045534226205983","caption":"Name a more iconic duo 💅 @Maddie L Bailey @Toni #madisonbailey #antoniagentry #gracieabrams #timecut #iloveyouimsorry @Netflix ","likes":3114842,"comments":6000,"shares":59135,"plays":27680222,"posted_at":"2024-10-23T18:51:06Z","cover_url":"https://p19-pu-sign-useast8.tiktokcdn-us.com/tos-useast8-p-0068-tx2/05f8c8369cd64d45a448fb82dfabc35d_1729709469~tplv-photomode-tiktok-play.jpeg?lk3s=b59d6b55&x-expires=1745006400&x-signature=KltRRmgWY64rtrVpIeSjlI8o2CQ%3D&shp=b59d6b55&shcp=-"},{"tiktok_video_id":"7462507490895482158","caption":"In loving memory of Reatha “Rose” Grey ❤️‍🩹 @Retirement House #retirementhouse ","likes":3525060,"comments":12809,"shares":297362,"plays":23346871,"posted_at":"2025-01-21T23:01:00Z","cover_url":"https://p16-sign.tiktokcdn-us.com/tos-useast5-p-0068-tx/o0WcGBSDnBJqChnFEMCCzAI1EDeQfk0guRIyuJ~tplv-photomode-tiktok-play.jpeg?lk3s=b59d6b55&x-expires=1746266400&x-signature=RT3YOLBHQemKfuHI%2BXF%2F69hDlrQ%3D&shp=b59d6b55&shcp=-"}]},"meta":{"cost":"$0.0010","balance":"$0.7942","request_id":"req_6d57ee5252705a4e0ce0320c4df4d1db"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"404":{"description":"Account not in the tracked corpus.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_found","message":"nosuchuser","request_id":"req_5c10900e919bc7a3ff79b7501d582b4c"}}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/tiktok/stored/post":{"get":{"tags":["TikTok"],"operationId":"ttStoredPost","summary":"Stored video","description":"One stored video with its author: caption, counts, publish time, video and cover URLs, duration and sound.\n\nStrictly DB: this reads what the crawler already stored and never crawls. A miss is a `404` and is not billed. Fetch a fresh one with `/v1/tiktok/item_detail`.","x-dashboard-cost":"$0.0005","security":[{"bearerAuth":[]}],"parameters":[{"name":"q","in":"query","required":true,"description":"TikTok video id, or its `tiktok.com/@handle/video/<id>` URL.","example":"7697307919943060767","schema":{"type":"string","maxLength":300,"example":"7697307919943060767"}}],"responses":{"200":{"description":"Success. The example is a captured response; long lists are truncated.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":true},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"tiktok_video_id":"7697307919943060767","caption":"I guess is time to retire #learnfromkhaby #comedy 🥊","likes":302500,"comments":7406,"shares":32500,"plays":4400000,"posted_at":"2026-10-16T16:46:21Z","video_url":"https://www.tiktok.com/@khaby.lame/video/7697307919943060767","duration":9,"music_title":"original sound","music_author":"Khabane lame","author_username":"khaby.lame","author_full_name":"Khabane lame","author_followers":162990885,"author_is_verified":true,"cover_url":"https://api.virev.ai/v1/media/tiktok_video/29940675/video_thumbnail?e=1793750400&s=47b7ff47153001fd73798b60ae3ac4a7"},"meta":{"cost":"$0.0005","balance":"$3.3627","request_id":"req_5c448ce558f96ef85efc4cfc04ae4668"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"404":{"description":"The video is not stored. You are not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/tiktok/stored/post/comments":{"get":{"tags":["TikTok"],"operationId":"ttStoredPostComments","summary":"Stored video comments","description":"The comments stored for one video, in the order they were stored, with `next_cursor` while `has_more` is true. A stored video with no collected comment page answers an empty list.\n\nStrictly DB: this reads what the crawler already stored and never crawls. A miss is a `404` and is not billed. Collect more with `/v1/tiktok/comment_list`.","x-dashboard-cost":"$0.0005","security":[{"bearerAuth":[]}],"parameters":[{"name":"q","in":"query","required":true,"description":"TikTok video id, or its `tiktok.com/@handle/video/<id>` URL.","example":"7681719358225239326","schema":{"type":"string","maxLength":300,"example":"7681719358225239326"}},{"name":"cursor","in":"query","required":false,"description":"Opaque `next_cursor` from the previous page.","schema":{"type":"string","maxLength":500}},{"name":"limit","in":"query","required":false,"description":"Comments per page.","schema":{"type":"integer","minimum":1,"maximum":200,"default":50},"examples":{"default":{"value":50,"x-disabled":true}}}],"responses":{"200":{"description":"Success. The example is a captured response; long lists are truncated.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":true},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"post":{"video_id":"7681719358225239326"},"comments":[{"tiktok_comment_id":"7681901814388622081","author_username":"annakhan_annie","author_tiktok_id":"6586283068750479365","text":"My hero is Prophet Muhammad ﷺ ❤️","like_count":12493,"reply_count":146,"posted_at":"2026-09-05T04:22:41+00:00"},{"tiktok_comment_id":"7681721078482387729","author_username":"ovayomzangwe901","author_tiktok_id":"7151662998456632325","text":"1m for what?😭","like_count":7533,"reply_count":41,"posted_at":"2026-09-04T16:41:16+00:00"},{"tiktok_comment_id":"7695763267344974598","author_username":"thetradesibysci","author_tiktok_id":"7669869049291965441","text":"thought he was the only one","like_count":0,"reply_count":0,"posted_at":"2026-10-12T12:52:12+00:00"}],"stored_total":3,"next_cursor":null,"has_more":false},"meta":{"cost":"$0.0005","balance":"$3.3627","request_id":"req_625c9591e615c5ff99bc2ee23627bf8e"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"404":{"description":"The video is not stored. You are not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/tiktok/user_detail":{"get":{"tags":["TikTok"],"operationId":"ttUserDetail","summary":"user_detail","x-dashboard-cost":"$0.0005","x-example-query":{"handle":"flighthouse"},"description":"The profile page's user detail: counts, bio, flags, avatar and bio links. `extra` carries `sec_uid`, `heart_count` and `region`. Returns `Profile` under `data`; the upstream document is an HTML page, so `get_raw` is not available.\n\nA field TikTok does not carry is null, a list it does not carry is `[]`, and TikTok-only facts sit under `extra`. Unknown, unsupported, and repeated query parameters return 400 before acquisition or billing.","security":[{"bearerAuth":[]}],"parameters":[{"name":"handle","in":"query","required":true,"description":"TikTok handle, with or without `@`, or a `tiktok.com/@handle` URL.","example":"flighthouse","schema":{"type":"string"}},{"name":"cached","in":"query","required":false,"description":"`auto` (default) serves a read saved within the last 24 hours for these exact arguments, otherwise fetches. `cache_only` never contacts TikTok (404 `not_cached` when nothing is saved, whatever its age). `live` always fetches. Anything else is a `400`.","schema":{"type":"string","enum":["auto","cache_only","live"],"default":"auto"},"examples":{"default":{"value":"auto","x-disabled":true}}},{"name":"get_raw","in":"query","required":false,"description":"Not available on this operation: the upstream document is an HTML page, and `true` answers 400. The default `false` returns the normalized type.","schema":{"type":"boolean","default":false},"examples":{"default":{"value":false,"x-disabled":true}}}],"responses":{"200":{"description":"`Profile` under `data`.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/Profile"},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"id":"24645153","username":"flighthouse","full_name":"flighthouse","biography":"New episodes daily! 🕺\nbusiness@flight.house","followers":28796800,"following":1334,"posts":6382,"is_verified":true,"is_private":false,"avatar_url":"https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/dbf978a5746e203e480ebce90c3d122d~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=14579&refresh_token=1657644e&x-expires=1784044800&x-signature=ioC6oc2YmoMYuvRruub%2FlBPcO0A%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my","external_url":null,"links":[],"category":null,"business_category":null,"is_business":null,"is_professional":null,"business_email":null,"business_phone":null,"business_address":null,"pronouns":[],"highlight_reel_count":null,"has_clips":null,"is_recently_joined":null,"fbid":null,"extra":{"sec_uid":"MS4wLjABAAAAnEkPI9XFOsqCQsqG7-JvND26SkmF2tHOSrDVR5abC0k","heart_count":2641246983,"region":null}},"meta":{"source":"live","fetched_at":"2026-07-12T16:03:16.146109+00:00","cost":"$0.0005","balance":"$0.3772","request_id":"req_5c5ab01bcb83c669903072760ebadb25"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"404":{"description":"`cached=cache_only` found nothing saved for these arguments (`not_cached`; call again with `cached=auto` to fetch it), or the TikTok account or item does not exist (`not_found`). You are not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_cached","message":"no saved tiktok/user_detail read for 'flighthouse'. cached=cache_only never fetches, so call again with cached=auto to fetch it. You are not charged.","request_id":"req_5c10900e919bc7a3ff79b7501d582b4c"}}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/tiktok/item_detail":{"get":{"tags":["TikTok"],"operationId":"ttItemDetail","summary":"item_detail","x-dashboard-cost":"$0.0005","x-example-query":{"url":"https://www.tiktok.com/@khaby.lame/video/7681719358225239326"},"description":"One video from its public page: caption, counts, sound, cover and author. Returns `Post` under `data`; the upstream document is an HTML page, so `get_raw` is not available.\n\nA field TikTok does not carry is null, a list it does not carry is `[]`, and TikTok-only facts sit under `extra`. Unknown, unsupported, and repeated query parameters return 400 before acquisition or billing.","security":[{"bearerAuth":[]}],"parameters":[{"name":"url","in":"query","required":true,"description":"TikTok video URL, `https://www.tiktok.com/@handle/video/<id>`. A bare video id is refused, because the read needs the author.","example":"https://www.tiktok.com/@khaby.lame/video/7681719358225239326","schema":{"type":"string"}},{"name":"cached","in":"query","required":false,"description":"`auto` (default) serves a read saved within the last 24 hours for these exact arguments, otherwise fetches. `cache_only` never contacts TikTok (404 `not_cached` when nothing is saved, whatever its age). `live` always fetches. Anything else is a `400`.","schema":{"type":"string","enum":["auto","cache_only","live"],"default":"auto"},"examples":{"default":{"value":"auto","x-disabled":true}}},{"name":"get_raw","in":"query","required":false,"description":"Not available on this operation: the upstream document is an HTML page, and `true` answers 400. The default `false` returns the normalized type.","schema":{"type":"boolean","default":false},"examples":{"default":{"value":false,"x-disabled":true}}}],"responses":{"200":{"description":"`Post` under `data`.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/Post"},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"id":"7681719358225239326","shortcode":null,"taken_at":"2026-09-04T16:34:44+00:00","kind":"video","product_type":null,"caption":"Well… that didn’t go as planned #learnfromkhaby #comedy ","hashtags":["comedy","learnfromkhaby"],"mentions":[],"accessibility_caption":null,"likes":1900000,"comments":26400,"views":16600000,"counts_hidden":null,"comments_disabled":null,"is_pinned":null,"is_paid_partnership":null,"owner":{"id":"127905465618821121","username":"khaby.lame","full_name":"Khabane lame","is_verified":true,"is_private":false,"avatar_url":"https://f005.backblazeb2.com/file/influencer-dev/staging/crawler/tiktok_account/39223.webp","latest_story_at":null,"extra":{"sec_uid":"MS4wLjABAAAAwAg0rSzO65WQfz4RzQgGv2Xdv108BgPXhRrrmNVIHQZ9PO8-flwwRtEppYTS0OjA"}},"coauthors":[],"sponsors":[],"tagged":[],"location":null,"audio":{"id":null,"title":"original sound","artist":"Khabane lame","is_original":null},"thumbnail_url":"https://f005.backblazeb2.com/file/influencer-dev/staging/crawler/tiktok_video/15196185.webp","video_duration":48,"media":[],"media_urls":[],"extra":{"url":"https://www.tiktok.com/@khaby.lame/video/7681719358225239326","shares":32900,"saves":82004}},"meta":{"source":"db","fetched_at":"2026-10-12T12:57:08.091819+00:00","cost":"$0.0005","balance":"$3.3627","request_id":"req_1d9624b05a144b873a94fca8316b13d3"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"404":{"description":"`cached=cache_only` found nothing saved for these arguments (`not_cached`; call again with `cached=auto` to fetch it), or the TikTok account or item does not exist (`not_found`). You are not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_cached","message":"no saved tiktok/item_detail read for 'https://www.tiktok.com/@khaby.lame/video/7681719358225239326'. cached=cache_only never fetches, so call again with cached=auto to fetch it. You are not charged.","request_id":"req_5c10900e919bc7a3ff79b7501d582b4c"}}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/tiktok/item_transcript":{"get":{"tags":["TikTok"],"operationId":"ttItemTranscript","summary":"item_transcript","x-dashboard-cost":"$0.0005","x-example-query":{"url":"https://www.tiktok.com/@khaby.lame/video/7683944847840922911"},"description":"The video's native caption track as text. This reads captions TikTok already has; it does not transcribe. A video with no native caption answers 502 and is not billed. Returns `Transcript` under `data`; the upstream document is an HTML page, so `get_raw` is not available.\n\nA field TikTok does not carry is null, a list it does not carry is `[]`, and TikTok-only facts sit under `extra`. Unknown, unsupported, and repeated query parameters return 400 before acquisition or billing.","security":[{"bearerAuth":[]}],"parameters":[{"name":"url","in":"query","required":true,"description":"TikTok video URL, `https://www.tiktok.com/@handle/video/<id>`. A bare video id is refused, because the read needs the author.","example":"https://www.tiktok.com/@khaby.lame/video/7683944847840922911","schema":{"type":"string"}},{"name":"language","in":"query","required":false,"description":"Two-letter caption language such as `en`. Omitted, the video’s own caption language is returned.","schema":{"type":"string","pattern":"^[A-Za-z]{2}$"}},{"name":"cached","in":"query","required":false,"description":"`auto` (default) serves a read saved within the last 24 hours for these exact arguments, otherwise fetches. `cache_only` never contacts TikTok (404 `not_cached` when nothing is saved, whatever its age). `live` always fetches. Anything else is a `400`.","schema":{"type":"string","enum":["auto","cache_only","live"],"default":"auto"},"examples":{"default":{"value":"auto","x-disabled":true}}},{"name":"get_raw","in":"query","required":false,"description":"Not available on this operation: the upstream document is an HTML page, and `true` answers 400. The default `false` returns the normalized type.","schema":{"type":"boolean","default":false},"examples":{"default":{"value":false,"x-disabled":true}}}],"responses":{"200":{"description":"`Transcript` under `data`.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/Transcript"},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"video_id":"7683944847840922911","language":"en","source_url":"https://v16-webapp.tiktokcdn-eu.com/82d66c139fa9f2fe803d93003e58d9ab/6acf7cbc/video/tos/alisg/tos-alisg-v-37c799-sg/eeaec5dbfa504b79bd8ce9b1d02129e9/?a=1988&bti=ODszNWYuMDE6&&bt=3049&ft=_sO_C~0xE12NvjR7yF7nRf6SYlcI6IxVvYjpiX&mime_type=video_mp4&rc=M2t3OXA5cjtnZDMzaTczNEBpM2t3OXA5cjtnZDMzaTczNEAuaGRyMmRjamVhLS1kMTJzYSMuaGRyMmRjamVhLS1kMTJzcw%3D%3D&l=20261012125907872992E6434E9E104923&btag=e00048000","text":"is here look\nis the tile of competition\nit's here look it's the souza santos tile\nconstructions"},"meta":{"source":"db","fetched_at":"2026-10-12T12:59:10.318343+00:00","cost":"$0.0005","balance":"$3.3627","request_id":"req_ef3fbbe432778194164201f84464b060"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"404":{"description":"`cached=cache_only` found nothing saved for these arguments (`not_cached`; call again with `cached=auto` to fetch it), or the TikTok account or item does not exist (`not_found`). You are not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_cached","message":"no saved tiktok/item_transcript read for 'https://www.tiktok.com/@khaby.lame/video/7683944847840922911'. cached=cache_only never fetches, so call again with cached=auto to fetch it. You are not charged.","request_id":"req_5c10900e919bc7a3ff79b7501d582b4c"}}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/tiktok/item_list":{"get":{"tags":["TikTok"],"operationId":"ttItemList","summary":"item_list","x-dashboard-cost":"$0.0005/35","x-example-query":{"handle":"nike","max_pages":"1"},"description":"The account's videos, newest first. With max_pages=1, returns `Page[Post]` under `data`; with `get_raw=true` returns the upstream JSON.\n\nThe default request creates a durable job (202). Use max_pages=1 for one synchronous Page response (200). Poll status_url, then read results_url with its opaque cursor. Acquisition stops at the first of since, max_pages, or exhaustion. Jobs continue after disconnects. Result responses are bounded to 3 MiB; this does not limit the crawl. Supply Idempotency-Key to recover a lost submission response; reuse it with the same inputs.\n\nA field TikTok does not carry is null, a list it does not carry is `[]`, and TikTok-only facts sit under `extra`. Unknown, unsupported, and repeated query parameters return 400 before acquisition or billing.\n\nBilling: $0.0005 per 35 unique returned items (one native page), rounded up to a minimum of one billing unit. Jobs settle once after successful completion. Submission, polling and repeat downloads are free.","security":[{"bearerAuth":[]}],"parameters":[{"name":"handle","in":"query","required":true,"description":"TikTok handle, with or without `@`, or a `tiktok.com/@handle` URL.","example":"nike","schema":{"type":"string"}},{"name":"since","in":"query","required":false,"description":"Stop at this date. `2025-09-21` means midnight UTC (2025-09-21T00:00:00Z). Datetimes must use RFC3339 with a timezone, for example `2025-09-21T09:00:00+09:00`. `365d` means 365 days before submission. Invalid calendar dates return 400. With max_pages, the first boundary reached stops the walk. since alone creates a job.","schema":{"type":"string"},"examples":{"default":{"value":"2025-09-21","x-disabled":true},"date":{"value":"2025-09-21","x-disabled":true},"datetime":{"value":"2025-09-21T00:00:00Z","x-disabled":true},"duration":{"value":"365d","x-disabled":true}}},{"name":"max_pages","in":"query","required":false,"example":1,"description":"Maximum pages to fetch. -1 walks until exhaustion or since with no page cap, and must be written. Omitted, since alone bounds the walk; with neither, the job stops after 10 pages. Any positive integer is accepted. 1 returns one page synchronously with HTTP 200; any other value creates a durable job with HTTP 202.","schema":{"type":"integer","anyOf":[{"enum":[-1]},{"minimum":1}]}},{"name":"cursor","in":"query","required":false,"description":"Opaque next_cursor from an earlier answer of this operation, also with `get_raw=true`. A native TikTok cursor from a raw page answers 400. Result download cursors belong to the results route.","schema":{"type":"string","minLength":1}},{"name":"page_size","in":"query","required":false,"description":"Native count, default 35. TikTok answers at most 35. Billed per 35 unique returned items, one native page.","schema":{"type":"integer","default":35,"minimum":1,"maximum":35},"examples":{"default":{"value":35,"x-disabled":true}}},{"name":"cached","in":"query","required":false,"description":"`auto` (default) serves a read saved within the last 24 hours for these exact arguments, otherwise fetches. `cache_only` never contacts TikTok (404 `not_cached` when nothing is saved, whatever its age). `live` always fetches. Anything else is a `400`. `cache_only` reads one saved page per request: omit `max_pages` or pass 1, and continue with `next_cursor`.","schema":{"type":"string","enum":["auto","cache_only","live"],"default":"auto"},"examples":{"default":{"value":"auto","x-disabled":true}}},{"name":"get_raw","in":"query","required":false,"description":"`true` returns the upstream JSON exactly as TikTok answered it instead of the normalized `Page[Post]`.","schema":{"type":"boolean","default":false},"examples":{"default":{"value":false,"x-disabled":true}}},{"name":"Idempotency-Key","in":"header","required":false,"description":"Reuse this key with the same inputs to recover a lost job submission. A different input with the same key returns 409.","schema":{"type":"string","minLength":1,"maxLength":200}}],"responses":{"200":{"description":"`Page[Post]` under `data`; with `get_raw=true` the upstream JSON.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"anyOf":[{"type":"object","required":["items","pages","next_cursor","has_more","stop_reason","coverage"],"properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/Post"},"description":"`Post` of every page walked, in page order."},"pages":{"type":"array","items":{"$ref":"#/components/schemas/PageRead"},"description":"One entry per page walked."},"next_cursor":{"type":"string","nullable":true,"description":"Opaque; pass back as `cursor` to continue."},"has_more":{"type":"boolean","description":"True when `next_cursor` is set, and when the walk stopped `cursor_stalled` on a page that said more results exist but gave no cursor to send back."},"stop_reason":{"type":"string","enum":["pages","since","exhausted","cursor_stalled","repeated_content","deadline","blocked","caught_up"],"description":"Why the walk stopped. `pages`: the page budget is spent and `next_cursor` continues it. `deadline`: the call ran out of time before its next page; `next_cursor` continues it. `since`: a whole page was older than `since`. `exhausted`: TikTok reported the end. `cursor_stalled`: TikTok claimed more but repeated or omitted its cursor. `repeated_content`: a page held only items already seen. `blocked`: TikTok refused a later page; `next_cursor` is the page it refused. `caught_up`: only watch passes the crawler runs for itself stop this way."},"coverage":{"$ref":"#/components/schemas/Coverage"}}},{"type":"object","required":["pages","next_cursor","has_more","stop_reason"],"description":"`get_raw=true`: every native page walked, exactly as TikTok answered it, plus the opaque `next_cursor` and `stop_reason` of the walk.","properties":{"pages":{"type":"array","items":{"type":"object","additionalProperties":true,"required":["itemList"],"properties":{"itemList":{"type":"array","items":{"type":"object","additionalProperties":true}}}},"description":"One native page per page walked, upstream bytes unchanged."},"next_cursor":{"type":"string","nullable":true,"description":"Opaque; pass back as `cursor`."},"has_more":{"type":"boolean","description":"True when `next_cursor` is set, and when the walk stopped `cursor_stalled` on a page that said more results exist but gave no cursor to send back."},"stop_reason":{"type":"string","enum":["pages","since","exhausted","cursor_stalled","repeated_content","deadline","blocked","caught_up"],"description":"Why the walk stopped. `pages`: the page budget is spent and `next_cursor` continues it. `deadline`: the call ran out of time before its next page; `next_cursor` continues it. `since`: a whole page was older than `since`. `exhausted`: TikTok reported the end. `cursor_stalled`: TikTok claimed more but repeated or omitted its cursor. `repeated_content`: a page held only items already seen. `blocked`: TikTok refused a later page; `next_cursor` is the page it refused. `caught_up`: only watch passes the crawler runs for itself stop this way."}}}],"description":"`Page[Post]`, or the upstream JSON when `get_raw=true`."},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"items":[{"id":"7695069640657079565","shortcode":null,"taken_at":"2026-10-10T16:00:43+00:00","kind":"video","product_type":null,"caption":"Snowball fight ready","hashtags":[],"mentions":[],"accessibility_caption":null,"likes":1419,"comments":41,"views":45900,"counts_hidden":null,"comments_disabled":null,"is_pinned":null,"is_paid_partnership":null,"owner":{"id":"208464585232822272","username":"nike","full_name":"Nike","is_verified":true,"is_private":false,"avatar_url":"https://p16-common-sign.tiktokcdn-eu.com/tos-maliva-avt-0068/e0b0ac7b6ad6447a8e923fd1eb162f2c~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=10399&refresh_token=eb254230&x-expires=1791982800&x-signature=1QyErOKNGhmDnSaGKnhTLIEdRVM%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=no1a","latest_story_at":null,"extra":{"sec_uid":"MS4wLjABAAAA_3ndMt8d_tECTdpKgCxcx238tOnQZX-20wqN01aMui5zQ7hsqSdff-jC5qYC-Cl_"}},"coauthors":[],"sponsors":[],"tagged":[],"location":null,"audio":{"id":null,"title":"original sound","artist":"Nike","is_original":null},"thumbnail_url":"https://p16-common-sign.tiktokcdn-eu.com/tos-useast5-p-0068-tx/oomqCKPAEpSFYDYADgwEySfAREAzDDAvEfnIYS~tplv-tiktokx-origin.image?dr=10395&x-expires=1791982800&x-signature=0OYbQ2lyESHF5j5bhSFADwlfzxQ%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=no1a","video_duration":28,"media":[],"media_urls":[],"extra":{"url":"https://www.tiktok.com/@nike/video/7695069640657079565","shares":19,"saves":52}},{"id":"7694698658817756429","shortcode":null,"taken_at":"2026-10-09T16:01:22+00:00","kind":"video","product_type":null,"caption":"Thermodynamics testing footage 001. ACG Lava Flow Ultralight. Meet your new heat source ♨️","hashtags":[],"mentions":[],"accessibility_caption":null,"likes":7822,"comments":81,"views":78800,"counts_hidden":null,"comments_disabled":null,"is_pinned":null,"is_paid_partnership":null,"owner":{"id":"208464585232822272","username":"nike","full_name":"Nike","is_verified":true,"is_private":false,"avatar_url":"https://p16-common-sign.tiktokcdn-eu.com/tos-maliva-avt-0068/e0b0ac7b6ad6447a8e923fd1eb162f2c~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=10399&refresh_token=eb254230&x-expires=1791982800&x-signature=1QyErOKNGhmDnSaGKnhTLIEdRVM%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=no1a","latest_story_at":null,"extra":{"sec_uid":"MS4wLjABAAAA_3ndMt8d_tECTdpKgCxcx238tOnQZX-20wqN01aMui5zQ7hsqSdff-jC5qYC-Cl_"}},"coauthors":[],"sponsors":[],"tagged":[],"location":null,"audio":{"id":null,"title":"original sound","artist":"Nike","is_original":null},"thumbnail_url":"https://p16-common-sign.tiktokcdn-eu.com/tos-useast5-p-0068-tx/oU9EJfQJJgHRB9AIAI4iAoCSDDyiEpdaqEfOAD~tplv-tiktokx-origin.image?dr=10395&x-expires=1791982800&x-signature=tRjbR%2FxEPsHczoo9pybe7D9asg0%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=no1a","video_duration":24,"media":[],"media_urls":[],"extra":{"url":"https://www.tiktok.com/@nike/video/7694698658817756429","shares":150,"saves":201}},{"id":"7694398644551748877","shortcode":null,"taken_at":"2026-10-08T20:36:48+00:00","kind":"video","product_type":null,"caption":"Five MVPs. At some point, it stops being a debate and starts being a pattern. Congrats, @A’ja Wilson ","hashtags":[],"mentions":[],"accessibility_caption":null,"likes":13500,"comments":237,"views":64500,"counts_hidden":null,"comments_disabled":null,"is_pinned":null,"is_paid_partnership":null,"owner":{"id":"208464585232822272","username":"nike","full_name":"Nike","is_verified":true,"is_private":false,"avatar_url":"https://p16-common-sign.tiktokcdn-eu.com/tos-maliva-avt-0068/e0b0ac7b6ad6447a8e923fd1eb162f2c~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=10399&refresh_token=eb254230&x-expires=1791982800&x-signature=1QyErOKNGhmDnSaGKnhTLIEdRVM%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=no1a","latest_story_at":null,"extra":{"sec_uid":"MS4wLjABAAAA_3ndMt8d_tECTdpKgCxcx238tOnQZX-20wqN01aMui5zQ7hsqSdff-jC5qYC-Cl_"}},"coauthors":[],"sponsors":[],"tagged":[],"location":null,"audio":{"id":null,"title":"original sound","artist":"Nike","is_original":null},"thumbnail_url":"https://p16-common-sign.tiktokcdn-eu.com/tos-useast5-p-0068-tx/owAefLthAtWN9GWeQQfcfbAnGyIiPWuQAASPIa~tplv-tiktokx-origin.image?dr=10395&x-expires=1791982800&x-signature=e5SSGR1hZX75V%2FVtyRQVEGSAW6M%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=no1a","video_duration":30,"media":[],"media_urls":[],"extra":{"url":"https://www.tiktok.com/@nike/video/7694398644551748877","shares":648,"saves":480}}],"pages":[{"cursor":null,"fetched_at":"2026-10-12T13:42:50.080320+00:00","count":35}],"next_cursor":"eyJjdXJzb3IiOiIxNzgxNDA3OTcyNzA5Iiwib3AiOiJpdGVtX2xpc3QifQ","has_more":true,"stop_reason":"pages","coverage":{"since":null,"oldest_at":"2026-10-08T20:36:48+00:00","since_reached":false}},"meta":{"source":"live","fetched_at":"2026-10-12T13:42:50.080320+00:00","cost":"$0.0005","balance":"$3.3627","request_id":"req_c57bc898ef47b9ce328001f733dac433"}}}}},"202":{"description":"Durable job accepted. No completed-result charge. Save batch_id; poll status_url. Retry submission with the same Idempotency-Key after a lost response. An account may have five queued, running or payment-required jobs. A sixth new job returns 429 rate_limited. Matching idempotent replays still work at the limit. Ready and failed jobs release their slots; pages within a job remain unbounded. This is a synthetic contract example, not a live capture.","x-example-provenance":"synthetic-contract","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","required":["batch_id","status","status_url","results_url","cost","item_count","error","retry_at","total","done_count","failed_count","created_at","started_at","finished_at"],"properties":{"batch_id":{"type":"string"},"status":{"type":"string","enum":["queued","running","payment_required","ready","failed"]},"status_url":{"type":"string"},"results_url":{"type":"string"},"cost":{"type":"string"},"item_count":{"type":"integer","nullable":true},"error":{"type":"string","nullable":true,"description":"Null unless failed. A failed target carries its own code; incomplete_result appears only when it has none and pages of the result are missing. profile_not_found, post_not_found, upstream_not_found or not_found: the target does not exist or is not visible. not_visible: The account exists, but its posts are not visible to logged-out readers (private, restricted, or hidden by Instagram). Retrying will not change the result until the account changes. not_cached: cached=cache_only found no saved read. incomplete_result: pages of the result are missing. temporarily_unavailable: the target could not be read for now (no capacity, a pause or repeated refusals); retry later with a new job. result_item_too_large: one result unit exceeds the delivery budget. result_snapshot_missing or result_snapshot_corrupt: the crawler could not serve the retained result of a paid job, and its charge is refunded; if the crawler serves it again, a later results read returns it and charges the job again. crawler_submit_400, crawler_submit_404 or crawler_submit_422: the crawl service refused the job request. crawler_job_failed: any other failure; the same job is not expected to succeed if resubmitted. cancelled: the job was cancelled with POST /v1/jobs/{job_id}/cancel. No failed job costs anything: only result_snapshot_missing and result_snapshot_corrupt follow a charge, and that charge is refunded."},"retry_at":{"type":"string","format":"date-time","nullable":true,"description":"Null unless the job failed temporarily_unavailable because a crawl route was closed for every caller. Then it is when the route opens again, and the response carries the same time as a Retry-After header in seconds. Submit a new job after it."},"total":{"type":"integer","description":"Targets in the job. A job submitted through a /v1 route has one."},"done_count":{"type":"integer","description":"Targets the crawler finished."},"failed_count":{"type":"integer","description":"Targets that failed."},"created_at":{"type":"string","format":"date-time","description":"When the job was submitted."},"started_at":{"type":"string","format":"date-time","nullable":true,"description":"When the crawler started the job. Null until it starts."},"finished_at":{"type":"string","format":"date-time","nullable":true,"description":"When the job finished or failed. Null while it is queued or running."}}},"meta":{"type":"object","required":["cost","request_id"],"properties":{"cost":{"type":"string","example":"$0.0000"},"request_id":{"type":"string"}}}}},"example":{"data":{"batch_id":"job_7641d5f0-717d-4b70-a2f1-f58d846d7242","status":"queued","status_url":"/v1/jobs/job_7641d5f0-717d-4b70-a2f1-f58d846d7242","results_url":"/v1/jobs/job_7641d5f0-717d-4b70-a2f1-f58d846d7242/results","cost":"$0.0000","item_count":null,"error":null,"retry_at":null,"total":1,"done_count":0,"failed_count":0,"created_at":"2026-10-12T12:56:17.403Z","started_at":null,"finished_at":null},"meta":{"cost":"$0.0000","request_id":"req_job_example"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"404":{"description":"`cached=cache_only` found nothing saved for these arguments (`not_cached`; call again with `cached=auto` to fetch it), or the TikTok account or item does not exist (`not_found`). You are not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_cached","message":"no saved tiktok/item_list read for 'nike'. cached=cache_only never fetches, so call again with cached=auto to fetch it. You are not charged.","request_id":"req_5c10900e919bc7a3ff79b7501d582b4c"}}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/tiktok/challenge_item_list":{"get":{"tags":["TikTok"],"operationId":"ttChallengeItemList","summary":"challenge_item_list","x-dashboard-cost":"$0.0005/30","x-example-query":{"tag":"skincare","max_pages":"1"},"description":"A hashtag's videos. TikTok pads the feed with videos that lack the tag, so only videos that carry it are answered; `get_raw=true` returns every native item. With max_pages=1, returns `Page[Post]` under `data`; with `get_raw=true` returns the upstream JSON.\n\nThe default request creates a durable job (202). Use max_pages=1 for one synchronous Page response (200). Poll status_url, then read results_url with its opaque cursor. Acquisition stops at the first of since, max_pages, or exhaustion. Jobs continue after disconnects. Result responses are bounded to 3 MiB; this does not limit the crawl. Supply Idempotency-Key to recover a lost submission response; reuse it with the same inputs.\n\nA field TikTok does not carry is null, a list it does not carry is `[]`, and TikTok-only facts sit under `extra`. Unknown, unsupported, and repeated query parameters return 400 before acquisition or billing.\n\nBilling: $0.0005 per 30 unique returned items (one native page), rounded up to a minimum of one billing unit. Jobs settle once after successful completion. Submission, polling and repeat downloads are free.","security":[{"bearerAuth":[]}],"parameters":[{"name":"tag","in":"query","required":true,"description":"A hashtag, with or without `#`.","example":"skincare","schema":{"type":"string"}},{"name":"since","in":"query","required":false,"description":"Stop at this date. `2025-09-21` means midnight UTC (2025-09-21T00:00:00Z). Datetimes must use RFC3339 with a timezone, for example `2025-09-21T09:00:00+09:00`. `365d` means 365 days before submission. Invalid calendar dates return 400. With max_pages, the first boundary reached stops the walk. since alone creates a job.","schema":{"type":"string"},"examples":{"default":{"value":"2025-09-21","x-disabled":true},"date":{"value":"2025-09-21","x-disabled":true},"datetime":{"value":"2025-09-21T00:00:00Z","x-disabled":true},"duration":{"value":"365d","x-disabled":true}}},{"name":"max_pages","in":"query","required":false,"example":1,"description":"Maximum pages to fetch. -1 walks until exhaustion or since with no page cap, and must be written. Omitted, since alone bounds the walk; with neither, the job stops after 10 pages. Any positive integer is accepted. 1 returns one page synchronously with HTTP 200; any other value creates a durable job with HTTP 202.","schema":{"type":"integer","anyOf":[{"enum":[-1]},{"minimum":1}]}},{"name":"cursor","in":"query","required":false,"description":"Opaque next_cursor from an earlier answer of this operation, also with `get_raw=true`. A native TikTok cursor from a raw page answers 400. Result download cursors belong to the results route.","schema":{"type":"string","minLength":1}},{"name":"page_size","in":"query","required":false,"description":"Native count, default 30. TikTok answers at most 30. Billed per 30 unique returned items, one native page.","schema":{"type":"integer","default":30,"minimum":1,"maximum":30},"examples":{"default":{"value":30,"x-disabled":true}}},{"name":"cached","in":"query","required":false,"description":"`auto` (default) serves a read saved within the last 24 hours for these exact arguments, otherwise fetches. `cache_only` never contacts TikTok (404 `not_cached` when nothing is saved, whatever its age). `live` always fetches. Anything else is a `400`. `cache_only` reads one saved page per request: omit `max_pages` or pass 1, and continue with `next_cursor`.","schema":{"type":"string","enum":["auto","cache_only","live"],"default":"auto"},"examples":{"default":{"value":"auto","x-disabled":true}}},{"name":"get_raw","in":"query","required":false,"description":"`true` returns the upstream JSON exactly as TikTok answered it instead of the normalized `Page[Post]`.","schema":{"type":"boolean","default":false},"examples":{"default":{"value":false,"x-disabled":true}}},{"name":"Idempotency-Key","in":"header","required":false,"description":"Reuse this key with the same inputs to recover a lost job submission. A different input with the same key returns 409.","schema":{"type":"string","minLength":1,"maxLength":200}}],"responses":{"200":{"description":"`Page[Post]` under `data`; with `get_raw=true` the upstream JSON.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"anyOf":[{"type":"object","required":["items","pages","next_cursor","has_more","stop_reason","coverage"],"properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/Post"},"description":"`Post` of every page walked, in page order."},"pages":{"type":"array","items":{"$ref":"#/components/schemas/PageRead"},"description":"One entry per page walked."},"next_cursor":{"type":"string","nullable":true,"description":"Opaque; pass back as `cursor` to continue."},"has_more":{"type":"boolean","description":"True when `next_cursor` is set, and when the walk stopped `cursor_stalled` on a page that said more results exist but gave no cursor to send back."},"stop_reason":{"type":"string","enum":["pages","since","exhausted","cursor_stalled","repeated_content","deadline","blocked","caught_up"],"description":"Why the walk stopped. `pages`: the page budget is spent and `next_cursor` continues it. `deadline`: the call ran out of time before its next page; `next_cursor` continues it. `since`: a whole page was older than `since`. `exhausted`: TikTok reported the end. `cursor_stalled`: TikTok claimed more but repeated or omitted its cursor. `repeated_content`: a page held only items already seen. `blocked`: TikTok refused a later page; `next_cursor` is the page it refused. `caught_up`: only watch passes the crawler runs for itself stop this way."},"coverage":{"$ref":"#/components/schemas/Coverage"}}},{"type":"object","required":["pages","next_cursor","has_more","stop_reason"],"description":"`get_raw=true`: every native page walked, exactly as TikTok answered it, plus the opaque `next_cursor` and `stop_reason` of the walk.","properties":{"pages":{"type":"array","items":{"type":"object","additionalProperties":true,"required":["itemList"],"properties":{"itemList":{"type":"array","items":{"type":"object","additionalProperties":true}}}},"description":"One native page per page walked, upstream bytes unchanged."},"next_cursor":{"type":"string","nullable":true,"description":"Opaque; pass back as `cursor`."},"has_more":{"type":"boolean","description":"True when `next_cursor` is set, and when the walk stopped `cursor_stalled` on a page that said more results exist but gave no cursor to send back."},"stop_reason":{"type":"string","enum":["pages","since","exhausted","cursor_stalled","repeated_content","deadline","blocked","caught_up"],"description":"Why the walk stopped. `pages`: the page budget is spent and `next_cursor` continues it. `deadline`: the call ran out of time before its next page; `next_cursor` continues it. `since`: a whole page was older than `since`. `exhausted`: TikTok reported the end. `cursor_stalled`: TikTok claimed more but repeated or omitted its cursor. `repeated_content`: a page held only items already seen. `blocked`: TikTok refused a later page; `next_cursor` is the page it refused. `caught_up`: only watch passes the crawler runs for itself stop this way."}}}],"description":"`Page[Post]`, or the upstream JSON when `get_raw=true`."},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"items":[{"id":"6890345164812913925","shortcode":null,"taken_at":"2020-11-02T02:18:53+00:00","kind":"video","product_type":null,"caption":"Reply to @mkujawaaa Should I do more responses like this to your questions? Lmk in the comments! #skincarebyhyram #skincare","hashtags":["skincare","skincarebyhyram"],"mentions":[],"accessibility_caption":null,"likes":148800,"comments":1858,"views":1200000,"counts_hidden":null,"comments_disabled":null,"is_pinned":null,"is_paid_partnership":null,"owner":{"id":"6756108693149205510","username":"hyram","full_name":"Hyram","is_verified":true,"is_private":false,"avatar_url":"https://p16-common-sign.tiktokcdn-eu.com/tos-maliva-avt-0068/7314271688706195461~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=10399&refresh_token=794252f8&x-expires=1791982800&x-signature=lHsDzBx8WR4%2FXxT7CFUf%2BLBgQao%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=no1a","latest_story_at":null,"extra":{"sec_uid":null}},"coauthors":[],"sponsors":[],"tagged":[],"location":null,"audio":{"id":null,"title":"original sound","artist":"Hyram","is_original":null},"thumbnail_url":"https://p16-common-sign.tiktokcdn-eu.com/tos-maliva-p-0068/d5b262918103438b98a2860b3f8edb65~tplv-tiktokx-origin.image?dr=10395&x-expires=1791982800&x-signature=9a3%2BcVW6eymG7Gv9i0mZIneIze4%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=no1a","video_duration":55,"media":[],"media_urls":[],"extra":{"url":"https://www.tiktok.com/@hyram/video/6890345164812913925","shares":616,"saves":2277}},{"id":"6887980428649696513","shortcode":null,"taken_at":"2020-10-26T17:21:59+00:00","kind":"video","product_type":null,"caption":"🧝🏽‍♀️💥 #fyp #foryou #skincare #oilyskin #doctorv #paulaschoice #cerave #xyzbca","hashtags":["cerave","doctorv","foryou","fyp","oilyskin","paulaschoice","skincare","xyzbca"],"mentions":[],"accessibility_caption":null,"likes":5746,"comments":64,"views":138100,"counts_hidden":null,"comments_disabled":null,"is_pinned":null,"is_paid_partnership":null,"owner":{"id":"6735157991278806022","username":"drvanitarattan","full_name":"SkincareByDrV","is_verified":true,"is_private":false,"avatar_url":"https://p16-common-sign.tiktokcdn-eu.com/tos-maliva-avt-0068/15260c2b3dc9fcf4c885559fd41a5e0f~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=10399&refresh_token=9a4c9070&x-expires=1791982800&x-signature=ePJ2YTsJ1xX2eZr%2FfbNkU4u8Sq0%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=no1a","latest_story_at":null,"extra":{"sec_uid":null}},"coauthors":[],"sponsors":[],"tagged":[],"location":null,"audio":{"id":null,"title":"yike or die remix","artist":"sydney♡₊˚","is_original":null},"thumbnail_url":"https://p16-common-sign.tiktokcdn-eu.com/tos-alisg-p-0037/6393cf85cb104d27bff4a33de0f04257~tplv-tiktokx-origin.image?dr=10395&x-expires=1791982800&x-signature=Svt8xQluzDB3rVm6bKQGEsZKZQQ%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=no1a","video_duration":15,"media":[],"media_urls":[],"extra":{"url":"https://www.tiktok.com/@drvanitarattan/video/6887980428649696513","shares":99,"saves":552}},{"id":"6877613497849482497","shortcode":null,"taken_at":"2020-09-28T18:53:00+00:00","kind":"video","product_type":null,"caption":"💥WHY WE GET ACNE! DM me on IG for help: mattrandon🥰 (follow first) #skincare #skincareroutine #acne #pimple #learnontiktok #DreamLongChallenge","hashtags":["acne","dreamlongchallenge","learnontiktok","pimple","skincare","skincareroutine"],"mentions":[],"accessibility_caption":null,"likes":162800,"comments":1310,"views":1000000,"counts_hidden":null,"comments_disabled":null,"is_pinned":null,"is_paid_partnership":null,"owner":{"id":"6754664095708808197","username":"mattrandon","full_name":"Mama Randon🧩","is_verified":false,"is_private":false,"avatar_url":"https://p16-common-sign.tiktokcdn-eu.com/tos-useast2a-avt-0068-euttp/1860f0af5ad3e3b95df184cc4e25361c~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=10399&refresh_token=126207e7&x-expires=1791982800&x-signature=gQSVmg6dfO7K%2F%2FWT0AGYnTfHsvM%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=no1a","latest_story_at":null,"extra":{"sec_uid":null}},"coauthors":[],"sponsors":[],"tagged":[],"location":null,"audio":{"id":null,"title":"Smile (Simlish Version)","artist":"Lily Allen","is_original":null},"thumbnail_url":"https://p16-common-sign.tiktokcdn-eu.com/tos-alisg-p-0037/4da29497f1d3423a9d37ca5e64d5aee2~tplv-tiktokx-origin.image?dr=10395&x-expires=1791982800&x-signature=k2fEpYVLj1sWOQVq%2BVnIDzb3s08%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=no1a","video_duration":36,"media":[],"media_urls":[],"extra":{"url":"https://www.tiktok.com/@mattrandon/video/6877613497849482497","shares":2431,"saves":17668}}],"pages":[{"cursor":null,"fetched_at":"2026-10-12T13:39:35.921783+00:00","count":30}],"next_cursor":"eyJjdXJzb3IiOiIzMCIsIm9wIjoiY2hhbGxlbmdlX2l0ZW1fbGlzdCJ9","has_more":true,"stop_reason":"pages","coverage":{"since":null,"oldest_at":"2020-09-28T18:53:00+00:00","since_reached":false}},"meta":{"source":"live","fetched_at":"2026-10-12T13:39:35.921783+00:00","cost":"$0.0005","balance":"$3.3627","request_id":"req_4eb963d32fbf84551d8fef324b36e6de"}}}}},"202":{"description":"Durable job accepted. No completed-result charge. Save batch_id; poll status_url. Retry submission with the same Idempotency-Key after a lost response. An account may have five queued, running or payment-required jobs. A sixth new job returns 429 rate_limited. Matching idempotent replays still work at the limit. Ready and failed jobs release their slots; pages within a job remain unbounded. This is a synthetic contract example, not a live capture.","x-example-provenance":"synthetic-contract","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","required":["batch_id","status","status_url","results_url","cost","item_count","error","retry_at","total","done_count","failed_count","created_at","started_at","finished_at"],"properties":{"batch_id":{"type":"string"},"status":{"type":"string","enum":["queued","running","payment_required","ready","failed"]},"status_url":{"type":"string"},"results_url":{"type":"string"},"cost":{"type":"string"},"item_count":{"type":"integer","nullable":true},"error":{"type":"string","nullable":true,"description":"Null unless failed. A failed target carries its own code; incomplete_result appears only when it has none and pages of the result are missing. profile_not_found, post_not_found, upstream_not_found or not_found: the target does not exist or is not visible. not_visible: The account exists, but its posts are not visible to logged-out readers (private, restricted, or hidden by Instagram). Retrying will not change the result until the account changes. not_cached: cached=cache_only found no saved read. incomplete_result: pages of the result are missing. temporarily_unavailable: the target could not be read for now (no capacity, a pause or repeated refusals); retry later with a new job. result_item_too_large: one result unit exceeds the delivery budget. result_snapshot_missing or result_snapshot_corrupt: the crawler could not serve the retained result of a paid job, and its charge is refunded; if the crawler serves it again, a later results read returns it and charges the job again. crawler_submit_400, crawler_submit_404 or crawler_submit_422: the crawl service refused the job request. crawler_job_failed: any other failure; the same job is not expected to succeed if resubmitted. cancelled: the job was cancelled with POST /v1/jobs/{job_id}/cancel. No failed job costs anything: only result_snapshot_missing and result_snapshot_corrupt follow a charge, and that charge is refunded."},"retry_at":{"type":"string","format":"date-time","nullable":true,"description":"Null unless the job failed temporarily_unavailable because a crawl route was closed for every caller. Then it is when the route opens again, and the response carries the same time as a Retry-After header in seconds. Submit a new job after it."},"total":{"type":"integer","description":"Targets in the job. A job submitted through a /v1 route has one."},"done_count":{"type":"integer","description":"Targets the crawler finished."},"failed_count":{"type":"integer","description":"Targets that failed."},"created_at":{"type":"string","format":"date-time","description":"When the job was submitted."},"started_at":{"type":"string","format":"date-time","nullable":true,"description":"When the crawler started the job. Null until it starts."},"finished_at":{"type":"string","format":"date-time","nullable":true,"description":"When the job finished or failed. Null while it is queued or running."}}},"meta":{"type":"object","required":["cost","request_id"],"properties":{"cost":{"type":"string","example":"$0.0000"},"request_id":{"type":"string"}}}}},"example":{"data":{"batch_id":"job_7641d5f0-717d-4b70-a2f1-f58d846d7242","status":"queued","status_url":"/v1/jobs/job_7641d5f0-717d-4b70-a2f1-f58d846d7242","results_url":"/v1/jobs/job_7641d5f0-717d-4b70-a2f1-f58d846d7242/results","cost":"$0.0000","item_count":null,"error":null,"retry_at":null,"total":1,"done_count":0,"failed_count":0,"created_at":"2026-10-12T12:56:17.403Z","started_at":null,"finished_at":null},"meta":{"cost":"$0.0000","request_id":"req_job_example"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"404":{"description":"`cached=cache_only` found nothing saved for these arguments (`not_cached`; call again with `cached=auto` to fetch it), or the TikTok account or item does not exist (`not_found`). You are not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_cached","message":"no saved tiktok/challenge_item_list read for 'skincare'. cached=cache_only never fetches, so call again with cached=auto to fetch it. You are not charged.","request_id":"req_5c10900e919bc7a3ff79b7501d582b4c"}}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/tiktok/challenge_detail":{"get":{"tags":["TikTok"],"operationId":"ttChallengeDetail","summary":"challenge_detail","x-dashboard-cost":"$0.0005","x-example-query":{"tag":"skincare"},"description":"A hashtag's own page: its id, title, description, and how many videos and views TikTok counts for it. Returns `Challenge` under `data`; with `get_raw=true` returns the upstream JSON.\n\nA field TikTok does not carry is null, a list it does not carry is `[]`, and TikTok-only facts sit under `extra`. Unknown, unsupported, and repeated query parameters return 400 before acquisition or billing.","security":[{"bearerAuth":[]}],"parameters":[{"name":"tag","in":"query","required":true,"description":"A hashtag, with or without `#`.","example":"skincare","schema":{"type":"string"}},{"name":"cached","in":"query","required":false,"description":"`auto` (default) serves a read saved within the last 24 hours for these exact arguments, otherwise fetches. `cache_only` never contacts TikTok (404 `not_cached` when nothing is saved, whatever its age). `live` always fetches. Anything else is a `400`.","schema":{"type":"string","enum":["auto","cache_only","live"],"default":"auto"},"examples":{"default":{"value":"auto","x-disabled":true}}},{"name":"get_raw","in":"query","required":false,"description":"`true` returns the upstream JSON exactly as TikTok answered it instead of the normalized `Challenge`.","schema":{"type":"boolean","default":false},"examples":{"default":{"value":false,"x-disabled":true}}}],"responses":{"200":{"description":"`Challenge` under `data`; with `get_raw=true` the upstream JSON.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"anyOf":[{"$ref":"#/components/schemas/Challenge"},{"type":"object","additionalProperties":true}],"description":"`Challenge`, or the upstream JSON when `get_raw=true`."},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"id":"504245","title":"skincare","description":"From routines to glow ups, discover how the skincare community on TikTok keeps their skin cared for.","videos":62641018,"views":1001362451160,"extra":{}},"meta":{"source":"live","fetched_at":"2026-10-28T08:55:54.194798+00:00","cost":"$0.0005","balance":"$0.9995","request_id":"req_fb8da1639e69e486f1859a4ff8d7d410"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"404":{"description":"`cached=cache_only` found nothing saved for these arguments (`not_cached`; call again with `cached=auto` to fetch it), or the TikTok account or item does not exist (`not_found`). You are not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_cached","message":"no saved tiktok/challenge_detail read for 'skincare'. cached=cache_only never fetches, so call again with cached=auto to fetch it. You are not charged.","request_id":"req_5c10900e919bc7a3ff79b7501d582b4c"}}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/tiktok/music_item_list":{"get":{"tags":["TikTok"],"operationId":"ttMusicItemList","summary":"music_item_list","x-dashboard-cost":"$0.0005/30","x-example-query":{"music_id":"7681719448159619870","max_pages":"1"},"description":"The videos that use one sound, with each video's author. With max_pages=1, returns `Page[Post]` under `data`; with `get_raw=true` returns the upstream JSON.\n\nThe default request creates a durable job (202). Use max_pages=1 for one synchronous Page response (200). Poll status_url, then read results_url with its opaque cursor. Acquisition stops at the first of since, max_pages, or exhaustion. Jobs continue after disconnects. Result responses are bounded to 3 MiB; this does not limit the crawl. Supply Idempotency-Key to recover a lost submission response; reuse it with the same inputs.\n\nA field TikTok does not carry is null, a list it does not carry is `[]`, and TikTok-only facts sit under `extra`. Unknown, unsupported, and repeated query parameters return 400 before acquisition or billing.\n\nBilling: $0.0005 per 30 unique returned items (one native page), rounded up to a minimum of one billing unit. Jobs settle once after successful completion. Submission, polling and repeat downloads are free.","security":[{"bearerAuth":[]}],"parameters":[{"name":"music_id","in":"query","required":true,"description":"TikTok sound id, or a `tiktok.com/music/<title>-<id>` URL.","example":"7681719448159619870","schema":{"type":"string"}},{"name":"since","in":"query","required":false,"description":"Stop at this date. `2025-09-21` means midnight UTC (2025-09-21T00:00:00Z). Datetimes must use RFC3339 with a timezone, for example `2025-09-21T09:00:00+09:00`. `365d` means 365 days before submission. Invalid calendar dates return 400. With max_pages, the first boundary reached stops the walk. since alone creates a job.","schema":{"type":"string"},"examples":{"default":{"value":"2025-09-21","x-disabled":true},"date":{"value":"2025-09-21","x-disabled":true},"datetime":{"value":"2025-09-21T00:00:00Z","x-disabled":true},"duration":{"value":"365d","x-disabled":true}}},{"name":"max_pages","in":"query","required":false,"example":1,"description":"Maximum pages to fetch. -1 walks until exhaustion or since with no page cap, and must be written. Omitted, since alone bounds the walk; with neither, the job stops after 10 pages. Any positive integer is accepted. 1 returns one page synchronously with HTTP 200; any other value creates a durable job with HTTP 202.","schema":{"type":"integer","anyOf":[{"enum":[-1]},{"minimum":1}]}},{"name":"cursor","in":"query","required":false,"description":"Opaque next_cursor from an earlier answer of this operation, also with `get_raw=true`. A native TikTok cursor from a raw page answers 400. Result download cursors belong to the results route.","schema":{"type":"string","minLength":1}},{"name":"page_size","in":"query","required":false,"description":"Native count, default 30. TikTok answers at most 30. Billed per 30 unique returned items, one native page.","schema":{"type":"integer","default":30,"minimum":1,"maximum":30},"examples":{"default":{"value":30,"x-disabled":true}}},{"name":"cached","in":"query","required":false,"description":"`auto` (default) serves a read saved within the last 24 hours for these exact arguments, otherwise fetches. `cache_only` never contacts TikTok (404 `not_cached` when nothing is saved, whatever its age). `live` always fetches. Anything else is a `400`. `cache_only` reads one saved page per request: omit `max_pages` or pass 1, and continue with `next_cursor`.","schema":{"type":"string","enum":["auto","cache_only","live"],"default":"auto"},"examples":{"default":{"value":"auto","x-disabled":true}}},{"name":"get_raw","in":"query","required":false,"description":"`true` returns the upstream JSON exactly as TikTok answered it instead of the normalized `Page[Post]`.","schema":{"type":"boolean","default":false},"examples":{"default":{"value":false,"x-disabled":true}}},{"name":"Idempotency-Key","in":"header","required":false,"description":"Reuse this key with the same inputs to recover a lost job submission. A different input with the same key returns 409.","schema":{"type":"string","minLength":1,"maxLength":200}}],"responses":{"200":{"description":"`Page[Post]` under `data`; with `get_raw=true` the upstream JSON.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"anyOf":[{"type":"object","required":["items","pages","next_cursor","has_more","stop_reason","coverage"],"properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/Post"},"description":"`Post` of every page walked, in page order."},"pages":{"type":"array","items":{"$ref":"#/components/schemas/PageRead"},"description":"One entry per page walked."},"next_cursor":{"type":"string","nullable":true,"description":"Opaque; pass back as `cursor` to continue."},"has_more":{"type":"boolean","description":"True when `next_cursor` is set, and when the walk stopped `cursor_stalled` on a page that said more results exist but gave no cursor to send back."},"stop_reason":{"type":"string","enum":["pages","since","exhausted","cursor_stalled","repeated_content","deadline","blocked","caught_up"],"description":"Why the walk stopped. `pages`: the page budget is spent and `next_cursor` continues it. `deadline`: the call ran out of time before its next page; `next_cursor` continues it. `since`: a whole page was older than `since`. `exhausted`: TikTok reported the end. `cursor_stalled`: TikTok claimed more but repeated or omitted its cursor. `repeated_content`: a page held only items already seen. `blocked`: TikTok refused a later page; `next_cursor` is the page it refused. `caught_up`: only watch passes the crawler runs for itself stop this way."},"coverage":{"$ref":"#/components/schemas/Coverage"}}},{"type":"object","required":["pages","next_cursor","has_more","stop_reason"],"description":"`get_raw=true`: every native page walked, exactly as TikTok answered it, plus the opaque `next_cursor` and `stop_reason` of the walk.","properties":{"pages":{"type":"array","items":{"type":"object","additionalProperties":true,"required":["itemList"],"properties":{"itemList":{"type":"array","items":{"type":"object","additionalProperties":true}}}},"description":"One native page per page walked, upstream bytes unchanged."},"next_cursor":{"type":"string","nullable":true,"description":"Opaque; pass back as `cursor`."},"has_more":{"type":"boolean","description":"True when `next_cursor` is set, and when the walk stopped `cursor_stalled` on a page that said more results exist but gave no cursor to send back."},"stop_reason":{"type":"string","enum":["pages","since","exhausted","cursor_stalled","repeated_content","deadline","blocked","caught_up"],"description":"Why the walk stopped. `pages`: the page budget is spent and `next_cursor` continues it. `deadline`: the call ran out of time before its next page; `next_cursor` continues it. `since`: a whole page was older than `since`. `exhausted`: TikTok reported the end. `cursor_stalled`: TikTok claimed more but repeated or omitted its cursor. `repeated_content`: a page held only items already seen. `blocked`: TikTok refused a later page; `next_cursor` is the page it refused. `caught_up`: only watch passes the crawler runs for itself stop this way."}}}],"description":"`Page[Post]`, or the upstream JSON when `get_raw=true`."},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"items":[{"id":"7681719358225239326","shortcode":null,"taken_at":"2026-09-04T16:34:44+00:00","kind":"video","product_type":null,"caption":"Well… that didn’t go as planned #learnfromkhaby #comedy ","hashtags":["comedy","learnfromkhaby"],"mentions":[],"accessibility_caption":null,"likes":1900000,"comments":26400,"views":16600000,"counts_hidden":null,"comments_disabled":null,"is_pinned":null,"is_paid_partnership":null,"owner":{"id":"127905465618821121","username":"khaby.lame","full_name":"Khabane lame","is_verified":true,"is_private":false,"avatar_url":"https://p16-common-sign.tiktokcdn-eu.com/tos-maliva-avt-0068/08987e23b94057953fd4f1738694bf5f~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=10399&refresh_token=aa753a91&x-expires=1791979200&x-signature=hZFIxH03iuNxi5zRKs6%2FF0l6bW8%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=no1a","latest_story_at":null,"extra":{"sec_uid":null}},"coauthors":[],"sponsors":[],"tagged":[],"location":null,"audio":{"id":null,"title":"original sound","artist":"Khabane lame","is_original":null},"thumbnail_url":"https://f005.backblazeb2.com/file/influencer-dev/staging/crawler/tiktok_video/15196185.webp","video_duration":48,"media":[],"media_urls":[],"extra":{"url":"https://www.tiktok.com/@khaby.lame/video/7681719358225239326","shares":32900,"saves":82005}},{"id":"7692142235051134216","shortcode":null,"taken_at":"2026-10-02T18:40:34+00:00","kind":"video","product_type":null,"caption":"Have you really experienced Ghana?? 🇬🇭 We are here to make your dream tour come true. #fyp #fyppppppppppppppppppppppp #tourwithkbi #kbitours #fypシ @👑🐝Royalty blessings233👑🐝 @Snr2cedis😎 @Kobbytours ","hashtags":["fyp","fyppppppppppppppppppppppp","fypシ","kbitours","tourwithkbi"],"mentions":[],"accessibility_caption":null,"likes":1213,"comments":12,"views":4756,"counts_hidden":null,"comments_disabled":null,"is_pinned":null,"is_paid_partnership":null,"owner":{"id":"7135303106576860165","username":"kbitoursrentals","full_name":"KBI TOURS & RENTALS","is_verified":false,"is_private":false,"avatar_url":"https://f005.backblazeb2.com/file/influencer-dev/staging/crawler/tiktok_account/288955.webp","latest_story_at":null,"extra":{"sec_uid":null}},"coauthors":[],"sponsors":[],"tagged":[],"location":null,"audio":{"id":null,"title":"original sound","artist":"Khabane lame","is_original":null},"thumbnail_url":"https://p16-common-sign.tiktokcdn-eu.com/tos-alisg-p-0037/ogqfiGfsgAgpuJIigMeIxoLl6gLNAaLIVfLKoe~tplv-tiktokx-origin.image?dr=10395&x-expires=1791979200&x-signature=We1tmr55CJH4LU0%2BCPDFv9DxxEU%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=no1a","video_duration":79,"media":[],"media_urls":[],"extra":{"url":"https://www.tiktok.com/@kbitoursrentals/video/7692142235051134216","shares":5,"saves":63}},{"id":"7690531694931103028","shortcode":null,"taken_at":"2026-09-28T10:30:50+00:00","kind":"video","product_type":null,"caption":"","hashtags":[],"mentions":[],"accessibility_caption":null,"likes":264,"comments":38,"views":3042,"counts_hidden":null,"comments_disabled":null,"is_pinned":null,"is_paid_partnership":null,"owner":{"id":"6966151548771763202","username":"amjadhussain7866","full_name":"Amjad Khan..","is_verified":false,"is_private":false,"avatar_url":"https://f005.backblazeb2.com/file/influencer-dev/staging/crawler/tiktok_account/288937.webp","latest_story_at":null,"extra":{"sec_uid":null}},"coauthors":[],"sponsors":[],"tagged":[],"location":null,"audio":{"id":null,"title":"original sound","artist":"Khabane lame","is_original":null},"thumbnail_url":"https://p16-common-sign.tiktokcdn-eu.com/tos-alisg-p-0037/oYquGg6QQek8B71EQUd62BAHMRFdvcfi9gKDBE~tplv-tiktokx-origin.image?dr=10395&x-expires=1791979200&x-signature=%2BzqFGSaNB0eMAJD2qQEvrK7uyvc%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=no1a","video_duration":15,"media":[],"media_urls":[],"extra":{"url":"https://www.tiktok.com/@amjadhussain7866/video/7690531694931103028","shares":37,"saves":11}}],"pages":[{"cursor":null,"fetched_at":"2026-10-12T12:57:34.564427+00:00","count":30}],"next_cursor":"eyJjdXJzb3IiOiIzMCIsIm9wIjoibXVzaWNfaXRlbV9saXN0In0","has_more":true,"stop_reason":"pages","coverage":{"since":null,"oldest_at":"2026-09-04T16:34:44+00:00","since_reached":false}},"meta":{"source":"db","fetched_at":"2026-10-12T12:57:34.564427+00:00","cost":"$0.0005","balance":"$3.3627","request_id":"req_fa7838afe08945238d265c80e04ffead"}}}}},"202":{"description":"Durable job accepted. No completed-result charge. Save batch_id; poll status_url. Retry submission with the same Idempotency-Key after a lost response. An account may have five queued, running or payment-required jobs. A sixth new job returns 429 rate_limited. Matching idempotent replays still work at the limit. Ready and failed jobs release their slots; pages within a job remain unbounded. This is a synthetic contract example, not a live capture.","x-example-provenance":"synthetic-contract","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","required":["batch_id","status","status_url","results_url","cost","item_count","error","retry_at","total","done_count","failed_count","created_at","started_at","finished_at"],"properties":{"batch_id":{"type":"string"},"status":{"type":"string","enum":["queued","running","payment_required","ready","failed"]},"status_url":{"type":"string"},"results_url":{"type":"string"},"cost":{"type":"string"},"item_count":{"type":"integer","nullable":true},"error":{"type":"string","nullable":true,"description":"Null unless failed. A failed target carries its own code; incomplete_result appears only when it has none and pages of the result are missing. profile_not_found, post_not_found, upstream_not_found or not_found: the target does not exist or is not visible. not_visible: The account exists, but its posts are not visible to logged-out readers (private, restricted, or hidden by Instagram). Retrying will not change the result until the account changes. not_cached: cached=cache_only found no saved read. incomplete_result: pages of the result are missing. temporarily_unavailable: the target could not be read for now (no capacity, a pause or repeated refusals); retry later with a new job. result_item_too_large: one result unit exceeds the delivery budget. result_snapshot_missing or result_snapshot_corrupt: the crawler could not serve the retained result of a paid job, and its charge is refunded; if the crawler serves it again, a later results read returns it and charges the job again. crawler_submit_400, crawler_submit_404 or crawler_submit_422: the crawl service refused the job request. crawler_job_failed: any other failure; the same job is not expected to succeed if resubmitted. cancelled: the job was cancelled with POST /v1/jobs/{job_id}/cancel. No failed job costs anything: only result_snapshot_missing and result_snapshot_corrupt follow a charge, and that charge is refunded."},"retry_at":{"type":"string","format":"date-time","nullable":true,"description":"Null unless the job failed temporarily_unavailable because a crawl route was closed for every caller. Then it is when the route opens again, and the response carries the same time as a Retry-After header in seconds. Submit a new job after it."},"total":{"type":"integer","description":"Targets in the job. A job submitted through a /v1 route has one."},"done_count":{"type":"integer","description":"Targets the crawler finished."},"failed_count":{"type":"integer","description":"Targets that failed."},"created_at":{"type":"string","format":"date-time","description":"When the job was submitted."},"started_at":{"type":"string","format":"date-time","nullable":true,"description":"When the crawler started the job. Null until it starts."},"finished_at":{"type":"string","format":"date-time","nullable":true,"description":"When the job finished or failed. Null while it is queued or running."}}},"meta":{"type":"object","required":["cost","request_id"],"properties":{"cost":{"type":"string","example":"$0.0000"},"request_id":{"type":"string"}}}}},"example":{"data":{"batch_id":"job_7641d5f0-717d-4b70-a2f1-f58d846d7242","status":"queued","status_url":"/v1/jobs/job_7641d5f0-717d-4b70-a2f1-f58d846d7242","results_url":"/v1/jobs/job_7641d5f0-717d-4b70-a2f1-f58d846d7242/results","cost":"$0.0000","item_count":null,"error":null,"retry_at":null,"total":1,"done_count":0,"failed_count":0,"created_at":"2026-10-12T12:56:17.403Z","started_at":null,"finished_at":null},"meta":{"cost":"$0.0000","request_id":"req_job_example"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"404":{"description":"`cached=cache_only` found nothing saved for these arguments (`not_cached`; call again with `cached=auto` to fetch it), or the TikTok account or item does not exist (`not_found`). You are not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_cached","message":"no saved tiktok/music_item_list read for '7681719448159619870'. cached=cache_only never fetches, so call again with cached=auto to fetch it. You are not charged.","request_id":"req_5c10900e919bc7a3ff79b7501d582b4c"}}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/tiktok/search_item_full":{"get":{"tags":["TikTok"],"operationId":"ttSearchItemFull","summary":"search_item_full","x-dashboard-cost":"$0.0005/20","x-example-query":{"keyword":"nike","max_pages":"1"},"description":"TikTok's video search, ranked by relevance across years. Search a brand name to find the videos that talk about it. With max_pages=1, returns `Page[Post]` under `data`; with `get_raw=true` returns the upstream JSON.\n\nThe default request creates a durable job (202). Use max_pages=1 for one synchronous Page response (200). Poll status_url, then read results_url with its opaque cursor. Acquisition stops at the first of since, max_pages, or exhaustion. Jobs continue after disconnects. Result responses are bounded to 3 MiB; this does not limit the crawl. Supply Idempotency-Key to recover a lost submission response; reuse it with the same inputs.\n\nA field TikTok does not carry is null, a list it does not carry is `[]`, and TikTok-only facts sit under `extra`. Unknown, unsupported, and repeated query parameters return 400 before acquisition or billing.\n\nBilling: $0.0005 per 20 unique returned items (one native page), rounded up to a minimum of one billing unit. Jobs settle once after successful completion. Submission, polling and repeat downloads are free.","security":[{"bearerAuth":[]}],"parameters":[{"name":"keyword","in":"query","required":true,"description":"The search term, up to 100 characters.","example":"nike","schema":{"type":"string"}},{"name":"since","in":"query","required":false,"description":"Stop at this date. `2025-09-21` means midnight UTC (2025-09-21T00:00:00Z). Datetimes must use RFC3339 with a timezone, for example `2025-09-21T09:00:00+09:00`. `365d` means 365 days before submission. Invalid calendar dates return 400. With max_pages, the first boundary reached stops the walk. since alone creates a job.","schema":{"type":"string"},"examples":{"default":{"value":"2025-09-21","x-disabled":true},"date":{"value":"2025-09-21","x-disabled":true},"datetime":{"value":"2025-09-21T00:00:00Z","x-disabled":true},"duration":{"value":"365d","x-disabled":true}}},{"name":"max_pages","in":"query","required":false,"example":1,"description":"Maximum pages to fetch. -1 walks until exhaustion or since with no page cap, and must be written. Omitted, since alone bounds the walk; with neither, the job stops after 10 pages. Any positive integer is accepted. 1 returns one page synchronously with HTTP 200; any other value creates a durable job with HTTP 202.","schema":{"type":"integer","anyOf":[{"enum":[-1]},{"minimum":1}]}},{"name":"cursor","in":"query","required":false,"description":"Opaque next_cursor from an earlier answer of this operation, also with `get_raw=true`. A native TikTok cursor from a raw page answers 400. Result download cursors belong to the results route.","schema":{"type":"string","minLength":1}},{"name":"page_size","in":"query","required":false,"description":"Native count, default 20. TikTok answers at most 20. Billed per 20 unique returned items, one native page.","schema":{"type":"integer","default":20,"minimum":1,"maximum":20},"examples":{"default":{"value":20,"x-disabled":true}}},{"name":"cached","in":"query","required":false,"description":"`auto` (default) serves a read saved within the last 24 hours for these exact arguments, otherwise fetches. `cache_only` never contacts TikTok (404 `not_cached` when nothing is saved, whatever its age). `live` always fetches. Anything else is a `400`. `cache_only` reads one saved page per request: omit `max_pages` or pass 1, and continue with `next_cursor`.","schema":{"type":"string","enum":["auto","cache_only","live"],"default":"auto"},"examples":{"default":{"value":"auto","x-disabled":true}}},{"name":"get_raw","in":"query","required":false,"description":"`true` returns the upstream JSON exactly as TikTok answered it instead of the normalized `Page[Post]`.","schema":{"type":"boolean","default":false},"examples":{"default":{"value":false,"x-disabled":true}}},{"name":"Idempotency-Key","in":"header","required":false,"description":"Reuse this key with the same inputs to recover a lost job submission. A different input with the same key returns 409.","schema":{"type":"string","minLength":1,"maxLength":200}}],"responses":{"200":{"description":"`Page[Post]` under `data`; with `get_raw=true` the upstream JSON.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"anyOf":[{"type":"object","required":["items","pages","next_cursor","has_more","stop_reason","coverage"],"properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/Post"},"description":"`Post` of every page walked, in page order."},"pages":{"type":"array","items":{"$ref":"#/components/schemas/PageRead"},"description":"One entry per page walked."},"next_cursor":{"type":"string","nullable":true,"description":"Opaque; pass back as `cursor` to continue."},"has_more":{"type":"boolean","description":"True when `next_cursor` is set, and when the walk stopped `cursor_stalled` on a page that said more results exist but gave no cursor to send back."},"stop_reason":{"type":"string","enum":["pages","since","exhausted","cursor_stalled","repeated_content","deadline","blocked","caught_up"],"description":"Why the walk stopped. `pages`: the page budget is spent and `next_cursor` continues it. `deadline`: the call ran out of time before its next page; `next_cursor` continues it. `since`: a whole page was older than `since`. `exhausted`: TikTok reported the end. `cursor_stalled`: TikTok claimed more but repeated or omitted its cursor. `repeated_content`: a page held only items already seen. `blocked`: TikTok refused a later page; `next_cursor` is the page it refused. `caught_up`: only watch passes the crawler runs for itself stop this way."},"coverage":{"$ref":"#/components/schemas/Coverage"}}},{"type":"object","required":["pages","next_cursor","has_more","stop_reason"],"description":"`get_raw=true`: every native page walked, exactly as TikTok answered it, plus the opaque `next_cursor` and `stop_reason` of the walk.","properties":{"pages":{"type":"array","items":{"type":"object","additionalProperties":true,"required":["item_list"],"properties":{"item_list":{"type":"array","items":{"type":"object","additionalProperties":true}}}},"description":"One native page per page walked, upstream bytes unchanged."},"next_cursor":{"type":"string","nullable":true,"description":"Opaque; pass back as `cursor`."},"has_more":{"type":"boolean","description":"True when `next_cursor` is set, and when the walk stopped `cursor_stalled` on a page that said more results exist but gave no cursor to send back."},"stop_reason":{"type":"string","enum":["pages","since","exhausted","cursor_stalled","repeated_content","deadline","blocked","caught_up"],"description":"Why the walk stopped. `pages`: the page budget is spent and `next_cursor` continues it. `deadline`: the call ran out of time before its next page; `next_cursor` continues it. `since`: a whole page was older than `since`. `exhausted`: TikTok reported the end. `cursor_stalled`: TikTok claimed more but repeated or omitted its cursor. `repeated_content`: a page held only items already seen. `blocked`: TikTok refused a later page; `next_cursor` is the page it refused. `caught_up`: only watch passes the crawler runs for itself stop this way."}}}],"description":"`Page[Post]`, or the upstream JSON when `get_raw=true`."},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"items":[{"id":"7694624183157935390","shortcode":null,"taken_at":"2026-10-09T23:00:00+00:00","kind":"video","product_type":null,"caption":"Nike air mags were every hypebeast dream sneaker 😂🔥","hashtags":[],"mentions":[],"accessibility_caption":null,"likes":37000,"comments":95,"views":352300,"counts_hidden":null,"comments_disabled":null,"is_pinned":null,"is_paid_partnership":null,"owner":{"id":"7035523887404450821","username":"calithekid1","full_name":"calithekid","is_verified":false,"is_private":false,"avatar_url":"https://p16-common-sign.tiktokcdn-eu.com/tos-maliva-avt-0068/c74493c7461ea519d18e4296b5f0a179~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=10399&refresh_token=961be57b&x-expires=1791982800&x-signature=iWuuWOgZbda7qfaZ%2FQxRkG3KigA%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=no1a","latest_story_at":null,"extra":{"sec_uid":null}},"coauthors":[],"sponsors":[],"tagged":[],"location":null,"audio":{"id":null,"title":"son original","artist":"Lenny","is_original":null},"thumbnail_url":"https://p16-common-sign.tiktokcdn-eu.com/tos-useast8-p-0068-tx2/oo5I5WvEETRyKQFQZBFqAzfDAoVWZEIAfMyEqj~tplv-tiktokx-origin.image?dr=10395&x-expires=1791982800&x-signature=5L79EzEhLIjMKumx0jYWnPzVSD8%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=no1a","video_duration":10,"media":[],"media_urls":[],"extra":{"url":"https://www.tiktok.com/@calithekid1/video/7694624183157935390","shares":3819,"saves":1698}},{"id":"7695674192158657825","shortcode":null,"taken_at":"2026-10-12T07:06:24+00:00","kind":"video","product_type":null,"caption":"❤️🫶🏻💙🌸🦋🦋🦋🌼🤗🤗🥰💋💋🌟","hashtags":[],"mentions":[],"accessibility_caption":null,"likes":29,"comments":3,"views":141,"counts_hidden":null,"comments_disabled":null,"is_pinned":null,"is_paid_partnership":null,"owner":{"id":"6808106188887557126","username":"karynhaizelden","full_name":"Karyn Haizelden","is_verified":false,"is_private":false,"avatar_url":"https://p16-common-sign.tiktokcdn-eu.com/tos-useast2a-avt-0068-euttp/ebcaae3838aef127a03d51dc8fdddbf3~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=10399&refresh_token=5f0be20c&x-expires=1791982800&x-signature=s3GgKpA4R2JIXCrwCwoTi8GQBAM%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=no1a","latest_story_at":null,"extra":{"sec_uid":null}},"coauthors":[],"sponsors":[],"tagged":[],"location":null,"audio":{"id":null,"title":"الصوت الأصلي","artist":"حسن","is_original":null},"thumbnail_url":"https://p16-common-sign.tiktokcdn-eu.com/tos-useast2a-p-0037-euttp/owiQmIICIBAfvIzMD11oy3FozAiMHhZBkOUN6z~tplv-tiktokx-origin.image?dr=10395&x-expires=1791982800&x-signature=T1OZKG%2Bc3dakAozHDNYhisp0M%2FY%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=no1a","video_duration":45,"media":[],"media_urls":[],"extra":{"url":"https://www.tiktok.com/@karynhaizelden/video/7695674192158657825","shares":0,"saves":0}},{"id":"7689374995503484192","shortcode":null,"taken_at":"2026-09-25T07:42:19+00:00","kind":"video","product_type":null,"caption":"Nike sneaker collection #nike #sneakers #shoes #sneakercollection #sneakerrotation ","hashtags":["nike","shoes","sneakercollection","sneakerrotation","sneakers"],"mentions":[],"accessibility_caption":null,"likes":277,"comments":6,"views":3623,"counts_hidden":null,"comments_disabled":null,"is_pinned":null,"is_paid_partnership":null,"owner":{"id":"7418673935666365472","username":"arthur.vngs","full_name":"arthur.vngs","is_verified":false,"is_private":false,"avatar_url":"https://p16-common-sign.tiktokcdn-eu.com/tos-useast2a-avt-0068-euttp/08d14a7439fafdccf34eb3bdb5f0a5f2~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=10399&refresh_token=2cb62bd4&x-expires=1791982800&x-signature=pC1TUS3TqsqEb06Sa5dQmo%2B4IOw%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=no1a","latest_story_at":null,"extra":{"sec_uid":null}},"coauthors":[],"sponsors":[],"tagged":[],"location":null,"audio":{"id":null,"title":"original sound","artist":"arthur.vngs","is_original":null},"thumbnail_url":"https://p19-common-sign.tiktokcdn-eu.com/tos-useast2a-p-0037-euttp/osAAxIAs2x1AR0kJpxihBiWCIBdByoLTiEfCxQ~tplv-tiktokx-origin.image?dr=10395&x-expires=1791982800&x-signature=H%2FkbmN4prkWRcwLwmwJas5oHk4k%3D&t=4d5b0474&ps=13740610&shp=81f88b70&shcp=43f4a2f9&idc=no1a","video_duration":88,"media":[],"media_urls":[],"extra":{"url":"https://www.tiktok.com/@arthur.vngs/video/7689374995503484192","shares":3,"saves":15}}],"pages":[{"cursor":null,"fetched_at":"2026-10-12T13:43:02.330943+00:00","count":20}],"next_cursor":"eyJjdXJzb3IiOiIyMCIsIm9wIjoic2VhcmNoX2l0ZW1fZnVsbCJ9","has_more":true,"stop_reason":"pages","coverage":{"since":null,"oldest_at":"2026-09-25T07:42:19+00:00","since_reached":false}},"meta":{"source":"live","fetched_at":"2026-10-12T13:43:02.330943+00:00","cost":"$0.0005","balance":"$3.3627","request_id":"req_23525c0a79ea897d3a8c31e6608545e5"}}}}},"202":{"description":"Durable job accepted. No completed-result charge. Save batch_id; poll status_url. Retry submission with the same Idempotency-Key after a lost response. An account may have five queued, running or payment-required jobs. A sixth new job returns 429 rate_limited. Matching idempotent replays still work at the limit. Ready and failed jobs release their slots; pages within a job remain unbounded. This is a synthetic contract example, not a live capture.","x-example-provenance":"synthetic-contract","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","required":["batch_id","status","status_url","results_url","cost","item_count","error","retry_at","total","done_count","failed_count","created_at","started_at","finished_at"],"properties":{"batch_id":{"type":"string"},"status":{"type":"string","enum":["queued","running","payment_required","ready","failed"]},"status_url":{"type":"string"},"results_url":{"type":"string"},"cost":{"type":"string"},"item_count":{"type":"integer","nullable":true},"error":{"type":"string","nullable":true,"description":"Null unless failed. A failed target carries its own code; incomplete_result appears only when it has none and pages of the result are missing. profile_not_found, post_not_found, upstream_not_found or not_found: the target does not exist or is not visible. not_visible: The account exists, but its posts are not visible to logged-out readers (private, restricted, or hidden by Instagram). Retrying will not change the result until the account changes. not_cached: cached=cache_only found no saved read. incomplete_result: pages of the result are missing. temporarily_unavailable: the target could not be read for now (no capacity, a pause or repeated refusals); retry later with a new job. result_item_too_large: one result unit exceeds the delivery budget. result_snapshot_missing or result_snapshot_corrupt: the crawler could not serve the retained result of a paid job, and its charge is refunded; if the crawler serves it again, a later results read returns it and charges the job again. crawler_submit_400, crawler_submit_404 or crawler_submit_422: the crawl service refused the job request. crawler_job_failed: any other failure; the same job is not expected to succeed if resubmitted. cancelled: the job was cancelled with POST /v1/jobs/{job_id}/cancel. No failed job costs anything: only result_snapshot_missing and result_snapshot_corrupt follow a charge, and that charge is refunded."},"retry_at":{"type":"string","format":"date-time","nullable":true,"description":"Null unless the job failed temporarily_unavailable because a crawl route was closed for every caller. Then it is when the route opens again, and the response carries the same time as a Retry-After header in seconds. Submit a new job after it."},"total":{"type":"integer","description":"Targets in the job. A job submitted through a /v1 route has one."},"done_count":{"type":"integer","description":"Targets the crawler finished."},"failed_count":{"type":"integer","description":"Targets that failed."},"created_at":{"type":"string","format":"date-time","description":"When the job was submitted."},"started_at":{"type":"string","format":"date-time","nullable":true,"description":"When the crawler started the job. Null until it starts."},"finished_at":{"type":"string","format":"date-time","nullable":true,"description":"When the job finished or failed. Null while it is queued or running."}}},"meta":{"type":"object","required":["cost","request_id"],"properties":{"cost":{"type":"string","example":"$0.0000"},"request_id":{"type":"string"}}}}},"example":{"data":{"batch_id":"job_7641d5f0-717d-4b70-a2f1-f58d846d7242","status":"queued","status_url":"/v1/jobs/job_7641d5f0-717d-4b70-a2f1-f58d846d7242","results_url":"/v1/jobs/job_7641d5f0-717d-4b70-a2f1-f58d846d7242/results","cost":"$0.0000","item_count":null,"error":null,"retry_at":null,"total":1,"done_count":0,"failed_count":0,"created_at":"2026-10-12T12:56:17.403Z","started_at":null,"finished_at":null},"meta":{"cost":"$0.0000","request_id":"req_job_example"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"404":{"description":"`cached=cache_only` found nothing saved for these arguments (`not_cached`; call again with `cached=auto` to fetch it), or the TikTok account or item does not exist (`not_found`). You are not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_cached","message":"no saved tiktok/search_item_full read for 'nike'. cached=cache_only never fetches, so call again with cached=auto to fetch it. You are not charged.","request_id":"req_5c10900e919bc7a3ff79b7501d582b4c"}}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/tiktok/search_user_full":{"get":{"tags":["TikTok"],"operationId":"ttSearchUserFull","summary":"search_user_full","x-dashboard-cost":"$0.0005/10","x-example-query":{"keyword":"khaby","max_pages":"1"},"description":"TikTok's account search, such as a brand's regional handles. With max_pages=1, returns `Page[Account]` under `data`; with `get_raw=true` returns the upstream JSON.\n\nThe default request creates a durable job (202). Use max_pages=1 for one synchronous Page response (200). Poll status_url, then read results_url with its opaque cursor. Acquisition stops at the first of since, max_pages, or exhaustion. Jobs continue after disconnects. Result responses are bounded to 3 MiB; this does not limit the crawl. Supply Idempotency-Key to recover a lost submission response; reuse it with the same inputs.\n\nA field TikTok does not carry is null, a list it does not carry is `[]`, and TikTok-only facts sit under `extra`. Unknown, unsupported, and repeated query parameters return 400 before acquisition or billing.\n\nBilling: $0.0005 per 10 unique returned items (one native page), rounded up to a minimum of one billing unit. Jobs settle once after successful completion. Submission, polling and repeat downloads are free.","security":[{"bearerAuth":[]}],"parameters":[{"name":"keyword","in":"query","required":true,"description":"The search term, up to 100 characters.","example":"khaby","schema":{"type":"string"}},{"name":"since","in":"query","required":false,"description":"Not accepted on this operation: its items carry no timestamp, so since returns 400 before billing.","schema":{"type":"string"}},{"name":"max_pages","in":"query","required":false,"example":1,"description":"Maximum pages to fetch. -1 walks until exhaustion or since with no page cap, and must be written. Omitted, since alone bounds the walk; with neither, the job stops after 10 pages. Any positive integer is accepted. 1 returns one page synchronously with HTTP 200; any other value creates a durable job with HTTP 202.","schema":{"type":"integer","anyOf":[{"enum":[-1]},{"minimum":1}]}},{"name":"cursor","in":"query","required":false,"description":"Opaque next_cursor from an earlier answer of this operation, also with `get_raw=true`. A native TikTok cursor from a raw page answers 400. Result download cursors belong to the results route.","schema":{"type":"string","minLength":1}},{"name":"page_size","in":"query","required":false,"description":"Native count, default 10. TikTok answers at most 10. Billed per 10 unique returned items, one native page.","schema":{"type":"integer","default":10,"minimum":1,"maximum":10},"examples":{"default":{"value":10,"x-disabled":true}}},{"name":"cached","in":"query","required":false,"description":"`auto` (default) serves a read saved within the last 24 hours for these exact arguments, otherwise fetches. `cache_only` never contacts TikTok (404 `not_cached` when nothing is saved, whatever its age). `live` always fetches. Anything else is a `400`. `cache_only` reads one saved page per request: omit `max_pages` or pass 1, and continue with `next_cursor`.","schema":{"type":"string","enum":["auto","cache_only","live"],"default":"auto"},"examples":{"default":{"value":"auto","x-disabled":true}}},{"name":"get_raw","in":"query","required":false,"description":"`true` returns the upstream JSON exactly as TikTok answered it instead of the normalized `Page[Account]`.","schema":{"type":"boolean","default":false},"examples":{"default":{"value":false,"x-disabled":true}}},{"name":"Idempotency-Key","in":"header","required":false,"description":"Reuse this key with the same inputs to recover a lost job submission. A different input with the same key returns 409.","schema":{"type":"string","minLength":1,"maxLength":200}}],"responses":{"200":{"description":"`Page[Account]` under `data`; with `get_raw=true` the upstream JSON.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"anyOf":[{"type":"object","required":["items","pages","next_cursor","has_more","stop_reason","coverage"],"properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/Account"},"description":"`Account` of every page walked, in page order."},"pages":{"type":"array","items":{"$ref":"#/components/schemas/PageRead"},"description":"One entry per page walked."},"next_cursor":{"type":"string","nullable":true,"description":"Opaque; pass back as `cursor` to continue."},"has_more":{"type":"boolean","description":"True when `next_cursor` is set, and when the walk stopped `cursor_stalled` on a page that said more results exist but gave no cursor to send back."},"stop_reason":{"type":"string","enum":["pages","since","exhausted","cursor_stalled","repeated_content","deadline","blocked","caught_up"],"description":"Why the walk stopped. `pages`: the page budget is spent and `next_cursor` continues it. `deadline`: the call ran out of time before its next page; `next_cursor` continues it. `since`: a whole page was older than `since`. `exhausted`: TikTok reported the end. `cursor_stalled`: TikTok claimed more but repeated or omitted its cursor. `repeated_content`: a page held only items already seen. `blocked`: TikTok refused a later page; `next_cursor` is the page it refused. `caught_up`: only watch passes the crawler runs for itself stop this way."},"coverage":{"$ref":"#/components/schemas/Coverage"}}},{"type":"object","required":["pages","next_cursor","has_more","stop_reason"],"description":"`get_raw=true`: every native page walked, exactly as TikTok answered it, plus the opaque `next_cursor` and `stop_reason` of the walk.","properties":{"pages":{"type":"array","items":{"type":"object","additionalProperties":true,"required":["user_list"],"properties":{"user_list":{"type":"array","items":{"type":"object","additionalProperties":true}}}},"description":"One native page per page walked, upstream bytes unchanged."},"next_cursor":{"type":"string","nullable":true,"description":"Opaque; pass back as `cursor`."},"has_more":{"type":"boolean","description":"True when `next_cursor` is set, and when the walk stopped `cursor_stalled` on a page that said more results exist but gave no cursor to send back."},"stop_reason":{"type":"string","enum":["pages","since","exhausted","cursor_stalled","repeated_content","deadline","blocked","caught_up"],"description":"Why the walk stopped. `pages`: the page budget is spent and `next_cursor` continues it. `deadline`: the call ran out of time before its next page; `next_cursor` continues it. `since`: a whole page was older than `since`. `exhausted`: TikTok reported the end. `cursor_stalled`: TikTok claimed more but repeated or omitted its cursor. `repeated_content`: a page held only items already seen. `blocked`: TikTok refused a later page; `next_cursor` is the page it refused. `caught_up`: only watch passes the crawler runs for itself stop this way."}}}],"description":"`Page[Account]`, or the upstream JSON when `get_raw=true`."},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"items":[{"id":"127905465618821121","username":"khaby.lame","full_name":"Khabane lame","is_verified":true,"is_private":false,"avatar_url":null,"latest_story_at":null,"extra":{"sec_uid":null}},{"id":"7115770598617809926","username":"khaby00_reacting","full_name":"Khaby00","is_verified":false,"is_private":false,"avatar_url":null,"latest_story_at":null,"extra":{"sec_uid":null}},{"id":"6983989895064814619","username":"khaby_official_dute_","full_name":"khaby official fan dute","is_verified":false,"is_private":false,"avatar_url":null,"latest_story_at":null,"extra":{"sec_uid":null}}],"pages":[{"cursor":null,"fetched_at":"2026-10-12T12:57:43.728153+00:00","count":10}],"next_cursor":"eyJjdXJzb3IiOiIxMCIsIm9wIjoic2VhcmNoX3VzZXJfZnVsbCJ9","has_more":true,"stop_reason":"pages","coverage":{"since":null,"oldest_at":null,"since_reached":false}},"meta":{"source":"db","fetched_at":"2026-10-12T12:57:43.728153+00:00","cost":"$0.0005","balance":"$3.3627","request_id":"req_395e70802f2552d912a62e08d25455d1"}}}}},"202":{"description":"Durable job accepted. No completed-result charge. Save batch_id; poll status_url. Retry submission with the same Idempotency-Key after a lost response. An account may have five queued, running or payment-required jobs. A sixth new job returns 429 rate_limited. Matching idempotent replays still work at the limit. Ready and failed jobs release their slots; pages within a job remain unbounded. This is a synthetic contract example, not a live capture.","x-example-provenance":"synthetic-contract","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","required":["batch_id","status","status_url","results_url","cost","item_count","error","retry_at","total","done_count","failed_count","created_at","started_at","finished_at"],"properties":{"batch_id":{"type":"string"},"status":{"type":"string","enum":["queued","running","payment_required","ready","failed"]},"status_url":{"type":"string"},"results_url":{"type":"string"},"cost":{"type":"string"},"item_count":{"type":"integer","nullable":true},"error":{"type":"string","nullable":true,"description":"Null unless failed. A failed target carries its own code; incomplete_result appears only when it has none and pages of the result are missing. profile_not_found, post_not_found, upstream_not_found or not_found: the target does not exist or is not visible. not_visible: The account exists, but its posts are not visible to logged-out readers (private, restricted, or hidden by Instagram). Retrying will not change the result until the account changes. not_cached: cached=cache_only found no saved read. incomplete_result: pages of the result are missing. temporarily_unavailable: the target could not be read for now (no capacity, a pause or repeated refusals); retry later with a new job. result_item_too_large: one result unit exceeds the delivery budget. result_snapshot_missing or result_snapshot_corrupt: the crawler could not serve the retained result of a paid job, and its charge is refunded; if the crawler serves it again, a later results read returns it and charges the job again. crawler_submit_400, crawler_submit_404 or crawler_submit_422: the crawl service refused the job request. crawler_job_failed: any other failure; the same job is not expected to succeed if resubmitted. cancelled: the job was cancelled with POST /v1/jobs/{job_id}/cancel. No failed job costs anything: only result_snapshot_missing and result_snapshot_corrupt follow a charge, and that charge is refunded."},"retry_at":{"type":"string","format":"date-time","nullable":true,"description":"Null unless the job failed temporarily_unavailable because a crawl route was closed for every caller. Then it is when the route opens again, and the response carries the same time as a Retry-After header in seconds. Submit a new job after it."},"total":{"type":"integer","description":"Targets in the job. A job submitted through a /v1 route has one."},"done_count":{"type":"integer","description":"Targets the crawler finished."},"failed_count":{"type":"integer","description":"Targets that failed."},"created_at":{"type":"string","format":"date-time","description":"When the job was submitted."},"started_at":{"type":"string","format":"date-time","nullable":true,"description":"When the crawler started the job. Null until it starts."},"finished_at":{"type":"string","format":"date-time","nullable":true,"description":"When the job finished or failed. Null while it is queued or running."}}},"meta":{"type":"object","required":["cost","request_id"],"properties":{"cost":{"type":"string","example":"$0.0000"},"request_id":{"type":"string"}}}}},"example":{"data":{"batch_id":"job_7641d5f0-717d-4b70-a2f1-f58d846d7242","status":"queued","status_url":"/v1/jobs/job_7641d5f0-717d-4b70-a2f1-f58d846d7242","results_url":"/v1/jobs/job_7641d5f0-717d-4b70-a2f1-f58d846d7242/results","cost":"$0.0000","item_count":null,"error":null,"retry_at":null,"total":1,"done_count":0,"failed_count":0,"created_at":"2026-10-12T12:56:17.403Z","started_at":null,"finished_at":null},"meta":{"cost":"$0.0000","request_id":"req_job_example"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"404":{"description":"`cached=cache_only` found nothing saved for these arguments (`not_cached`; call again with `cached=auto` to fetch it), or the TikTok account or item does not exist (`not_found`). You are not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_cached","message":"no saved tiktok/search_user_full read for 'khaby'. cached=cache_only never fetches, so call again with cached=auto to fetch it. You are not charged.","request_id":"req_5c10900e919bc7a3ff79b7501d582b4c"}}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/tiktok/comment_list":{"get":{"tags":["TikTok"],"operationId":"ttCommentList","summary":"comment_list","x-dashboard-cost":"$0.0005/20","x-example-query":{"url":"https://www.tiktok.com/@khaby.lame/video/7681719358225239326","max_pages":"1"},"description":"A video's top-level comments with author, likes and reply count. With max_pages=1, returns `Page[Comment]` under `data`; with `get_raw=true` returns the upstream JSON.\n\nThe default request creates a durable job (202). Use max_pages=1 for one synchronous Page response (200). Poll status_url, then read results_url with its opaque cursor. Acquisition stops at the first of since, max_pages, or exhaustion. Jobs continue after disconnects. Result responses are bounded to 3 MiB; this does not limit the crawl. Supply Idempotency-Key to recover a lost submission response; reuse it with the same inputs.\n\nA field TikTok does not carry is null, a list it does not carry is `[]`, and TikTok-only facts sit under `extra`. Unknown, unsupported, and repeated query parameters return 400 before acquisition or billing.\n\nBilling: $0.0005 per 20 unique returned items (one native page), rounded up to a minimum of one billing unit. Jobs settle once after successful completion. Submission, polling and repeat downloads are free.","security":[{"bearerAuth":[]}],"parameters":[{"name":"url","in":"query","required":true,"description":"TikTok video URL, `https://www.tiktok.com/@handle/video/<id>`. A bare video id is refused, because the read needs the author.","example":"https://www.tiktok.com/@khaby.lame/video/7681719358225239326","schema":{"type":"string"}},{"name":"since","in":"query","required":false,"description":"Not accepted on this operation: its items carry no timestamp, so since returns 400 before billing.","schema":{"type":"string"}},{"name":"max_pages","in":"query","required":false,"example":1,"description":"Maximum pages to fetch. -1 walks until exhaustion or since with no page cap, and must be written. Omitted, since alone bounds the walk; with neither, the job stops after 10 pages. Any positive integer is accepted. 1 returns one page synchronously with HTTP 200; any other value creates a durable job with HTTP 202.","schema":{"type":"integer","anyOf":[{"enum":[-1]},{"minimum":1}]}},{"name":"cursor","in":"query","required":false,"description":"Opaque next_cursor from an earlier answer of this operation, also with `get_raw=true`. A native TikTok cursor from a raw page answers 400. Result download cursors belong to the results route.","schema":{"type":"string","minLength":1}},{"name":"page_size","in":"query","required":false,"description":"Native count, default 20. TikTok answers at most 20. Billed per 20 unique returned items, one native page.","schema":{"type":"integer","default":20,"minimum":1,"maximum":20},"examples":{"default":{"value":20,"x-disabled":true}}},{"name":"cached","in":"query","required":false,"description":"`auto` (default) serves a read saved within the last 24 hours for these exact arguments, otherwise fetches. `cache_only` never contacts TikTok (404 `not_cached` when nothing is saved, whatever its age). `live` always fetches. Anything else is a `400`. `cache_only` reads one saved page per request: omit `max_pages` or pass 1, and continue with `next_cursor`.","schema":{"type":"string","enum":["auto","cache_only","live"],"default":"auto"},"examples":{"default":{"value":"auto","x-disabled":true}}},{"name":"get_raw","in":"query","required":false,"description":"`true` returns the upstream JSON exactly as TikTok answered it instead of the normalized `Page[Comment]`.","schema":{"type":"boolean","default":false},"examples":{"default":{"value":false,"x-disabled":true}}},{"name":"Idempotency-Key","in":"header","required":false,"description":"Reuse this key with the same inputs to recover a lost job submission. A different input with the same key returns 409.","schema":{"type":"string","minLength":1,"maxLength":200}}],"responses":{"200":{"description":"`Page[Comment]` under `data`; with `get_raw=true` the upstream JSON.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"anyOf":[{"type":"object","required":["items","pages","next_cursor","has_more","stop_reason","coverage"],"properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/Comment"},"description":"`Comment` of every page walked, in page order."},"pages":{"type":"array","items":{"$ref":"#/components/schemas/PageRead"},"description":"One entry per page walked."},"next_cursor":{"type":"string","nullable":true,"description":"Opaque; pass back as `cursor` to continue."},"has_more":{"type":"boolean","description":"True when `next_cursor` is set, and when the walk stopped `cursor_stalled` on a page that said more results exist but gave no cursor to send back."},"stop_reason":{"type":"string","enum":["pages","since","exhausted","cursor_stalled","repeated_content","deadline","blocked","caught_up"],"description":"Why the walk stopped. `pages`: the page budget is spent and `next_cursor` continues it. `deadline`: the call ran out of time before its next page; `next_cursor` continues it. `since`: a whole page was older than `since`. `exhausted`: TikTok reported the end. `cursor_stalled`: TikTok claimed more but repeated or omitted its cursor. `repeated_content`: a page held only items already seen. `blocked`: TikTok refused a later page; `next_cursor` is the page it refused. `caught_up`: only watch passes the crawler runs for itself stop this way."},"coverage":{"$ref":"#/components/schemas/Coverage"}}},{"type":"object","required":["pages","next_cursor","has_more","stop_reason"],"description":"`get_raw=true`: every native page walked, exactly as TikTok answered it, plus the opaque `next_cursor` and `stop_reason` of the walk.","properties":{"pages":{"type":"array","items":{"type":"object","additionalProperties":true,"required":["comments"],"properties":{"comments":{"type":"array","items":{"type":"object","additionalProperties":true}}}},"description":"One native page per page walked, upstream bytes unchanged."},"next_cursor":{"type":"string","nullable":true,"description":"Opaque; pass back as `cursor`."},"has_more":{"type":"boolean","description":"True when `next_cursor` is set, and when the walk stopped `cursor_stalled` on a page that said more results exist but gave no cursor to send back."},"stop_reason":{"type":"string","enum":["pages","since","exhausted","cursor_stalled","repeated_content","deadline","blocked","caught_up"],"description":"Why the walk stopped. `pages`: the page budget is spent and `next_cursor` continues it. `deadline`: the call ran out of time before its next page; `next_cursor` continues it. `since`: a whole page was older than `since`. `exhausted`: TikTok reported the end. `cursor_stalled`: TikTok claimed more but repeated or omitted its cursor. `repeated_content`: a page held only items already seen. `blocked`: TikTok refused a later page; `next_cursor` is the page it refused. `caught_up`: only watch passes the crawler runs for itself stop this way."}}}],"description":"`Page[Comment]`, or the upstream JSON when `get_raw=true`."},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"items":[{"id":"7681901814388622081","text":"My hero is Prophet Muhammad ﷺ ❤️","created_at":"2026-09-05T04:22:41+00:00","likes":12493,"replies":146,"liked_by_owner":null,"owner":{"id":"6586283068750479365","username":"annakhan_annie","full_name":"Anna Khan","is_verified":null,"is_private":null,"avatar_url":null,"latest_story_at":null,"extra":{"sec_uid":null}},"extra":{}},{"id":"7681721078482387729","text":"1m for what?😭","created_at":"2026-09-04T16:41:16+00:00","likes":7533,"replies":41,"liked_by_owner":null,"owner":{"id":"7151662998456632325","username":"ovayomzangwe901","full_name":"ovi.","is_verified":null,"is_private":null,"avatar_url":null,"latest_story_at":null,"extra":{"sec_uid":null}},"extra":{}},{"id":"7695763267344974598","text":"thought he was the only one","created_at":"2026-10-12T12:52:12+00:00","likes":0,"replies":0,"liked_by_owner":null,"owner":{"id":"7669869049291965441","username":"thetradesibysci","full_name":"thetradesibysci","is_verified":null,"is_private":null,"avatar_url":null,"latest_story_at":null,"extra":{"sec_uid":null}},"extra":{}}],"pages":[{"cursor":null,"fetched_at":"2026-10-12T12:58:00.084829+00:00","count":20}],"next_cursor":"eyJjdXJzb3IiOiIyMCIsIm9wIjoiY29tbWVudF9saXN0In0","has_more":true,"stop_reason":"pages","coverage":{"since":null,"oldest_at":null,"since_reached":false}},"meta":{"source":"db","fetched_at":"2026-10-12T12:58:00.084829+00:00","cost":"$0.0005","balance":"$3.3627","request_id":"req_28b36b7a92b073b717902b0877f87df1"}}}}},"202":{"description":"Durable job accepted. No completed-result charge. Save batch_id; poll status_url. Retry submission with the same Idempotency-Key after a lost response. An account may have five queued, running or payment-required jobs. A sixth new job returns 429 rate_limited. Matching idempotent replays still work at the limit. Ready and failed jobs release their slots; pages within a job remain unbounded. This is a synthetic contract example, not a live capture.","x-example-provenance":"synthetic-contract","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","required":["batch_id","status","status_url","results_url","cost","item_count","error","retry_at","total","done_count","failed_count","created_at","started_at","finished_at"],"properties":{"batch_id":{"type":"string"},"status":{"type":"string","enum":["queued","running","payment_required","ready","failed"]},"status_url":{"type":"string"},"results_url":{"type":"string"},"cost":{"type":"string"},"item_count":{"type":"integer","nullable":true},"error":{"type":"string","nullable":true,"description":"Null unless failed. A failed target carries its own code; incomplete_result appears only when it has none and pages of the result are missing. profile_not_found, post_not_found, upstream_not_found or not_found: the target does not exist or is not visible. not_visible: The account exists, but its posts are not visible to logged-out readers (private, restricted, or hidden by Instagram). Retrying will not change the result until the account changes. not_cached: cached=cache_only found no saved read. incomplete_result: pages of the result are missing. temporarily_unavailable: the target could not be read for now (no capacity, a pause or repeated refusals); retry later with a new job. result_item_too_large: one result unit exceeds the delivery budget. result_snapshot_missing or result_snapshot_corrupt: the crawler could not serve the retained result of a paid job, and its charge is refunded; if the crawler serves it again, a later results read returns it and charges the job again. crawler_submit_400, crawler_submit_404 or crawler_submit_422: the crawl service refused the job request. crawler_job_failed: any other failure; the same job is not expected to succeed if resubmitted. cancelled: the job was cancelled with POST /v1/jobs/{job_id}/cancel. No failed job costs anything: only result_snapshot_missing and result_snapshot_corrupt follow a charge, and that charge is refunded."},"retry_at":{"type":"string","format":"date-time","nullable":true,"description":"Null unless the job failed temporarily_unavailable because a crawl route was closed for every caller. Then it is when the route opens again, and the response carries the same time as a Retry-After header in seconds. Submit a new job after it."},"total":{"type":"integer","description":"Targets in the job. A job submitted through a /v1 route has one."},"done_count":{"type":"integer","description":"Targets the crawler finished."},"failed_count":{"type":"integer","description":"Targets that failed."},"created_at":{"type":"string","format":"date-time","description":"When the job was submitted."},"started_at":{"type":"string","format":"date-time","nullable":true,"description":"When the crawler started the job. Null until it starts."},"finished_at":{"type":"string","format":"date-time","nullable":true,"description":"When the job finished or failed. Null while it is queued or running."}}},"meta":{"type":"object","required":["cost","request_id"],"properties":{"cost":{"type":"string","example":"$0.0000"},"request_id":{"type":"string"}}}}},"example":{"data":{"batch_id":"job_7641d5f0-717d-4b70-a2f1-f58d846d7242","status":"queued","status_url":"/v1/jobs/job_7641d5f0-717d-4b70-a2f1-f58d846d7242","results_url":"/v1/jobs/job_7641d5f0-717d-4b70-a2f1-f58d846d7242/results","cost":"$0.0000","item_count":null,"error":null,"retry_at":null,"total":1,"done_count":0,"failed_count":0,"created_at":"2026-10-12T12:56:17.403Z","started_at":null,"finished_at":null},"meta":{"cost":"$0.0000","request_id":"req_job_example"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"404":{"description":"`cached=cache_only` found nothing saved for these arguments (`not_cached`; call again with `cached=auto` to fetch it), or the TikTok account or item does not exist (`not_found`). You are not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_cached","message":"no saved tiktok/comment_list read for 'https://www.tiktok.com/@khaby.lame/video/7681719358225239326'. cached=cache_only never fetches, so call again with cached=auto to fetch it. You are not charged.","request_id":"req_5c10900e919bc7a3ff79b7501d582b4c"}}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/tiktok/related_item_list":{"get":{"tags":["TikTok"],"operationId":"ttRelatedItemList","summary":"related_item_list","x-dashboard-cost":"$0.0005","x-example-query":{"url":"https://www.tiktok.com/@khaby.lame/video/7681719358225239326"},"description":"The videos TikTok ranks as similar to one video. TikTok picks them by similar content, so they find creators in the same niche; they do not show duets, stitches or collaborations. Returns `Post[]` under `data`; with `get_raw=true` returns the upstream JSON.\n\nA field TikTok does not carry is null, a list it does not carry is `[]`, and TikTok-only facts sit under `extra`. Unknown, unsupported, and repeated query parameters return 400 before acquisition or billing.","security":[{"bearerAuth":[]}],"parameters":[{"name":"url","in":"query","required":true,"description":"TikTok video URL, `https://www.tiktok.com/@handle/video/<id>`. A bare video id is refused, because the read needs the author.","example":"https://www.tiktok.com/@khaby.lame/video/7681719358225239326","schema":{"type":"string"}},{"name":"cached","in":"query","required":false,"description":"`auto` (default) serves a read saved within the last 24 hours for these exact arguments, otherwise fetches. `cache_only` never contacts TikTok (404 `not_cached` when nothing is saved, whatever its age). `live` always fetches. Anything else is a `400`.","schema":{"type":"string","enum":["auto","cache_only","live"],"default":"auto"},"examples":{"default":{"value":"auto","x-disabled":true}}},{"name":"get_raw","in":"query","required":false,"description":"`true` returns the upstream JSON exactly as TikTok answered it instead of the normalized `Post[]`.","schema":{"type":"boolean","default":false},"examples":{"default":{"value":false,"x-disabled":true}}}],"responses":{"200":{"description":"`Post[]` under `data`; with `get_raw=true` the upstream JSON.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"anyOf":[{"type":"array","items":{"$ref":"#/components/schemas/Post"}},{"type":"object","additionalProperties":true}],"description":"`Post[]`, or the upstream JSON when `get_raw=true`."},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":[{"id":"7688786985896381727","shortcode":null,"taken_at":"2026-09-23T17:40:45+00:00","kind":"video","product_type":null,"caption":"Landing in a new country without worrying about WiFi? It’s so simple with @Holafly | eSIM holafly🤲🏿 🌍 📶  #Holafly   ","hashtags":["holafly"],"mentions":[],"accessibility_caption":null,"likes":329400,"comments":6147,"views":6700000,"counts_hidden":null,"comments_disabled":null,"is_pinned":null,"is_paid_partnership":null,"owner":{"id":"127905465618821121","username":"khaby.lame","full_name":"Khabane lame","is_verified":true,"is_private":false,"avatar_url":"https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/08987e23b94057953fd4f1738694bf5f~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=14579&refresh_token=06949bfc&x-expires=1791979200&x-signature=ll1BWfMpjIDIEY9G3IPYZWKHskk%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my2","latest_story_at":null,"extra":{"sec_uid":null}},"coauthors":[],"sponsors":[],"tagged":[],"location":null,"audio":{"id":null,"title":"original sound","artist":"Khabane lame","is_original":null},"thumbnail_url":"https://f005.backblazeb2.com/file/influencer-dev/staging/crawler/tiktok_video/17354802.webp","video_duration":23,"media":[],"media_urls":[],"extra":{"url":"https://www.tiktok.com/@khaby.lame/video/7688786985896381727","shares":1906,"saves":18647}},{"id":"7683944847840922911","shortcode":null,"taken_at":"2026-09-10T16:30:36+00:00","kind":"video","product_type":null,"caption":"DM to purchase ✌🏾#learnfromkhaby #comedy ","hashtags":["comedy","learnfromkhaby"],"mentions":[],"accessibility_caption":null,"likes":6500000,"comments":45200,"views":85400000,"counts_hidden":null,"comments_disabled":null,"is_pinned":null,"is_paid_partnership":null,"owner":{"id":"127905465618821121","username":"khaby.lame","full_name":"Khabane lame","is_verified":true,"is_private":false,"avatar_url":"https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/08987e23b94057953fd4f1738694bf5f~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=14579&refresh_token=06949bfc&x-expires=1791979200&x-signature=ll1BWfMpjIDIEY9G3IPYZWKHskk%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my2","latest_story_at":null,"extra":{"sec_uid":null}},"coauthors":[],"sponsors":[],"tagged":[],"location":null,"audio":{"id":null,"title":"original sound","artist":"Khabane lame","is_original":null},"thumbnail_url":"https://f005.backblazeb2.com/file/influencer-dev/staging/crawler/tiktok_video/17354799.webp","video_duration":31,"media":[],"media_urls":[],"extra":{"url":"https://www.tiktok.com/@khaby.lame/video/7683944847840922911","shares":217100,"saves":224625}},{"id":"7670957230178503966","shortcode":null,"taken_at":"2026-08-06T16:32:00+00:00","kind":"video","product_type":null,"caption":"I showed you how it’s done… your turn now.#learnfromkhaby #comedy ","hashtags":["comedy","learnfromkhaby"],"mentions":[],"accessibility_caption":null,"likes":4400000,"comments":58200,"views":86600000,"counts_hidden":null,"comments_disabled":null,"is_pinned":null,"is_paid_partnership":null,"owner":{"id":"127905465618821121","username":"khaby.lame","full_name":"Khabane lame","is_verified":true,"is_private":false,"avatar_url":"https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/08987e23b94057953fd4f1738694bf5f~tplv-tiktokx-cropcenter:1080:1080.jpeg?dr=14579&refresh_token=06949bfc&x-expires=1791979200&x-signature=ll1BWfMpjIDIEY9G3IPYZWKHskk%3D&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=81f88b70&idc=my2","latest_story_at":null,"extra":{"sec_uid":null}},"coauthors":[],"sponsors":[],"tagged":[],"location":null,"audio":{"id":null,"title":"original sound","artist":"Khabane lame","is_original":null},"thumbnail_url":"https://f005.backblazeb2.com/file/influencer-dev/staging/crawler/tiktok_video/15196233.webp","video_duration":44,"media":[],"media_urls":[],"extra":{"url":"https://www.tiktok.com/@khaby.lame/video/7670957230178503966","shares":295600,"saves":171788}}],"meta":{"source":"db","fetched_at":"2026-10-12T12:59:02.489602+00:00","cost":"$0.0005","balance":"$3.3627","request_id":"req_6a82fc3d818e7fd4b35f162d3c94c5bd"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"404":{"description":"`cached=cache_only` found nothing saved for these arguments (`not_cached`; call again with `cached=auto` to fetch it), or the TikTok account or item does not exist (`not_found`). You are not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_cached","message":"no saved tiktok/related_item_list read for 'https://www.tiktok.com/@khaby.lame/video/7681719358225239326'. cached=cache_only never fetches, so call again with cached=auto to fetch it. You are not charged.","request_id":"req_5c10900e919bc7a3ff79b7501d582b4c"}}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/tiktok/followers":{"get":{"tags":["TikTok"],"operationId":"ttFollowers","summary":"followers","x-dashboard-cost":"$0.0005/30","x-example-query":{"handle":"khaby.lame","max_pages":"1"},"description":"The accounts that follow this account, as TikTok serves them without a login. With max_pages=1, returns `Page[Account]` under `data`; with `get_raw=true` returns the upstream JSON.\n\nThe default request creates a durable job (202). Use max_pages=1 for one synchronous Page response (200). Poll status_url, then read results_url with its opaque cursor. Acquisition stops at the first of since, max_pages, or exhaustion. Jobs continue after disconnects. Result responses are bounded to 3 MiB; this does not limit the crawl. Supply Idempotency-Key to recover a lost submission response; reuse it with the same inputs.\n\nA field TikTok does not carry is null, a list it does not carry is `[]`, and TikTok-only facts sit under `extra`. Unknown, unsupported, and repeated query parameters return 400 before acquisition or billing.\n\nBilling: $0.0005 per 30 unique returned items (one native page), rounded up to a minimum of one billing unit. Jobs settle once after successful completion. Submission, polling and repeat downloads are free.","security":[{"bearerAuth":[]}],"parameters":[{"name":"handle","in":"query","required":true,"description":"TikTok handle, with or without `@`, or a `tiktok.com/@handle` URL.","example":"khaby.lame","schema":{"type":"string"}},{"name":"since","in":"query","required":false,"description":"Not accepted on this operation: its items carry no timestamp, so since returns 400 before billing.","schema":{"type":"string"}},{"name":"max_pages","in":"query","required":false,"example":1,"description":"Maximum pages to fetch. -1 walks until exhaustion or since with no page cap, and must be written. Omitted, since alone bounds the walk; with neither, the job stops after 10 pages. Any positive integer is accepted. 1 returns one page synchronously with HTTP 200; any other value creates a durable job with HTTP 202.","schema":{"type":"integer","anyOf":[{"enum":[-1]},{"minimum":1}]}},{"name":"cursor","in":"query","required":false,"description":"Opaque next_cursor from an earlier answer of this operation, also with `get_raw=true`. A native TikTok cursor from a raw page answers 400. Result download cursors belong to the results route.","schema":{"type":"string","minLength":1}},{"name":"page_size","in":"query","required":false,"description":"Native count, default 30. TikTok answers at most 30. Billed per 30 unique returned items, one native page.","schema":{"type":"integer","default":30,"minimum":1,"maximum":30},"examples":{"default":{"value":30,"x-disabled":true}}},{"name":"cached","in":"query","required":false,"description":"`auto` (default) serves a read saved within the last 24 hours for these exact arguments, otherwise fetches. `cache_only` never contacts TikTok (404 `not_cached` when nothing is saved, whatever its age). `live` always fetches. Anything else is a `400`. `cache_only` reads one saved page per request: omit `max_pages` or pass 1, and continue with `next_cursor`.","schema":{"type":"string","enum":["auto","cache_only","live"],"default":"auto"},"examples":{"default":{"value":"auto","x-disabled":true}}},{"name":"get_raw","in":"query","required":false,"description":"`true` returns the upstream JSON exactly as TikTok answered it instead of the normalized `Page[Account]`.","schema":{"type":"boolean","default":false},"examples":{"default":{"value":false,"x-disabled":true}}},{"name":"Idempotency-Key","in":"header","required":false,"description":"Reuse this key with the same inputs to recover a lost job submission. A different input with the same key returns 409.","schema":{"type":"string","minLength":1,"maxLength":200}}],"responses":{"200":{"description":"`Page[Account]` under `data`; with `get_raw=true` the upstream JSON.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"anyOf":[{"type":"object","required":["items","pages","next_cursor","has_more","stop_reason","coverage"],"properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/Account"},"description":"`Account` of every page walked, in page order."},"pages":{"type":"array","items":{"$ref":"#/components/schemas/PageRead"},"description":"One entry per page walked."},"next_cursor":{"type":"string","nullable":true,"description":"Opaque; pass back as `cursor` to continue."},"has_more":{"type":"boolean","description":"True when `next_cursor` is set, and when the walk stopped `cursor_stalled` on a page that said more results exist but gave no cursor to send back."},"stop_reason":{"type":"string","enum":["pages","since","exhausted","cursor_stalled","repeated_content","deadline","blocked","caught_up"],"description":"Why the walk stopped. `pages`: the page budget is spent and `next_cursor` continues it. `deadline`: the call ran out of time before its next page; `next_cursor` continues it. `since`: a whole page was older than `since`. `exhausted`: TikTok reported the end. `cursor_stalled`: TikTok claimed more but repeated or omitted its cursor. `repeated_content`: a page held only items already seen. `blocked`: TikTok refused a later page; `next_cursor` is the page it refused. `caught_up`: only watch passes the crawler runs for itself stop this way."},"coverage":{"$ref":"#/components/schemas/Coverage"}}},{"type":"object","required":["pages","next_cursor","has_more","stop_reason"],"description":"`get_raw=true`: every native page walked, exactly as TikTok answered it, plus the opaque `next_cursor` and `stop_reason` of the walk.","properties":{"pages":{"type":"array","items":{"type":"object","additionalProperties":true,"required":["userList"],"properties":{"userList":{"type":"array","items":{"type":"object","additionalProperties":true}}}},"description":"One native page per page walked, upstream bytes unchanged."},"next_cursor":{"type":"string","nullable":true,"description":"Opaque; pass back as `cursor`."},"has_more":{"type":"boolean","description":"True when `next_cursor` is set, and when the walk stopped `cursor_stalled` on a page that said more results exist but gave no cursor to send back."},"stop_reason":{"type":"string","enum":["pages","since","exhausted","cursor_stalled","repeated_content","deadline","blocked","caught_up"],"description":"Why the walk stopped. `pages`: the page budget is spent and `next_cursor` continues it. `deadline`: the call ran out of time before its next page; `next_cursor` continues it. `since`: a whole page was older than `since`. `exhausted`: TikTok reported the end. `cursor_stalled`: TikTok claimed more but repeated or omitted its cursor. `repeated_content`: a page held only items already seen. `blocked`: TikTok refused a later page; `next_cursor` is the page it refused. `caught_up`: only watch passes the crawler runs for itself stop this way."}}}],"description":"`Page[Account]`, or the upstream JSON when `get_raw=true`."},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"items":[{"id":"7025335115594597381","username":"sasuke208954673","full_name":"@luka23","is_verified":false,"is_private":false,"avatar_url":"https://f005.backblazeb2.com/file/influencer-dev/staging/crawler/tiktok_account/289012.webp","latest_story_at":null,"extra":{"sec_uid":null}},{"id":"7692475020983878676","username":"afrin006980","full_name":"!...A.F.R.I.N...!","is_verified":false,"is_private":false,"avatar_url":"https://f005.backblazeb2.com/file/influencer-dev/staging/crawler/tiktok_account/288988.webp","latest_story_at":null,"extra":{"sec_uid":null}},{"id":"7190822001945297925","username":"agrifoutayirlabe","full_name":"Lee","is_verified":false,"is_private":true,"avatar_url":"https://f005.backblazeb2.com/file/influencer-dev/staging/crawler/tiktok_account/288989.webp","latest_story_at":null,"extra":{"sec_uid":null}}],"pages":[{"cursor":null,"fetched_at":"2026-10-12T12:57:48.541824+00:00","count":30}],"next_cursor":"eyJjdXJzb3IiOiIxNzgxNDA3OTcyIiwib3AiOiJmb2xsb3dlcnMifQ","has_more":true,"stop_reason":"pages","coverage":{"since":null,"oldest_at":null,"since_reached":false}},"meta":{"source":"db","fetched_at":"2026-10-12T12:57:48.541824+00:00","cost":"$0.0005","balance":"$3.3627","request_id":"req_1c192a4faf78a99bccf2473e59cce8e2"}}}}},"202":{"description":"Durable job accepted. No completed-result charge. Save batch_id; poll status_url. Retry submission with the same Idempotency-Key after a lost response. An account may have five queued, running or payment-required jobs. A sixth new job returns 429 rate_limited. Matching idempotent replays still work at the limit. Ready and failed jobs release their slots; pages within a job remain unbounded. This is a synthetic contract example, not a live capture.","x-example-provenance":"synthetic-contract","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","required":["batch_id","status","status_url","results_url","cost","item_count","error","retry_at","total","done_count","failed_count","created_at","started_at","finished_at"],"properties":{"batch_id":{"type":"string"},"status":{"type":"string","enum":["queued","running","payment_required","ready","failed"]},"status_url":{"type":"string"},"results_url":{"type":"string"},"cost":{"type":"string"},"item_count":{"type":"integer","nullable":true},"error":{"type":"string","nullable":true,"description":"Null unless failed. A failed target carries its own code; incomplete_result appears only when it has none and pages of the result are missing. profile_not_found, post_not_found, upstream_not_found or not_found: the target does not exist or is not visible. not_visible: The account exists, but its posts are not visible to logged-out readers (private, restricted, or hidden by Instagram). Retrying will not change the result until the account changes. not_cached: cached=cache_only found no saved read. incomplete_result: pages of the result are missing. temporarily_unavailable: the target could not be read for now (no capacity, a pause or repeated refusals); retry later with a new job. result_item_too_large: one result unit exceeds the delivery budget. result_snapshot_missing or result_snapshot_corrupt: the crawler could not serve the retained result of a paid job, and its charge is refunded; if the crawler serves it again, a later results read returns it and charges the job again. crawler_submit_400, crawler_submit_404 or crawler_submit_422: the crawl service refused the job request. crawler_job_failed: any other failure; the same job is not expected to succeed if resubmitted. cancelled: the job was cancelled with POST /v1/jobs/{job_id}/cancel. No failed job costs anything: only result_snapshot_missing and result_snapshot_corrupt follow a charge, and that charge is refunded."},"retry_at":{"type":"string","format":"date-time","nullable":true,"description":"Null unless the job failed temporarily_unavailable because a crawl route was closed for every caller. Then it is when the route opens again, and the response carries the same time as a Retry-After header in seconds. Submit a new job after it."},"total":{"type":"integer","description":"Targets in the job. A job submitted through a /v1 route has one."},"done_count":{"type":"integer","description":"Targets the crawler finished."},"failed_count":{"type":"integer","description":"Targets that failed."},"created_at":{"type":"string","format":"date-time","description":"When the job was submitted."},"started_at":{"type":"string","format":"date-time","nullable":true,"description":"When the crawler started the job. Null until it starts."},"finished_at":{"type":"string","format":"date-time","nullable":true,"description":"When the job finished or failed. Null while it is queued or running."}}},"meta":{"type":"object","required":["cost","request_id"],"properties":{"cost":{"type":"string","example":"$0.0000"},"request_id":{"type":"string"}}}}},"example":{"data":{"batch_id":"job_7641d5f0-717d-4b70-a2f1-f58d846d7242","status":"queued","status_url":"/v1/jobs/job_7641d5f0-717d-4b70-a2f1-f58d846d7242","results_url":"/v1/jobs/job_7641d5f0-717d-4b70-a2f1-f58d846d7242/results","cost":"$0.0000","item_count":null,"error":null,"retry_at":null,"total":1,"done_count":0,"failed_count":0,"created_at":"2026-10-12T12:56:17.403Z","started_at":null,"finished_at":null},"meta":{"cost":"$0.0000","request_id":"req_job_example"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"404":{"description":"`cached=cache_only` found nothing saved for these arguments (`not_cached`; call again with `cached=auto` to fetch it), or the TikTok account or item does not exist (`not_found`). You are not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_cached","message":"no saved tiktok/followers read for 'khaby.lame'. cached=cache_only never fetches, so call again with cached=auto to fetch it. You are not charged.","request_id":"req_5c10900e919bc7a3ff79b7501d582b4c"}}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/tiktok/following":{"get":{"tags":["TikTok"],"operationId":"ttFollowing","summary":"following","x-dashboard-cost":"$0.0005/30","x-example-query":{"handle":"khaby.lame","max_pages":"1"},"description":"The accounts this account follows. With max_pages=1, returns `Page[Account]` under `data`; with `get_raw=true` returns the upstream JSON.\n\nThe default request creates a durable job (202). Use max_pages=1 for one synchronous Page response (200). Poll status_url, then read results_url with its opaque cursor. Acquisition stops at the first of since, max_pages, or exhaustion. Jobs continue after disconnects. Result responses are bounded to 3 MiB; this does not limit the crawl. Supply Idempotency-Key to recover a lost submission response; reuse it with the same inputs.\n\nA field TikTok does not carry is null, a list it does not carry is `[]`, and TikTok-only facts sit under `extra`. Unknown, unsupported, and repeated query parameters return 400 before acquisition or billing.\n\nBilling: $0.0005 per 30 unique returned items (one native page), rounded up to a minimum of one billing unit. Jobs settle once after successful completion. Submission, polling and repeat downloads are free.","security":[{"bearerAuth":[]}],"parameters":[{"name":"handle","in":"query","required":true,"description":"TikTok handle, with or without `@`, or a `tiktok.com/@handle` URL.","example":"khaby.lame","schema":{"type":"string"}},{"name":"since","in":"query","required":false,"description":"Not accepted on this operation: its items carry no timestamp, so since returns 400 before billing.","schema":{"type":"string"}},{"name":"max_pages","in":"query","required":false,"example":1,"description":"Maximum pages to fetch. -1 walks until exhaustion or since with no page cap, and must be written. Omitted, since alone bounds the walk; with neither, the job stops after 10 pages. Any positive integer is accepted. 1 returns one page synchronously with HTTP 200; any other value creates a durable job with HTTP 202.","schema":{"type":"integer","anyOf":[{"enum":[-1]},{"minimum":1}]}},{"name":"cursor","in":"query","required":false,"description":"Opaque next_cursor from an earlier answer of this operation, also with `get_raw=true`. A native TikTok cursor from a raw page answers 400. Result download cursors belong to the results route.","schema":{"type":"string","minLength":1}},{"name":"page_size","in":"query","required":false,"description":"Native count, default 30. TikTok answers at most 30. Billed per 30 unique returned items, one native page.","schema":{"type":"integer","default":30,"minimum":1,"maximum":30},"examples":{"default":{"value":30,"x-disabled":true}}},{"name":"cached","in":"query","required":false,"description":"`auto` (default) serves a read saved within the last 24 hours for these exact arguments, otherwise fetches. `cache_only` never contacts TikTok (404 `not_cached` when nothing is saved, whatever its age). `live` always fetches. Anything else is a `400`. `cache_only` reads one saved page per request: omit `max_pages` or pass 1, and continue with `next_cursor`.","schema":{"type":"string","enum":["auto","cache_only","live"],"default":"auto"},"examples":{"default":{"value":"auto","x-disabled":true}}},{"name":"get_raw","in":"query","required":false,"description":"`true` returns the upstream JSON exactly as TikTok answered it instead of the normalized `Page[Account]`.","schema":{"type":"boolean","default":false},"examples":{"default":{"value":false,"x-disabled":true}}},{"name":"Idempotency-Key","in":"header","required":false,"description":"Reuse this key with the same inputs to recover a lost job submission. A different input with the same key returns 409.","schema":{"type":"string","minLength":1,"maxLength":200}}],"responses":{"200":{"description":"`Page[Account]` under `data`; with `get_raw=true` the upstream JSON.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"anyOf":[{"type":"object","required":["items","pages","next_cursor","has_more","stop_reason","coverage"],"properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/Account"},"description":"`Account` of every page walked, in page order."},"pages":{"type":"array","items":{"$ref":"#/components/schemas/PageRead"},"description":"One entry per page walked."},"next_cursor":{"type":"string","nullable":true,"description":"Opaque; pass back as `cursor` to continue."},"has_more":{"type":"boolean","description":"True when `next_cursor` is set, and when the walk stopped `cursor_stalled` on a page that said more results exist but gave no cursor to send back."},"stop_reason":{"type":"string","enum":["pages","since","exhausted","cursor_stalled","repeated_content","deadline","blocked","caught_up"],"description":"Why the walk stopped. `pages`: the page budget is spent and `next_cursor` continues it. `deadline`: the call ran out of time before its next page; `next_cursor` continues it. `since`: a whole page was older than `since`. `exhausted`: TikTok reported the end. `cursor_stalled`: TikTok claimed more but repeated or omitted its cursor. `repeated_content`: a page held only items already seen. `blocked`: TikTok refused a later page; `next_cursor` is the page it refused. `caught_up`: only watch passes the crawler runs for itself stop this way."},"coverage":{"$ref":"#/components/schemas/Coverage"}}},{"type":"object","required":["pages","next_cursor","has_more","stop_reason"],"description":"`get_raw=true`: every native page walked, exactly as TikTok answered it, plus the opaque `next_cursor` and `stop_reason` of the walk.","properties":{"pages":{"type":"array","items":{"type":"object","additionalProperties":true,"required":["userList"],"properties":{"userList":{"type":"array","items":{"type":"object","additionalProperties":true}}}},"description":"One native page per page walked, upstream bytes unchanged."},"next_cursor":{"type":"string","nullable":true,"description":"Opaque; pass back as `cursor`."},"has_more":{"type":"boolean","description":"True when `next_cursor` is set, and when the walk stopped `cursor_stalled` on a page that said more results exist but gave no cursor to send back."},"stop_reason":{"type":"string","enum":["pages","since","exhausted","cursor_stalled","repeated_content","deadline","blocked","caught_up"],"description":"Why the walk stopped. `pages`: the page budget is spent and `next_cursor` continues it. `deadline`: the call ran out of time before its next page; `next_cursor` continues it. `since`: a whole page was older than `since`. `exhausted`: TikTok reported the end. `cursor_stalled`: TikTok claimed more but repeated or omitted its cursor. `repeated_content`: a page held only items already seen. `blocked`: TikTok refused a later page; `next_cursor` is the page it refused. `caught_up`: only watch passes the crawler runs for itself stop this way."}}}],"description":"`Page[Account]`, or the upstream JSON when `get_raw=true`."},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"items":[{"id":"7530943790661305399","username":"user38180545530128","full_name":"user38180545530128","is_verified":false,"is_private":false,"avatar_url":"https://f005.backblazeb2.com/file/influencer-dev/staging/crawler/tiktok_account/288921.webp","latest_story_at":null,"extra":{"sec_uid":null}},{"id":"7059636734342038534","username":"fifaworldcup","full_name":"FIFA World Cup","is_verified":true,"is_private":false,"avatar_url":"https://f005.backblazeb2.com/file/influencer-dev/staging/crawler/tiktok_account/17551.webp","latest_story_at":null,"extra":{"sec_uid":null}},{"id":"6551237489917432832","username":"tiktokcreators","full_name":"tiktok creators","is_verified":true,"is_private":false,"avatar_url":"https://f005.backblazeb2.com/file/influencer-dev/staging/crawler/tiktok_account/7419.webp","latest_story_at":null,"extra":{"sec_uid":null}}],"pages":[{"cursor":null,"fetched_at":"2026-10-12T12:57:52.719822+00:00","count":30}],"next_cursor":"eyJjdXJzb3IiOiIxNzgxNDA3OTcyIiwib3AiOiJmb2xsb3dpbmcifQ","has_more":true,"stop_reason":"pages","coverage":{"since":null,"oldest_at":null,"since_reached":false}},"meta":{"source":"db","fetched_at":"2026-10-12T12:57:52.719822+00:00","cost":"$0.0005","balance":"$3.3627","request_id":"req_9e3c8937bd0d4fdb852bc091ed0fc145"}}}}},"202":{"description":"Durable job accepted. No completed-result charge. Save batch_id; poll status_url. Retry submission with the same Idempotency-Key after a lost response. An account may have five queued, running or payment-required jobs. A sixth new job returns 429 rate_limited. Matching idempotent replays still work at the limit. Ready and failed jobs release their slots; pages within a job remain unbounded. This is a synthetic contract example, not a live capture.","x-example-provenance":"synthetic-contract","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","required":["batch_id","status","status_url","results_url","cost","item_count","error","retry_at","total","done_count","failed_count","created_at","started_at","finished_at"],"properties":{"batch_id":{"type":"string"},"status":{"type":"string","enum":["queued","running","payment_required","ready","failed"]},"status_url":{"type":"string"},"results_url":{"type":"string"},"cost":{"type":"string"},"item_count":{"type":"integer","nullable":true},"error":{"type":"string","nullable":true,"description":"Null unless failed. A failed target carries its own code; incomplete_result appears only when it has none and pages of the result are missing. profile_not_found, post_not_found, upstream_not_found or not_found: the target does not exist or is not visible. not_visible: The account exists, but its posts are not visible to logged-out readers (private, restricted, or hidden by Instagram). Retrying will not change the result until the account changes. not_cached: cached=cache_only found no saved read. incomplete_result: pages of the result are missing. temporarily_unavailable: the target could not be read for now (no capacity, a pause or repeated refusals); retry later with a new job. result_item_too_large: one result unit exceeds the delivery budget. result_snapshot_missing or result_snapshot_corrupt: the crawler could not serve the retained result of a paid job, and its charge is refunded; if the crawler serves it again, a later results read returns it and charges the job again. crawler_submit_400, crawler_submit_404 or crawler_submit_422: the crawl service refused the job request. crawler_job_failed: any other failure; the same job is not expected to succeed if resubmitted. cancelled: the job was cancelled with POST /v1/jobs/{job_id}/cancel. No failed job costs anything: only result_snapshot_missing and result_snapshot_corrupt follow a charge, and that charge is refunded."},"retry_at":{"type":"string","format":"date-time","nullable":true,"description":"Null unless the job failed temporarily_unavailable because a crawl route was closed for every caller. Then it is when the route opens again, and the response carries the same time as a Retry-After header in seconds. Submit a new job after it."},"total":{"type":"integer","description":"Targets in the job. A job submitted through a /v1 route has one."},"done_count":{"type":"integer","description":"Targets the crawler finished."},"failed_count":{"type":"integer","description":"Targets that failed."},"created_at":{"type":"string","format":"date-time","description":"When the job was submitted."},"started_at":{"type":"string","format":"date-time","nullable":true,"description":"When the crawler started the job. Null until it starts."},"finished_at":{"type":"string","format":"date-time","nullable":true,"description":"When the job finished or failed. Null while it is queued or running."}}},"meta":{"type":"object","required":["cost","request_id"],"properties":{"cost":{"type":"string","example":"$0.0000"},"request_id":{"type":"string"}}}}},"example":{"data":{"batch_id":"job_7641d5f0-717d-4b70-a2f1-f58d846d7242","status":"queued","status_url":"/v1/jobs/job_7641d5f0-717d-4b70-a2f1-f58d846d7242","results_url":"/v1/jobs/job_7641d5f0-717d-4b70-a2f1-f58d846d7242/results","cost":"$0.0000","item_count":null,"error":null,"retry_at":null,"total":1,"done_count":0,"failed_count":0,"created_at":"2026-10-12T12:56:17.403Z","started_at":null,"finished_at":null},"meta":{"cost":"$0.0000","request_id":"req_job_example"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"404":{"description":"`cached=cache_only` found nothing saved for these arguments (`not_cached`; call again with `cached=auto` to fetch it), or the TikTok account or item does not exist (`not_found`). You are not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_cached","message":"no saved tiktok/following read for 'khaby.lame'. cached=cache_only never fetches, so call again with cached=auto to fetch it. You are not charged.","request_id":"req_5c10900e919bc7a3ff79b7501d582b4c"}}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/tiktok/user_playlist":{"get":{"tags":["TikTok"],"operationId":"ttUserPlaylist","summary":"user_playlist","x-dashboard-cost":"$0.0005","x-example-query":{"handle":"tiktok"},"description":"The playlists (series) a creator curates, with each playlist’s video count. An account with no playlists answers an empty list. Returns `Playlist[]` under `data`; with `get_raw=true` returns the upstream JSON.\n\nA field TikTok does not carry is null, a list it does not carry is `[]`, and TikTok-only facts sit under `extra`. Unknown, unsupported, and repeated query parameters return 400 before acquisition or billing.","security":[{"bearerAuth":[]}],"parameters":[{"name":"handle","in":"query","required":true,"description":"TikTok handle, with or without `@`, or a `tiktok.com/@handle` URL.","example":"tiktok","schema":{"type":"string"}},{"name":"cached","in":"query","required":false,"description":"`auto` (default) serves a read saved within the last 24 hours for these exact arguments, otherwise fetches. `cache_only` never contacts TikTok (404 `not_cached` when nothing is saved, whatever its age). `live` always fetches. Anything else is a `400`.","schema":{"type":"string","enum":["auto","cache_only","live"],"default":"auto"},"examples":{"default":{"value":"auto","x-disabled":true}}},{"name":"get_raw","in":"query","required":false,"description":"`true` returns the upstream JSON exactly as TikTok answered it instead of the normalized `Playlist[]`.","schema":{"type":"boolean","default":false},"examples":{"default":{"value":false,"x-disabled":true}}}],"responses":{"200":{"description":"`Playlist[]` under `data`; with `get_raw=true` the upstream JSON.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"anyOf":[{"type":"array","items":{"$ref":"#/components/schemas/Playlist"}},{"type":"object","additionalProperties":true}],"description":"`Playlist[]`, or the upstream JSON when `get_raw=true`."},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":[{"id":"7681171537575824159","name":"Songs Of The Summer 2026","videos":null,"cover_url":null},{"id":"7659874208872221471","name":"Behind The Breakthrough","videos":null,"cover_url":null},{"id":"7516638364301265695","name":"In The Mix","videos":null,"cover_url":null}],"meta":{"source":"live","fetched_at":"2026-10-12T13:43:32.516973+00:00","cost":"$0.0005","balance":"$3.3627","request_id":"req_efdf9be34f7d3915d1a03c1aee77c100"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"404":{"description":"`cached=cache_only` found nothing saved for these arguments (`not_cached`; call again with `cached=auto` to fetch it), or the TikTok account or item does not exist (`not_found`). You are not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_cached","message":"no saved tiktok/user_playlist read for 'tiktok'. cached=cache_only never fetches, so call again with cached=auto to fetch it. You are not charged.","request_id":"req_5c10900e919bc7a3ff79b7501d582b4c"}}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/tiktok/mentioned-in":{"get":{"tags":["TikTok"],"operationId":"ttMentionedIn","summary":"Videos mentioning an account","description":"Videos by other creators that @mention an account, newest first. Point it at a brand to list creators who posted about it.\n\nStrictly DB. TikTok has no tagged feed, so this list comes from the captions of videos already crawled. Read `basis.completeness = \"floor\"` as \"at least this many\", never a total. An account with no stored row answers 200 with `target.tracked = false`. `next_cursor` is null on the last page; send it back as `cursor` for the next one.","x-dashboard-cost":"$0.0005","x-example-query":{"q":"khaby.lame","limit":"3"},"security":[{"bearerAuth":[]}],"parameters":[{"name":"q","in":"query","required":true,"description":"TikTok username, @handle, or `tiktok.com/@handle` URL.","example":"khaby.lame","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"How many videos to return, 1 to 100.","schema":{"type":"integer","minimum":1,"maximum":100,"default":30},"examples":{"default":{"value":30,"x-disabled":true}}},{"name":"cursor","in":"query","required":false,"description":"Opaque `next_cursor` from the previous page.","schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Mentioning videos.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":true},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"target":{"username":"khaby.lame","tracked":true,"tiktok_id":"127905465618821121"},"basis":{"index":"derived","source":"caption textExtra mentions inverted over the crawled corpus","mention_rows":41,"distinct_authors":37,"id_resolved_rows":41,"completeness":"floor"},"videos":[{"tiktok_video_id":"7692892750076808481","caption":"#duo avec @Khabane lame #learnfromkhaby #rire #comedia #vision ","likes":null,"comments":null,"shares":null,"plays":null,"posted_at":"2026-10-04T19:12:53Z","video_url":null,"cover_url":null,"author_username":"andre.junior292","author_full_name":"ANDRÉ","author_followers":20300,"author_is_verified":false,"mentioned_platform_id":"127905465618821121","extractor_surface":"music","first_seen_at":"2026-10-12T12:57:38.431160Z","matched_by_user_id":true},{"tiktok_video_id":"7690486524751695112","caption":"#duet with @Khabane lame #learnfromkhaby ","likes":null,"comments":null,"shares":null,"plays":null,"posted_at":"2026-09-28T07:35:36Z","video_url":null,"cover_url":null,"author_username":"king874523","author_full_name":"malik","author_followers":1744,"author_is_verified":false,"mentioned_platform_id":"127905465618821121","extractor_surface":"music","first_seen_at":"2026-10-12T12:57:38.431160Z","matched_by_user_id":true},{"tiktok_video_id":"7689882029210471688","caption":"#duet with @Khabane lame #learnfromkhaby #fynnyvideo ","likes":null,"comments":null,"shares":null,"plays":null,"posted_at":"2026-09-26T16:29:49Z","video_url":null,"cover_url":null,"author_username":"5solayman35","author_full_name":"MD Solayman Howlader","author_followers":930,"author_is_verified":false,"mentioned_platform_id":"127905465618821121","extractor_surface":"music","first_seen_at":"2026-10-12T12:57:38.431160Z","matched_by_user_id":true}],"next_cursor":"WzE3MzU0NzIyLCIyMDI2LTA5LTI2VDE2OjI5OjQ5KzAwOjAwIl0","has_more":true},"meta":{"cost":"$0.0005","balance":"$3.3627","request_id":"req_812ca0b7c9b7eb5083add8dcb6fef7d1"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/youtube/profile":{"get":{"tags":["YouTube"],"operationId":"ytProfile","summary":"Channel","x-dashboard-cost":"$0.0005","description":"A YouTube channel profile read model over the tracked corpus: name, bio, subscriber/video/view counts, country, verified flag, keywords, and avatar/banner URLs — plus the AI enrichment block when present.\n\nStrictly DB — a channel we have never crawled is a `404`, never a crawl. `q` accepts a case-sensitive @handle or a `UC…` channel id. Fetch a fresh channel with `/v1/youtube/channel` using an @handle, UC… id, or supported channel URL.\n\nThe response carries no email or contact block. Find emails with `/v1/contacts/find-from-instagram/fast` or the other `/v1/contacts/find*` paths.","security":[{"bearerAuth":[]}],"parameters":[{"name":"q","in":"query","required":true,"description":"YouTube @handle (case-sensitive), `UC…` channel id, or a `youtube.com/@handle` / `/channel/UC…` URL.","schema":{"type":"string"},"example":"mkbhd"}],"responses":{"200":{"description":"YouTube channel.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object"},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"id":1,"profile_id":1316,"platform":"youtube","username":"mkbhd","channel_id":"UCBJycsmduvYEL83R_U4JriQ","full_name":"Marques Brownlee","biography":"MKBHD: Quality Tech Videos | YouTuber | Geek | Consumer Electronics | Tech Head | Internet Personality!\n\nbusiness@MKBHD.com\n\nNYC","profile_pic_url":"https://yt3.googleusercontent.com/qu4TmIaYUlS41-dJ9gZ7DUR3nilvmB5_11i6OKSdvNnBNiyOusZP1bMN6ICnuxtjFBb6ioKgRQ=s900-c-k-c0x00ffffff-no-rj","banner_url":null,"followers":21100000,"posts_count":1800,"view_count":11000000,"country":null,"is_verified":true,"keywords":null,"last_scraped_at":"2026-07-08T10:59:08.260812Z","enrichment":null},"meta":{"cost":"$0.0005","balance":"$0.7937","request_id":"req_2fce3541a7532eaa897a736d0f90925b"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"404":{"description":"Channel not in the tracked corpus.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_found","message":"UCzz00zz00zz00zz00zz00zA","request_id":"req_5c10900e919bc7a3ff79b7501d582b4c"}}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/youtube/videos":{"get":{"tags":["YouTube"],"operationId":"ytVideos","summary":"Videos","x-dashboard-cost":"$0.0005","description":"A channel's tracked videos, newest first, with video id, title, description, views, likes, comments, publish time, duration, Shorts/live flags, category, keywords, and thumbnail when observed. Videos with no publish time come last. DB read over the tracked corpus — flat price for up to 100 videos a page. `next_cursor` is null on the last page; send it back as `cursor` for the next one. For a live walk of a channel's tab, use `/v1/youtube/channel_videos`.","security":[{"bearerAuth":[]}],"parameters":[{"name":"q","in":"query","required":true,"description":"YouTube @handle (case-sensitive), `UC…` channel id, or a `youtube.com/@handle` / `/channel/UC…` URL.","schema":{"type":"string"},"example":"mkbhd"},{"name":"limit","in":"query","required":false,"description":"How many videos to return (1–100). Flat price regardless of count.","schema":{"type":"integer","default":30,"minimum":1,"maximum":100},"examples":{"default":{"value":30,"x-disabled":true}}},{"name":"cursor","in":"query","required":false,"description":"Opaque `next_cursor` from the previous page.","schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"Videos, most recent first.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","required":["videos","next_cursor","has_more"],"properties":{"videos":{"type":"array","items":{"type":"object"}},"next_cursor":{"type":"string","nullable":true,"description":"Opaque; pass back as `cursor`."},"has_more":{"type":"boolean","description":"True exactly when `next_cursor` is set."}}},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"videos":[{"youtube_video_id":"eWKY0OnPByg","title":"Apple Lost the AI Race","description":"Apple lost the AI race. Actually, Apple won the AI race. Wait.\n\nThat shirt: http://shop.MKBHD.com\n\nPlaylist of MKBHD Intro music: https://goo.gl/B3AWV5\n\n~\nhttp://twitter.com/MKBHD\nhttp://instagram.com/MKBHD\nhttp://facebook.com/MKBHD","views":2223253,"likes":93340,"comments":null,"posted_at":"2026-07-08T19:44:58Z","length_seconds":423,"is_short":false,"is_live_content":false,"category":"Science & Technology","keywords":["Apple","AI race","new siri","MKBHD"],"thumbnail_url":"https://api.virev.ai/v1/media/youtube_video/729/video_thumbnail?e=1793750400&s=23c8532b5d52077f48c21e40d1a8f47b"}],"next_cursor":null,"has_more":false},"meta":{"cost":"$0.0005","balance":"$4.9945","request_id":"req_8d22e0902491c6dc0cb94df937f22f1b"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"404":{"description":"Channel not in the tracked corpus.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_found","message":"UCzz00zz00zz00zz00zz00zA","request_id":"req_5c10900e919bc7a3ff79b7501d582b4c"}}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/youtube/stats":{"get":{"tags":["YouTube"],"operationId":"ytStats","summary":"View analytics","x-dashboard-cost":"$0.0010","description":"Performance analytics over a channel's tracked videos: tracked count, total/avg/max/median views, average duration, total likes/comments, average engagement rate, and the top 5 videos by views. Numbers describe the tracked corpus (`tracked_videos`), not the channel's full history; legacy sparse fields remain null.","security":[{"bearerAuth":[]}],"parameters":[{"name":"q","in":"query","required":true,"description":"YouTube @handle (case-sensitive), `UC…` channel id, or a `youtube.com/@handle` / `/channel/UC…` URL.","schema":{"type":"string"},"example":"mkbhd"}],"responses":{"200":{"description":"View aggregates.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object"},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"username":"mkbhd","followers":21100000,"tracked_videos":30,"total_views":106800000,"avg_views":3560000,"max_views":7300000,"median_views":3700000,"avg_length_seconds":null,"top_videos":[{"youtube_video_id":"kBX5WH9b4M4","title":"Macbook Neo Impressions: Reincarnated!","views":7300000,"length_seconds":null,"thumbnail_url":null},{"youtube_video_id":"eFUB_jL_XcM","title":"So This is Peak Foldable","views":6400000,"length_seconds":null,"thumbnail_url":null}]},"meta":{"cost":"$0.0010","balance":"$0.7922","request_id":"req_03e2cbfb2c088a8eebed5f7187097c5e"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"404":{"description":"Channel not in the tracked corpus.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_found","message":"UCzz00zz00zz00zz00zz00zA","request_id":"req_5c10900e919bc7a3ff79b7501d582b4c"}}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/youtube/stored/post":{"get":{"tags":["YouTube"],"operationId":"ytStoredPost","summary":"Stored video","description":"One stored video with its channel: title, description, counts, publish time, duration, the paid partnership flag and its collaborators.\n\nStrictly DB: this reads what the crawler already stored and never crawls. A miss is a `404` and is not billed. Fetch a fresh one with `/v1/youtube/video`.","x-dashboard-cost":"$0.0005","security":[{"bearerAuth":[]}],"parameters":[{"name":"q","in":"query","required":true,"description":"YouTube video id, or a watch, Shorts or youtu.be URL.","example":"0e3GPea1Tyg","schema":{"type":"string","maxLength":300,"example":"0e3GPea1Tyg"}}],"responses":{"200":{"description":"Success. The example is a captured response; long lists are truncated.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":true},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"youtube_video_id":"0e3GPea1Tyg","title":"$456,000 Squid Game In Real Life!","description":"MAKE SURE YOU WATCH UNTIL GLASS BRIDGE IT'S INSANE!\n\nWatch Beast Games now on Prime Video!!! https://www.beastgames.com\n\nThank you GoPro for supplying us with cameras to get some of these shots. You can get them here: https://prf.hn/l/6bNbQB3\n\nShoutout to SOKRISPYMEDIA for helping with visuals!\n\nSUB TO ALL CHANNELS\nwww.youtube.com/@UCX6OQ3DkcsbYNE6H8uQQuVA\nwww.youtube.com/@UC4-79UOlP48-QNGgCko5p2g \nwww.youtube.com/@UCIPPMRA040LQr5QPyJEbmXA \nwww.youtube.com/@UCUaT_39o1x6qWjz7K2pWcgw \nwww.youtube.com/@UCAiLfjNXkNv24uhpzUgPa6A \nwww.youtube.com/@UCZzvDDvaYti8Dd8bLEiSoyQ \n\nNew Merch - https://mrbeast.store/\nCheck out Viewstats! - https://www.viewstats.com/\n\nFor any questions or inquiries regarding this video, please reach out to chucky@mrbeastbusiness.com\n\nMusic Provided by https://www.extrememusic.com/\n----------------------------------------------------------------\nfollow all of these or i will kick you\n• Facebook - https://www.facebook.com/MrBeast/\n• Twitter - https://twitter.com/MrBeast\n•  Instagram - https://www.instagram.com/mrbeast\n•  Im Hiring! - https://www.mrbeastjobs.com/\n--------------------------------------------------------------------","views":942007314,"likes":20070730,"comments":null,"posted_at":"2021-11-24T21:00:01+00:00","length_seconds":1541,"is_short":false,"is_live_content":false,"category":"Entertainment","keywords":[],"thumbnail_url":"https://i.ytimg.com/vi/0e3GPea1Tyg/maxresdefault.jpg","is_paid_partnership":false,"comments_disabled":false,"likes_hidden":false,"channel_handle":"MrBeast","channel_id":"UCX6OQ3DkcsbYNE6H8uQQuVA","channel_title":"MrBeast","channel_followers":509000000,"channel_is_verified":true,"collab_handles":[]},"meta":{"cost":"$0.0005","balance":"$3.3567","request_id":"req_38a875101766a6b44e7d36b875f31fcc"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"404":{"description":"The video is not stored. You are not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/youtube/stored/post/comments":{"get":{"tags":["YouTube"],"operationId":"ytStoredPostComments","summary":"Stored video comments","description":"The comments stored for one video, in the order they were stored, with `next_cursor` while `has_more` is true. A stored video with no collected comment page answers an empty list.\n\nStrictly DB: this reads what the crawler already stored and never crawls. A miss is a `404` and is not billed. Collect more with `/v1/youtube/video_comments`.","x-dashboard-cost":"$0.0005","security":[{"bearerAuth":[]}],"parameters":[{"name":"q","in":"query","required":true,"description":"YouTube video id, or a watch, Shorts or youtu.be URL.","example":"dQw4w9WgXcQ","schema":{"type":"string","maxLength":300,"example":"dQw4w9WgXcQ"}},{"name":"cursor","in":"query","required":false,"description":"Opaque `next_cursor` from the previous page.","schema":{"type":"string","maxLength":500}},{"name":"limit","in":"query","required":false,"description":"Comments per page.","schema":{"type":"integer","minimum":1,"maximum":200,"default":50},"examples":{"default":{"value":50,"x-disabled":true}}}],"responses":{"200":{"description":"Success. The example is a captured response; long lists are truncated.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":true},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"post":{"video_id":"dQw4w9WgXcQ"},"comments":[{"comment_id":"UgzthbIGrJkqH1XU_bt4AaABAg","parent_comment_id":null,"author":"srtboy54","text":"Who else got Rick Rolled by Matty McTech?","likes":10000,"replies":414,"published_text":"3 weeks ago","reply_level":0},{"comment_id":"UgzssGo7up_iorj07qp4AaABAg","parent_comment_id":null,"author":"AdrianLikesGaming","text":"Bro i just scanned the qr code...","likes":210,"replies":9,"published_text":"1 day ago","reply_level":0}],"stored_total":111,"next_cursor":"WzM1XQ","has_more":true},"meta":{"cost":"$0.0005","balance":"$9.9995","request_id":"req_ee6bdbb77a396ce98fa87fd87465d98e"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"404":{"description":"The video is not stored. You are not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/youtube/channel":{"get":{"tags":["YouTube"],"operationId":"ytChannel","summary":"channel","x-dashboard-cost":"$0.0005","x-example-query":{"handle":"@mkbhd"},"description":"The channel's About panel: subscribers, videos, links and join date. `extra` carries `banner_url`, `view_count`, `country`, `joined_date` and `keywords`. Returns `Profile` under `data`; with `get_raw=true` returns the upstream JSON.\n\nA field YouTube does not carry is null, a list it does not carry is `[]`, and YouTube-only facts sit under `extra`. Unknown, unsupported, and repeated query parameters return 400 before acquisition or billing.","security":[{"bearerAuth":[]}],"parameters":[{"name":"handle","in":"query","required":true,"description":"A channel @handle, its `UC…` channel id, or a youtube.com/@handle or /channel/ URL. Handles are case-sensitive.","example":"@mkbhd","schema":{"type":"string"}},{"name":"language","in":"query","required":false,"description":"The language YouTube answers in, a BCP-47 code such as `en` or `pt-BR`; omitted is `en`.","schema":{"type":"string"}},{"name":"cached","in":"query","required":false,"description":"`auto` (default) serves a read saved within the last 24 hours for these exact arguments, otherwise fetches. `cache_only` never contacts YouTube (404 `not_cached` when nothing is saved, whatever its age). `live` always fetches. Anything else is a `400`.","schema":{"type":"string","enum":["auto","cache_only","live"],"default":"auto"},"examples":{"default":{"value":"auto","x-disabled":true}}},{"name":"get_raw","in":"query","required":false,"description":"`true` returns the upstream JSON exactly as YouTube answered it instead of the normalized `Profile`.","schema":{"type":"boolean","default":false},"examples":{"default":{"value":false,"x-disabled":true}}}],"responses":{"200":{"description":"`Profile` under `data`; with `get_raw=true` the upstream JSON.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"anyOf":[{"$ref":"#/components/schemas/Profile"},{"type":"object","additionalProperties":true}],"description":"`Profile`, or the upstream JSON when `get_raw=true`."},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"id":"UCBJycsmduvYEL83R_U4JriQ","username":"mkbhd","full_name":"Marques Brownlee","biography":"MKBHD: Quality Tech Videos | YouTuber | Geek | Consumer Electronics | Tech Head | Internet Personality!\n\nbusiness@MKBHD.com\n\nNYC","followers":21100000,"following":null,"posts":1835,"is_verified":true,"is_private":null,"avatar_url":"https://yt3.googleusercontent.com/qu4TmIaYUlS41-dJ9gZ7DUR3nilvmB5_11i6OKSdvNnBNiyOusZP1bMN6ICnuxtjFBb6ioKgRQ=s68-c-k-c0x00ffffff-no-rj","external_url":"http://twitter.com/MKBHD","links":[{"url":"http://twitter.com/MKBHD","title":null},{"url":"http://instagram.com/MKBHD","title":null},{"url":"http://youtube.com/c/TheStudio","title":null},{"url":"http://reddit.com/r/MKBHD","title":null},{"url":"http://discord.gg/MKBHD","title":null}],"category":null,"business_category":null,"is_business":null,"is_professional":null,"business_email":null,"business_phone":null,"business_address":null,"pronouns":[],"highlight_reel_count":null,"has_clips":null,"is_recently_joined":null,"fbid":null,"extra":{"banner_url":"https://yt3.googleusercontent.com/zi_48HwHU4s0Hnb6tZuvRzTfCPHrLEnrtIMDLzMauDEyDmURh9JZ4wrNd3lKr7m9uVnT4YjYKw=w2560-fcrop64=1,00005a57ffffa5a8-k-c0xffffffff-no-nd-rj","view_count":5477465487,"country":"United States","joined_date":"2008-03-21T00:00:00Z","keywords":null}},"meta":{"source":"live","fetched_at":"2026-07-13T16:03:25.083509+00:00","cost":"$0.0005","balance":"$0.3772","request_id":"req_4c9f8e6ecd85bfce68885799cfd8f6a8"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"404":{"description":"`cached=cache_only` found nothing saved for these arguments (`not_cached`; call again with `cached=auto` to fetch it), or the YouTube account or item does not exist (`not_found`). You are not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_cached","message":"no saved youtube/channel read for '@mkbhd'. cached=cache_only never fetches, so call again with cached=auto to fetch it. You are not charged.","request_id":"req_5c10900e919bc7a3ff79b7501d582b4c"}}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/youtube/channel_videos":{"get":{"tags":["YouTube"],"operationId":"ytChannelVideos","summary":"channel_videos","x-dashboard-cost":"$0.0005/30","x-example-query":{"handle":"@MrBeast","max_pages":"1"},"description":"The channel's Videos tab. A listed video carries its title, views and a relative date (`extra.published_text`); `include_extras=true` reads each watch page for the exact date, likes and description, and `paid_only=true` keeps the videos that disclose a paid promotion. With max_pages=1, returns `Page[Post]` under `data`; with `get_raw=true` returns the upstream JSON.\n\nThe default request creates a durable job (202). Use max_pages=1 for one synchronous Page response (200). Poll status_url, then read results_url with its opaque cursor. Acquisition stops at the first of since, max_pages, or exhaustion. Jobs continue after disconnects. Result responses are bounded to 3 MiB; this does not limit the crawl. Supply Idempotency-Key to recover a lost submission response; reuse it with the same inputs. YouTube sets every page’s size, so there is no `page_size`.\n\nA field YouTube does not carry is null, a list it does not carry is `[]`, and YouTube-only facts sit under `extra`. Unknown, unsupported, and repeated query parameters return 400 before acquisition or billing.\n\nBilling: $0.0005 per 30 unique returned items (one native page), rounded up to a minimum of one billing unit; a `get_raw=true` page bills one unit. Jobs settle once after successful completion. Submission, polling and repeat downloads are free.","security":[{"bearerAuth":[]}],"parameters":[{"name":"handle","in":"query","required":true,"description":"A channel @handle, its `UC…` channel id, or a youtube.com/@handle or /channel/ URL. Handles are case-sensitive.","example":"@MrBeast","schema":{"type":"string"}},{"name":"sort","in":"query","required":false,"description":"`latest` or `popular`; omitted is `latest`.","schema":{"type":"string","enum":["latest","popular"]}},{"name":"include_extras","in":"query","required":false,"description":"`true` reads each video’s watch page for its exact date, likes and description.","schema":{"type":"boolean","default":false},"examples":{"default":{"value":false,"x-disabled":true}}},{"name":"paid_only","in":"query","required":false,"description":"`true` answers only the videos whose watch page discloses a paid promotion.","schema":{"type":"boolean","default":false},"examples":{"default":{"value":false,"x-disabled":true}}},{"name":"since","in":"query","required":false,"description":"Stop at this date. `2025-09-21` means midnight UTC (2025-09-21T00:00:00Z). Datetimes must use RFC3339 with a timezone, for example `2025-09-21T09:00:00+09:00`. `365d` means 365 days before submission. Invalid calendar dates return 400. With max_pages, the first boundary reached stops the walk. since alone creates a job.","schema":{"type":"string"},"examples":{"default":{"value":"2025-09-21","x-disabled":true},"date":{"value":"2025-09-21","x-disabled":true},"datetime":{"value":"2025-09-21T00:00:00Z","x-disabled":true},"duration":{"value":"365d","x-disabled":true}}},{"name":"max_pages","in":"query","required":false,"example":1,"description":"Maximum pages to fetch. -1 walks until exhaustion or since with no page cap, and must be written. Omitted, since alone bounds the walk; with neither, the job stops after 10 pages. Any positive integer is accepted. 1 returns one page synchronously with HTTP 200; any other value creates a durable job with HTTP 202.","schema":{"type":"integer","anyOf":[{"enum":[-1]},{"minimum":1}]}},{"name":"cursor","in":"query","required":false,"description":"Opaque next_cursor from an earlier answer of this operation, also with `get_raw=true`. A native YouTube cursor from a raw page answers 400. Result download cursors belong to the results route.","schema":{"type":"string","minLength":1}},{"name":"cached","in":"query","required":false,"description":"`auto` (default) serves a read saved within the last 24 hours for these exact arguments, otherwise fetches. `cache_only` never contacts YouTube (404 `not_cached` when nothing is saved, whatever its age). `live` always fetches. Anything else is a `400`. `cache_only` reads one saved page per request: omit `max_pages` or pass 1, and continue with `next_cursor`.","schema":{"type":"string","enum":["auto","cache_only","live"],"default":"auto"},"examples":{"default":{"value":"auto","x-disabled":true}}},{"name":"get_raw","in":"query","required":false,"description":"`true` returns the upstream JSON exactly as YouTube answered it instead of the normalized `Page[Post]`.","schema":{"type":"boolean","default":false},"examples":{"default":{"value":false,"x-disabled":true}}},{"name":"Idempotency-Key","in":"header","required":false,"description":"Reuse this key with the same inputs to recover a lost job submission. A different input with the same key returns 409.","schema":{"type":"string","minLength":1,"maxLength":200}}],"responses":{"200":{"description":"`Page[Post]` under `data`; with `get_raw=true` the upstream JSON.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"anyOf":[{"type":"object","required":["items","pages","next_cursor","has_more","stop_reason","coverage"],"properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/Post"},"description":"`Post` of every page walked, in page order."},"pages":{"type":"array","items":{"$ref":"#/components/schemas/PageRead"},"description":"One entry per page walked."},"next_cursor":{"type":"string","nullable":true,"description":"Opaque; pass back as `cursor` to continue."},"has_more":{"type":"boolean","description":"True when `next_cursor` is set, and when the walk stopped `cursor_stalled` on a page that said more results exist but gave no cursor to send back."},"stop_reason":{"type":"string","enum":["pages","since","exhausted","cursor_stalled","repeated_content","deadline","blocked","caught_up"],"description":"Why the walk stopped. `pages`: the page budget is spent and `next_cursor` continues it. `deadline`: the call ran out of time before its next page; `next_cursor` continues it. `since`: a whole page was older than `since`. `exhausted`: YouTube reported the end. `cursor_stalled`: YouTube claimed more but repeated or omitted its cursor. `repeated_content`: a page held only items already seen. `blocked`: YouTube refused a later page; `next_cursor` is the page it refused. `caught_up`: only watch passes the crawler runs for itself stop this way."},"coverage":{"$ref":"#/components/schemas/Coverage"}}},{"type":"object","additionalProperties":true}],"description":"`Page[Post]`, or the upstream JSON when `get_raw=true`."},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"items":[{"id":"iYlODtkyw_I","shortcode":null,"taken_at":null,"kind":"video","product_type":"video","caption":null,"hashtags":[],"mentions":[],"accessibility_caption":null,"likes":null,"comments":null,"views":76000000,"counts_hidden":null,"comments_disabled":null,"is_pinned":null,"is_paid_partnership":null,"owner":{"id":"UCX6OQ3DkcsbYNE6H8uQQuVA","username":"MrBeast","full_name":"MrBeast","is_verified":null,"is_private":null,"avatar_url":null,"latest_story_at":null,"extra":{}},"coauthors":[],"sponsors":[],"tagged":[],"location":null,"audio":null,"thumbnail_url":"http://media.web.garage.localhost:3902/crawler/youtube_video/48135.webp","video_duration":2105,"media":[],"media_urls":[],"extra":{"title":"Survive 30 Days Chained To A Stranger, Win $250,000","url":"https://www.youtube.com/watch?v=iYlODtkyw_I","published_text":"3 weeks ago"}},{"id":"__fmDj0ZJ1Q","shortcode":null,"taken_at":null,"kind":"video","product_type":"video","caption":null,"hashtags":[],"mentions":[],"accessibility_caption":null,"likes":null,"comments":null,"views":74000000,"counts_hidden":null,"comments_disabled":null,"is_pinned":null,"is_paid_partnership":null,"owner":{"id":"UCX6OQ3DkcsbYNE6H8uQQuVA","username":"MrBeast","full_name":"MrBeast","is_verified":null,"is_private":null,"avatar_url":null,"latest_story_at":null,"extra":{}},"coauthors":[],"sponsors":[],"tagged":[],"location":null,"audio":null,"thumbnail_url":"http://media.web.garage.localhost:3902/crawler/youtube_video/48134.webp","video_duration":1928,"media":[],"media_urls":[],"extra":{"title":"50 YouTube Legends Fight For $1,000,000","url":"https://www.youtube.com/watch?v=__fmDj0ZJ1Q","published_text":"1 month ago"}}],"pages":[{"cursor":null,"fetched_at":"2026-07-22T08:56:21.106692+00:00","count":2}],"next_cursor":null,"has_more":false,"stop_reason":"exhausted","coverage":{"since":null,"oldest_at":null,"since_reached":false}},"meta":{"source":"db","fetched_at":"2026-07-22T08:56:21.106692+00:00","cost":"$0.0005","balance":"$3.3597","request_id":"req_2c69c8bb40348fb28cf7b7dceca73766"}}}}},"202":{"description":"Durable job accepted. No completed-result charge. Save batch_id; poll status_url. Retry submission with the same Idempotency-Key after a lost response. An account may have five queued, running or payment-required jobs. A sixth new job returns 429 rate_limited. Matching idempotent replays still work at the limit. Ready and failed jobs release their slots; pages within a job remain unbounded. This is a synthetic contract example, not a live capture.","x-example-provenance":"synthetic-contract","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","required":["batch_id","status","status_url","results_url","cost","item_count","error","retry_at","total","done_count","failed_count","created_at","started_at","finished_at"],"properties":{"batch_id":{"type":"string"},"status":{"type":"string","enum":["queued","running","payment_required","ready","failed"]},"status_url":{"type":"string"},"results_url":{"type":"string"},"cost":{"type":"string"},"item_count":{"type":"integer","nullable":true},"error":{"type":"string","nullable":true,"description":"Null unless failed. A failed target carries its own code; incomplete_result appears only when it has none and pages of the result are missing. profile_not_found, post_not_found, upstream_not_found or not_found: the target does not exist or is not visible. not_visible: The account exists, but its posts are not visible to logged-out readers (private, restricted, or hidden by Instagram). Retrying will not change the result until the account changes. not_cached: cached=cache_only found no saved read. incomplete_result: pages of the result are missing. temporarily_unavailable: the target could not be read for now (no capacity, a pause or repeated refusals); retry later with a new job. result_item_too_large: one result unit exceeds the delivery budget. result_snapshot_missing or result_snapshot_corrupt: the crawler could not serve the retained result of a paid job, and its charge is refunded; if the crawler serves it again, a later results read returns it and charges the job again. crawler_submit_400, crawler_submit_404 or crawler_submit_422: the crawl service refused the job request. crawler_job_failed: any other failure; the same job is not expected to succeed if resubmitted. cancelled: the job was cancelled with POST /v1/jobs/{job_id}/cancel. No failed job costs anything: only result_snapshot_missing and result_snapshot_corrupt follow a charge, and that charge is refunded."},"retry_at":{"type":"string","format":"date-time","nullable":true,"description":"Null unless the job failed temporarily_unavailable because a crawl route was closed for every caller. Then it is when the route opens again, and the response carries the same time as a Retry-After header in seconds. Submit a new job after it."},"total":{"type":"integer","description":"Targets in the job. A job submitted through a /v1 route has one."},"done_count":{"type":"integer","description":"Targets the crawler finished."},"failed_count":{"type":"integer","description":"Targets that failed."},"created_at":{"type":"string","format":"date-time","description":"When the job was submitted."},"started_at":{"type":"string","format":"date-time","nullable":true,"description":"When the crawler started the job. Null until it starts."},"finished_at":{"type":"string","format":"date-time","nullable":true,"description":"When the job finished or failed. Null while it is queued or running."}}},"meta":{"type":"object","required":["cost","request_id"],"properties":{"cost":{"type":"string","example":"$0.0000"},"request_id":{"type":"string"}}}}},"example":{"data":{"batch_id":"job_7641d5f0-717d-4b70-a2f1-f58d846d7242","status":"queued","status_url":"/v1/jobs/job_7641d5f0-717d-4b70-a2f1-f58d846d7242","results_url":"/v1/jobs/job_7641d5f0-717d-4b70-a2f1-f58d846d7242/results","cost":"$0.0000","item_count":null,"error":null,"retry_at":null,"total":1,"done_count":0,"failed_count":0,"created_at":"2026-10-12T12:56:17.403Z","started_at":null,"finished_at":null},"meta":{"cost":"$0.0000","request_id":"req_job_example"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"404":{"description":"`cached=cache_only` found nothing saved for these arguments (`not_cached`; call again with `cached=auto` to fetch it), or the YouTube account or item does not exist (`not_found`). You are not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_cached","message":"no saved youtube/channel_videos read for '@MrBeast'. cached=cache_only never fetches, so call again with cached=auto to fetch it. You are not charged.","request_id":"req_5c10900e919bc7a3ff79b7501d582b4c"}}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/youtube/channel_shorts":{"get":{"tags":["YouTube"],"operationId":"ytChannelShorts","summary":"channel_shorts","x-dashboard-cost":"$0.0005/48","x-example-query":{"handle":"@MrBeast","max_pages":"1"},"description":"The channel's Shorts tab. With max_pages=1, returns `Page[Post]` under `data`; with `get_raw=true` returns the upstream JSON.\n\nThe default request creates a durable job (202). Use max_pages=1 for one synchronous Page response (200). Poll status_url, then read results_url with its opaque cursor. Acquisition stops at the first of since, max_pages, or exhaustion. Jobs continue after disconnects. Result responses are bounded to 3 MiB; this does not limit the crawl. Supply Idempotency-Key to recover a lost submission response; reuse it with the same inputs. YouTube sets every page’s size, so there is no `page_size`.\n\nA field YouTube does not carry is null, a list it does not carry is `[]`, and YouTube-only facts sit under `extra`. Unknown, unsupported, and repeated query parameters return 400 before acquisition or billing.\n\nBilling: $0.0005 per 48 unique returned items (one native page), rounded up to a minimum of one billing unit; a `get_raw=true` page bills one unit. Jobs settle once after successful completion. Submission, polling and repeat downloads are free.","security":[{"bearerAuth":[]}],"parameters":[{"name":"handle","in":"query","required":true,"description":"A channel @handle, its `UC…` channel id, or a youtube.com/@handle or /channel/ URL. Handles are case-sensitive.","example":"@MrBeast","schema":{"type":"string"}},{"name":"sort","in":"query","required":false,"description":"`latest` or `popular`; omitted is `latest`.","schema":{"type":"string","enum":["latest","popular"]}},{"name":"include_extras","in":"query","required":false,"description":"`true` reads each video’s watch page for its exact date, likes and description.","schema":{"type":"boolean","default":false},"examples":{"default":{"value":false,"x-disabled":true}}},{"name":"paid_only","in":"query","required":false,"description":"`true` answers only the videos whose watch page discloses a paid promotion.","schema":{"type":"boolean","default":false},"examples":{"default":{"value":false,"x-disabled":true}}},{"name":"since","in":"query","required":false,"description":"Stop at this date. `2025-09-21` means midnight UTC (2025-09-21T00:00:00Z). Datetimes must use RFC3339 with a timezone, for example `2025-09-21T09:00:00+09:00`. `365d` means 365 days before submission. Invalid calendar dates return 400. With max_pages, the first boundary reached stops the walk. since alone creates a job.","schema":{"type":"string"},"examples":{"default":{"value":"2025-09-21","x-disabled":true},"date":{"value":"2025-09-21","x-disabled":true},"datetime":{"value":"2025-09-21T00:00:00Z","x-disabled":true},"duration":{"value":"365d","x-disabled":true}}},{"name":"max_pages","in":"query","required":false,"example":1,"description":"Maximum pages to fetch. -1 walks until exhaustion or since with no page cap, and must be written. Omitted, since alone bounds the walk; with neither, the job stops after 10 pages. Any positive integer is accepted. 1 returns one page synchronously with HTTP 200; any other value creates a durable job with HTTP 202.","schema":{"type":"integer","anyOf":[{"enum":[-1]},{"minimum":1}]}},{"name":"cursor","in":"query","required":false,"description":"Opaque next_cursor from an earlier answer of this operation, also with `get_raw=true`. A native YouTube cursor from a raw page answers 400. Result download cursors belong to the results route.","schema":{"type":"string","minLength":1}},{"name":"cached","in":"query","required":false,"description":"`auto` (default) serves a read saved within the last 24 hours for these exact arguments, otherwise fetches. `cache_only` never contacts YouTube (404 `not_cached` when nothing is saved, whatever its age). `live` always fetches. Anything else is a `400`. `cache_only` reads one saved page per request: omit `max_pages` or pass 1, and continue with `next_cursor`.","schema":{"type":"string","enum":["auto","cache_only","live"],"default":"auto"},"examples":{"default":{"value":"auto","x-disabled":true}}},{"name":"get_raw","in":"query","required":false,"description":"`true` returns the upstream JSON exactly as YouTube answered it instead of the normalized `Page[Post]`.","schema":{"type":"boolean","default":false},"examples":{"default":{"value":false,"x-disabled":true}}},{"name":"Idempotency-Key","in":"header","required":false,"description":"Reuse this key with the same inputs to recover a lost job submission. A different input with the same key returns 409.","schema":{"type":"string","minLength":1,"maxLength":200}}],"responses":{"200":{"description":"`Page[Post]` under `data`; with `get_raw=true` the upstream JSON.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"anyOf":[{"type":"object","required":["items","pages","next_cursor","has_more","stop_reason","coverage"],"properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/Post"},"description":"`Post` of every page walked, in page order."},"pages":{"type":"array","items":{"$ref":"#/components/schemas/PageRead"},"description":"One entry per page walked."},"next_cursor":{"type":"string","nullable":true,"description":"Opaque; pass back as `cursor` to continue."},"has_more":{"type":"boolean","description":"True when `next_cursor` is set, and when the walk stopped `cursor_stalled` on a page that said more results exist but gave no cursor to send back."},"stop_reason":{"type":"string","enum":["pages","since","exhausted","cursor_stalled","repeated_content","deadline","blocked","caught_up"],"description":"Why the walk stopped. `pages`: the page budget is spent and `next_cursor` continues it. `deadline`: the call ran out of time before its next page; `next_cursor` continues it. `since`: a whole page was older than `since`. `exhausted`: YouTube reported the end. `cursor_stalled`: YouTube claimed more but repeated or omitted its cursor. `repeated_content`: a page held only items already seen. `blocked`: YouTube refused a later page; `next_cursor` is the page it refused. `caught_up`: only watch passes the crawler runs for itself stop this way."},"coverage":{"$ref":"#/components/schemas/Coverage"}}},{"type":"object","additionalProperties":true}],"description":"`Page[Post]`, or the upstream JSON when `get_raw=true`."},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"items":[{"id":"Df5Y-2ndQyU","shortcode":null,"taken_at":null,"kind":"video","product_type":"short","caption":null,"hashtags":[],"mentions":[],"accessibility_caption":null,"likes":null,"comments":null,"views":1000000,"counts_hidden":null,"comments_disabled":null,"is_pinned":null,"is_paid_partnership":null,"owner":{"id":"UCX6OQ3DkcsbYNE6H8uQQuVA","username":"MrBeast","full_name":"MrBeast","is_verified":null,"is_private":null,"avatar_url":null,"latest_story_at":null,"extra":{}},"coauthors":[],"sponsors":[],"tagged":[],"location":null,"audio":null,"thumbnail_url":"http://media.web.garage.localhost:3902/crawler/youtube_video/8776673.webp","video_duration":null,"media":[],"media_urls":[],"extra":{"title":"Read My Book","url":"https://www.youtube.com/watch?v=Df5Y-2ndQyU","published_text":null}},{"id":"egvLKQe6I4I","shortcode":null,"taken_at":null,"kind":"video","product_type":"short","caption":null,"hashtags":[],"mentions":[],"accessibility_caption":null,"likes":null,"comments":null,"views":76000000,"counts_hidden":null,"comments_disabled":null,"is_pinned":null,"is_paid_partnership":null,"owner":{"id":"UCX6OQ3DkcsbYNE6H8uQQuVA","username":"MrBeast","full_name":"MrBeast","is_verified":null,"is_private":null,"avatar_url":null,"latest_story_at":null,"extra":{}},"coauthors":[],"sponsors":[],"tagged":[],"location":null,"audio":null,"thumbnail_url":"http://media.web.garage.localhost:3902/crawler/youtube_video/8776712.webp","video_duration":null,"media":[],"media_urls":[],"extra":{"title":"Don't Pop the Balloon","url":"https://www.youtube.com/watch?v=egvLKQe6I4I","published_text":null}}],"pages":[{"cursor":null,"fetched_at":"2026-07-22T08:56:41.011839+00:00","count":2}],"next_cursor":null,"has_more":false,"stop_reason":"exhausted","coverage":{"since":null,"oldest_at":null,"since_reached":false}},"meta":{"source":"db","fetched_at":"2026-07-22T08:56:41.011839+00:00","cost":"$0.0005","balance":"$3.3592","request_id":"req_f874f588df5924c046e8b038e8f30a6c"}}}}},"202":{"description":"Durable job accepted. No completed-result charge. Save batch_id; poll status_url. Retry submission with the same Idempotency-Key after a lost response. An account may have five queued, running or payment-required jobs. A sixth new job returns 429 rate_limited. Matching idempotent replays still work at the limit. Ready and failed jobs release their slots; pages within a job remain unbounded. This is a synthetic contract example, not a live capture.","x-example-provenance":"synthetic-contract","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","required":["batch_id","status","status_url","results_url","cost","item_count","error","retry_at","total","done_count","failed_count","created_at","started_at","finished_at"],"properties":{"batch_id":{"type":"string"},"status":{"type":"string","enum":["queued","running","payment_required","ready","failed"]},"status_url":{"type":"string"},"results_url":{"type":"string"},"cost":{"type":"string"},"item_count":{"type":"integer","nullable":true},"error":{"type":"string","nullable":true,"description":"Null unless failed. A failed target carries its own code; incomplete_result appears only when it has none and pages of the result are missing. profile_not_found, post_not_found, upstream_not_found or not_found: the target does not exist or is not visible. not_visible: The account exists, but its posts are not visible to logged-out readers (private, restricted, or hidden by Instagram). Retrying will not change the result until the account changes. not_cached: cached=cache_only found no saved read. incomplete_result: pages of the result are missing. temporarily_unavailable: the target could not be read for now (no capacity, a pause or repeated refusals); retry later with a new job. result_item_too_large: one result unit exceeds the delivery budget. result_snapshot_missing or result_snapshot_corrupt: the crawler could not serve the retained result of a paid job, and its charge is refunded; if the crawler serves it again, a later results read returns it and charges the job again. crawler_submit_400, crawler_submit_404 or crawler_submit_422: the crawl service refused the job request. crawler_job_failed: any other failure; the same job is not expected to succeed if resubmitted. cancelled: the job was cancelled with POST /v1/jobs/{job_id}/cancel. No failed job costs anything: only result_snapshot_missing and result_snapshot_corrupt follow a charge, and that charge is refunded."},"retry_at":{"type":"string","format":"date-time","nullable":true,"description":"Null unless the job failed temporarily_unavailable because a crawl route was closed for every caller. Then it is when the route opens again, and the response carries the same time as a Retry-After header in seconds. Submit a new job after it."},"total":{"type":"integer","description":"Targets in the job. A job submitted through a /v1 route has one."},"done_count":{"type":"integer","description":"Targets the crawler finished."},"failed_count":{"type":"integer","description":"Targets that failed."},"created_at":{"type":"string","format":"date-time","description":"When the job was submitted."},"started_at":{"type":"string","format":"date-time","nullable":true,"description":"When the crawler started the job. Null until it starts."},"finished_at":{"type":"string","format":"date-time","nullable":true,"description":"When the job finished or failed. Null while it is queued or running."}}},"meta":{"type":"object","required":["cost","request_id"],"properties":{"cost":{"type":"string","example":"$0.0000"},"request_id":{"type":"string"}}}}},"example":{"data":{"batch_id":"job_7641d5f0-717d-4b70-a2f1-f58d846d7242","status":"queued","status_url":"/v1/jobs/job_7641d5f0-717d-4b70-a2f1-f58d846d7242","results_url":"/v1/jobs/job_7641d5f0-717d-4b70-a2f1-f58d846d7242/results","cost":"$0.0000","item_count":null,"error":null,"retry_at":null,"total":1,"done_count":0,"failed_count":0,"created_at":"2026-10-12T12:56:17.403Z","started_at":null,"finished_at":null},"meta":{"cost":"$0.0000","request_id":"req_job_example"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"404":{"description":"`cached=cache_only` found nothing saved for these arguments (`not_cached`; call again with `cached=auto` to fetch it), or the YouTube account or item does not exist (`not_found`). You are not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_cached","message":"no saved youtube/channel_shorts read for '@MrBeast'. cached=cache_only never fetches, so call again with cached=auto to fetch it. You are not charged.","request_id":"req_5c10900e919bc7a3ff79b7501d582b4c"}}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/youtube/channel_lives":{"get":{"tags":["YouTube"],"operationId":"ytChannelLives","summary":"channel_lives","x-dashboard-cost":"$0.0005/30","x-example-query":{"handle":"@MrBeast","max_pages":"1"},"description":"The channel's Live tab, newest first. With max_pages=1, returns `Page[Post]` under `data`; with `get_raw=true` returns the upstream JSON.\n\nThe default request creates a durable job (202). Use max_pages=1 for one synchronous Page response (200). Poll status_url, then read results_url with its opaque cursor. Acquisition stops at the first of since, max_pages, or exhaustion. Jobs continue after disconnects. Result responses are bounded to 3 MiB; this does not limit the crawl. Supply Idempotency-Key to recover a lost submission response; reuse it with the same inputs. YouTube sets every page’s size, so there is no `page_size`.\n\nA field YouTube does not carry is null, a list it does not carry is `[]`, and YouTube-only facts sit under `extra`. Unknown, unsupported, and repeated query parameters return 400 before acquisition or billing.\n\nBilling: $0.0005 per 30 unique returned items (one native page), rounded up to a minimum of one billing unit; a `get_raw=true` page bills one unit. Jobs settle once after successful completion. Submission, polling and repeat downloads are free.","security":[{"bearerAuth":[]}],"parameters":[{"name":"handle","in":"query","required":true,"description":"A channel @handle, its `UC…` channel id, or a youtube.com/@handle or /channel/ URL. Handles are case-sensitive.","example":"@MrBeast","schema":{"type":"string"}},{"name":"include_extras","in":"query","required":false,"description":"`true` reads each video’s watch page for its exact date, likes and description.","schema":{"type":"boolean","default":false},"examples":{"default":{"value":false,"x-disabled":true}}},{"name":"paid_only","in":"query","required":false,"description":"`true` answers only the videos whose watch page discloses a paid promotion.","schema":{"type":"boolean","default":false},"examples":{"default":{"value":false,"x-disabled":true}}},{"name":"since","in":"query","required":false,"description":"Stop at this date. `2025-09-21` means midnight UTC (2025-09-21T00:00:00Z). Datetimes must use RFC3339 with a timezone, for example `2025-09-21T09:00:00+09:00`. `365d` means 365 days before submission. Invalid calendar dates return 400. With max_pages, the first boundary reached stops the walk. since alone creates a job.","schema":{"type":"string"},"examples":{"default":{"value":"2025-09-21","x-disabled":true},"date":{"value":"2025-09-21","x-disabled":true},"datetime":{"value":"2025-09-21T00:00:00Z","x-disabled":true},"duration":{"value":"365d","x-disabled":true}}},{"name":"max_pages","in":"query","required":false,"example":1,"description":"Maximum pages to fetch. -1 walks until exhaustion or since with no page cap, and must be written. Omitted, since alone bounds the walk; with neither, the job stops after 10 pages. Any positive integer is accepted. 1 returns one page synchronously with HTTP 200; any other value creates a durable job with HTTP 202.","schema":{"type":"integer","anyOf":[{"enum":[-1]},{"minimum":1}]}},{"name":"cursor","in":"query","required":false,"description":"Opaque next_cursor from an earlier answer of this operation, also with `get_raw=true`. A native YouTube cursor from a raw page answers 400. Result download cursors belong to the results route.","schema":{"type":"string","minLength":1}},{"name":"cached","in":"query","required":false,"description":"`auto` (default) serves a read saved within the last 24 hours for these exact arguments, otherwise fetches. `cache_only` never contacts YouTube (404 `not_cached` when nothing is saved, whatever its age). `live` always fetches. Anything else is a `400`. `cache_only` reads one saved page per request: omit `max_pages` or pass 1, and continue with `next_cursor`.","schema":{"type":"string","enum":["auto","cache_only","live"],"default":"auto"},"examples":{"default":{"value":"auto","x-disabled":true}}},{"name":"get_raw","in":"query","required":false,"description":"`true` returns the upstream JSON exactly as YouTube answered it instead of the normalized `Page[Post]`.","schema":{"type":"boolean","default":false},"examples":{"default":{"value":false,"x-disabled":true}}},{"name":"Idempotency-Key","in":"header","required":false,"description":"Reuse this key with the same inputs to recover a lost job submission. A different input with the same key returns 409.","schema":{"type":"string","minLength":1,"maxLength":200}}],"responses":{"200":{"description":"`Page[Post]` under `data`; with `get_raw=true` the upstream JSON.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"anyOf":[{"type":"object","required":["items","pages","next_cursor","has_more","stop_reason","coverage"],"properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/Post"},"description":"`Post` of every page walked, in page order."},"pages":{"type":"array","items":{"$ref":"#/components/schemas/PageRead"},"description":"One entry per page walked."},"next_cursor":{"type":"string","nullable":true,"description":"Opaque; pass back as `cursor` to continue."},"has_more":{"type":"boolean","description":"True when `next_cursor` is set, and when the walk stopped `cursor_stalled` on a page that said more results exist but gave no cursor to send back."},"stop_reason":{"type":"string","enum":["pages","since","exhausted","cursor_stalled","repeated_content","deadline","blocked","caught_up"],"description":"Why the walk stopped. `pages`: the page budget is spent and `next_cursor` continues it. `deadline`: the call ran out of time before its next page; `next_cursor` continues it. `since`: a whole page was older than `since`. `exhausted`: YouTube reported the end. `cursor_stalled`: YouTube claimed more but repeated or omitted its cursor. `repeated_content`: a page held only items already seen. `blocked`: YouTube refused a later page; `next_cursor` is the page it refused. `caught_up`: only watch passes the crawler runs for itself stop this way."},"coverage":{"$ref":"#/components/schemas/Coverage"}}},{"type":"object","additionalProperties":true}],"description":"`Page[Post]`, or the upstream JSON when `get_raw=true`."},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"items":[{"id":"iYlODtkyw_I","shortcode":null,"taken_at":null,"kind":"video","product_type":"live","caption":null,"hashtags":[],"mentions":[],"accessibility_caption":null,"likes":null,"comments":null,"views":76000000,"counts_hidden":null,"comments_disabled":null,"is_pinned":null,"is_paid_partnership":null,"owner":{"id":"UCX6OQ3DkcsbYNE6H8uQQuVA","username":"MrBeast","full_name":"MrBeast","is_verified":null,"is_private":null,"avatar_url":null,"latest_story_at":null,"extra":{}},"coauthors":[],"sponsors":[],"tagged":[],"location":null,"audio":null,"thumbnail_url":"http://media.web.garage.localhost:3902/crawler/youtube_video/48135.webp","video_duration":2105,"media":[],"media_urls":[],"extra":{"title":"Survive 30 Days Chained To A Stranger, Win $250,000","url":"https://www.youtube.com/watch?v=iYlODtkyw_I","published_text":"3 weeks ago"}},{"id":"__fmDj0ZJ1Q","shortcode":null,"taken_at":null,"kind":"video","product_type":"live","caption":null,"hashtags":[],"mentions":[],"accessibility_caption":null,"likes":null,"comments":null,"views":74000000,"counts_hidden":null,"comments_disabled":null,"is_pinned":null,"is_paid_partnership":null,"owner":{"id":"UCX6OQ3DkcsbYNE6H8uQQuVA","username":"MrBeast","full_name":"MrBeast","is_verified":null,"is_private":null,"avatar_url":null,"latest_story_at":null,"extra":{}},"coauthors":[],"sponsors":[],"tagged":[],"location":null,"audio":null,"thumbnail_url":"http://media.web.garage.localhost:3902/crawler/youtube_video/48134.webp","video_duration":1928,"media":[],"media_urls":[],"extra":{"title":"50 YouTube Legends Fight For $1,000,000","url":"https://www.youtube.com/watch?v=__fmDj0ZJ1Q","published_text":"1 month ago"}}],"pages":[{"cursor":null,"fetched_at":"2026-07-22T08:57:06.860643+00:00","count":2}],"next_cursor":null,"has_more":false,"stop_reason":"exhausted","coverage":{"since":null,"oldest_at":null,"since_reached":false}},"meta":{"source":"db","fetched_at":"2026-07-22T08:57:06.860643+00:00","cost":"$0.0005","balance":"$3.3587","request_id":"req_e626a5d22b78e159e00a49f6a5e68a9c"}}}}},"202":{"description":"Durable job accepted. No completed-result charge. Save batch_id; poll status_url. Retry submission with the same Idempotency-Key after a lost response. An account may have five queued, running or payment-required jobs. A sixth new job returns 429 rate_limited. Matching idempotent replays still work at the limit. Ready and failed jobs release their slots; pages within a job remain unbounded. This is a synthetic contract example, not a live capture.","x-example-provenance":"synthetic-contract","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","required":["batch_id","status","status_url","results_url","cost","item_count","error","retry_at","total","done_count","failed_count","created_at","started_at","finished_at"],"properties":{"batch_id":{"type":"string"},"status":{"type":"string","enum":["queued","running","payment_required","ready","failed"]},"status_url":{"type":"string"},"results_url":{"type":"string"},"cost":{"type":"string"},"item_count":{"type":"integer","nullable":true},"error":{"type":"string","nullable":true,"description":"Null unless failed. A failed target carries its own code; incomplete_result appears only when it has none and pages of the result are missing. profile_not_found, post_not_found, upstream_not_found or not_found: the target does not exist or is not visible. not_visible: The account exists, but its posts are not visible to logged-out readers (private, restricted, or hidden by Instagram). Retrying will not change the result until the account changes. not_cached: cached=cache_only found no saved read. incomplete_result: pages of the result are missing. temporarily_unavailable: the target could not be read for now (no capacity, a pause or repeated refusals); retry later with a new job. result_item_too_large: one result unit exceeds the delivery budget. result_snapshot_missing or result_snapshot_corrupt: the crawler could not serve the retained result of a paid job, and its charge is refunded; if the crawler serves it again, a later results read returns it and charges the job again. crawler_submit_400, crawler_submit_404 or crawler_submit_422: the crawl service refused the job request. crawler_job_failed: any other failure; the same job is not expected to succeed if resubmitted. cancelled: the job was cancelled with POST /v1/jobs/{job_id}/cancel. No failed job costs anything: only result_snapshot_missing and result_snapshot_corrupt follow a charge, and that charge is refunded."},"retry_at":{"type":"string","format":"date-time","nullable":true,"description":"Null unless the job failed temporarily_unavailable because a crawl route was closed for every caller. Then it is when the route opens again, and the response carries the same time as a Retry-After header in seconds. Submit a new job after it."},"total":{"type":"integer","description":"Targets in the job. A job submitted through a /v1 route has one."},"done_count":{"type":"integer","description":"Targets the crawler finished."},"failed_count":{"type":"integer","description":"Targets that failed."},"created_at":{"type":"string","format":"date-time","description":"When the job was submitted."},"started_at":{"type":"string","format":"date-time","nullable":true,"description":"When the crawler started the job. Null until it starts."},"finished_at":{"type":"string","format":"date-time","nullable":true,"description":"When the job finished or failed. Null while it is queued or running."}}},"meta":{"type":"object","required":["cost","request_id"],"properties":{"cost":{"type":"string","example":"$0.0000"},"request_id":{"type":"string"}}}}},"example":{"data":{"batch_id":"job_7641d5f0-717d-4b70-a2f1-f58d846d7242","status":"queued","status_url":"/v1/jobs/job_7641d5f0-717d-4b70-a2f1-f58d846d7242","results_url":"/v1/jobs/job_7641d5f0-717d-4b70-a2f1-f58d846d7242/results","cost":"$0.0000","item_count":null,"error":null,"retry_at":null,"total":1,"done_count":0,"failed_count":0,"created_at":"2026-10-12T12:56:17.403Z","started_at":null,"finished_at":null},"meta":{"cost":"$0.0000","request_id":"req_job_example"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"404":{"description":"`cached=cache_only` found nothing saved for these arguments (`not_cached`; call again with `cached=auto` to fetch it), or the YouTube account or item does not exist (`not_found`). You are not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_cached","message":"no saved youtube/channel_lives read for '@MrBeast'. cached=cache_only never fetches, so call again with cached=auto to fetch it. You are not charged.","request_id":"req_5c10900e919bc7a3ff79b7501d582b4c"}}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/youtube/channel_playlists":{"get":{"tags":["YouTube"],"operationId":"ytChannelPlaylists","summary":"channel_playlists","x-dashboard-cost":"$0.0005/30","x-example-query":{"handle":"@MrBeast","max_pages":"1"},"description":"The playlists the channel shows. With max_pages=1, returns `Page[YouTubePlaylist]` under `data`; with `get_raw=true` returns the upstream JSON.\n\nThe default request creates a durable job (202). Use max_pages=1 for one synchronous Page response (200). Poll status_url, then read results_url with its opaque cursor. Acquisition stops at the first of since, max_pages, or exhaustion. Jobs continue after disconnects. Result responses are bounded to 3 MiB; this does not limit the crawl. Supply Idempotency-Key to recover a lost submission response; reuse it with the same inputs. YouTube sets every page’s size, so there is no `page_size`.\n\nA field YouTube does not carry is null, a list it does not carry is `[]`, and YouTube-only facts sit under `extra`. Unknown, unsupported, and repeated query parameters return 400 before acquisition or billing.\n\nBilling: $0.0005 per 30 unique returned items (one native page), rounded up to a minimum of one billing unit; a `get_raw=true` page bills one unit. Jobs settle once after successful completion. Submission, polling and repeat downloads are free.","security":[{"bearerAuth":[]}],"parameters":[{"name":"handle","in":"query","required":true,"description":"A channel @handle, its `UC…` channel id, or a youtube.com/@handle or /channel/ URL. Handles are case-sensitive.","example":"@MrBeast","schema":{"type":"string"}},{"name":"since","in":"query","required":false,"description":"Not accepted on this operation: its items carry no timestamp, so since returns 400 before billing.","schema":{"type":"string"}},{"name":"max_pages","in":"query","required":false,"example":1,"description":"Maximum pages to fetch. -1 walks until exhaustion or since with no page cap, and must be written. Omitted, since alone bounds the walk; with neither, the job stops after 10 pages. Any positive integer is accepted. 1 returns one page synchronously with HTTP 200; any other value creates a durable job with HTTP 202.","schema":{"type":"integer","anyOf":[{"enum":[-1]},{"minimum":1}]}},{"name":"cursor","in":"query","required":false,"description":"Opaque next_cursor from an earlier answer of this operation, also with `get_raw=true`. A native YouTube cursor from a raw page answers 400. Result download cursors belong to the results route.","schema":{"type":"string","minLength":1}},{"name":"cached","in":"query","required":false,"description":"`auto` (default) serves a read saved within the last 24 hours for these exact arguments, otherwise fetches. `cache_only` never contacts YouTube (404 `not_cached` when nothing is saved, whatever its age). `live` always fetches. Anything else is a `400`. `cache_only` reads one saved page per request: omit `max_pages` or pass 1, and continue with `next_cursor`.","schema":{"type":"string","enum":["auto","cache_only","live"],"default":"auto"},"examples":{"default":{"value":"auto","x-disabled":true}}},{"name":"get_raw","in":"query","required":false,"description":"`true` returns the upstream JSON exactly as YouTube answered it instead of the normalized `Page[YouTubePlaylist]`.","schema":{"type":"boolean","default":false},"examples":{"default":{"value":false,"x-disabled":true}}},{"name":"Idempotency-Key","in":"header","required":false,"description":"Reuse this key with the same inputs to recover a lost job submission. A different input with the same key returns 409.","schema":{"type":"string","minLength":1,"maxLength":200}}],"responses":{"200":{"description":"`Page[YouTubePlaylist]` under `data`; with `get_raw=true` the upstream JSON.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"anyOf":[{"type":"object","required":["items","pages","next_cursor","has_more","stop_reason","coverage"],"properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/YouTubePlaylist"},"description":"`YouTubePlaylist` of every page walked, in page order."},"pages":{"type":"array","items":{"$ref":"#/components/schemas/PageRead"},"description":"One entry per page walked."},"next_cursor":{"type":"string","nullable":true,"description":"Opaque; pass back as `cursor` to continue."},"has_more":{"type":"boolean","description":"True when `next_cursor` is set, and when the walk stopped `cursor_stalled` on a page that said more results exist but gave no cursor to send back."},"stop_reason":{"type":"string","enum":["pages","since","exhausted","cursor_stalled","repeated_content","deadline","blocked","caught_up"],"description":"Why the walk stopped. `pages`: the page budget is spent and `next_cursor` continues it. `deadline`: the call ran out of time before its next page; `next_cursor` continues it. `since`: a whole page was older than `since`. `exhausted`: YouTube reported the end. `cursor_stalled`: YouTube claimed more but repeated or omitted its cursor. `repeated_content`: a page held only items already seen. `blocked`: YouTube refused a later page; `next_cursor` is the page it refused. `caught_up`: only watch passes the crawler runs for itself stop this way."},"coverage":{"$ref":"#/components/schemas/Coverage"}}},{"type":"object","additionalProperties":true}],"description":"`Page[YouTubePlaylist]`, or the upstream JSON when `get_raw=true`."},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"items":[{"id":"PLoSWVnSA9vG8hI-SUpAimvYJrPh-PRRvp","title":"If You Survive, You Win","description":null,"videos":null,"thumbnail_url":"https://i.ytimg.com/vi/tnTPaLOaHz8/hqdefault.jpg?sqp=-oaymwEXCOADEI4CSFryq4qpAwkIARUAAIhCGAE=&rs=AOn4CLCjPAnSe9imDV7q3RLqefBW_CQRCw","url":"https://www.youtube.com/playlist?list=PLoSWVnSA9vG8hI-SUpAimvYJrPh-PRRvp"},{"id":"PLoSWVnSA9vG_s-XT40oPKF0iWFGw8pOp2","title":"Helping People In Need","description":null,"videos":null,"thumbnail_url":"https://i.ytimg.com/tvfilm_banner/PLoSWVnSA9vG_s-XT40oPKF0iWFGw8pOp2/16_9_.jpg?sqp=CKj7gdMG-oaymwEICNYGEOADSFqi85f_AwYIsPuCygY=&rs=AOn4CLCkZiqGxF6_2LLGaR3I6SD4v2xaZg","url":"https://www.youtube.com/playlist?list=PLoSWVnSA9vG_s-XT40oPKF0iWFGw8pOp2"}],"pages":[{"cursor":null,"fetched_at":"2026-07-22T08:57:32.363912+00:00","count":2}],"next_cursor":"eyJjb250aW51YXRpb24iOiI0cW1Gc2dKZ0VoaFZRMWcyVDFFelJHdGpjMkpaVGtVMlNEaDFVVkYxVmtFYVJEaG5XWEpIYVcxaFFWTlpTMHBFV21sTmFsSnJXbGRhYTB4VVFYZE5SRUYwVFdwSk0wMURNV2xaTWswMVRGUlZORTFxVVhsUFYwMTNUMGRhYUU5QkpUTkVKVE5FIiwib3AiOiJjaGFubmVsX3BsYXlsaXN0cyJ9","has_more":true,"stop_reason":"pages","coverage":{"since":null,"oldest_at":null,"since_reached":false}},"meta":{"source":"db","fetched_at":"2026-07-22T08:57:32.363912+00:00","cost":"$0.0005","balance":"$3.3582","request_id":"req_e155ac750d90073b41f25f810489f260"}}}}},"202":{"description":"Durable job accepted. No completed-result charge. Save batch_id; poll status_url. Retry submission with the same Idempotency-Key after a lost response. An account may have five queued, running or payment-required jobs. A sixth new job returns 429 rate_limited. Matching idempotent replays still work at the limit. Ready and failed jobs release their slots; pages within a job remain unbounded. This is a synthetic contract example, not a live capture.","x-example-provenance":"synthetic-contract","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","required":["batch_id","status","status_url","results_url","cost","item_count","error","retry_at","total","done_count","failed_count","created_at","started_at","finished_at"],"properties":{"batch_id":{"type":"string"},"status":{"type":"string","enum":["queued","running","payment_required","ready","failed"]},"status_url":{"type":"string"},"results_url":{"type":"string"},"cost":{"type":"string"},"item_count":{"type":"integer","nullable":true},"error":{"type":"string","nullable":true,"description":"Null unless failed. A failed target carries its own code; incomplete_result appears only when it has none and pages of the result are missing. profile_not_found, post_not_found, upstream_not_found or not_found: the target does not exist or is not visible. not_visible: The account exists, but its posts are not visible to logged-out readers (private, restricted, or hidden by Instagram). Retrying will not change the result until the account changes. not_cached: cached=cache_only found no saved read. incomplete_result: pages of the result are missing. temporarily_unavailable: the target could not be read for now (no capacity, a pause or repeated refusals); retry later with a new job. result_item_too_large: one result unit exceeds the delivery budget. result_snapshot_missing or result_snapshot_corrupt: the crawler could not serve the retained result of a paid job, and its charge is refunded; if the crawler serves it again, a later results read returns it and charges the job again. crawler_submit_400, crawler_submit_404 or crawler_submit_422: the crawl service refused the job request. crawler_job_failed: any other failure; the same job is not expected to succeed if resubmitted. cancelled: the job was cancelled with POST /v1/jobs/{job_id}/cancel. No failed job costs anything: only result_snapshot_missing and result_snapshot_corrupt follow a charge, and that charge is refunded."},"retry_at":{"type":"string","format":"date-time","nullable":true,"description":"Null unless the job failed temporarily_unavailable because a crawl route was closed for every caller. Then it is when the route opens again, and the response carries the same time as a Retry-After header in seconds. Submit a new job after it."},"total":{"type":"integer","description":"Targets in the job. A job submitted through a /v1 route has one."},"done_count":{"type":"integer","description":"Targets the crawler finished."},"failed_count":{"type":"integer","description":"Targets that failed."},"created_at":{"type":"string","format":"date-time","description":"When the job was submitted."},"started_at":{"type":"string","format":"date-time","nullable":true,"description":"When the crawler started the job. Null until it starts."},"finished_at":{"type":"string","format":"date-time","nullable":true,"description":"When the job finished or failed. Null while it is queued or running."}}},"meta":{"type":"object","required":["cost","request_id"],"properties":{"cost":{"type":"string","example":"$0.0000"},"request_id":{"type":"string"}}}}},"example":{"data":{"batch_id":"job_7641d5f0-717d-4b70-a2f1-f58d846d7242","status":"queued","status_url":"/v1/jobs/job_7641d5f0-717d-4b70-a2f1-f58d846d7242","results_url":"/v1/jobs/job_7641d5f0-717d-4b70-a2f1-f58d846d7242/results","cost":"$0.0000","item_count":null,"error":null,"retry_at":null,"total":1,"done_count":0,"failed_count":0,"created_at":"2026-10-12T12:56:17.403Z","started_at":null,"finished_at":null},"meta":{"cost":"$0.0000","request_id":"req_job_example"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"404":{"description":"`cached=cache_only` found nothing saved for these arguments (`not_cached`; call again with `cached=auto` to fetch it), or the YouTube account or item does not exist (`not_found`). You are not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_cached","message":"no saved youtube/channel_playlists read for '@MrBeast'. cached=cache_only never fetches, so call again with cached=auto to fetch it. You are not charged.","request_id":"req_5c10900e919bc7a3ff79b7501d582b4c"}}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/youtube/channel_community_posts":{"get":{"tags":["YouTube"],"operationId":"ytChannelCommunityPosts","summary":"channel_community_posts","x-dashboard-cost":"$0.0005/30","x-example-query":{"handle":"@MrBeast","max_pages":"1"},"description":"The channel's community posts. With max_pages=1, returns `Page[Post]` under `data`; with `get_raw=true` returns the upstream JSON.\n\nThe default request creates a durable job (202). Use max_pages=1 for one synchronous Page response (200). Poll status_url, then read results_url with its opaque cursor. Acquisition stops at the first of since, max_pages, or exhaustion. Jobs continue after disconnects. Result responses are bounded to 3 MiB; this does not limit the crawl. Supply Idempotency-Key to recover a lost submission response; reuse it with the same inputs. YouTube sets every page’s size, so there is no `page_size`.\n\nA field YouTube does not carry is null, a list it does not carry is `[]`, and YouTube-only facts sit under `extra`. Unknown, unsupported, and repeated query parameters return 400 before acquisition or billing.\n\nBilling: $0.0005 per 30 unique returned items (one native page), rounded up to a minimum of one billing unit; a `get_raw=true` page bills one unit. Jobs settle once after successful completion. Submission, polling and repeat downloads are free.","security":[{"bearerAuth":[]}],"parameters":[{"name":"handle","in":"query","required":true,"description":"A channel @handle, its `UC…` channel id, or a youtube.com/@handle or /channel/ URL. Handles are case-sensitive.","example":"@MrBeast","schema":{"type":"string"}},{"name":"since","in":"query","required":false,"description":"Not accepted on this operation: its items carry no timestamp, so since returns 400 before billing.","schema":{"type":"string"}},{"name":"max_pages","in":"query","required":false,"example":1,"description":"Maximum pages to fetch. -1 walks until exhaustion or since with no page cap, and must be written. Omitted, since alone bounds the walk; with neither, the job stops after 10 pages. Any positive integer is accepted. 1 returns one page synchronously with HTTP 200; any other value creates a durable job with HTTP 202.","schema":{"type":"integer","anyOf":[{"enum":[-1]},{"minimum":1}]}},{"name":"cursor","in":"query","required":false,"description":"Opaque next_cursor from an earlier answer of this operation, also with `get_raw=true`. A native YouTube cursor from a raw page answers 400. Result download cursors belong to the results route.","schema":{"type":"string","minLength":1}},{"name":"cached","in":"query","required":false,"description":"`auto` (default) serves a read saved within the last 24 hours for these exact arguments, otherwise fetches. `cache_only` never contacts YouTube (404 `not_cached` when nothing is saved, whatever its age). `live` always fetches. Anything else is a `400`. `cache_only` reads one saved page per request: omit `max_pages` or pass 1, and continue with `next_cursor`.","schema":{"type":"string","enum":["auto","cache_only","live"],"default":"auto"},"examples":{"default":{"value":"auto","x-disabled":true}}},{"name":"get_raw","in":"query","required":false,"description":"`true` returns the upstream JSON exactly as YouTube answered it instead of the normalized `Page[Post]`.","schema":{"type":"boolean","default":false},"examples":{"default":{"value":false,"x-disabled":true}}},{"name":"Idempotency-Key","in":"header","required":false,"description":"Reuse this key with the same inputs to recover a lost job submission. A different input with the same key returns 409.","schema":{"type":"string","minLength":1,"maxLength":200}}],"responses":{"200":{"description":"`Page[Post]` under `data`; with `get_raw=true` the upstream JSON.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"anyOf":[{"type":"object","required":["items","pages","next_cursor","has_more","stop_reason","coverage"],"properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/Post"},"description":"`Post` of every page walked, in page order."},"pages":{"type":"array","items":{"$ref":"#/components/schemas/PageRead"},"description":"One entry per page walked."},"next_cursor":{"type":"string","nullable":true,"description":"Opaque; pass back as `cursor` to continue."},"has_more":{"type":"boolean","description":"True when `next_cursor` is set, and when the walk stopped `cursor_stalled` on a page that said more results exist but gave no cursor to send back."},"stop_reason":{"type":"string","enum":["pages","since","exhausted","cursor_stalled","repeated_content","deadline","blocked","caught_up"],"description":"Why the walk stopped. `pages`: the page budget is spent and `next_cursor` continues it. `deadline`: the call ran out of time before its next page; `next_cursor` continues it. `since`: a whole page was older than `since`. `exhausted`: YouTube reported the end. `cursor_stalled`: YouTube claimed more but repeated or omitted its cursor. `repeated_content`: a page held only items already seen. `blocked`: YouTube refused a later page; `next_cursor` is the page it refused. `caught_up`: only watch passes the crawler runs for itself stop this way."},"coverage":{"$ref":"#/components/schemas/Coverage"}}},{"type":"object","additionalProperties":true}],"description":"`Page[Post]`, or the upstream JSON when `get_raw=true`."},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"items":[{"id":"Ugkxg-YuyvHwnlFZRktAZHHELzGBrskCHChJ","shortcode":null,"taken_at":null,"kind":null,"product_type":"community_post","caption":"I found MrsBeast ❤️❤️❤️","hashtags":[],"mentions":[],"accessibility_caption":null,"likes":1000000,"comments":null,"views":null,"counts_hidden":null,"comments_disabled":null,"is_pinned":null,"is_paid_partnership":null,"owner":{"id":"UCX6OQ3DkcsbYNE6H8uQQuVA","username":"MrBeast","full_name":"MrBeast","is_verified":null,"is_private":null,"avatar_url":null,"latest_story_at":null,"extra":{}},"coauthors":[],"sponsors":[],"tagged":[],"location":null,"audio":null,"thumbnail_url":null,"video_duration":null,"media":[],"media_urls":[],"extra":{"url":"https://www.youtube.com/post/Ugkxg-YuyvHwnlFZRktAZHHELzGBrskCHChJ","published_text":"15 hours ago","attachment_type":"postMultiImage","attachment":{"title":null,"video_id":null,"thumbnails":[{"url":"https://yt3.ggpht.com/oiElfzENMAx3umYLMOH0sZOodVZChBV2L0ddB-KbqwR9B0djUx9o-JMD8ehXMt9fmKtAkGeO3ySq=s288-c-fcrop64=1,00000000ffffc002-rw-nd-v1","width":288,"height":288},{"url":"https://yt3.ggpht.com/oiElfzENMAx3umYLMOH0sZOodVZChBV2L0ddB-KbqwR9B0djUx9o-JMD8ehXMt9fmKtAkGeO3ySq=s400-c-fcrop64=1,00000000ffffc002-rw-nd-v1","width":400,"height":400}]}}},{"id":"Ugkx5QH9-Xr0EWbVJ1riARjVrDcXRN1LfJS7","shortcode":null,"taken_at":null,"kind":null,"product_type":"community_post","caption":"World Cup was fun","hashtags":[],"mentions":[],"accessibility_caption":null,"likes":1500000,"comments":null,"views":null,"counts_hidden":null,"comments_disabled":null,"is_pinned":null,"is_paid_partnership":null,"owner":{"id":"UCX6OQ3DkcsbYNE6H8uQQuVA","username":"MrBeast","full_name":"MrBeast","is_verified":null,"is_private":null,"avatar_url":null,"latest_story_at":null,"extra":{}},"coauthors":[],"sponsors":[],"tagged":[],"location":null,"audio":null,"thumbnail_url":null,"video_duration":null,"media":[],"media_urls":[],"extra":{"url":"https://www.youtube.com/post/Ugkx5QH9-Xr0EWbVJ1riARjVrDcXRN1LfJS7","published_text":"2 days ago","attachment_type":"postMultiImage","attachment":{"title":null,"video_id":null,"thumbnails":[{"url":"https://yt3.ggpht.com/wTY3z3Ws2f97goiOPzWqUJMt_LLjENEnpjJoCEefj_yzalyDfkc3N9OKfbtpCqo9KRe927hAX7lJqr0=s288-c-fcrop64=1,00003852ffffe2fc-rw-nd-v1","width":288,"height":288},{"url":"https://yt3.ggpht.com/wTY3z3Ws2f97goiOPzWqUJMt_LLjENEnpjJoCEefj_yzalyDfkc3N9OKfbtpCqo9KRe927hAX7lJqr0=s400-c-fcrop64=1,00003852ffffe2fc-rw-nd-v1","width":400,"height":400}]}}}],"pages":[{"cursor":null,"fetched_at":"2026-07-22T08:58:08.505929+00:00","count":2}],"next_cursor":"eyJjb250aW51YXRpb24iOiI0cW1Gc2dLQkFSSVlWVU5ZTms5Uk0wUnJZM05pV1U1Rk5rZzRkVkZSZFZaQkdreEZaMVozWWpOT01HTTJiMFJMUVc5clZWUktiMUV4U2tkVmJrWlZZVEo0VVZac1VrSk5SbFp4VVd4a1ZsWXdXbHBXTW5CVFlURktWVkpyV2xOV1ZWcERTMEZ5ZVVKblVVdEJhMjlCbWdJV1ltRmphM04wWVdkbExXbDBaVzB0YzJWamRHbHZiZyUzRCUzRCIsIm9wIjoiY2hhbm5lbF9jb21tdW5pdHlfcG9zdHMifQ","has_more":true,"stop_reason":"pages","coverage":{"since":null,"oldest_at":null,"since_reached":false}},"meta":{"source":"db","fetched_at":"2026-07-22T08:58:08.505929+00:00","cost":"$0.0005","balance":"$3.3577","request_id":"req_ffe628a2dd2af3bb202e7039fa856daf"}}}}},"202":{"description":"Durable job accepted. No completed-result charge. Save batch_id; poll status_url. Retry submission with the same Idempotency-Key after a lost response. An account may have five queued, running or payment-required jobs. A sixth new job returns 429 rate_limited. Matching idempotent replays still work at the limit. Ready and failed jobs release their slots; pages within a job remain unbounded. This is a synthetic contract example, not a live capture.","x-example-provenance":"synthetic-contract","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","required":["batch_id","status","status_url","results_url","cost","item_count","error","retry_at","total","done_count","failed_count","created_at","started_at","finished_at"],"properties":{"batch_id":{"type":"string"},"status":{"type":"string","enum":["queued","running","payment_required","ready","failed"]},"status_url":{"type":"string"},"results_url":{"type":"string"},"cost":{"type":"string"},"item_count":{"type":"integer","nullable":true},"error":{"type":"string","nullable":true,"description":"Null unless failed. A failed target carries its own code; incomplete_result appears only when it has none and pages of the result are missing. profile_not_found, post_not_found, upstream_not_found or not_found: the target does not exist or is not visible. not_visible: The account exists, but its posts are not visible to logged-out readers (private, restricted, or hidden by Instagram). Retrying will not change the result until the account changes. not_cached: cached=cache_only found no saved read. incomplete_result: pages of the result are missing. temporarily_unavailable: the target could not be read for now (no capacity, a pause or repeated refusals); retry later with a new job. result_item_too_large: one result unit exceeds the delivery budget. result_snapshot_missing or result_snapshot_corrupt: the crawler could not serve the retained result of a paid job, and its charge is refunded; if the crawler serves it again, a later results read returns it and charges the job again. crawler_submit_400, crawler_submit_404 or crawler_submit_422: the crawl service refused the job request. crawler_job_failed: any other failure; the same job is not expected to succeed if resubmitted. cancelled: the job was cancelled with POST /v1/jobs/{job_id}/cancel. No failed job costs anything: only result_snapshot_missing and result_snapshot_corrupt follow a charge, and that charge is refunded."},"retry_at":{"type":"string","format":"date-time","nullable":true,"description":"Null unless the job failed temporarily_unavailable because a crawl route was closed for every caller. Then it is when the route opens again, and the response carries the same time as a Retry-After header in seconds. Submit a new job after it."},"total":{"type":"integer","description":"Targets in the job. A job submitted through a /v1 route has one."},"done_count":{"type":"integer","description":"Targets the crawler finished."},"failed_count":{"type":"integer","description":"Targets that failed."},"created_at":{"type":"string","format":"date-time","description":"When the job was submitted."},"started_at":{"type":"string","format":"date-time","nullable":true,"description":"When the crawler started the job. Null until it starts."},"finished_at":{"type":"string","format":"date-time","nullable":true,"description":"When the job finished or failed. Null while it is queued or running."}}},"meta":{"type":"object","required":["cost","request_id"],"properties":{"cost":{"type":"string","example":"$0.0000"},"request_id":{"type":"string"}}}}},"example":{"data":{"batch_id":"job_7641d5f0-717d-4b70-a2f1-f58d846d7242","status":"queued","status_url":"/v1/jobs/job_7641d5f0-717d-4b70-a2f1-f58d846d7242","results_url":"/v1/jobs/job_7641d5f0-717d-4b70-a2f1-f58d846d7242/results","cost":"$0.0000","item_count":null,"error":null,"retry_at":null,"total":1,"done_count":0,"failed_count":0,"created_at":"2026-10-12T12:56:17.403Z","started_at":null,"finished_at":null},"meta":{"cost":"$0.0000","request_id":"req_job_example"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"404":{"description":"`cached=cache_only` found nothing saved for these arguments (`not_cached`; call again with `cached=auto` to fetch it), or the YouTube account or item does not exist (`not_found`). You are not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_cached","message":"no saved youtube/channel_community_posts read for '@MrBeast'. cached=cache_only never fetches, so call again with cached=auto to fetch it. You are not charged.","request_id":"req_5c10900e919bc7a3ff79b7501d582b4c"}}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/youtube/community_post":{"get":{"tags":["YouTube"],"operationId":"ytCommunityPost","summary":"community_post","x-dashboard-cost":"$0.0005","x-example-query":{"url":"https://www.youtube.com/post/UgkxX6gkDxQ0KRucvyG7NLui0LhjHp0CLlfZ"},"description":"One community post from its public page. Returns `Post` under `data`; the upstream document is an HTML page, so `get_raw` is not available.\n\nA field YouTube does not carry is null, a list it does not carry is `[]`, and YouTube-only facts sit under `extra`. Unknown, unsupported, and repeated query parameters return 400 before acquisition or billing.","security":[{"bearerAuth":[]}],"parameters":[{"name":"url","in":"query","required":true,"description":"A community post URL, `https://www.youtube.com/post/Ug…`, or the bare `Ug…` post id.","example":"https://www.youtube.com/post/UgkxX6gkDxQ0KRucvyG7NLui0LhjHp0CLlfZ","schema":{"type":"string"}},{"name":"cached","in":"query","required":false,"description":"`auto` (default) serves a read saved within the last 24 hours for these exact arguments, otherwise fetches. `cache_only` never contacts YouTube (404 `not_cached` when nothing is saved, whatever its age). `live` always fetches. Anything else is a `400`.","schema":{"type":"string","enum":["auto","cache_only","live"],"default":"auto"},"examples":{"default":{"value":"auto","x-disabled":true}}},{"name":"get_raw","in":"query","required":false,"description":"Not available on this operation: the upstream document is an HTML page, and `true` answers 400. The default `false` returns the normalized type.","schema":{"type":"boolean","default":false},"examples":{"default":{"value":false,"x-disabled":true}}}],"responses":{"200":{"description":"`Post` under `data`.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/Post"},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"id":"UgkxX6gkDxQ0KRucvyG7NLui0LhjHp0CLlfZ","shortcode":null,"taken_at":null,"kind":null,"product_type":"community_post","caption":"Alright, it's that time: https://vote.mkbhd.com\n\nWelcome to the Blind Smartphone Camera Test 2023! 20 smartphones. 3 categories. Scientific winners revealed (I'll collect and reveal all the most interesting data soon. Your winners may surprise you!)","hashtags":[],"mentions":[],"accessibility_caption":null,"likes":12000,"comments":null,"views":null,"counts_hidden":null,"comments_disabled":null,"is_pinned":null,"is_paid_partnership":null,"owner":{"id":"UCBJycsmduvYEL83R_U4JriQ","username":null,"full_name":"Marques Brownlee","is_verified":null,"is_private":null,"avatar_url":null,"latest_story_at":null,"extra":{}},"coauthors":[],"sponsors":[],"tagged":[],"location":null,"audio":null,"thumbnail_url":null,"video_duration":null,"media":[],"media_urls":[],"extra":{"url":"https://www.youtube.com/post/UgkxX6gkDxQ0KRucvyG7NLui0LhjHp0CLlfZ","published_text":"2 years ago (edited)","attachment_type":"backstageImage","attachment":{"video_id":null,"title":null,"thumbnails":[{"url":"https://yt3.ggpht.com/zy6PEg0QzlzFe8xfDxpAbe1mGV0pXgc-xV1MvQ7rlf_EWjEj_YqN0Y2b7fiaOCdghICsMxy8tDGDaA=s288-rw-nd-v1","width":288,"height":225},{"url":"https://yt3.ggpht.com/zy6PEg0QzlzFe8xfDxpAbe1mGV0pXgc-xV1MvQ7rlf_EWjEj_YqN0Y2b7fiaOCdghICsMxy8tDGDaA=s400-rw-nd-v1","width":400,"height":313}]}}},"meta":{"source":"live","fetched_at":"2026-10-12T13:43:29.715008+00:00","cost":"$0.0005","balance":"$9.9995","request_id":"req_d1182055b864e818d8ff8a46a7e26001"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"404":{"description":"`cached=cache_only` found nothing saved for these arguments (`not_cached`; call again with `cached=auto` to fetch it), or the YouTube account or item does not exist (`not_found`). You are not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_cached","message":"no saved youtube/community_post read for 'https://www.youtube.com/post/UgkxX6gkDxQ0KRucvyG7NLui0LhjHp0CLlfZ'. cached=cache_only never fetches, so call again with cached=auto to fetch it. You are not charged.","request_id":"req_5c10900e919bc7a3ff79b7501d582b4c"}}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/youtube/playlist":{"get":{"tags":["YouTube"],"operationId":"ytPlaylist","summary":"playlist","x-dashboard-cost":"$0.0005/100","x-example-query":{"playlist_id":"PLFgquLnL59alCl_2TQvOiD5Vgm1hCaGSI","max_pages":"1"},"description":"A playlist's videos in playlist order. With max_pages=1, returns `Page[Post]` under `data`; with `get_raw=true` returns the upstream JSON.\n\nThe default request creates a durable job (202). Use max_pages=1 for one synchronous Page response (200). Poll status_url, then read results_url with its opaque cursor. Acquisition stops at the first of since, max_pages, or exhaustion. Jobs continue after disconnects. Result responses are bounded to 3 MiB; this does not limit the crawl. Supply Idempotency-Key to recover a lost submission response; reuse it with the same inputs. YouTube sets every page’s size, so there is no `page_size`.\n\nA field YouTube does not carry is null, a list it does not carry is `[]`, and YouTube-only facts sit under `extra`. Unknown, unsupported, and repeated query parameters return 400 before acquisition or billing.\n\nBilling: $0.0005 per 100 unique returned items (one native page), rounded up to a minimum of one billing unit; a `get_raw=true` page bills one unit. Jobs settle once after successful completion. Submission, polling and repeat downloads are free.","security":[{"bearerAuth":[]}],"parameters":[{"name":"playlist_id","in":"query","required":true,"description":"A playlist id (PL…, UU…, OL…), or a youtube.com playlist URL.","example":"PLFgquLnL59alCl_2TQvOiD5Vgm1hCaGSI","schema":{"type":"string"}},{"name":"since","in":"query","required":false,"description":"Not accepted on this operation: its items carry no timestamp, so since returns 400 before billing.","schema":{"type":"string"}},{"name":"max_pages","in":"query","required":false,"example":1,"description":"Maximum pages to fetch. -1 walks until exhaustion or since with no page cap, and must be written. Omitted, since alone bounds the walk; with neither, the job stops after 10 pages. Any positive integer is accepted. 1 returns one page synchronously with HTTP 200; any other value creates a durable job with HTTP 202.","schema":{"type":"integer","anyOf":[{"enum":[-1]},{"minimum":1}]}},{"name":"cursor","in":"query","required":false,"description":"Opaque next_cursor from an earlier answer of this operation, also with `get_raw=true`. A native YouTube cursor from a raw page answers 400. Result download cursors belong to the results route.","schema":{"type":"string","minLength":1}},{"name":"cached","in":"query","required":false,"description":"`auto` (default) serves a read saved within the last 24 hours for these exact arguments, otherwise fetches. `cache_only` never contacts YouTube (404 `not_cached` when nothing is saved, whatever its age). `live` always fetches. Anything else is a `400`. `cache_only` reads one saved page per request: omit `max_pages` or pass 1, and continue with `next_cursor`.","schema":{"type":"string","enum":["auto","cache_only","live"],"default":"auto"},"examples":{"default":{"value":"auto","x-disabled":true}}},{"name":"get_raw","in":"query","required":false,"description":"`true` returns the upstream JSON exactly as YouTube answered it instead of the normalized `Page[Post]`.","schema":{"type":"boolean","default":false},"examples":{"default":{"value":false,"x-disabled":true}}},{"name":"Idempotency-Key","in":"header","required":false,"description":"Reuse this key with the same inputs to recover a lost job submission. A different input with the same key returns 409.","schema":{"type":"string","minLength":1,"maxLength":200}}],"responses":{"200":{"description":"`Page[Post]` under `data`; with `get_raw=true` the upstream JSON.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"anyOf":[{"type":"object","required":["items","pages","next_cursor","has_more","stop_reason","coverage"],"properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/Post"},"description":"`Post` of every page walked, in page order."},"pages":{"type":"array","items":{"$ref":"#/components/schemas/PageRead"},"description":"One entry per page walked."},"next_cursor":{"type":"string","nullable":true,"description":"Opaque; pass back as `cursor` to continue."},"has_more":{"type":"boolean","description":"True when `next_cursor` is set, and when the walk stopped `cursor_stalled` on a page that said more results exist but gave no cursor to send back."},"stop_reason":{"type":"string","enum":["pages","since","exhausted","cursor_stalled","repeated_content","deadline","blocked","caught_up"],"description":"Why the walk stopped. `pages`: the page budget is spent and `next_cursor` continues it. `deadline`: the call ran out of time before its next page; `next_cursor` continues it. `since`: a whole page was older than `since`. `exhausted`: YouTube reported the end. `cursor_stalled`: YouTube claimed more but repeated or omitted its cursor. `repeated_content`: a page held only items already seen. `blocked`: YouTube refused a later page; `next_cursor` is the page it refused. `caught_up`: only watch passes the crawler runs for itself stop this way."},"coverage":{"$ref":"#/components/schemas/Coverage"}}},{"type":"object","additionalProperties":true}],"description":"`Page[Post]`, or the upstream JSON when `get_raw=true`."},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"items":[{"id":"Df5Y-2ndQyU","shortcode":null,"taken_at":null,"kind":"video","product_type":"video","caption":null,"hashtags":[],"mentions":[],"accessibility_caption":null,"likes":null,"comments":null,"views":5200000,"counts_hidden":null,"comments_disabled":null,"is_pinned":null,"is_paid_partnership":null,"owner":{"id":"UCX6OQ3DkcsbYNE6H8uQQuVA","username":"MrBeast","full_name":null,"is_verified":null,"is_private":null,"avatar_url":null,"latest_story_at":null,"extra":{}},"coauthors":[],"sponsors":[],"tagged":[],"location":null,"audio":null,"thumbnail_url":"https://i.ytimg.com/vi/Df5Y-2ndQyU/hqdefault.jpg?sqp=-oaymwE2CNACELwBSFXyq4qpAygIARUAAIhCGAFwAcABBvABAfgBtgiAAoAPigIMCAAQARg7ID4ofzAP&rs=AOn4CLCIdtbVJRIKyQDVKkPeRFktuYvdUA","video_duration":33,"media":[],"media_urls":[],"extra":{"title":"Read My Book, You Could Win $1,000,000","url":"https://www.youtube.com/watch?v=Df5Y-2ndQyU","published_text":"3 days ago"}},{"id":"egvLKQe6I4I","shortcode":null,"taken_at":null,"kind":"video","product_type":"video","caption":null,"hashtags":[],"mentions":[],"accessibility_caption":null,"likes":null,"comments":null,"views":75000000,"counts_hidden":null,"comments_disabled":null,"is_pinned":null,"is_paid_partnership":null,"owner":{"id":"UCX6OQ3DkcsbYNE6H8uQQuVA","username":"MrBeast","full_name":null,"is_verified":null,"is_private":null,"avatar_url":null,"latest_story_at":null,"extra":{}},"coauthors":[],"sponsors":[],"tagged":[],"location":null,"audio":null,"thumbnail_url":"https://i.ytimg.com/vi/egvLKQe6I4I/hqdefault.jpg?sqp=-oaymwE2CNACELwBSFXyq4qpAygIARUAAIhCGAFwAcABBvABAfgBtgiAAoAPigIMCAAQARhlIGEoMTAP&rs=AOn4CLA9iDvyVUcn7G_cYtMaSOrVZMyRLQ","video_duration":51,"media":[],"media_urls":[],"extra":{"title":"Don't Pop the Balloon","url":"https://www.youtube.com/watch?v=egvLKQe6I4I","published_text":"10 days ago"}}],"pages":[{"cursor":null,"fetched_at":"2026-07-21T15:11:14.935040+00:00","count":2}],"next_cursor":"eyJjb250aW51YXRpb24iOiI0cW1Gc2dKdEVocFdURlZWV0RaUFVUTkVhMk56WWxsT1JUWklPSFZSVVhWV1FSbzBRMEZHTmtoc1FsVlBhMDVJVlZkc1JsSlZNSGRVVlZaU1pXeEtjVnA2Ums1bGJGcEhWRmh3VmsxVk9VVlVVU1V6UkNVelJKb0NHRlZWV0RaUFVUTkVhMk56WWxsT1JUWklPSFZSVVhWV1FRJTNEJTNEIiwib3AiOiJwbGF5bGlzdCJ9","has_more":true,"stop_reason":"pages","coverage":{"since":null,"oldest_at":null,"since_reached":false}},"meta":{"source":"db","fetched_at":"2026-07-21T15:11:14.935040+00:00","cost":"$0.0005","balance":"$3.0860","request_id":"req_cdfa39bc7523a0a29285590dc5089471"}}}}},"202":{"description":"Durable job accepted. No completed-result charge. Save batch_id; poll status_url. Retry submission with the same Idempotency-Key after a lost response. An account may have five queued, running or payment-required jobs. A sixth new job returns 429 rate_limited. Matching idempotent replays still work at the limit. Ready and failed jobs release their slots; pages within a job remain unbounded. This is a synthetic contract example, not a live capture.","x-example-provenance":"synthetic-contract","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","required":["batch_id","status","status_url","results_url","cost","item_count","error","retry_at","total","done_count","failed_count","created_at","started_at","finished_at"],"properties":{"batch_id":{"type":"string"},"status":{"type":"string","enum":["queued","running","payment_required","ready","failed"]},"status_url":{"type":"string"},"results_url":{"type":"string"},"cost":{"type":"string"},"item_count":{"type":"integer","nullable":true},"error":{"type":"string","nullable":true,"description":"Null unless failed. A failed target carries its own code; incomplete_result appears only when it has none and pages of the result are missing. profile_not_found, post_not_found, upstream_not_found or not_found: the target does not exist or is not visible. not_visible: The account exists, but its posts are not visible to logged-out readers (private, restricted, or hidden by Instagram). Retrying will not change the result until the account changes. not_cached: cached=cache_only found no saved read. incomplete_result: pages of the result are missing. temporarily_unavailable: the target could not be read for now (no capacity, a pause or repeated refusals); retry later with a new job. result_item_too_large: one result unit exceeds the delivery budget. result_snapshot_missing or result_snapshot_corrupt: the crawler could not serve the retained result of a paid job, and its charge is refunded; if the crawler serves it again, a later results read returns it and charges the job again. crawler_submit_400, crawler_submit_404 or crawler_submit_422: the crawl service refused the job request. crawler_job_failed: any other failure; the same job is not expected to succeed if resubmitted. cancelled: the job was cancelled with POST /v1/jobs/{job_id}/cancel. No failed job costs anything: only result_snapshot_missing and result_snapshot_corrupt follow a charge, and that charge is refunded."},"retry_at":{"type":"string","format":"date-time","nullable":true,"description":"Null unless the job failed temporarily_unavailable because a crawl route was closed for every caller. Then it is when the route opens again, and the response carries the same time as a Retry-After header in seconds. Submit a new job after it."},"total":{"type":"integer","description":"Targets in the job. A job submitted through a /v1 route has one."},"done_count":{"type":"integer","description":"Targets the crawler finished."},"failed_count":{"type":"integer","description":"Targets that failed."},"created_at":{"type":"string","format":"date-time","description":"When the job was submitted."},"started_at":{"type":"string","format":"date-time","nullable":true,"description":"When the crawler started the job. Null until it starts."},"finished_at":{"type":"string","format":"date-time","nullable":true,"description":"When the job finished or failed. Null while it is queued or running."}}},"meta":{"type":"object","required":["cost","request_id"],"properties":{"cost":{"type":"string","example":"$0.0000"},"request_id":{"type":"string"}}}}},"example":{"data":{"batch_id":"job_7641d5f0-717d-4b70-a2f1-f58d846d7242","status":"queued","status_url":"/v1/jobs/job_7641d5f0-717d-4b70-a2f1-f58d846d7242","results_url":"/v1/jobs/job_7641d5f0-717d-4b70-a2f1-f58d846d7242/results","cost":"$0.0000","item_count":null,"error":null,"retry_at":null,"total":1,"done_count":0,"failed_count":0,"created_at":"2026-10-12T12:56:17.403Z","started_at":null,"finished_at":null},"meta":{"cost":"$0.0000","request_id":"req_job_example"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"404":{"description":"`cached=cache_only` found nothing saved for these arguments (`not_cached`; call again with `cached=auto` to fetch it), or the YouTube account or item does not exist (`not_found`). You are not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_cached","message":"no saved youtube/playlist read for 'PLFgquLnL59alCl_2TQvOiD5Vgm1hCaGSI'. cached=cache_only never fetches, so call again with cached=auto to fetch it. You are not charged.","request_id":"req_5c10900e919bc7a3ff79b7501d582b4c"}}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/youtube/search":{"get":{"tags":["YouTube"],"operationId":"ytSearch","summary":"search","x-dashboard-cost":"$0.0005/20","x-example-query":{"keyword":"mkbhd","max_pages":"1"},"description":"YouTube's search: videos, channels and playlists, ranked. With max_pages=1, returns `Page[YouTubeSearchResult]` under `data`; with `get_raw=true` returns the upstream JSON.\n\nThe default request creates a durable job (202). Use max_pages=1 for one synchronous Page response (200). Poll status_url, then read results_url with its opaque cursor. Acquisition stops at the first of since, max_pages, or exhaustion. Jobs continue after disconnects. Result responses are bounded to 3 MiB; this does not limit the crawl. Supply Idempotency-Key to recover a lost submission response; reuse it with the same inputs. YouTube sets every page’s size, so there is no `page_size`.\n\nA field YouTube does not carry is null, a list it does not carry is `[]`, and YouTube-only facts sit under `extra`. Unknown, unsupported, and repeated query parameters return 400 before acquisition or billing.\n\nBilling: $0.0005 per 20 unique returned items (one native page), rounded up to a minimum of one billing unit; a `get_raw=true` page bills one unit. Jobs settle once after successful completion. Submission, polling and repeat downloads are free.","security":[{"bearerAuth":[]}],"parameters":[{"name":"keyword","in":"query","required":true,"description":"The search query, up to 100 characters.","example":"mkbhd","schema":{"type":"string"}},{"name":"upload_date","in":"query","required":false,"description":"Only videos uploaded `today`, `this_week`, `this_month` or `this_year`.","schema":{"type":"string","enum":["today","this_week","this_month","this_year"]}},{"name":"sort_by","in":"query","required":false,"description":"`relevance` or `popular`; omitted is `relevance`.","schema":{"type":"string","enum":["relevance","popular"]}},{"name":"type","in":"query","required":false,"description":"One result type.","schema":{"type":"string","enum":["videos","shorts","channels","playlists"]}},{"name":"duration","in":"query","required":false,"description":"Only videos `under_3_min`, `between_3_and_20_min` or `over_20_min`.","schema":{"type":"string","enum":["under_3_min","between_3_and_20_min","over_20_min"]}},{"name":"region","in":"query","required":false,"description":"A two-letter country code that localizes the results.","schema":{"type":"string"}},{"name":"include_extras","in":"query","required":false,"description":"`true` reads each video’s watch page for its exact date, likes and description.","schema":{"type":"boolean","default":false},"examples":{"default":{"value":false,"x-disabled":true}}},{"name":"since","in":"query","required":false,"description":"Stop at this date. `2025-09-21` means midnight UTC (2025-09-21T00:00:00Z). Datetimes must use RFC3339 with a timezone, for example `2025-09-21T09:00:00+09:00`. `365d` means 365 days before submission. Invalid calendar dates return 400. With max_pages, the first boundary reached stops the walk. since alone creates a job.","schema":{"type":"string"},"examples":{"default":{"value":"2025-09-21","x-disabled":true},"date":{"value":"2025-09-21","x-disabled":true},"datetime":{"value":"2025-09-21T00:00:00Z","x-disabled":true},"duration":{"value":"365d","x-disabled":true}}},{"name":"max_pages","in":"query","required":false,"example":1,"description":"Maximum pages to fetch. -1 walks until exhaustion or since with no page cap, and must be written. Omitted, since alone bounds the walk; with neither, the job stops after 10 pages. Any positive integer is accepted. 1 returns one page synchronously with HTTP 200; any other value creates a durable job with HTTP 202.","schema":{"type":"integer","anyOf":[{"enum":[-1]},{"minimum":1}]}},{"name":"cursor","in":"query","required":false,"description":"Opaque next_cursor from an earlier answer of this operation, also with `get_raw=true`. A native YouTube cursor from a raw page answers 400. Result download cursors belong to the results route.","schema":{"type":"string","minLength":1}},{"name":"cached","in":"query","required":false,"description":"`auto` (default) serves a read saved within the last 24 hours for these exact arguments, otherwise fetches. `cache_only` never contacts YouTube (404 `not_cached` when nothing is saved, whatever its age). `live` always fetches. Anything else is a `400`. `cache_only` reads one saved page per request: omit `max_pages` or pass 1, and continue with `next_cursor`.","schema":{"type":"string","enum":["auto","cache_only","live"],"default":"auto"},"examples":{"default":{"value":"auto","x-disabled":true}}},{"name":"get_raw","in":"query","required":false,"description":"`true` returns the upstream JSON exactly as YouTube answered it instead of the normalized `Page[YouTubeSearchResult]`.","schema":{"type":"boolean","default":false},"examples":{"default":{"value":false,"x-disabled":true}}},{"name":"Idempotency-Key","in":"header","required":false,"description":"Reuse this key with the same inputs to recover a lost job submission. A different input with the same key returns 409.","schema":{"type":"string","minLength":1,"maxLength":200}}],"responses":{"200":{"description":"`Page[YouTubeSearchResult]` under `data`; with `get_raw=true` the upstream JSON.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"anyOf":[{"type":"object","required":["items","pages","next_cursor","has_more","stop_reason","coverage"],"properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/YouTubeSearchResult"},"description":"`YouTubeSearchResult` of every page walked, in page order."},"pages":{"type":"array","items":{"$ref":"#/components/schemas/PageRead"},"description":"One entry per page walked."},"next_cursor":{"type":"string","nullable":true,"description":"Opaque; pass back as `cursor` to continue."},"has_more":{"type":"boolean","description":"True when `next_cursor` is set, and when the walk stopped `cursor_stalled` on a page that said more results exist but gave no cursor to send back."},"stop_reason":{"type":"string","enum":["pages","since","exhausted","cursor_stalled","repeated_content","deadline","blocked","caught_up"],"description":"Why the walk stopped. `pages`: the page budget is spent and `next_cursor` continues it. `deadline`: the call ran out of time before its next page; `next_cursor` continues it. `since`: a whole page was older than `since`. `exhausted`: YouTube reported the end. `cursor_stalled`: YouTube claimed more but repeated or omitted its cursor. `repeated_content`: a page held only items already seen. `blocked`: YouTube refused a later page; `next_cursor` is the page it refused. `caught_up`: only watch passes the crawler runs for itself stop this way."},"coverage":{"$ref":"#/components/schemas/Coverage"}}},{"type":"object","additionalProperties":true}],"description":"`Page[YouTubeSearchResult]`, or the upstream JSON when `get_raw=true`."},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"items":[{"id":"NofmSGPCDr4","shortcode":null,"taken_at":null,"kind":"video","product_type":"video","caption":null,"hashtags":[],"mentions":[],"accessibility_caption":null,"likes":null,"comments":null,"views":47724,"counts_hidden":null,"comments_disabled":null,"is_pinned":null,"is_paid_partnership":null,"owner":{"id":"UCEcrRXW3oEYfUctetZTAWLw","username":"Waveform","full_name":null,"is_verified":null,"is_private":null,"avatar_url":null,"latest_story_at":null,"extra":{}},"coauthors":[],"sponsors":[],"tagged":[],"location":null,"audio":null,"thumbnail_url":"https://i.ytimg.com/vi/NofmSGPCDr4/hq720.jpg?sqp=-oaymwEcCNAFEJQDSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLACoQbCyrTfxa5oG83_LghFD_Q-Mw","video_duration":5826,"media":[],"media_urls":[],"extra":{"title":"That's a Totally Normal Thing to Say! (Trivia Extravaganza 2026)","url":"https://www.youtube.com/watch?v=NofmSGPCDr4","published_text":"18 hours ago"}},{"id":"_oRgdlJUD18","shortcode":null,"taken_at":null,"kind":"video","product_type":"video","caption":null,"hashtags":[],"mentions":[],"accessibility_caption":null,"likes":null,"comments":null,"views":4866487,"counts_hidden":null,"comments_disabled":null,"is_pinned":null,"is_paid_partnership":null,"owner":{"id":"UCBJycsmduvYEL83R_U4JriQ","username":"mkbhd","full_name":null,"is_verified":null,"is_private":null,"avatar_url":null,"latest_story_at":null,"extra":{}},"coauthors":[],"sponsors":[],"tagged":[],"location":null,"audio":null,"thumbnail_url":"https://i.ytimg.com/vi/_oRgdlJUD18/hq720.jpg?sqp=-oaymwEcCNAFEJQDSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLAO0NyQu5wWhmFYJhgnId8YVBJ-yA","video_duration":919,"media":[],"media_urls":[],"extra":{"title":"iOS 27 Hands-On: Top 5 New Features!","url":"https://www.youtube.com/watch?v=_oRgdlJUD18","published_text":"8 days ago"}}],"pages":[{"cursor":null,"fetched_at":"2026-07-22T10:43:40.534082+00:00","count":2}],"next_cursor":"eyJjb250aW51YXRpb24iOiJFcFlERWdWdGEySm9aQnFNQTFOQ1UwTkJVWFJQWWpKYWRGVXdaRkZSTUZKNVRrbEpRa014T1haVmJXUnJZa1Z3VmxKRVJUUm5aMFZNVG1wT2RGZ3lXbnBVTUZWMFdsWkhRMEZSZEVsWGJscHhUMFpSTVZneU9WWlNXVWxDUXpKV1dGTXhhM2RVTWpWUlVXNXNibWRuUlV4YVZFNXRaV3BPYTJOWGFFOU9SRk5EUVZGMFJWWlhaRkZTYXpWVFlsaE9SRlZaU1VKSFJsWkVVV3R3TlZrelRuUmFTRll5VjFWV1RVOUVUbE5ZTVZVd1UyNUtjRlZaU1VKRE1WVjBXbnBDVWxkSFRrUlZTRnB5WjJkRlRGSnNTa3BPZW1nd1kxUnNSbUZYZFVOQlVYTTFVakZPUldSck9IZFVSVnBIVWxsSlFrTXhUalZWYW1SVFkyeG9jbU5XVG5wblowVk1XREprUkZkSE1VeGhhMUpzV1RGWFEwRlJjek5UTVVwb1dXdDRTVTR5Y0dwU1dVbENRekZDTVdKdWEzUk5ibVJ5VkZad1FtZG5SVXhsYm5CeFkxUmtabHBIVW1sTlJsZERRVkYwYlZSWVFYcFdSa0p6VWxWS1VsbzBTVUpETVVaNVZrUlNWRTlYYTNwWlYyUkdaMmRGVEdGcVNubGpNM0F4VjJrd05WVkdiWGxCVVZsTFFrRm5XVVZCVEhGQlVWRkpRV2hCV2hpQjRPZ1lJZ3R6WldGeVkyZ3RabVZsWkElM0QlM0QiLCJvcCI6InNlYXJjaCJ9","has_more":true,"stop_reason":"pages","coverage":{"since":null,"oldest_at":null,"since_reached":false}},"meta":{"source":"live","fetched_at":"2026-07-22T10:43:40.534082+00:00","cost":"$0.0005","balance":"$3.3532","request_id":"req_84955589797944212fffad9def6dcbb1"}}}}},"202":{"description":"Durable job accepted. No completed-result charge. Save batch_id; poll status_url. Retry submission with the same Idempotency-Key after a lost response. An account may have five queued, running or payment-required jobs. A sixth new job returns 429 rate_limited. Matching idempotent replays still work at the limit. Ready and failed jobs release their slots; pages within a job remain unbounded. This is a synthetic contract example, not a live capture.","x-example-provenance":"synthetic-contract","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","required":["batch_id","status","status_url","results_url","cost","item_count","error","retry_at","total","done_count","failed_count","created_at","started_at","finished_at"],"properties":{"batch_id":{"type":"string"},"status":{"type":"string","enum":["queued","running","payment_required","ready","failed"]},"status_url":{"type":"string"},"results_url":{"type":"string"},"cost":{"type":"string"},"item_count":{"type":"integer","nullable":true},"error":{"type":"string","nullable":true,"description":"Null unless failed. A failed target carries its own code; incomplete_result appears only when it has none and pages of the result are missing. profile_not_found, post_not_found, upstream_not_found or not_found: the target does not exist or is not visible. not_visible: The account exists, but its posts are not visible to logged-out readers (private, restricted, or hidden by Instagram). Retrying will not change the result until the account changes. not_cached: cached=cache_only found no saved read. incomplete_result: pages of the result are missing. temporarily_unavailable: the target could not be read for now (no capacity, a pause or repeated refusals); retry later with a new job. result_item_too_large: one result unit exceeds the delivery budget. result_snapshot_missing or result_snapshot_corrupt: the crawler could not serve the retained result of a paid job, and its charge is refunded; if the crawler serves it again, a later results read returns it and charges the job again. crawler_submit_400, crawler_submit_404 or crawler_submit_422: the crawl service refused the job request. crawler_job_failed: any other failure; the same job is not expected to succeed if resubmitted. cancelled: the job was cancelled with POST /v1/jobs/{job_id}/cancel. No failed job costs anything: only result_snapshot_missing and result_snapshot_corrupt follow a charge, and that charge is refunded."},"retry_at":{"type":"string","format":"date-time","nullable":true,"description":"Null unless the job failed temporarily_unavailable because a crawl route was closed for every caller. Then it is when the route opens again, and the response carries the same time as a Retry-After header in seconds. Submit a new job after it."},"total":{"type":"integer","description":"Targets in the job. A job submitted through a /v1 route has one."},"done_count":{"type":"integer","description":"Targets the crawler finished."},"failed_count":{"type":"integer","description":"Targets that failed."},"created_at":{"type":"string","format":"date-time","description":"When the job was submitted."},"started_at":{"type":"string","format":"date-time","nullable":true,"description":"When the crawler started the job. Null until it starts."},"finished_at":{"type":"string","format":"date-time","nullable":true,"description":"When the job finished or failed. Null while it is queued or running."}}},"meta":{"type":"object","required":["cost","request_id"],"properties":{"cost":{"type":"string","example":"$0.0000"},"request_id":{"type":"string"}}}}},"example":{"data":{"batch_id":"job_7641d5f0-717d-4b70-a2f1-f58d846d7242","status":"queued","status_url":"/v1/jobs/job_7641d5f0-717d-4b70-a2f1-f58d846d7242","results_url":"/v1/jobs/job_7641d5f0-717d-4b70-a2f1-f58d846d7242/results","cost":"$0.0000","item_count":null,"error":null,"retry_at":null,"total":1,"done_count":0,"failed_count":0,"created_at":"2026-10-12T12:56:17.403Z","started_at":null,"finished_at":null},"meta":{"cost":"$0.0000","request_id":"req_job_example"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"404":{"description":"`cached=cache_only` found nothing saved for these arguments (`not_cached`; call again with `cached=auto` to fetch it), or the YouTube account or item does not exist (`not_found`). You are not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_cached","message":"no saved youtube/search read for 'mkbhd'. cached=cache_only never fetches, so call again with cached=auto to fetch it. You are not charged.","request_id":"req_5c10900e919bc7a3ff79b7501d582b4c"}}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/youtube/search_hashtag":{"get":{"tags":["YouTube"],"operationId":"ytSearchHashtag","summary":"search_hashtag","x-dashboard-cost":"$0.0005/20","x-example-query":{"tag":"technology","max_pages":"1"},"description":"The videos YouTube finds for a hashtag. With max_pages=1, returns `Page[YouTubeSearchResult]` under `data`; with `get_raw=true` returns the upstream JSON.\n\nThe default request creates a durable job (202). Use max_pages=1 for one synchronous Page response (200). Poll status_url, then read results_url with its opaque cursor. Acquisition stops at the first of since, max_pages, or exhaustion. Jobs continue after disconnects. Result responses are bounded to 3 MiB; this does not limit the crawl. Supply Idempotency-Key to recover a lost submission response; reuse it with the same inputs. YouTube sets every page’s size, so there is no `page_size`.\n\nA field YouTube does not carry is null, a list it does not carry is `[]`, and YouTube-only facts sit under `extra`. Unknown, unsupported, and repeated query parameters return 400 before acquisition or billing.\n\nBilling: $0.0005 per 20 unique returned items (one native page), rounded up to a minimum of one billing unit; a `get_raw=true` page bills one unit. Jobs settle once after successful completion. Submission, polling and repeat downloads are free.","security":[{"bearerAuth":[]}],"parameters":[{"name":"tag","in":"query","required":true,"description":"A hashtag, with or without `#`.","example":"technology","schema":{"type":"string"}},{"name":"type","in":"query","required":false,"description":"One result type.","schema":{"type":"string","enum":["all","shorts"]}},{"name":"since","in":"query","required":false,"description":"Stop at this date. `2025-09-21` means midnight UTC (2025-09-21T00:00:00Z). Datetimes must use RFC3339 with a timezone, for example `2025-09-21T09:00:00+09:00`. `365d` means 365 days before submission. Invalid calendar dates return 400. With max_pages, the first boundary reached stops the walk. since alone creates a job.","schema":{"type":"string"},"examples":{"default":{"value":"2025-09-21","x-disabled":true},"date":{"value":"2025-09-21","x-disabled":true},"datetime":{"value":"2025-09-21T00:00:00Z","x-disabled":true},"duration":{"value":"365d","x-disabled":true}}},{"name":"max_pages","in":"query","required":false,"example":1,"description":"Maximum pages to fetch. -1 walks until exhaustion or since with no page cap, and must be written. Omitted, since alone bounds the walk; with neither, the job stops after 10 pages. Any positive integer is accepted. 1 returns one page synchronously with HTTP 200; any other value creates a durable job with HTTP 202.","schema":{"type":"integer","anyOf":[{"enum":[-1]},{"minimum":1}]}},{"name":"cursor","in":"query","required":false,"description":"Opaque next_cursor from an earlier answer of this operation, also with `get_raw=true`. A native YouTube cursor from a raw page answers 400. Result download cursors belong to the results route.","schema":{"type":"string","minLength":1}},{"name":"cached","in":"query","required":false,"description":"`auto` (default) serves a read saved within the last 24 hours for these exact arguments, otherwise fetches. `cache_only` never contacts YouTube (404 `not_cached` when nothing is saved, whatever its age). `live` always fetches. Anything else is a `400`. `cache_only` reads one saved page per request: omit `max_pages` or pass 1, and continue with `next_cursor`.","schema":{"type":"string","enum":["auto","cache_only","live"],"default":"auto"},"examples":{"default":{"value":"auto","x-disabled":true}}},{"name":"get_raw","in":"query","required":false,"description":"`true` returns the upstream JSON exactly as YouTube answered it instead of the normalized `Page[YouTubeSearchResult]`.","schema":{"type":"boolean","default":false},"examples":{"default":{"value":false,"x-disabled":true}}},{"name":"Idempotency-Key","in":"header","required":false,"description":"Reuse this key with the same inputs to recover a lost job submission. A different input with the same key returns 409.","schema":{"type":"string","minLength":1,"maxLength":200}}],"responses":{"200":{"description":"`Page[YouTubeSearchResult]` under `data`; with `get_raw=true` the upstream JSON.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"anyOf":[{"type":"object","required":["items","pages","next_cursor","has_more","stop_reason","coverage"],"properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/YouTubeSearchResult"},"description":"`YouTubeSearchResult` of every page walked, in page order."},"pages":{"type":"array","items":{"$ref":"#/components/schemas/PageRead"},"description":"One entry per page walked."},"next_cursor":{"type":"string","nullable":true,"description":"Opaque; pass back as `cursor` to continue."},"has_more":{"type":"boolean","description":"True when `next_cursor` is set, and when the walk stopped `cursor_stalled` on a page that said more results exist but gave no cursor to send back."},"stop_reason":{"type":"string","enum":["pages","since","exhausted","cursor_stalled","repeated_content","deadline","blocked","caught_up"],"description":"Why the walk stopped. `pages`: the page budget is spent and `next_cursor` continues it. `deadline`: the call ran out of time before its next page; `next_cursor` continues it. `since`: a whole page was older than `since`. `exhausted`: YouTube reported the end. `cursor_stalled`: YouTube claimed more but repeated or omitted its cursor. `repeated_content`: a page held only items already seen. `blocked`: YouTube refused a later page; `next_cursor` is the page it refused. `caught_up`: only watch passes the crawler runs for itself stop this way."},"coverage":{"$ref":"#/components/schemas/Coverage"}}},{"type":"object","additionalProperties":true}],"description":"`Page[YouTubeSearchResult]`, or the upstream JSON when `get_raw=true`."},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"items":[{"id":"Otim2mDjsYM","shortcode":null,"taken_at":null,"kind":"video","product_type":"video","caption":null,"hashtags":[],"mentions":[],"accessibility_caption":null,"likes":null,"comments":null,"views":720445,"counts_hidden":null,"comments_disabled":null,"is_pinned":null,"is_paid_partnership":null,"owner":{"id":"UCUTF61UNExRdjmoK5mXwWfQ","username":"AI.Uncovered","full_name":null,"is_verified":null,"is_private":null,"avatar_url":null,"latest_story_at":null,"extra":{}},"coauthors":[],"sponsors":[],"tagged":[],"location":null,"audio":null,"thumbnail_url":"https://i.ytimg.com/vi/Otim2mDjsYM/hq720.jpg?sqp=-oaymwEcCNAFEJQDSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLAYjWFWHlo558sRr3nl_E1dKsJbsA","video_duration":730,"media":[],"media_urls":[],"extra":{"title":"Top 17 New Technology Trends That Will Define 2026","url":"https://www.youtube.com/watch?v=Otim2mDjsYM","published_text":"11 months ago"}},{"id":"5RDSkR8_AQ0","shortcode":null,"taken_at":null,"kind":"video","product_type":"video","caption":null,"hashtags":[],"mentions":[],"accessibility_caption":null,"likes":null,"comments":null,"views":411941411,"counts_hidden":null,"comments_disabled":null,"is_pinned":null,"is_paid_partnership":null,"owner":{"id":"UC8zJedg1f4sKnyuHWeS6vyw","username":null,"full_name":null,"is_verified":null,"is_private":null,"avatar_url":null,"latest_story_at":null,"extra":{}},"coauthors":[],"sponsors":[],"tagged":[],"location":null,"audio":null,"thumbnail_url":"https://i.ytimg.com/vi/5RDSkR8_AQ0/hq720.jpg?sqp=-oaymwEcCNAFEJQDSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLAUiAIZBygcx_HKjJ6B6EieFadS6w","video_duration":249,"media":[],"media_urls":[],"extra":{"title":"50 Cent - Ayo Technology (Official Music Video) ft. Justin Timberlake","url":"https://www.youtube.com/watch?v=5RDSkR8_AQ0","published_text":"17 years ago"}}],"pages":[{"cursor":null,"fetched_at":"2026-07-22T10:43:44.297758+00:00","count":2}],"next_cursor":"eyJjb250aW51YXRpb24iOiJFdXdDRWdzamRHVmphRzV2Ykc5bmVScmNBbE5DVTBOQlVYUlFaRWRzZEUxdE1VVmhiazVhVkZsSlFrTjZWbE5TUms1eVZXcG9abEZXUlhkblowVk1Wa014UjB4WVdsZFViRnBTVGxSRFEwRlJkR2hoUlhOM1VqSlplRlZJYUhOaU5FbENRekZHUWxGVVpHbE5WVVl5VFVkd1RtZG5SVXhNVnpWTVpVVldRMUpzVGxaWFJXMURRVkYwZUZkcVpGQmhia0p4VWpGYVNHTTBTVUpETWxveFlWVnZkRTB3VG10V1ZFNVNaMmRGVEZVemNFNWhWWEJIVkRKRk1tUjZhVU5CVVhSeVVsTXhTbE5yZUZsYVJGSmhVMWxKUWtNd2RIQlJWMnhQVkVjNWNGSXlPVTVuWjBWTVZUTlNSbEZzT1ROaWJsSnpWMnBEUTBGUmRETmphM0I2VWxob1RrOUZVWFJpTkVsQ1F6TkdhRmRyTldoVlZFNVlVVEl4VG1kblJVeFpWVVV3V210U2NtTXdPV3RsVmxkRFFWRjBVVlpYU2pCWFZXUm1UVmhvUmxrMFNVSkRNV3hRVkRJNVMxbHVjRWhOVlVwV2MyZEZSME5uVVVsR1FrRkRObWRGUlVOQlNWRkhVU1V6UkNVelJCaUI0T2dZSWd0elpXRnlZMmd0Wm1WbFpBJTNEJTNEIiwib3AiOiJzZWFyY2hfaGFzaHRhZyJ9","has_more":true,"stop_reason":"pages","coverage":{"since":null,"oldest_at":null,"since_reached":false}},"meta":{"source":"live","fetched_at":"2026-07-22T10:43:44.297758+00:00","cost":"$0.0005","balance":"$3.3527","request_id":"req_572975d209a93c3b5780836560df5eeb"}}}}},"202":{"description":"Durable job accepted. No completed-result charge. Save batch_id; poll status_url. Retry submission with the same Idempotency-Key after a lost response. An account may have five queued, running or payment-required jobs. A sixth new job returns 429 rate_limited. Matching idempotent replays still work at the limit. Ready and failed jobs release their slots; pages within a job remain unbounded. This is a synthetic contract example, not a live capture.","x-example-provenance":"synthetic-contract","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","required":["batch_id","status","status_url","results_url","cost","item_count","error","retry_at","total","done_count","failed_count","created_at","started_at","finished_at"],"properties":{"batch_id":{"type":"string"},"status":{"type":"string","enum":["queued","running","payment_required","ready","failed"]},"status_url":{"type":"string"},"results_url":{"type":"string"},"cost":{"type":"string"},"item_count":{"type":"integer","nullable":true},"error":{"type":"string","nullable":true,"description":"Null unless failed. A failed target carries its own code; incomplete_result appears only when it has none and pages of the result are missing. profile_not_found, post_not_found, upstream_not_found or not_found: the target does not exist or is not visible. not_visible: The account exists, but its posts are not visible to logged-out readers (private, restricted, or hidden by Instagram). Retrying will not change the result until the account changes. not_cached: cached=cache_only found no saved read. incomplete_result: pages of the result are missing. temporarily_unavailable: the target could not be read for now (no capacity, a pause or repeated refusals); retry later with a new job. result_item_too_large: one result unit exceeds the delivery budget. result_snapshot_missing or result_snapshot_corrupt: the crawler could not serve the retained result of a paid job, and its charge is refunded; if the crawler serves it again, a later results read returns it and charges the job again. crawler_submit_400, crawler_submit_404 or crawler_submit_422: the crawl service refused the job request. crawler_job_failed: any other failure; the same job is not expected to succeed if resubmitted. cancelled: the job was cancelled with POST /v1/jobs/{job_id}/cancel. No failed job costs anything: only result_snapshot_missing and result_snapshot_corrupt follow a charge, and that charge is refunded."},"retry_at":{"type":"string","format":"date-time","nullable":true,"description":"Null unless the job failed temporarily_unavailable because a crawl route was closed for every caller. Then it is when the route opens again, and the response carries the same time as a Retry-After header in seconds. Submit a new job after it."},"total":{"type":"integer","description":"Targets in the job. A job submitted through a /v1 route has one."},"done_count":{"type":"integer","description":"Targets the crawler finished."},"failed_count":{"type":"integer","description":"Targets that failed."},"created_at":{"type":"string","format":"date-time","description":"When the job was submitted."},"started_at":{"type":"string","format":"date-time","nullable":true,"description":"When the crawler started the job. Null until it starts."},"finished_at":{"type":"string","format":"date-time","nullable":true,"description":"When the job finished or failed. Null while it is queued or running."}}},"meta":{"type":"object","required":["cost","request_id"],"properties":{"cost":{"type":"string","example":"$0.0000"},"request_id":{"type":"string"}}}}},"example":{"data":{"batch_id":"job_7641d5f0-717d-4b70-a2f1-f58d846d7242","status":"queued","status_url":"/v1/jobs/job_7641d5f0-717d-4b70-a2f1-f58d846d7242","results_url":"/v1/jobs/job_7641d5f0-717d-4b70-a2f1-f58d846d7242/results","cost":"$0.0000","item_count":null,"error":null,"retry_at":null,"total":1,"done_count":0,"failed_count":0,"created_at":"2026-10-12T12:56:17.403Z","started_at":null,"finished_at":null},"meta":{"cost":"$0.0000","request_id":"req_job_example"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"404":{"description":"`cached=cache_only` found nothing saved for these arguments (`not_cached`; call again with `cached=auto` to fetch it), or the YouTube account or item does not exist (`not_found`). You are not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_cached","message":"no saved youtube/search_hashtag read for 'technology'. cached=cache_only never fetches, so call again with cached=auto to fetch it. You are not charged.","request_id":"req_5c10900e919bc7a3ff79b7501d582b4c"}}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/youtube/search_suggestions":{"get":{"tags":["YouTube"],"operationId":"ytSearchSuggestions","summary":"search_suggestions","x-dashboard-cost":"$0.0005","x-example-query":{"keyword":"mkbhd"},"description":"YouTube's autocomplete for a query. Returns `YouTubeSuggestion[]` under `data`; with `get_raw=true` returns the upstream JSON.\n\nA field YouTube does not carry is null, a list it does not carry is `[]`, and YouTube-only facts sit under `extra`. Unknown, unsupported, and repeated query parameters return 400 before acquisition or billing.","security":[{"bearerAuth":[]}],"parameters":[{"name":"keyword","in":"query","required":true,"description":"The search query, up to 100 characters.","example":"mkbhd","schema":{"type":"string"}},{"name":"region","in":"query","required":false,"description":"A two-letter country code that localizes the results.","schema":{"type":"string"}},{"name":"cached","in":"query","required":false,"description":"`auto` (default) serves a read saved within the last 24 hours for these exact arguments, otherwise fetches. `cache_only` never contacts YouTube (404 `not_cached` when nothing is saved, whatever its age). `live` always fetches. Anything else is a `400`.","schema":{"type":"string","enum":["auto","cache_only","live"],"default":"auto"},"examples":{"default":{"value":"auto","x-disabled":true}}},{"name":"get_raw","in":"query","required":false,"description":"`true` returns the upstream JSON exactly as YouTube answered it instead of the normalized `YouTubeSuggestion[]`.","schema":{"type":"boolean","default":false},"examples":{"default":{"value":false,"x-disabled":true}}}],"responses":{"200":{"description":"`YouTubeSuggestion[]` under `data`; with `get_raw=true` the upstream JSON.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"anyOf":[{"type":"array","items":{"$ref":"#/components/schemas/YouTubeSuggestion"}},{"type":"object","additionalProperties":true}],"description":"`YouTubeSuggestion[]`, or the upstream JSON when `get_raw=true`."},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":[{"text":"marques brownlee","channel":{"id":null,"username":"American Influencer","full_name":"Marques Brownlee","is_verified":null,"is_private":null,"avatar_url":"https://encrypted-tbn1.gstatic.com/images?q=tbn:ANd9GcQcUbO3RAkBeZOoWPkaiUjcMPoqxLrApS1IO3NDdN4r9X9YsRxe","latest_story_at":null,"extra":{}}},{"text":"marques brownlee iphone 17","channel":null}],"meta":{"source":"live","fetched_at":"2026-07-22T10:44:06.776706+00:00","cost":"$0.0005","balance":"$3.3522","request_id":"req_f8c5024ad21c08e0c93032bb03729d5a"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"404":{"description":"`cached=cache_only` found nothing saved for these arguments (`not_cached`; call again with `cached=auto` to fetch it), or the YouTube account or item does not exist (`not_found`). You are not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_cached","message":"no saved youtube/search_suggestions read for 'mkbhd'. cached=cache_only never fetches, so call again with cached=auto to fetch it. You are not charged.","request_id":"req_5c10900e919bc7a3ff79b7501d582b4c"}}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/youtube/video":{"get":{"tags":["YouTube"],"operationId":"ytVideo","summary":"video","x-dashboard-cost":"$0.0005","x-example-query":{"video_id":"0e3GPea1Tyg"},"description":"One video from its watch page: date, counts, description, duration and the paid promotion flag. `extra.title` is the title. A removed or unplayable video answers 404. Returns `Post` under `data`; with `get_raw=true` returns the upstream JSON.\n\nA field YouTube does not carry is null, a list it does not carry is `[]`, and YouTube-only facts sit under `extra`. Unknown, unsupported, and repeated query parameters return 400 before acquisition or billing.","security":[{"bearerAuth":[]}],"parameters":[{"name":"video_id","in":"query","required":true,"description":"An 11-character video id, or a watch, Shorts, live, embed or youtu.be URL.","example":"0e3GPea1Tyg","schema":{"type":"string"}},{"name":"language","in":"query","required":false,"description":"The language YouTube answers in, a BCP-47 code such as `en` or `pt-BR`; omitted is `en`.","schema":{"type":"string"}},{"name":"cached","in":"query","required":false,"description":"`auto` (default) serves a read saved within the last 24 hours for these exact arguments, otherwise fetches. `cache_only` never contacts YouTube (404 `not_cached` when nothing is saved, whatever its age). `live` always fetches. Anything else is a `400`.","schema":{"type":"string","enum":["auto","cache_only","live"],"default":"auto"},"examples":{"default":{"value":"auto","x-disabled":true}}},{"name":"get_raw","in":"query","required":false,"description":"`true` returns the upstream JSON exactly as YouTube answered it instead of the normalized `Post`.","schema":{"type":"boolean","default":false},"examples":{"default":{"value":false,"x-disabled":true}}}],"responses":{"200":{"description":"`Post` under `data`; with `get_raw=true` the upstream JSON.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"anyOf":[{"$ref":"#/components/schemas/Post"},{"type":"object","additionalProperties":true}],"description":"`Post`, or the upstream JSON when `get_raw=true`."},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"id":"0e3GPea1Tyg","shortcode":null,"taken_at":"2021-11-24T21:00:01+00:00","kind":"video","product_type":"video","caption":"MAKE SURE YOU WATCH UNTIL GLASS BRIDGE IT'S INSANE!\n\nWatch Beast Games now on Prime Video!!! https://www.beastgames.com\n\nThank you GoPro for supplying us with cameras to get some of these shots. You can get them here: https://prf.hn/l/6bNbQB3\n\nShoutout to SOKRISPYMEDIA for helping with visuals!\n\nSUB TO ALL CHANNELS\nwww.youtube.com/@UCX6OQ3DkcsbYNE6H8uQQuVA\nwww.youtube.com/@UC4-79UOlP48-QNGgCko5p2g \nwww.youtube.com/@UCIPPMRA040LQr5QPyJEbmXA \nwww.youtube.com/@UCUaT_39o1x6qWjz7K2pWcgw \nwww.youtube.com/@UCAiLfjNXkNv24uhpzUgPa6A \nwww.youtube.com/@UCZzvDDvaYti8Dd8bLEiSoyQ \n\nNew Merch - https://mrbeast.store/\nCheck out Viewstats! - https://www.viewstats.com/\n\nFor any questions or inquiries regarding this video, please reach out to chucky@mrbeastbusiness.com\n\nMusic Provided by https://www.extrememusic.com/\n----------------------------------------------------------------\nfollow all of these or i will kick you\n• Facebook - https://www.facebook.com/MrBeast/\n• Twitter - https://twitter.com/MrBeast\n•  Instagram - https://www.instagram.com/mrbeast\n•  Im Hiring! - https://www.mrbeastjobs.com/\n--------------------------------------------------------------------","hashtags":[],"mentions":["UCX6OQ3DkcsbYNE6H8uQQuVA","UC4-79UOlP48-QNGgCko5p2g","UCIPPMRA040LQr5QPyJEbmXA","UCUaT_39o1x6qWjz7K2pWcgw","UCAiLfjNXkNv24uhpzUgPa6A","UCZzvDDvaYti8Dd8bLEiSoyQ","mrbeastbusiness.com"],"accessibility_caption":null,"likes":20070730,"comments":null,"views":942007314,"counts_hidden":null,"comments_disabled":null,"is_pinned":null,"is_paid_partnership":false,"owner":{"id":"UCX6OQ3DkcsbYNE6H8uQQuVA","username":"MrBeast","full_name":"MrBeast","is_verified":null,"is_private":null,"avatar_url":null,"latest_story_at":null,"extra":{}},"coauthors":[],"sponsors":[],"tagged":[],"location":null,"audio":null,"thumbnail_url":"https://i.ytimg.com/vi/0e3GPea1Tyg/maxresdefault.jpg","video_duration":1541,"media":[],"media_urls":[],"extra":{"title":"$456,000 Squid Game In Real Life!","url":"https://www.youtube.com/watch?v=0e3GPea1Tyg","published_text":null}},"meta":{"source":"db","fetched_at":"2026-07-21T14:04:00.789385+00:00","cost":"$0.0005","balance":"$3.3567","request_id":"req_38a875101766a6b44e7d36b875f31fcc"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"404":{"description":"`cached=cache_only` found nothing saved for these arguments (`not_cached`; call again with `cached=auto` to fetch it), or the YouTube account or item does not exist (`not_found`). You are not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_cached","message":"no saved youtube/video read for '0e3GPea1Tyg'. cached=cache_only never fetches, so call again with cached=auto to fetch it. You are not charged.","request_id":"req_5c10900e919bc7a3ff79b7501d582b4c"}}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/youtube/video_comments":{"get":{"tags":["YouTube"],"operationId":"ytVideoComments","summary":"video_comments","x-dashboard-cost":"$0.0005/20","x-example-query":{"video_id":"0e3GPea1Tyg","max_pages":"1"},"description":"A video's top-level comments. A comment with replies carries `extra.replies_token` for `/v1/youtube/video_comment_replies`. With max_pages=1, returns `Page[Comment]` under `data`; with `get_raw=true` returns the upstream JSON.\n\nThe default request creates a durable job (202). Use max_pages=1 for one synchronous Page response (200). Poll status_url, then read results_url with its opaque cursor. Acquisition stops at the first of since, max_pages, or exhaustion. Jobs continue after disconnects. Result responses are bounded to 3 MiB; this does not limit the crawl. Supply Idempotency-Key to recover a lost submission response; reuse it with the same inputs. YouTube sets every page’s size, so there is no `page_size`.\n\nA field YouTube does not carry is null, a list it does not carry is `[]`, and YouTube-only facts sit under `extra`. Unknown, unsupported, and repeated query parameters return 400 before acquisition or billing.\n\nBilling: $0.0005 per 20 unique returned items (one native page), rounded up to a minimum of one billing unit; a `get_raw=true` page bills one unit. Jobs settle once after successful completion. Submission, polling and repeat downloads are free.","security":[{"bearerAuth":[]}],"parameters":[{"name":"video_id","in":"query","required":true,"description":"An 11-character video id, or a watch, Shorts, live, embed or youtu.be URL.","example":"0e3GPea1Tyg","schema":{"type":"string"}},{"name":"order","in":"query","required":false,"description":"`top` or `newest`; omitted is `top`.","schema":{"type":"string","enum":["top","newest"]}},{"name":"since","in":"query","required":false,"description":"Not accepted on this operation: its items carry no timestamp, so since returns 400 before billing.","schema":{"type":"string"}},{"name":"max_pages","in":"query","required":false,"example":1,"description":"Maximum pages to fetch. -1 walks until exhaustion or since with no page cap, and must be written. Omitted, since alone bounds the walk; with neither, the job stops after 10 pages. Any positive integer is accepted. 1 returns one page synchronously with HTTP 200; any other value creates a durable job with HTTP 202.","schema":{"type":"integer","anyOf":[{"enum":[-1]},{"minimum":1}]}},{"name":"cursor","in":"query","required":false,"description":"Opaque next_cursor from an earlier answer of this operation, also with `get_raw=true`. A native YouTube cursor from a raw page answers 400. Result download cursors belong to the results route.","schema":{"type":"string","minLength":1}},{"name":"cached","in":"query","required":false,"description":"`auto` (default) serves a read saved within the last 24 hours for these exact arguments, otherwise fetches. `cache_only` never contacts YouTube (404 `not_cached` when nothing is saved, whatever its age). `live` always fetches. Anything else is a `400`. `cache_only` reads one saved page per request: omit `max_pages` or pass 1, and continue with `next_cursor`.","schema":{"type":"string","enum":["auto","cache_only","live"],"default":"auto"},"examples":{"default":{"value":"auto","x-disabled":true}}},{"name":"get_raw","in":"query","required":false,"description":"`true` returns the upstream JSON exactly as YouTube answered it instead of the normalized `Page[Comment]`.","schema":{"type":"boolean","default":false},"examples":{"default":{"value":false,"x-disabled":true}}},{"name":"Idempotency-Key","in":"header","required":false,"description":"Reuse this key with the same inputs to recover a lost job submission. A different input with the same key returns 409.","schema":{"type":"string","minLength":1,"maxLength":200}}],"responses":{"200":{"description":"`Page[Comment]` under `data`; with `get_raw=true` the upstream JSON.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"anyOf":[{"type":"object","required":["items","pages","next_cursor","has_more","stop_reason","coverage"],"properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/Comment"},"description":"`Comment` of every page walked, in page order."},"pages":{"type":"array","items":{"$ref":"#/components/schemas/PageRead"},"description":"One entry per page walked."},"next_cursor":{"type":"string","nullable":true,"description":"Opaque; pass back as `cursor` to continue."},"has_more":{"type":"boolean","description":"True when `next_cursor` is set, and when the walk stopped `cursor_stalled` on a page that said more results exist but gave no cursor to send back."},"stop_reason":{"type":"string","enum":["pages","since","exhausted","cursor_stalled","repeated_content","deadline","blocked","caught_up"],"description":"Why the walk stopped. `pages`: the page budget is spent and `next_cursor` continues it. `deadline`: the call ran out of time before its next page; `next_cursor` continues it. `since`: a whole page was older than `since`. `exhausted`: YouTube reported the end. `cursor_stalled`: YouTube claimed more but repeated or omitted its cursor. `repeated_content`: a page held only items already seen. `blocked`: YouTube refused a later page; `next_cursor` is the page it refused. `caught_up`: only watch passes the crawler runs for itself stop this way."},"coverage":{"$ref":"#/components/schemas/Coverage"}}},{"type":"object","additionalProperties":true}],"description":"`Page[Comment]`, or the upstream JSON when `get_raw=true`."},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"items":[{"id":"UgzH8vliQSJKHQMGZjx4AaABAg","text":"Like I said in the video, subscribe if you haven’t already and you could win $10,000!","created_at":null,"likes":1100000,"replies":733,"liked_by_owner":null,"owner":{"id":"UCX6OQ3DkcsbYNE6H8uQQuVA","username":"MrBeast","full_name":"@MrBeast","is_verified":null,"is_private":null,"avatar_url":"https://yt3.ggpht.com/nxYrc_1_2f77DoBadyxMTmv7ZpRZapHR5jbuYe7PlPd5cIRJxtNNEYyOC0ZsxaDyJJzXrnJiuDE=s88-c-k-c0x00ffffff-no-rj","latest_story_at":null,"extra":{}},"extra":{"published_text":"4 years ago","parent_id":null,"replies_token":"Eg0SCzBlM0dQZWExVHlnGAYygwEaUBIaVWd6SDh2bGlRU0pLSFFNR1pqeDRBYUFCQWciAggAKhhVQ1g2T1EzRGtjc2JZTkU2SDh1UVF1VkEyCzBlM0dQZWExVHlnQABICoIBAggBQi9jb21tZW50LXJlcGxpZXMtaXRlbS1VZ3pIOHZsaVFTSktIUU1HWmp4NEFhQUJBZw%3D%3D"}},{"id":"UgyS2kMwcV_2l9Wnq0d4AaABAg","text":"Who is here on July 20th, Just after the FIFA Final..?","created_at":null,"likes":100,"replies":27,"liked_by_owner":null,"owner":{"id":"UCNz8quwi6eMvGqKO-Ah-GyQ","username":"saqibmarwat5782","full_name":"@saqibmarwat5782","is_verified":null,"is_private":null,"avatar_url":"http://media.web.garage.localhost:3902/crawler/youtube_account/1025385.webp","latest_story_at":null,"extra":{}},"extra":{"published_text":"22 hours ago","parent_id":null,"replies_token":"Eg0SCzBlM0dQZWExVHlnGAYygwEaUBIaVWd5UzJrTXdjVl8ybDlXbnEwZDRBYUFCQWciAggAKhhVQ1g2T1EzRGtjc2JZTkU2SDh1UVF1VkEyCzBlM0dQZWExVHlnQAFICoIBAggBQi9jb21tZW50LXJlcGxpZXMtaXRlbS1VZ3lTMmtNd2NWXzJsOVducTBkNEFhQUJBZw%3D%3D"}}],"pages":[{"cursor":null,"fetched_at":"2026-07-21T15:25:55.779620+00:00","count":2}],"next_cursor":"eyJjb250aW51YXRpb24iOiJFZzBTQ3pCbE0wZFFaV0V4VkhsbkdBWXlnd0VhVUJJYVZXZDZTRGgyYkdsUlUwcExTRkZOUjFwcWVEUkJZVUZDUVdjaUFnZ0FLaGhWUTFnMlQxRXpSR3RqYzJKWlRrVTJTRGgxVVZGMVZrRXlDekJsTTBkUVpXRXhWSGxuUUFCSUNvSUJBZ2dCUWk5amIyMXRaVzUwTFhKbGNHeHBaWE10YVhSbGJTMVZaM3BJT0hac2FWRlRTa3RJVVUxSFdtcDRORUZoUVVKQlp3JTNEJTNEIiwib3AiOiJ2aWRlb19jb21tZW50cyJ9","has_more":true,"stop_reason":"pages","coverage":{"since":null,"oldest_at":null,"since_reached":false}},"meta":{"source":"db","fetched_at":"2026-07-21T15:25:55.779620+00:00","cost":"$0.0005","balance":"$3.3562","request_id":"req_f770852af7df2bdaeda83ad37fe7c700"}}}}},"202":{"description":"Durable job accepted. No completed-result charge. Save batch_id; poll status_url. Retry submission with the same Idempotency-Key after a lost response. An account may have five queued, running or payment-required jobs. A sixth new job returns 429 rate_limited. Matching idempotent replays still work at the limit. Ready and failed jobs release their slots; pages within a job remain unbounded. This is a synthetic contract example, not a live capture.","x-example-provenance":"synthetic-contract","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","required":["batch_id","status","status_url","results_url","cost","item_count","error","retry_at","total","done_count","failed_count","created_at","started_at","finished_at"],"properties":{"batch_id":{"type":"string"},"status":{"type":"string","enum":["queued","running","payment_required","ready","failed"]},"status_url":{"type":"string"},"results_url":{"type":"string"},"cost":{"type":"string"},"item_count":{"type":"integer","nullable":true},"error":{"type":"string","nullable":true,"description":"Null unless failed. A failed target carries its own code; incomplete_result appears only when it has none and pages of the result are missing. profile_not_found, post_not_found, upstream_not_found or not_found: the target does not exist or is not visible. not_visible: The account exists, but its posts are not visible to logged-out readers (private, restricted, or hidden by Instagram). Retrying will not change the result until the account changes. not_cached: cached=cache_only found no saved read. incomplete_result: pages of the result are missing. temporarily_unavailable: the target could not be read for now (no capacity, a pause or repeated refusals); retry later with a new job. result_item_too_large: one result unit exceeds the delivery budget. result_snapshot_missing or result_snapshot_corrupt: the crawler could not serve the retained result of a paid job, and its charge is refunded; if the crawler serves it again, a later results read returns it and charges the job again. crawler_submit_400, crawler_submit_404 or crawler_submit_422: the crawl service refused the job request. crawler_job_failed: any other failure; the same job is not expected to succeed if resubmitted. cancelled: the job was cancelled with POST /v1/jobs/{job_id}/cancel. No failed job costs anything: only result_snapshot_missing and result_snapshot_corrupt follow a charge, and that charge is refunded."},"retry_at":{"type":"string","format":"date-time","nullable":true,"description":"Null unless the job failed temporarily_unavailable because a crawl route was closed for every caller. Then it is when the route opens again, and the response carries the same time as a Retry-After header in seconds. Submit a new job after it."},"total":{"type":"integer","description":"Targets in the job. A job submitted through a /v1 route has one."},"done_count":{"type":"integer","description":"Targets the crawler finished."},"failed_count":{"type":"integer","description":"Targets that failed."},"created_at":{"type":"string","format":"date-time","description":"When the job was submitted."},"started_at":{"type":"string","format":"date-time","nullable":true,"description":"When the crawler started the job. Null until it starts."},"finished_at":{"type":"string","format":"date-time","nullable":true,"description":"When the job finished or failed. Null while it is queued or running."}}},"meta":{"type":"object","required":["cost","request_id"],"properties":{"cost":{"type":"string","example":"$0.0000"},"request_id":{"type":"string"}}}}},"example":{"data":{"batch_id":"job_7641d5f0-717d-4b70-a2f1-f58d846d7242","status":"queued","status_url":"/v1/jobs/job_7641d5f0-717d-4b70-a2f1-f58d846d7242","results_url":"/v1/jobs/job_7641d5f0-717d-4b70-a2f1-f58d846d7242/results","cost":"$0.0000","item_count":null,"error":null,"retry_at":null,"total":1,"done_count":0,"failed_count":0,"created_at":"2026-10-12T12:56:17.403Z","started_at":null,"finished_at":null},"meta":{"cost":"$0.0000","request_id":"req_job_example"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"404":{"description":"`cached=cache_only` found nothing saved for these arguments (`not_cached`; call again with `cached=auto` to fetch it), or the YouTube account or item does not exist (`not_found`). You are not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_cached","message":"no saved youtube/video_comments read for '0e3GPea1Tyg'. cached=cache_only never fetches, so call again with cached=auto to fetch it. You are not charged.","request_id":"req_5c10900e919bc7a3ff79b7501d582b4c"}}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/youtube/video_comment_replies":{"get":{"tags":["YouTube"],"operationId":"ytVideoCommentReplies","summary":"video_comment_replies","x-dashboard-cost":"$0.0005/20","x-example-query":{"replies_token":"Eg0SCzBlM0dQZWExVHlnGAYygwEaUBIaVWd6SDh2bGlRU0pLSFFNR1pqeDRBYUFCQWciAggAKhhVQ1g2T1EzRGtjc2JZTkU2SDh1UVF1VkEyCzBlM0dQZWExVHlnQABICoIBAggBQi9jb21tZW50LXJlcGxpZXMtaXRlbS1VZ3pIOHZsaVFTSktIUU1HWmp4NEFhQUJBZw==","max_pages":"1"},"description":"The replies to one comment. With max_pages=1, returns `Page[Comment]` under `data`; with `get_raw=true` returns the upstream JSON.\n\nThe default request creates a durable job (202). Use max_pages=1 for one synchronous Page response (200). Poll status_url, then read results_url with its opaque cursor. Acquisition stops at the first of since, max_pages, or exhaustion. Jobs continue after disconnects. Result responses are bounded to 3 MiB; this does not limit the crawl. Supply Idempotency-Key to recover a lost submission response; reuse it with the same inputs. YouTube sets every page’s size, so there is no `page_size`.\n\nA field YouTube does not carry is null, a list it does not carry is `[]`, and YouTube-only facts sit under `extra`. Unknown, unsupported, and repeated query parameters return 400 before acquisition or billing.\n\nBilling: $0.0005 per 20 unique returned items (one native page), rounded up to a minimum of one billing unit; a `get_raw=true` page bills one unit. Jobs settle once after successful completion. Submission, polling and repeat downloads are free.","security":[{"bearerAuth":[]}],"parameters":[{"name":"replies_token","in":"query","required":true,"description":"A comment’s `extra.replies_token` from `/v1/youtube/video_comments`.","example":"Eg0SCzBlM0dQZWExVHlnGAYygwEaUBIaVWd6SDh2bGlRU0pLSFFNR1pqeDRBYUFCQWciAggAKhhVQ1g2T1EzRGtjc2JZTkU2SDh1UVF1VkEyCzBlM0dQZWExVHlnQABICoIBAggBQi9jb21tZW50LXJlcGxpZXMtaXRlbS1VZ3pIOHZsaVFTSktIUU1HWmp4NEFhQUJBZw==","schema":{"type":"string"}},{"name":"since","in":"query","required":false,"description":"Not accepted on this operation: its items carry no timestamp, so since returns 400 before billing.","schema":{"type":"string"}},{"name":"max_pages","in":"query","required":false,"example":1,"description":"Maximum pages to fetch. -1 walks until exhaustion or since with no page cap, and must be written. Omitted, since alone bounds the walk; with neither, the job stops after 10 pages. Any positive integer is accepted. 1 returns one page synchronously with HTTP 200; any other value creates a durable job with HTTP 202.","schema":{"type":"integer","anyOf":[{"enum":[-1]},{"minimum":1}]}},{"name":"cursor","in":"query","required":false,"description":"Opaque next_cursor from an earlier answer of this operation, also with `get_raw=true`. A native YouTube cursor from a raw page answers 400. Result download cursors belong to the results route.","schema":{"type":"string","minLength":1}},{"name":"cached","in":"query","required":false,"description":"`auto` (default) serves a read saved within the last 24 hours for these exact arguments, otherwise fetches. `cache_only` never contacts YouTube (404 `not_cached` when nothing is saved, whatever its age). `live` always fetches. Anything else is a `400`. `cache_only` reads one saved page per request: omit `max_pages` or pass 1, and continue with `next_cursor`.","schema":{"type":"string","enum":["auto","cache_only","live"],"default":"auto"},"examples":{"default":{"value":"auto","x-disabled":true}}},{"name":"get_raw","in":"query","required":false,"description":"`true` returns the upstream JSON exactly as YouTube answered it instead of the normalized `Page[Comment]`.","schema":{"type":"boolean","default":false},"examples":{"default":{"value":false,"x-disabled":true}}},{"name":"Idempotency-Key","in":"header","required":false,"description":"Reuse this key with the same inputs to recover a lost job submission. A different input with the same key returns 409.","schema":{"type":"string","minLength":1,"maxLength":200}}],"responses":{"200":{"description":"`Page[Comment]` under `data`; with `get_raw=true` the upstream JSON.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"anyOf":[{"type":"object","required":["items","pages","next_cursor","has_more","stop_reason","coverage"],"properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/Comment"},"description":"`Comment` of every page walked, in page order."},"pages":{"type":"array","items":{"$ref":"#/components/schemas/PageRead"},"description":"One entry per page walked."},"next_cursor":{"type":"string","nullable":true,"description":"Opaque; pass back as `cursor` to continue."},"has_more":{"type":"boolean","description":"True when `next_cursor` is set, and when the walk stopped `cursor_stalled` on a page that said more results exist but gave no cursor to send back."},"stop_reason":{"type":"string","enum":["pages","since","exhausted","cursor_stalled","repeated_content","deadline","blocked","caught_up"],"description":"Why the walk stopped. `pages`: the page budget is spent and `next_cursor` continues it. `deadline`: the call ran out of time before its next page; `next_cursor` continues it. `since`: a whole page was older than `since`. `exhausted`: YouTube reported the end. `cursor_stalled`: YouTube claimed more but repeated or omitted its cursor. `repeated_content`: a page held only items already seen. `blocked`: YouTube refused a later page; `next_cursor` is the page it refused. `caught_up`: only watch passes the crawler runs for itself stop this way."},"coverage":{"$ref":"#/components/schemas/Coverage"}}},{"type":"object","additionalProperties":true}],"description":"`Page[Comment]`, or the upstream JSON when `get_raw=true`."},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"items":[{"id":"UgzKYksqeQ5gA3t0g0F4AaABAg.91a9XW7osVT952pvnnAzll","text":"The biggest comrade ever","created_at":null,"likes":6900,"replies":2,"liked_by_owner":null,"owner":{"id":"UCWU69Qbi3A6Bzx4xU-UeK7g","username":"egdog_tm","full_name":"@egdog_tm","is_verified":null,"is_private":null,"avatar_url":"https://yt3.ggpht.com/1glim4K6lUrgwfThCmliOU7tTxWQ6Tnl2VSEZKFQNxn5braBtYx8bcljKcvw1U0Cv9LlbcfqIg=s88-c-k-c0x00ffffff-no-rj","latest_story_at":null,"extra":{}},"extra":{"published_text":"6 years ago","parent_id":"UgzKYksqeQ5gA3t0g0F4AaABAg","replies_token":null}},{"id":"UgzKYksqeQ5gA3t0g0F4AaABAg.91a9XW7osVT953cxv6qamK","text":"You sir, are a legend","created_at":null,"likes":6300,"replies":2,"liked_by_owner":null,"owner":{"id":"UCFVN9hXPkEfbWBCdNZW6ezA","username":"andrejhofer2007","full_name":"@andrejhofer2007","is_verified":null,"is_private":null,"avatar_url":"https://yt3.ggpht.com/ytc/AIdro_nHNmhgK4mtwlkvbYzWQNsHe7dvV4nJKisK6SmVW8O7u9Pa8T0cWxyinae9f8_eisKzEw=s88-c-k-c0x00ffffff-no-rj","latest_story_at":null,"extra":{}},"extra":{"published_text":"6 years ago","parent_id":"UgzKYksqeQ5gA3t0g0F4AaABAg","replies_token":null}},{"id":"UgzKYksqeQ5gA3t0g0F4AaABAg.91a9XW7osVT961rS_2wf3F","text":"respect","created_at":null,"likes":4600,"replies":4,"liked_by_owner":null,"owner":{"id":"UC6BLT7n-EQnEILjILxvaJXg","username":"Kanenfan","full_name":"@Kanenfan","is_verified":null,"is_private":null,"avatar_url":"https://yt3.ggpht.com/Q0hjeewb2BhpoOKOEYJ9vBJU-IwUX2aKsnHJhod_RP97N2QQMpcAvikjLpXwQwPoSbWP-9qy=s88-c-k-c0x00ffffff-no-rj","latest_story_at":null,"extra":{}},"extra":{"published_text":"6 years ago","parent_id":"UgzKYksqeQ5gA3t0g0F4AaABAg","replies_token":null}}],"pages":[{"cursor":null,"fetched_at":"2026-10-15T10:27:57.650746+00:00","count":3}],"next_cursor":"eyJjb250aW51YXRpb24iOiJFZzBTQzJSUmR6UjNPVmRuV0dOUkdBWXkyZ0VLVTJkbGRGOWpiMjF0Wlc1MFgzZHBkR2hmY21Wd2JHbGxjMTl6ZEhKbFlXMHRMVU5uWjBsblFWRldSamRtVWs5Q1NVWkRTMEZuUjBGRmFVUm5iMDFEUzJKWUxWQk5Sa1ZMYW5WdGRIZERWVUZDV1VGUkdsQVNHbFZuZWt0WmEzTnhaVkUxWjBFemREQm5NRVkwUVdGQlFrRm5JZ0lJQUNvWVZVTjFRVmhHYTJkemR6Rk1OM2hoUTJadVpEVktTazkzTWd0a1VYYzBkemxYWjFoalVVQUJTREtDQVFJSUFTZ0tRaTlqYjIxdFpXNTBMWEpsY0d4cFpYTXRhWFJsYlMxVlozcExXV3R6Y1dWUk5XZEJNM1F3WnpCR05FRmhRVUpCWnclM0QlM0QiLCJvcCI6InZpZGVvX2NvbW1lbnRfcmVwbGllcyJ9","has_more":true,"stop_reason":"pages","coverage":{"since":null,"oldest_at":null,"since_reached":false}},"meta":{"source":"live","fetched_at":"2026-10-15T10:27:57.650746+00:00","cost":"$0.0005","balance":"$9.9995","request_id":"req_202a93d41e9e97a0317c7c08eee6e5fd"}}}}},"202":{"description":"Durable job accepted. No completed-result charge. Save batch_id; poll status_url. Retry submission with the same Idempotency-Key after a lost response. An account may have five queued, running or payment-required jobs. A sixth new job returns 429 rate_limited. Matching idempotent replays still work at the limit. Ready and failed jobs release their slots; pages within a job remain unbounded. This is a synthetic contract example, not a live capture.","x-example-provenance":"synthetic-contract","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","required":["batch_id","status","status_url","results_url","cost","item_count","error","retry_at","total","done_count","failed_count","created_at","started_at","finished_at"],"properties":{"batch_id":{"type":"string"},"status":{"type":"string","enum":["queued","running","payment_required","ready","failed"]},"status_url":{"type":"string"},"results_url":{"type":"string"},"cost":{"type":"string"},"item_count":{"type":"integer","nullable":true},"error":{"type":"string","nullable":true,"description":"Null unless failed. A failed target carries its own code; incomplete_result appears only when it has none and pages of the result are missing. profile_not_found, post_not_found, upstream_not_found or not_found: the target does not exist or is not visible. not_visible: The account exists, but its posts are not visible to logged-out readers (private, restricted, or hidden by Instagram). Retrying will not change the result until the account changes. not_cached: cached=cache_only found no saved read. incomplete_result: pages of the result are missing. temporarily_unavailable: the target could not be read for now (no capacity, a pause or repeated refusals); retry later with a new job. result_item_too_large: one result unit exceeds the delivery budget. result_snapshot_missing or result_snapshot_corrupt: the crawler could not serve the retained result of a paid job, and its charge is refunded; if the crawler serves it again, a later results read returns it and charges the job again. crawler_submit_400, crawler_submit_404 or crawler_submit_422: the crawl service refused the job request. crawler_job_failed: any other failure; the same job is not expected to succeed if resubmitted. cancelled: the job was cancelled with POST /v1/jobs/{job_id}/cancel. No failed job costs anything: only result_snapshot_missing and result_snapshot_corrupt follow a charge, and that charge is refunded."},"retry_at":{"type":"string","format":"date-time","nullable":true,"description":"Null unless the job failed temporarily_unavailable because a crawl route was closed for every caller. Then it is when the route opens again, and the response carries the same time as a Retry-After header in seconds. Submit a new job after it."},"total":{"type":"integer","description":"Targets in the job. A job submitted through a /v1 route has one."},"done_count":{"type":"integer","description":"Targets the crawler finished."},"failed_count":{"type":"integer","description":"Targets that failed."},"created_at":{"type":"string","format":"date-time","description":"When the job was submitted."},"started_at":{"type":"string","format":"date-time","nullable":true,"description":"When the crawler started the job. Null until it starts."},"finished_at":{"type":"string","format":"date-time","nullable":true,"description":"When the job finished or failed. Null while it is queued or running."}}},"meta":{"type":"object","required":["cost","request_id"],"properties":{"cost":{"type":"string","example":"$0.0000"},"request_id":{"type":"string"}}}}},"example":{"data":{"batch_id":"job_7641d5f0-717d-4b70-a2f1-f58d846d7242","status":"queued","status_url":"/v1/jobs/job_7641d5f0-717d-4b70-a2f1-f58d846d7242","results_url":"/v1/jobs/job_7641d5f0-717d-4b70-a2f1-f58d846d7242/results","cost":"$0.0000","item_count":null,"error":null,"retry_at":null,"total":1,"done_count":0,"failed_count":0,"created_at":"2026-10-12T12:56:17.403Z","started_at":null,"finished_at":null},"meta":{"cost":"$0.0000","request_id":"req_job_example"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"404":{"description":"`cached=cache_only` found nothing saved for these arguments (`not_cached`; call again with `cached=auto` to fetch it), or the YouTube account or item does not exist (`not_found`). You are not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_cached","message":"no saved youtube/video_comment_replies read for 'Eg0SCzBlM0dQZWExVHlnGAYygwEaUBIaVWd6SDh2bGlRU0pLSFFNR1pqeDRBYUFCQWciAggAKhhVQ1g2T1EzRGtjc2JZTkU2SDh1UVF1VkEyCzBlM0dQZWExVHlnQABICoIBAggBQi9jb21tZW50LXJlcGxpZXMtaXRlbS1VZ3pIOHZsaVFTSktIUU1HWmp4NEFhQUJBZw=='. cached=cache_only never fetches, so call again with cached=auto to fetch it. You are not charged.","request_id":"req_5c10900e919bc7a3ff79b7501d582b4c"}}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/youtube/video_transcript":{"get":{"tags":["YouTube"],"operationId":"ytVideoTranscript","summary":"video_transcript","x-dashboard-cost":"$0.0005","x-example-query":{"video_id":"0e3GPea1Tyg"},"description":"The video's caption track in one language as timed segments and text. This reads captions YouTube already has; it does not transcribe. A video with no track in that language answers 404 `no_captions` and is not billed. Returns `YouTubeTranscript` under `data`; with `get_raw=true` returns the upstream JSON.\n\nA field YouTube does not carry is null, a list it does not carry is `[]`, and YouTube-only facts sit under `extra`. Unknown, unsupported, and repeated query parameters return 400 before acquisition or billing.","security":[{"bearerAuth":[]}],"parameters":[{"name":"video_id","in":"query","required":true,"description":"An 11-character video id, or a watch, Shorts, live, embed or youtu.be URL.","example":"0e3GPea1Tyg","schema":{"type":"string"}},{"name":"language","in":"query","required":false,"description":"The language YouTube answers in, a BCP-47 code such as `en` or `pt-BR`; omitted is `en`.","schema":{"type":"string"}},{"name":"cached","in":"query","required":false,"description":"`auto` (default) serves a read saved within the last 24 hours for these exact arguments, otherwise fetches. `cache_only` never contacts YouTube (404 `not_cached` when nothing is saved, whatever its age). `live` always fetches. Anything else is a `400`.","schema":{"type":"string","enum":["auto","cache_only","live"],"default":"auto"},"examples":{"default":{"value":"auto","x-disabled":true}}},{"name":"get_raw","in":"query","required":false,"description":"`true` returns the upstream JSON exactly as YouTube answered it instead of the normalized `YouTubeTranscript`.","schema":{"type":"boolean","default":false},"examples":{"default":{"value":false,"x-disabled":true}}}],"responses":{"200":{"description":"`YouTubeTranscript` under `data`; with `get_raw=true` the upstream JSON.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"anyOf":[{"$ref":"#/components/schemas/YouTubeTranscript"},{"type":"object","additionalProperties":true}],"description":"`YouTubeTranscript`, or the upstream JSON when `get_raw=true`."},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"video_id":"0e3GPea1Tyg","language":"en","language_name":"English","text":"- [Mr. Beast] I've recreated every single set from Squid Game in real life, and whichever one of these 456 people survives the longest, wins 456 grand. (contestants cheering) The first game we're gonna play is red light, green light. They have 30 minutes to cross the red line on the other side of the huge room. So without further ado, green light. (tense music) Red light. (gun shot) Oh, oh. And as you can see, every single player has a device strapped to them, that when they're eliminated, it pops. Chris, you wanna have a chance at one? - Red light. (gun shot) Oh, oh, no. - I know for sure this guy moved. Green light. - Red light. Oh yo, they're dropping. Okay, now some people are getting out. - You gotta get a better spot for the next red light, right? - Mmhmm. - You're fine. - 30 people have gotten out so far. If they move right now, they're out. They have to hold this position until we say green light. And I can take all the time I want, 'cause we still have 23 minutes left. - We gotta get a green light going. This guy's doing a full squat. - Green light. Green light. Oh they all stopped. Red light. (gun shot) Oh. - I called it, I called it. Oh no. - Can you push my glasses up? - Okay. - Do it slowly though, be careful. - Are you good? - Yeah, perfect. - Okay. Green light. Red light. You're still moving. She was jogging over here. We're gonna go see who's in the very back. You are in dead last. What's going on? - I let the others clear the path for me. - You literally haven't even moved. - Well, a couple steps. - We'll see if it pans out, green light. Yellow, red light. Oh, that we got her, the yellow light worked. - Oh, that was diabolical to throw a yellow light out there. - Since 067 was a big part of the show. I'll let you say green light. - [All] Green light. - Red light, yo, it would be funny if she just got out. As you can see, over 100 people have been eliminated. Do the honors, Chandler. - Green light, red light. (gun shot) - [Mr. Beast] Oh, that was a l…","segments":[{"text":"- [Mr. Beast] I've recreated every single set from Squid Game in real life, and whichever one of these 456 people survives the longest, wins 456 grand.","start_ms":0,"duration_ms":9000},{"text":"(contestants cheering) The first game we're gonna play is red light, green light.","start_ms":9000,"duration_ms":4000}],"segments_complete":true},"meta":{"source":"db","fetched_at":"2026-07-21T15:12:06.655918+00:00","cost":"$0.0005","balance":"$3.3557","request_id":"req_e4ceffba450b3f58066a5352f5323298"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"404":{"description":"`cached=cache_only` found nothing saved for these arguments (`not_cached`; call again with `cached=auto` to fetch it), or the YouTube account or item does not exist (`not_found`). You are not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_cached","message":"no saved youtube/video_transcript read for '0e3GPea1Tyg'. cached=cache_only never fetches, so call again with cached=auto to fetch it. You are not charged.","request_id":"req_5c10900e919bc7a3ff79b7501d582b4c"}}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/youtube/video_sponsors":{"get":{"tags":["YouTube"],"operationId":"ytVideoSponsors","summary":"video_sponsors","x-dashboard-cost":"$0.0010","x-example-query":{"video_id":"0e3GPea1Tyg"},"description":"Sponsor names the description or caption track states, with the phrase that names each. This is our heuristic, not YouTube's own list. Returns `YouTubeSponsors` under `data`; with `get_raw=true` returns the upstream JSON.\n\nA field YouTube does not carry is null, a list it does not carry is `[]`, and YouTube-only facts sit under `extra`. Unknown, unsupported, and repeated query parameters return 400 before acquisition or billing.","security":[{"bearerAuth":[]}],"parameters":[{"name":"video_id","in":"query","required":true,"description":"An 11-character video id, or a watch, Shorts, live, embed or youtu.be URL.","example":"0e3GPea1Tyg","schema":{"type":"string"}},{"name":"language","in":"query","required":false,"description":"The language YouTube answers in, a BCP-47 code such as `en` or `pt-BR`; omitted is `en`.","schema":{"type":"string"}},{"name":"cached","in":"query","required":false,"description":"`auto` (default) serves a read saved within the last 24 hours for these exact arguments, otherwise fetches. `cache_only` never contacts YouTube (404 `not_cached` when nothing is saved, whatever its age). `live` always fetches. Anything else is a `400`.","schema":{"type":"string","enum":["auto","cache_only","live"],"default":"auto"},"examples":{"default":{"value":"auto","x-disabled":true}}},{"name":"get_raw","in":"query","required":false,"description":"`true` returns the upstream JSON exactly as YouTube answered it instead of the normalized `YouTubeSponsors`.","schema":{"type":"boolean","default":false},"examples":{"default":{"value":false,"x-disabled":true}}}],"responses":{"200":{"description":"`YouTubeSponsors` under `data`; with `get_raw=true` the upstream JSON.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"anyOf":[{"$ref":"#/components/schemas/YouTubeSponsors"},{"type":"object","additionalProperties":true}],"description":"`YouTubeSponsors`, or the upstream JSON when `get_raw=true`."},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"video_id":"0e3GPea1Tyg","is_paid_partnership":false,"sponsors":[{"name":"beastgames.com","confidence":0.35,"evidence":"https://www.beastgames.com","source":"description_link"},{"name":"prf.hn","confidence":0.35,"evidence":"https://prf.hn/l/6bNbQB3","source":"description_link"}]},"meta":{"source":"db","fetched_at":"2026-07-21T13:47:07.073680+00:00","cost":"$0.0010","balance":"$3.3542","request_id":"req_73df0dfc30911743f00da430175f738f"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"404":{"description":"`cached=cache_only` found nothing saved for these arguments (`not_cached`; call again with `cached=auto` to fetch it), or the YouTube account or item does not exist (`not_found`). You are not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_cached","message":"no saved youtube/video_sponsors read for '0e3GPea1Tyg'. cached=cache_only never fetches, so call again with cached=auto to fetch it. You are not charged.","request_id":"req_5c10900e919bc7a3ff79b7501d582b4c"}}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/youtube/video_thumbnails":{"get":{"tags":["YouTube"],"operationId":"ytVideoThumbnails","summary":"video_thumbnails","x-dashboard-cost":"$0.0005","x-example-query":{"video_id":"0e3GPea1Tyg"},"description":"Every thumbnail size the watch page names. Returns `YouTubeThumbnail[]` under `data`; with `get_raw=true` returns the upstream JSON.\n\nA field YouTube does not carry is null, a list it does not carry is `[]`, and YouTube-only facts sit under `extra`. Unknown, unsupported, and repeated query parameters return 400 before acquisition or billing.","security":[{"bearerAuth":[]}],"parameters":[{"name":"video_id","in":"query","required":true,"description":"An 11-character video id, or a watch, Shorts, live, embed or youtu.be URL.","example":"0e3GPea1Tyg","schema":{"type":"string"}},{"name":"cached","in":"query","required":false,"description":"`auto` (default) serves a read saved within the last 24 hours for these exact arguments, otherwise fetches. `cache_only` never contacts YouTube (404 `not_cached` when nothing is saved, whatever its age). `live` always fetches. Anything else is a `400`.","schema":{"type":"string","enum":["auto","cache_only","live"],"default":"auto"},"examples":{"default":{"value":"auto","x-disabled":true}}},{"name":"get_raw","in":"query","required":false,"description":"`true` returns the upstream JSON exactly as YouTube answered it instead of the normalized `YouTubeThumbnail[]`.","schema":{"type":"boolean","default":false},"examples":{"default":{"value":false,"x-disabled":true}}}],"responses":{"200":{"description":"`YouTubeThumbnail[]` under `data`; with `get_raw=true` the upstream JSON.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"anyOf":[{"type":"array","items":{"$ref":"#/components/schemas/YouTubeThumbnail"}},{"type":"object","additionalProperties":true}],"description":"`YouTubeThumbnail[]`, or the upstream JSON when `get_raw=true`."},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":[{"url":"https://i.ytimg.com/vi/0e3GPea1Tyg/hqdefault.jpg?sqp=-oaymwEmCKgBEF5IWvKriqkDGQgBFQAAiEIYAdgBAeIBCggYEAIYBjgBQAE=&rs=AOn4CLAhlks90rgUnxrHv_-nmRqcAP5Apw","width":168,"height":94},{"url":"https://i.ytimg.com/vi/0e3GPea1Tyg/hqdefault.jpg?sqp=-oaymwEmCMQBEG5IWvKriqkDGQgBFQAAiEIYAdgBAeIBCggYEAIYBjgBQAE=&rs=AOn4CLA_equnQIAwRdbpvLLAIKn9KPTdmw","width":196,"height":110}],"meta":{"source":"db","fetched_at":"2026-07-21T13:47:03.099132+00:00","cost":"$0.0005","balance":"$3.3537","request_id":"req_da8d11576c2d5b767242fbaf3675686d"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"404":{"description":"`cached=cache_only` found nothing saved for these arguments (`not_cached`; call again with `cached=auto` to fetch it), or the YouTube account or item does not exist (`not_found`). You are not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_cached","message":"no saved youtube/video_thumbnails read for '0e3GPea1Tyg'. cached=cache_only never fetches, so call again with cached=auto to fetch it. You are not charged.","request_id":"req_5c10900e919bc7a3ff79b7501d582b4c"}}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/youtube/profile_full":{"get":{"tags":["YouTube"],"operationId":"ytProfileFull","summary":"profile_full","x-dashboard-cost":"$0.0010","x-example-query":{"handle":"@MrBeast"},"description":"The channel, its newest videos read from their watch pages, and engagement, cadence and format figures over them. `posts` is how many videos to read, 1 to 100, default 25. Returns `YouTubeProfileFull` under `data`; with `get_raw=true` returns the upstream JSON.\n\nA field YouTube does not carry is null, a list it does not carry is `[]`, and YouTube-only facts sit under `extra`. Unknown, unsupported, and repeated query parameters return 400 before acquisition or billing.","security":[{"bearerAuth":[]}],"parameters":[{"name":"handle","in":"query","required":true,"description":"A channel @handle, its `UC…` channel id, or a youtube.com/@handle or /channel/ URL. Handles are case-sensitive.","example":"@MrBeast","schema":{"type":"string"}},{"name":"posts","in":"query","required":false,"description":"How many of the newest videos to read, 1 to 100; omitted is 25.","schema":{"type":"integer","minimum":1,"maximum":100,"default":25},"examples":{"default":{"value":25,"x-disabled":true}}},{"name":"cached","in":"query","required":false,"description":"`auto` (default) serves a read saved within the last 24 hours for these exact arguments, otherwise fetches. `cache_only` never contacts YouTube (404 `not_cached` when nothing is saved, whatever its age). `live` always fetches. Anything else is a `400`.","schema":{"type":"string","enum":["auto","cache_only","live"],"default":"auto"},"examples":{"default":{"value":"auto","x-disabled":true}}},{"name":"get_raw","in":"query","required":false,"description":"`true` returns the upstream JSON exactly as YouTube answered it instead of the normalized `YouTubeProfileFull`.","schema":{"type":"boolean","default":false},"examples":{"default":{"value":false,"x-disabled":true}}}],"responses":{"200":{"description":"`YouTubeProfileFull` under `data`; with `get_raw=true` the upstream JSON.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"anyOf":[{"$ref":"#/components/schemas/YouTubeProfileFull"},{"type":"object","additionalProperties":true}],"description":"`YouTubeProfileFull`, or the upstream JSON when `get_raw=true`."},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"profile":{"id":"UCX6OQ3DkcsbYNE6H8uQQuVA","username":"MrBeast","full_name":"MrBeast","biography":"SUBSCRIBE FOR A COOKIE!\nNew MrBeast or MrBeast Gaming video every single Saturday at noon eastern time!\nAccomplishments:\n- Raised $20,000,000 To Plant 20,000,000 Trees\n- Removed 30,000,000 pounds of trash from the ocean\n- Helped 2,000 people walk again\n- Helped 1,000 blind people see\n- Helped 1,000 deaf people hear\n- Built wells in Africa\n- Built and gave away 100 houses\n- Adopted every dog in a shelter (twice)\n- Given millions to charity\n- Started my own snack company Feastables\n- Started my own software company Viewstats\n- Gave away a private island (twice)\n- Gave away 1 million meals\n- I counted to 100k\n- Ran a marathon in the world's largest shoes\n- Survived 50 hours in Antarctica\n- Recreated Squid Game in real life\n- Created the largest competition show with 1000 people (Beast Games)\n- Gave $5,000,000 to one person\n\nTerms & Conditions of Current Sweepstakes: \nhttps://mrb.gg/bow-and-arrow\nhttps://bit.ly/MrB_Birthday_YT\nhttps://bit.ly/MrB_Cash_Giveaway\n\n\n","followers":509000000,"following":null,"posts":993,"is_verified":true,"is_private":null,"avatar_url":"https://yt3.googleusercontent.com/nxYrc_1_2f77DoBadyxMTmv7ZpRZapHR5jbuYe7PlPd5cIRJxtNNEYyOC0ZsxaDyJJzXrnJiuDE=s68-c-k-c0x00ffffff-no-rj","external_url":"https://www.themostdangerousgames.com/","links":[{"url":"https://www.themostdangerousgames.com/","title":null},{"url":"https://www.instagram.com/mrbeast/","title":null}],"category":null,"business_category":null,"is_business":null,"is_professional":null,"business_email":null,"business_phone":null,"business_address":null,"pronouns":[],"highlight_reel_count":null,"has_clips":null,"is_recently_joined":null,"fbid":null,"extra":{"banner_url":"https://yt3.googleusercontent.com/mHMO_eEMp0dPvh0ADwXhPXNYb_GnjSVsLI8biqF1CpxT8OPl7izhNQsDPD3JHhd5y5Mg9GrP=w2560-fcrop64=1,00005a57ffffa5a8-k-c0xffffffff-no-nd-rj","view_count":134087957302,"country":"United States","joined_date":"2012-02-19T00:00:00Z","keywords":null}},"posts":[{"id":"iYlODtkyw_I","shortcode":null,"taken_at":"2026-06-27T16:00:05+00:00","kind":"video","product_type":"video","caption":null,"hashtags":[],"mentions":[],"accessibility_caption":null,"likes":1532487,"comments":null,"views":76958980,"counts_hidden":null,"comments_disabled":null,"is_pinned":null,"is_paid_partnership":null,"owner":{"id":"UCX6OQ3DkcsbYNE6H8uQQuVA","username":"MrBeast","full_name":"MrBeast","is_verified":null,"is_private":null,"avatar_url":null,"latest_story_at":null,"extra":{}},"coauthors":[],"sponsors":[],"tagged":[],"location":null,"audio":null,"thumbnail_url":"https://i.ytimg.com/vi/iYlODtkyw_I/maxresdefault.jpg","video_duration":2104,"media":[],"media_urls":[],"extra":{"title":"Survive 30 Days Chained To A Stranger, Win $250,000","url":"https://www.youtube.com/watch?v=iYlODtkyw_I","published_text":null}},{"id":"__fmDj0ZJ1Q","shortcode":null,"taken_at":"2026-06-13T16:00:00+00:00","kind":"video","product_type":"video","caption":null,"hashtags":[],"mentions":[],"accessibility_caption":null,"likes":2161944,"comments":null,"views":74644496,"counts_hidden":null,"comments_disabled":null,"is_pinned":null,"is_paid_partnership":null,"owner":{"id":"UCX6OQ3DkcsbYNE6H8uQQuVA","username":"MrBeast","full_name":"MrBeast","is_verified":null,"is_private":null,"avatar_url":null,"latest_story_at":null,"extra":{}},"coauthors":[],"sponsors":[],"tagged":[],"location":null,"audio":null,"thumbnail_url":"https://i.ytimg.com/vi/__fmDj0ZJ1Q/maxresdefault.jpg","video_duration":1927,"media":[],"media_urls":[],"extra":{"title":"50 YouTube Legends Fight For $1,000,000","url":"https://www.youtube.com/watch?v=__fmDj0ZJ1Q","published_text":null}}],"computed":{"average_engagement_rate":0.022639238112403506,"posting_cadence_per_week":0.5001654905291819,"cadence_window_days":125.95831018518518,"top_post":{"id":"zRtGL0-5rg4","title":"Last To Leave Grocery Store, Wins $250,000","url":"https://www.youtube.com/watch?v=zRtGL0-5rg4","thumbnail":"https://i.ytimg.com/vi/zRtGL0-5rg4/maxresdefault.jpg","views":171973798,"likes":3299593,"comments":null,"published_at":"2026-04-18T16:00:01+00:00","published_text":null,"duration_seconds":2577,"is_short":false,"is_live_content":false,"channel_handle":"MrBeast","channel_id":null},"format_mix":{"shorts":0,"live":0,"videos":10}}},"meta":{"source":"live","fetched_at":"2026-07-22T10:56:17.656628+00:00","cost":"$0.0010","balance":"$3.0845","request_id":"req_0a7a234c6652e17a364b67f6cb733531"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"404":{"description":"`cached=cache_only` found nothing saved for these arguments (`not_cached`; call again with `cached=auto` to fetch it), or the YouTube account or item does not exist (`not_found`). You are not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_cached","message":"no saved youtube/profile_full read for '@MrBeast'. cached=cache_only never fetches, so call again with cached=auto to fetch it. You are not charged.","request_id":"req_5c10900e919bc7a3ff79b7501d582b4c"}}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/linkedin/stored/company":{"get":{"tags":["LinkedIn"],"operationId":"liStoredCompany","summary":"Stored company","description":"One stored company page with its size, industry, headquarters and followers.\n\nStrictly DB: this reads what the crawler already stored and never crawls. A miss is a `404` and is not billed. Fetch a fresh one with `/v1/linkedin/company`.","x-dashboard-cost":"$0.0005","security":[{"bearerAuth":[]}],"parameters":[{"name":"q","in":"query","required":true,"description":"A company slug or linkedin.com/company URL, or its numeric company id.","example":"microsoft","schema":{"type":"string","maxLength":300,"example":"microsoft"}}],"responses":{"200":{"description":"Success. The example is a captured response; long lists are truncated.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":true},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"linkedin_company_id":"1035","canonical_urn":"urn:li:organization:1035","slug":"microsoft","name":"Microsoft","description":"Every company has a mission. What's ours? To empower every person and every organization to achieve more. We believe technology can and should be a force for good and that meaningful innovation contributes to a brighter world in the future and today. Our culture doesn’t just encourage curiosity; it embraces it. Each day we make progress together by showing up as our authentic selves. We show up with a learn-it-all mentality. We show up cheering on others, knowing their success doesn't diminish our own. We show up every day open to learning our own biases, changing our behavior, and inviting in differences. Because impact matters. \n\nMicrosoft operates in 190 countries and is made up of approximately 228,000 passionate employees worldwide.","industry":"Software Development","company_size_text":"10,001+ employees","company_size_min":null,"company_size_max":null,"employee_count":231136,"headquarters":"Redmond, Washington","website":"https://www.linkedin.com/redir/redirect?url=https%3A%2F%2Fnews%2Emicrosoft%2Ecom%2F&urlhash=sqqa&trk=about_website","logo_url":"https://media.licdn.com/dms/image/v2/D560BAQH32RJQCl3dDQ/company-logo_200_200/B56ZYQ0mrGGoAM-/0/1744038948046/microsoft_logo?e=2147483647&v=beta&t=ts9MGrTk7Lz3R1bmAfzCL8euuuuPWPCoXfdiLA2_IzM","followers":29386865,"organization_type":"Public Company","founded_year":null,"specialties":["Business Software","Developer Tools","Home & Educational Software","Tablets","Search","Advertising","Servers","Windows Operating System","Windows Applications & Platforms","Smartphones","Cloud Computing","Quantum Computing","Future of Work","Productivity","AI","Artificial Intelligence","Machine Learning","Laptops","Mixed Reality","Virtual Reality","Gaming","Developers","and IT Professional"],"locations":[],"funding":{},"job_count":2000,"job_count_exact":false,"job_count_lower_bound":true,"first_scraped_at":"2026-08-10T09:07:10.751091Z","last_scraped_at":"2026-10-27T20:42:43.462566Z"},"meta":{"cost":"$0.0005","balance":"$0.9835","request_id":"req_7e4e405c818e431293b08b7b649a7152"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"404":{"description":"The company is not stored. You are not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/linkedin/stored/company/posts":{"get":{"tags":["LinkedIn"],"operationId":"liStoredCompanyPosts","summary":"Stored company posts","description":"The stored posts of one company. Newest first, with an opaque `next_cursor` while `has_more` is true; send it back as `cursor`.\n\nStrictly DB: this reads what the crawler already stored and never crawls. A miss is a `404` and is not billed.","x-dashboard-cost":"$0.0005","security":[{"bearerAuth":[]}],"parameters":[{"name":"q","in":"query","required":true,"description":"A company slug or linkedin.com/company URL, or its numeric company id.","example":"microsoft","schema":{"type":"string","maxLength":300,"example":"microsoft"}},{"name":"cursor","in":"query","required":false,"description":"`next_cursor` from the previous page.","schema":{"type":"string","maxLength":200}},{"name":"limit","in":"query","required":false,"description":"Rows per page.","schema":{"type":"integer","minimum":1,"maximum":100,"default":30},"examples":{"default":{"value":30,"x-disabled":true}}}],"responses":{"200":{"description":"Success. The example is a captured response; long lists are truncated.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":true},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"posts":[{"linkedin_activity_id":"7520878131965091840","canonical_urn":"urn:li:activity:7520878131965091840","author_display_name":"Microsoft","author_urn":"urn:li:organization:1035","caption":"Information overload is real. What if you could lighten it?\n \nIn the October edition of The Monthly Tech-In, we explore how AI is increasingly helping people turn mounds of data into action.\n \nAt the office, the new Microsoft Copilot is changing how work gets done. In the field, emergency responders are using Microsoft's HASTE system to analyze cities after natural disasters to see which neighborhoods and roads were hit the hardest. And with an eye toward the moon, NASA is increasingly turning to the technology to extract new insights from its decades of data.\n \nRead on to learn how AI can help distill data in the real world – and beyond it.","likes":337,"comments":14,"reposts":null,"posted_at":"2026-10-27T16:04:37.817000Z","post_url":"https://www.linkedin.com/posts/microsoft_october-2026-the-new-copilot-activity-7520878131965091840-mCcZ","content_type":"text","media_urls":[],"image_url":null,"video_url":null,"is_video":false,"metric_precision":{},"first_seen_at":"2026-10-27T20:42:42.393037Z","last_seen_at":"2026-10-27T20:42:42.597897Z"},{"linkedin_activity_id":"7516505833061474305","canonical_urn":"urn:li:activity:7516505833061474305","author_display_name":"Microsoft","author_urn":"urn:li:organization:1035","caption":"This month, the Microsoft Atlanta team, in partnership with Black in Technology, hosted the 404 Tech Summit (BitCon) for two days of conversations on AI and the future of work with Atlanta's tech community. Great to learn alongside the technologists, students, and leaders shaping what's next.","likes":274,"comments":44,"reposts":null,"posted_at":"2026-10-15T14:30:40.526000Z","post_url":"https://www.linkedin.com/posts/microsoft_this-month-the-microsoft-atlanta-team-in-activity-7516505833061474305-T6ou","content_type":"text","media_urls":[],"image_url":null,"video_url":null,"is_video":false,"metric_precision":{},"first_seen_at":"2026-10-27T20:42:42.393037Z","last_seen_at":"2026-10-27T20:42:42.597897Z"}],"next_cursor":"WzEzMzgsIjIwMjYtMTAtMTVUMTQ6MzA6NDAuNTI2MDAwKzAwOjAwIl0","has_more":true},"meta":{"cost":"$0.0005","balance":"$0.9830","request_id":"req_96b9878fa5227a2e72421c247c6ab806"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"404":{"description":"The company is not stored. You are not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/linkedin/stored/company/jobs":{"get":{"tags":["LinkedIn"],"operationId":"liStoredCompanyJobs","summary":"Stored company jobs","description":"The stored jobs of one company, by publish time. Newest first, with an opaque `next_cursor` while `has_more` is true; send it back as `cursor`.\n\nStrictly DB: this reads what the crawler already stored and never crawls. A miss is a `404` and is not billed. Collect more with `/v1/linkedin/company_jobs`.","x-dashboard-cost":"$0.0005","security":[{"bearerAuth":[]}],"parameters":[{"name":"q","in":"query","required":true,"description":"A company slug or linkedin.com/company URL, or its numeric company id.","example":"microsoft","schema":{"type":"string","maxLength":300,"example":"microsoft"}},{"name":"cursor","in":"query","required":false,"description":"`next_cursor` from the previous page.","schema":{"type":"string","maxLength":200}},{"name":"limit","in":"query","required":false,"description":"Rows per page.","schema":{"type":"integer","minimum":1,"maximum":100,"default":30},"examples":{"default":{"value":30,"x-disabled":true}}}],"responses":{"200":{"description":"Success. The example is a captured response; long lists are truncated.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":true},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"jobs":[{"linkedin_job_id":"4476177880","title":"Senior Applied Scientist - Ads Monetization","location":"Redmond, WA","employment_type":null,"seniority_level":null,"workplace_type":null,"skills":[],"published_at":"2026-10-27T00:00:00Z","expires_at":null,"applicant_count":null,"canonical_url":"https://www.linkedin.com/jobs/view/senior-applied-scientist-ads-monetization-at-microsoft-4476177880","apply_url":null,"extra":{"partial":true,"benefits":"Actively Hiring","company_name":"Microsoft","company_slug":"microsoft","published_at_approximate":false},"first_scraped_at":"2026-10-27T20:42:41.437669Z","last_scraped_at":"2026-10-27T20:42:41.437669Z"},{"linkedin_job_id":"4482875099","title":"Applied Scientist - AI Experiences Search","location":"Redmond, WA","employment_type":null,"seniority_level":null,"workplace_type":null,"skills":[],"published_at":"2026-10-23T00:00:00Z","expires_at":null,"applicant_count":null,"canonical_url":"https://www.linkedin.com/jobs/view/applied-scientist-ai-experiences-search-at-microsoft-4482875099","apply_url":null,"extra":{"partial":true,"benefits":"Actively Hiring","company_name":"Microsoft","company_slug":"microsoft","published_at_approximate":false},"first_scraped_at":"2026-10-27T20:42:41.437669Z","last_scraped_at":"2026-10-27T20:42:41.437669Z"}],"next_cursor":"WzI2MDksIjIwMjYtMTAtMjNUMDA6MDA6MDArMDA6MDAiXQ","has_more":true},"meta":{"cost":"$0.0005","balance":"$0.9825","request_id":"req_13aab3004833767792fc21fc74cb1912"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"404":{"description":"The company is not stored. You are not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/linkedin/stored/company/ads":{"get":{"tags":["LinkedIn"],"operationId":"liStoredCompanyAds","summary":"Stored company ads","description":"The stored Ad Library ads of one advertiser, by first impression day. Newest first, with an opaque `next_cursor` while `has_more` is true; send it back as `cursor`. A numeric `q` reads the advertiser id even when its company page is not stored.\n\nStrictly DB: this reads what the crawler already stored and never crawls. A miss is a `404` and is not billed. Collect more with `/v1/linkedin/company_ads`.","x-dashboard-cost":"$0.0005","security":[{"bearerAuth":[]}],"parameters":[{"name":"q","in":"query","required":true,"description":"A company slug or linkedin.com/company URL, or its numeric company id.","example":"microsoft","schema":{"type":"string","maxLength":300,"example":"microsoft"}},{"name":"cursor","in":"query","required":false,"description":"`next_cursor` from the previous page.","schema":{"type":"string","maxLength":200}},{"name":"limit","in":"query","required":false,"description":"Rows per page.","schema":{"type":"integer","minimum":1,"maximum":100,"default":30},"examples":{"default":{"value":30,"x-disabled":true}}}],"responses":{"200":{"description":"Success. The example is a captured response; long lists are truncated.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":true},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"ads":[{"linkedin_ad_id":"1611650554","advertiser_name":"Microsoft","advertiser_type":"company","advertiser_url":"https://www.linkedin.com/company/1035","advertiser_native_id":"1035","payer":"ZENITH UK (MEDIA) LIMITED","format":"Video Ad","ad_copy":"Every organization wants to move faster with AI. Every IT leader knows that speed without security, compliance and control doesn't last.\n\nJoin me at Microsoft Ignite, November 17–20, to see what's coming across AI and cloud first, and how customers & partners are moving AI from pilot to production – securely, responsibly and at scale.\n\nIn AI, speed and control aren't trade-offs. Done well, each makes the other possible.\n\nJoin us in San Francisco or online for free. See you there!\nRegister today: https://lnkd.in/e78rdssQ\n#MicrosoftIgnite","media_urls":["https://dms.licdn.com/playlist/vid/v2/D4E05AQG7J7AN_LabpQ/mp4-720p-30fp-crf28/B4EaFnsZgOGwCA-/0/1792741057150?e=2147483647&v=beta&t=SYTNC1_Is1NVNv_rTiMDdWJCRf_xrFydpIYCjmfiQdI","https://media.licdn.com/dms/image/v2/D4E05AQG7J7AN_LabpQ/videocover-high/B4EaFnsZgOGwBQ-/0/1792755330776?e=2147483647&v=beta&t=lleAG0LL5vSFmLHZf-N_4v12-gIGtSr5FxfigAhycPg"],"destination_urls":["https://lnkd.in/e78rdssQ"],"impression_start":"2026-10-23","impression_end":"2026-10-27","impressions_exact":null,"impressions_min":300000,"impressions_max":500000,"targeting":{"language":{"includes":["English"]},"location":{"includes":["Greece","Türkiye","Italy","Israel","Malta","Spain","Portugal","Cyprus"]},"parameters":{"job":{"excluded":false,"targeted":true},"company":{"excluded":true,"targeted":false},"audience":{"excluded":false,"targeted":false},"education":{"excluded":false,"targeted":false},"demographic":{"excluded":false,"targeted":false},"member_interests_and_traits":{"excluded":false,"targeted":false}}},"restricted":false,"first_scraped_at":"2026-10-27T20:42:43.487790Z","last_scraped_at":"2026-10-27T20:42:43.487790Z"},{"linkedin_ad_id":"1611641184","advertiser_name":"Microsoft","advertiser_type":"company","advertiser_url":"https://www.linkedin.com/company/1035","advertiser_native_id":"1035","payer":"ZENITH UK (MEDIA) LIMITED","format":"Single Image Ad","ad_copy":"What we announce at Ignite lands in the systems you already run. Hear from Microsoft leaders on what's changing, what it means for your technical teams, and how to deploy it securely. Register free to watch online.","media_urls":["https://media.licdn.com/dms/image/v2/D4E10AQHKw49ODozEZw/image-shrink_1280/B4EaFUPpTmHwAc-/0/1792414750135/EMEA_FY27_Q2_Ignite_EN_IMGbpng?e=2147483647&v=beta&t=v7iSxTDTpN3mu07ozhhpxzS1zhR_SbpFlt485AD_2nY"],"destination_urls":["https://register.ignite.microsoft.com/flow/microsoft/ignite27/welcome/page/welcome#:~:text=Digital%20pass,17%E2%80%9320,%202026&wt.mc_ID=msignite26_mcaps_fld_northeu_pd_scl_lin_0239?trk=ad_library_ad_preview_content_image","https://register.ignite.microsoft.com/flow/microsoft/ignite27/welcome/page/welcome#:~:text=Digital%20pass,17%E2%80%9320,%202026&wt.mc_ID=msignite26_mcaps_fld_northeu_pd_scl_lin_0239?trk=ad_library_ad_preview_headline_content"],"impression_start":"2026-10-23","impression_end":"2026-10-27","impressions_exact":null,"impressions_min":1000,"impressions_max":5000,"targeting":{"language":{"includes":["English"]},"location":{"includes":["Finland","Poland","Denmark","Sweden","Romania","Luxembourg","Hungary","Belgium","Czechia","Norway"]},"parameters":{"job":{"excluded":false,"targeted":true},"company":{"excluded":true,"targeted":false},"audience":{"excluded":false,"targeted":false},"education":{"excluded":false,"targeted":false},"demographic":{"excluded":false,"targeted":false},"member_interests_and_traits":{"excluded":false,"targeted":false}}},"restricted":false,"first_scraped_at":"2026-10-27T20:42:43.487790Z","last_scraped_at":"2026-10-27T20:42:43.487790Z"}],"next_cursor":"WzI2ODQsIjIwMjYtMTAtMjMiXQ","has_more":true},"meta":{"cost":"$0.0005","balance":"$0.9820","request_id":"req_16eae095dda5a9a20895a3b622cb0a2e"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"404":{"description":"The company is not stored. You are not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/linkedin/stored/member":{"get":{"tags":["LinkedIn"],"operationId":"liStoredMember","summary":"Stored member","description":"One stored member profile.\n\nStrictly DB: this reads what the crawler already stored and never crawls. A miss is a `404` and is not billed. Fetch a fresh one with `/v1/linkedin/profile`.","x-dashboard-cost":"$0.0005","security":[{"bearerAuth":[]}],"parameters":[{"name":"q","in":"query","required":true,"description":"A member slug or linkedin.com/in URL.","example":"satyanadella","schema":{"type":"string","maxLength":300,"example":"satyanadella"}}],"responses":{"200":{"description":"Success. The example is a captured response; long lists are truncated.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":true},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"linkedin_native_id":"251749025","canonical_urn":"urn:li:member:251749025","slug":"williamhgates","account_kind":"member","full_name":"Bill Gates","headline":"Chair of the Gates Foundation. Founder of Breakthrough Energy. Co-founder of Microsoft. Voracious reader. Avid traveler. Active blogger.","biography":"Creator, Top Voice","location":"Seattle, Washington, United States, US","profile_pic_url":"http://127.0.0.1:5196/v1/media/linkedin_account/166/profile_pic?e=1793750400&s=360263f6f9758f343c399bcb6b992551","banner_url":null,"external_urls":[],"followers":40760678,"connections":8,"connections_exact":true,"current_company_name":"Gates Foundation","current_company_slug":"gates-foundation","metric_precision":{},"first_scraped_at":"2026-10-12T15:46:21.406967Z","last_scraped_at":"2026-10-27T20:42:41.519956Z"},"meta":{"cost":"$0.0005","balance":"$0.9815","request_id":"req_d24f90b1aabbe492795c24f1b46060ff"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"404":{"description":"The member is not stored. You are not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/linkedin/stored/member/posts":{"get":{"tags":["LinkedIn"],"operationId":"liStoredMemberPosts","summary":"Stored member posts","description":"The stored posts of one member. Newest first, with an opaque `next_cursor` while `has_more` is true; send it back as `cursor`.\n\nStrictly DB: this reads what the crawler already stored and never crawls. A miss is a `404` and is not billed.","x-dashboard-cost":"$0.0005","security":[{"bearerAuth":[]}],"parameters":[{"name":"q","in":"query","required":true,"description":"A member slug or linkedin.com/in URL.","example":"satyanadella","schema":{"type":"string","maxLength":300,"example":"satyanadella"}},{"name":"cursor","in":"query","required":false,"description":"`next_cursor` from the previous page.","schema":{"type":"string","maxLength":200}},{"name":"limit","in":"query","required":false,"description":"Rows per page.","schema":{"type":"integer","minimum":1,"maximum":100,"default":30},"examples":{"default":{"value":30,"x-disabled":true}}}],"responses":{"200":{"description":"Success. The example is a captured response; long lists are truncated.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":true},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"posts":[],"next_cursor":null,"has_more":false},"meta":{"cost":"$0.0005","balance":"$0.9810","request_id":"req_53c56941eda3d039ec86f75b22cd584c"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"404":{"description":"The member is not stored. You are not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/linkedin/stored/post":{"get":{"tags":["LinkedIn"],"operationId":"liStoredPost","summary":"Stored post","description":"One stored post with its author and counts.\n\nStrictly DB: this reads what the crawler already stored and never crawls. A miss is a `404` and is not billed. Fetch a fresh one with `/v1/linkedin/post`.","x-dashboard-cost":"$0.0005","security":[{"bearerAuth":[]}],"parameters":[{"name":"q","in":"query","required":true,"description":"A linkedin.com/posts or /feed/update URL, or the numeric activity id.","example":"7481413628601229312","schema":{"type":"string","maxLength":300,"example":"7481413628601229312"}}],"responses":{"200":{"description":"Success. The example is a captured response; long lists are truncated.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":true},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"linkedin_activity_id":"7481413628601229312","canonical_urn":"urn:li:activity:7481413628601229312","author_display_name":"OpenAI 12,056,703 followers 3mo","author_urn":"urn:li:organization:11130470","caption":"As part of our ongoing efforts to strengthen our safeguards for advanced AI capabilities in biology, we’re evolving our Bio Bug Bounty into an ongoing private program, known as the OpenAI Bio Bug Bounty program and doubling rewards to $50K. We’re inviting researchers with experience in AI red teaming, security, or biosecurity to try to find a universal jailbreak that can defeat our predefined biosafety challenge against OpenAI’s frontier models. https://lnkd.in/eb8_Y_NB","likes":961,"comments":135,"reposts":null,"posted_at":"2026-07-10T18:26:46.986000Z","post_url":"https://www.linkedin.com/feed/update/urn:li:activity:7481413628601229312/","content_type":"text","media_urls":[],"image_url":null,"video_url":null,"is_video":false,"metric_precision":{},"first_seen_at":"2026-10-27T20:42:43.434635Z","last_seen_at":"2026-10-27T20:42:43.434635Z","author_slug":"openai","author_kind":"company","author_native_id":"11130470","author_name":"OpenAI 12,056,703 followers 3mo"},"meta":{"cost":"$0.0005","balance":"$0.9805","request_id":"req_ac100ec18509b62696da050a9f309a4d"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"404":{"description":"The post is not stored. You are not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/linkedin/stored/post/comments":{"get":{"tags":["LinkedIn"],"operationId":"liStoredPostComments","summary":"Stored post comments","description":"The comments stored for one post, in the order they were stored, with `next_cursor` while `has_more` is true.\n\nStrictly DB: this reads what the crawler already stored and never crawls. A miss is a `404` and is not billed.","x-dashboard-cost":"$0.0005","security":[{"bearerAuth":[]}],"parameters":[{"name":"q","in":"query","required":true,"description":"A linkedin.com/posts or /feed/update URL, or the numeric activity id.","example":"7481413628601229312","schema":{"type":"string","maxLength":300,"example":"7481413628601229312"}},{"name":"cursor","in":"query","required":false,"description":"Opaque `next_cursor` from the previous page.","schema":{"type":"string","maxLength":500}},{"name":"limit","in":"query","required":false,"description":"Comments per page.","schema":{"type":"integer","minimum":1,"maximum":200,"default":50},"examples":{"default":{"value":50,"x-disabled":true}}}],"responses":{"200":{"description":"Success. The example is a captured response; long lists are truncated.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":true},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"post":{"activity_id":"7481413628601229312"},"comments":[{"linkedin_comment_id":"7481414183733952512","canonical_urn":"urn:li:comment:(urn:li:activity:7481413628601229312,7481414183733952512)","author_display_name":"Sergio Cardenas","author_slug":"sergioestebanc","text":"cc Aryan Sharma","reactions":1,"commented_at":"2026-07-10T18:28:59.357000Z","is_partial":true,"first_seen_at":"2026-10-27T20:42:43.443105Z"},{"linkedin_comment_id":"7481415220238884865","canonical_urn":"urn:li:comment:(urn:li:activity:7481413628601229312,7481415220238884865)","author_display_name":"Richard B","author_slug":"richard-b-42469439b","text":"$50K for a universal biosafety jailbreak is a serious signal. OpenAI are acknowledging the threat is real enough to put significant money behind finding it before someone else does. SPECTER ORACLE runs autonomous LLM-vs-LLM jailbreaking — DeepSeek R1 as the attacker, 10 strategies, 97.14% ASR across frontier models. The biosafety challenge is a constrained version of what SPECTER COGBURN and SPECTER JACKAL do systematically. The question worth asking is whether a private bug bounty programme with pre-defined challenge parameters actually finds the most dangerous jailbreaks — or whether the most dangerous ones are the ones that bypass the challenge definition itself. Red Specter Security Research","reactions":32,"commented_at":"2026-07-10T18:33:06.479000Z","is_partial":true,"first_seen_at":"2026-10-27T20:42:43.443105Z"}],"stored_total":9,"next_cursor":"WzE3XQ","has_more":true},"meta":{"cost":"$0.0005","balance":"$0.9800","request_id":"req_848fb8ecd3ae31318aff9ed770d4d482"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"404":{"description":"The post is not stored. You are not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/linkedin/stored/job":{"get":{"tags":["LinkedIn"],"operationId":"liStoredJob","summary":"Stored job","description":"One stored job posting.\n\nStrictly DB: this reads what the crawler already stored and never crawls. A miss is a `404` and is not billed. Fetch a fresh one with `/v1/linkedin/job`.","x-dashboard-cost":"$0.0005","security":[{"bearerAuth":[]}],"parameters":[{"name":"q","in":"query","required":true,"description":"The numeric LinkedIn job id.","example":"4426792692","schema":{"type":"string","maxLength":30,"example":"4426792692"}}],"responses":{"200":{"description":"Success. The example is a captured response; long lists are truncated.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":true},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"linkedin_job_id":"4426792692","title":"Principal Applied Scientist - CoreAI","location":"Redmond, WA","employment_type":"Full-time","seniority_level":"Not Applicable","workplace_type":null,"skills":[],"published_at":"2026-10-17T00:00:00Z","expires_at":null,"applicant_count":91,"canonical_url":"https://www.linkedin.com/jobs/view/4426792692","apply_url":null,"extra":{"closed":false,"partial":true,"benefits":"Actively Hiring","criteria":{"industries":"Software Development","employment type":"Full-time","seniority level":"Not Applicable"},"posted_text":"1 week ago","company_name":"Microsoft","company_slug":"microsoft","applicants_text":"91 applicants","applicant_count_min":null,"applicant_count_below":null,"include_skills_available":false,"published_at_approximate":false},"first_scraped_at":"2026-10-27T20:42:41.437669Z","last_scraped_at":"2026-10-27T20:42:43.465778Z","description":"Overview The CoreAI organization at Microsoft builds the end-to-end Artificial Intelligence (AI) stack and is core to Azure AI innovation and differentiation, as well as all of Microsoft’s flagship products, from GitHub, to Office, Teams, and Xbox. We are the team building Responsible AI, Azure OpenAI, Model as a Service, Azure Machine Learning (ML), Cognitive Services, and the global Azure AI infrastructure for running the largest AI workloads on the planet. We ensure Microsoft ships AI systems that are safe, secure, and trustworthy—empowering every person and organization on the planet to achieve more. Our team sits at the intersection of cutting-edge AI research and planet-scale production systems, powering technologies like GitHub Copilot and Azure OpenAI. We are looking for a Principal Applied Scientist to join our team! Microsoft’s mission is to empower every person and every organization on the planet to achieve more. As employees we come together with a growth mindset, innovate to empower others, and collaborate to realize our shared goals. Each day we build on our values of respect, integrity, and accountability to create a culture of inclusion where everyone can thrive at work and beyond. In alignment with our Microsoft values, we are committed to cultivating an inclusive work environment for all employees to positively impact our culture every day. Responsibilities In this role you’ll develop machine learning techniques that push the boundaries of safety, alignment, and trustworthy AI. You’ll collaborate across product, research, and engineering teams to design, build, and maintain responsible AI systems that make an impact at scale—from early-stage development and experimentation to production, monitoring, and continuous iteration. Qualifications Required Qualifications: Bachelor's Degree in Computer Science, Computational Linguistics, or related field AND 6+ years related experience (e.g., statistics, predictive analytics, research) OR Master's Degree in Computer Science, Computational Linguistics or related field AND 4+ years related experience (e.g., statistics, predictive analytics, research) OR Doctorate in Computer Science, Computational Linguistics, or related field AND 3+ years related experience (e.g., statistics, predictive analytics, research) OR equivalent experience. Other Requirements Ability to meet Microsoft, customer and/or government security screening requirements are required for this role. These requirements include but are not limited to the following specialized security screenings: Microsoft Cloud Background Check: This position will be required to pass the Microsoft Cloud background check upon hire/transfer and every two years thereafter. Preferred Qualifications Experience and familiarity with large language models (LLMs). Experience with and a solid foundation in large distributed systems, algorithms, and software engineering principles. Master’s or PhD in Computer Science, Machine Learning, Data Science, or a related field. 5+ years of experience in a research/ML engineering or an applied research scientist position, ideally with a focus on AI safety. Have hands-on experience with deep learning and transformer-based models Excel at problem-solving and analytics, with a proactive approach to challenges Thrive in fast-moving environments where priorities shift and definitions evolve. Enjoy taking ownership end-to-end and learning whatever is necessary to get results. Comfortable working independently while thriving in cross-team collaborations. Understand methods for training and fine-tuning LLMs, including distillation, supervised fine-tuning, and policy optimization. #coreai Applied Sciences IC5 - The typical base pay range for this role across the U.S. is USD $142,800 - $274,800 per year. There is a different range applicable to specific work locations, within the San Francisco Bay area and New York City metropolitan area, and the base pay range for this role in those locations is USD $188,000 - $304,200 per year. Certain roles may be eligible for benefits and other compensation. Find additional benefits and pay information here: https://careers.microsoft.com/us/en/us-corporate-pay Applied Sciences IC6 - The typical base pay range for this role across the U.S. is USD $165,600 - $296,400 per year. There is a different range applicable to specific work locations, within the San Francisco Bay area and New York City metropolitan area, and the base pay range for this role in those locations is USD $220,800 - $331,200 per year. Certain roles may be eligible for benefits and other compensation. Find additional benefits and pay information here: https://careers.microsoft.com/us/en/us-corporate-pay This position will be open for a minimum of 5 days, with applications accepted on an ongoing basis until the position is filled. Microsoft is an equal opportunity employer. All qualified applicants will receive consideration for employment without regard to age, ancestry, citizenship, color, family or medical care leave, gender identity or expression, genetic information, immigration status, marital status, medical condition, national origin, physical or mental disability, political affiliation, protected veteran or military status, race, ethnicity, religion, sex (including pregnancy), sexual orientation, or any other characteristic protected by applicable local laws, regulations and ordinances. If you need assistance with religious accommodations and/or a reasonable accommodation due to a disability during the application process, read more about requesting accommodations.","company_id":"1035","company_slug":"microsoft","company_name":"Microsoft"},"meta":{"cost":"$0.0005","balance":"$0.9795","request_id":"req_efd0a4f533a65e393435ce1fa05992f0"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"404":{"description":"The job is not stored. You are not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/linkedin/stored/ad":{"get":{"tags":["LinkedIn"],"operationId":"liStoredAd","summary":"Stored ad","description":"One stored Ad Library ad.\n\nStrictly DB: this reads what the crawler already stored and never crawls. A miss is a `404` and is not billed. Fetch a fresh one with `/v1/linkedin/ad`.","x-dashboard-cost":"$0.0005","security":[{"bearerAuth":[]}],"parameters":[{"name":"q","in":"query","required":true,"description":"The numeric Ad Library ad id.","example":"1498307266","schema":{"type":"string","maxLength":30,"example":"1498307266"}}],"responses":{"200":{"description":"Success. The example is a captured response; long lists are truncated.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":true},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"linkedin_ad_id":"1498307266","advertiser_name":"Kent Kaufman","advertiser_type":"member","advertiser_url":"https://www.linkedin.com/in/kent-kaufman-b475552","advertiser_native_id":null,"payer":"KLK Consulting","format":"Single Image Ad","ad_copy":"Two AI Stumbles in One Week: Why Values-Based Leadership Must Be Distributed\n\nIn the space of just three days this month, two major AI companies highlighted a critical weakness in how leadership is practiced today.\n\nOn July 10, Apple filed a lawsuit alleging that OpenAI's hardware division, led by former Apple executive Tang Tan, engaged in a coordinated effort to steal trade secrets. Just three days earlier, Meta launched a feature in its new Muse Image tool that allowed users to generate AI images of people by simply tagging their public Instagram accounts — with the feature turned on by default and no notification to the person whose likeness was used. Meta removed the feature days later after widespread backlash.\n\nThese incidents are very different in nature. The allegations against OpenAI, if true, point to something deeper than a miscalculation. They suggest a potential breakdown in ethical boundaries at a leadership level inside a high-growth organization. Meta's case, while serious, looks more like a failure of judgment — moving fast under competitive pressure without properly accounting for user expectations around consent and likeness rights.\n\nWhat connects both cases is this: when the financial and competitive stakes are extremely high, internal pressure can distort decision-making. Even experienced leaders are influenced by the culture and incentives around them. Company culture is not neutral — it either reinforces ethical guardrails or makes it easier to overlook them.\n\nIn my book AI L4IR: Leadership and the 4th Industrial Revolution, I argue that ethical leadership in this era cannot remain concentrated at the top. It must be highly distributed — embedded in how product teams, engineers, recruiters, and middle managers make decisions every day.\n\nWhen billions of dollars and strategic positioning are on the line, relying on a small group of senior leaders to catch every ethical risk is unrealistic. Organizations that build cultures where people at all levels feel empowered (and expected) to ask \"Should we?\" — not just \"Can we?\" — will be far better positioned to innovate responsibly and maintain trust.\n\n#AI #Leadership #AIISV AI Institute of Silicon Valley Manoj Fernando Farooq Ali\n\nI explore both incidents and the broader leadership implications in more detail here:\nhttps://radi8.it/nqanzN8\n\nHow are you thinking about building stronger ethical decision-making into your teams as AI capabilities continue to advance?","media_urls":["https://media.licdn.com/dms/image/v2/D5622AQHBziNgyJBv3g/feedshare-image-high-res/B56Z9THumEGUAU-/0/1783805962934?e=2147483647&v=beta&t=9FRvZ2QyiNGOqxpEoef85QqhwgJ5NoHDVXvMcMP_now"],"destination_urls":["https://radi8.it/nqanzN8"],"impression_start":null,"impression_end":null,"impressions_exact":null,"impressions_min":null,"impressions_max":null,"targeting":{},"restricted":false,"first_scraped_at":"2026-08-10T09:04:30.801843Z","last_scraped_at":"2026-10-27T20:42:43.511754Z"},"meta":{"cost":"$0.0005","balance":"$0.9790","request_id":"req_3c0c926b2012bc626cca2ba98166f318"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"404":{"description":"The ad is not stored. You are not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/linkedin/profile":{"get":{"tags":["LinkedIn"],"operationId":"liProfile","summary":"profile","x-dashboard-cost":"$0.0005","x-example-query":{"handle":"satyanadella"},"description":"A member's guest profile: name, headline, about, followers and connections. `extra` carries `headline`, `location`, `connections` and the current company. Returns `Profile` under `data`. LinkedIn is read as a signed-out guest and every upstream document is an HTML page, so `get_raw` is not available.\n\nA field LinkedIn does not carry is null, a list it does not carry is `[]`, and LinkedIn-only facts sit under `extra`. Unknown, unsupported, and repeated query parameters return 400 before acquisition or billing.","security":[{"bearerAuth":[]}],"parameters":[{"name":"handle","in":"query","required":true,"description":"A member or company slug, or its linkedin.com/in or /company URL.","example":"satyanadella","schema":{"type":"string"}},{"name":"cached","in":"query","required":false,"description":"`auto` (default) serves a read saved within the last 24 hours for these exact arguments, otherwise fetches. `cache_only` never contacts LinkedIn (404 `not_cached` when nothing is saved, whatever its age). `live` always fetches. Anything else is a `400`.","schema":{"type":"string","enum":["auto","cache_only","live"],"default":"auto"},"examples":{"default":{"value":"auto","x-disabled":true}}},{"name":"get_raw","in":"query","required":false,"description":"Not available on this operation: the upstream document is an HTML page, and `true` answers 400. The default `false` returns the normalized type.","schema":{"type":"boolean","default":false},"examples":{"default":{"value":false,"x-disabled":true}}}],"responses":{"200":{"description":"`Profile` under `data`.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/Profile"},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"id":"251749025","username":"williamhgates","full_name":"Bill Gates","biography":"Creator, Top Voice","followers":40760678,"following":null,"posts":null,"is_verified":null,"is_private":false,"avatar_url":"https://media.licdn.com/dms/image/v2/D5603AQF-RYZP55jmXA/profile-displayphoto-shrink_200_200/B56ZRi8g.aGsAY-/0/1736826818802?e=2147483647&v=beta&t=bKWfN6UwwtiCqFWsG7rBELbd48qJOAMLdxhBzzkJV0k","external_url":null,"links":[],"category":null,"business_category":null,"is_business":null,"is_professional":null,"business_email":null,"business_phone":null,"business_address":null,"pronouns":[],"highlight_reel_count":null,"has_clips":null,"is_recently_joined":null,"fbid":null,"extra":{"account_kind":"member","canonical_urn":"urn:li:member:251749025","headline":"Chair of the Gates Foundation. Founder of Breakthrough Energy. Co-founder of Microsoft. Voracious reader. Avid traveler. Active blogger.","location":"Seattle, Washington, United States, US","connections":8,"connections_exact":true,"current_company_name":"Gates Foundation","current_company_slug":"gates-foundation","url":"https://www.linkedin.com/in/williamhgates/","followers_approximate":false}},"meta":{"source":"live","fetched_at":"2026-10-27T20:38:47.181001+00:00","cost":"$0.0005","balance":"$0.9990","request_id":"req_f1816dc58d602f061fd3412af09ce0e2"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"404":{"description":"`cached=cache_only` found nothing saved for these arguments (`not_cached`; call again with `cached=auto` to fetch it), or the LinkedIn account or item does not exist (`not_found`). You are not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_cached","message":"no saved linkedin/profile read for 'satyanadella'. cached=cache_only never fetches, so call again with cached=auto to fetch it. You are not charged.","request_id":"req_5c10900e919bc7a3ff79b7501d582b4c"}}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/linkedin/company":{"get":{"tags":["LinkedIn"],"operationId":"liCompany","summary":"company","x-dashboard-cost":"$0.0005","x-example-query":{"handle":"microsoft"},"description":"A company page: name, about, industry, headquarters, website and followers. `extra.company` carries its size, type, founding year, specialties and job count. Returns `Profile` under `data`. LinkedIn is read as a signed-out guest and every upstream document is an HTML page, so `get_raw` is not available.\n\nA field LinkedIn does not carry is null, a list it does not carry is `[]`, and LinkedIn-only facts sit under `extra`. Unknown, unsupported, and repeated query parameters return 400 before acquisition or billing.","security":[{"bearerAuth":[]}],"parameters":[{"name":"handle","in":"query","required":true,"description":"A member or company slug, or its linkedin.com/in or /company URL.","example":"microsoft","schema":{"type":"string"}},{"name":"cached","in":"query","required":false,"description":"`auto` (default) serves a read saved within the last 24 hours for these exact arguments, otherwise fetches. `cache_only` never contacts LinkedIn (404 `not_cached` when nothing is saved, whatever its age). `live` always fetches. Anything else is a `400`.","schema":{"type":"string","enum":["auto","cache_only","live"],"default":"auto"},"examples":{"default":{"value":"auto","x-disabled":true}}},{"name":"get_raw","in":"query","required":false,"description":"Not available on this operation: the upstream document is an HTML page, and `true` answers 400. The default `false` returns the normalized type.","schema":{"type":"boolean","default":false},"examples":{"default":{"value":false,"x-disabled":true}}}],"responses":{"200":{"description":"`Profile` under `data`.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/Profile"},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"id":"1035","username":"microsoft","full_name":"Microsoft","biography":"Every company has a mission. What's ours? To empower every person and every organization to achieve more. We believe technology can and should be a force for good and that meaningful innovation contributes to a brighter world in the future and today. Our culture doesn’t just encourage curiosity; it embraces it. Each day we make progress together by showing up as our authentic selves. We show up with a learn-it-all mentality. We show up cheering on others, knowing their success doesn't diminish our own. We show up every day open to learning our own biases, changing our behavior, and inviting in differences. Because impact matters. \n\nMicrosoft operates in 190 countries and is made up of approximately 228,000 passionate employees worldwide.","followers":29386865,"following":null,"posts":null,"is_verified":null,"is_private":false,"avatar_url":"https://media.licdn.com/dms/image/v2/D560BAQH32RJQCl3dDQ/company-logo_200_200/B56ZYQ0mrGGoAM-/0/1744038948046/microsoft_logo?e=2147483647&v=beta&t=ts9MGrTk7Lz3R1bmAfzCL8euuuuPWPCoXfdiLA2_IzM","external_url":"https://www.linkedin.com/redir/redirect?url=https%3A%2F%2Fnews%2Emicrosoft%2Ecom%2F&urlhash=sqqa&trk=about_website","links":[{"url":"https://www.linkedin.com/redir/redirect?url=https%3A%2F%2Fnews%2Emicrosoft%2Ecom%2F&urlhash=sqqa&trk=about_website","title":null}],"category":"Software Development","business_category":null,"is_business":true,"is_professional":null,"business_email":null,"business_phone":null,"business_address":"Redmond, Washington","pronouns":[],"highlight_reel_count":null,"has_clips":null,"is_recently_joined":null,"fbid":null,"extra":{"account_kind":"company","canonical_urn":"urn:li:organization:1035","url":"https://www.linkedin.com/company/microsoft/","followers_approximate":false,"company":{"size_text":"10,001+ employees","size_min":null,"size_max":null,"employee_count":231136,"organization_type":"Public Company","founded_year":null,"specialties":["Business Software","Developer Tools","Home & Educational Software","Tablets","Search","Advertising","Servers","Windows Operating System","Windows Applications & Platforms","Smartphones","Cloud Computing","Quantum Computing","Future of Work","Productivity","AI","Artificial Intelligence","Machine Learning","Laptops","Mixed Reality","Virtual Reality","Gaming","Developers","and IT Professional"],"locations":[],"funding":{},"job_count":null,"affiliate_parent_id":null},"affiliated_pages":[{"id":null,"username":"github","full_name":"GitHub Software Development San Francisco, CA"},{"id":null,"username":"microsoft-ai","full_name":"Microsoft AI Software Development Redmond, Washington"},{"id":null,"username":"xbox","full_name":"XBOX Entertainment Providers"},{"id":null,"username":"halostudios","full_name":"Halo Studios Computer Games Redmond, WA"},{"id":null,"username":"m12vc","full_name":"M12, Microsoft's Venture Fund Venture Capital and Private Equity Principals San Francisco, California"},{"id":null,"username":"microsoftflip","full_name":"Flip E-Learning Providers Minneapolis, MN"},{"id":null,"username":"studios-quality","full_name":"Studios Quality - Xbox Game Studios Computer Games Redmond, WA"},{"id":null,"username":"microsoftlearn","full_name":"Microsoft Learn IT Services and IT Consulting Redmond, Washington"},{"id":null,"username":"microsoft-azure","full_name":"Microsoft Azure Technology, Information and Internet"},{"id":null,"username":"microsoft-developers","full_name":"Microsoft Developer Software Development Redmond, WA"},{"id":null,"username":"microsoftcopilot","full_name":"Microsoft Copilot Software Development Redmond, Washington"},{"id":null,"username":"microsoft-cloud-platform","full_name":"Microsoft Cloud Software Development Redmond, Washington"},{"id":null,"username":"vs-code","full_name":"Visual Studio Code Software Development Redmond, Washington"},{"id":null,"username":"microsoft-security","full_name":"Microsoft Security Computer and Network Security"},{"id":null,"username":"microsoftresearch","full_name":"Microsoft Research Think Tanks Redmond, Washington"},{"id":null,"username":"windows-developers","full_name":"Windows Developer"},{"id":null,"username":"microsoft-cloud-partner-program","full_name":"Microsoft AI Cloud Partner Program Information Technology & Services Redmond, Washington"},{"id":null,"username":"microsoft-dynamics","full_name":"Microsoft Dynamics 365 Software Development Redmond, Washington"},{"id":null,"username":"microsoft-visual-studio","full_name":"Microsoft Visual Studio Software Development Redmond, Washington"},{"id":null,"username":"microsoft-power-platform","full_name":"Microsoft Power Platform Software Development Redmond, WA"},{"id":null,"username":"microsoft-threat-intelligence","full_name":"Microsoft Threat Intelligence Computer and Network Security Redmond, Washington"},{"id":null,"username":"microsoftfabric","full_name":"Microsoft Fabric Data Infrastructure and Analytics"},{"id":null,"username":"msft-sql-server","full_name":"Microsoft SQL Software Development Redmond, WA"},{"id":null,"username":"microsoft-on-the-issues","full_name":"Microsoft On the Issues Technology, Information and Internet Redmond, Washington"},{"id":null,"username":"microsoft-events","full_name":"Microsoft Events Technology, Information and Internet"},{"id":null,"username":"microsoft-security-response-center","full_name":"Microsoft Security Response Center Computer and Network Security"},{"id":null,"username":"microsoft-surface","full_name":"Microsoft Surface Computer Hardware Redmond, WA"},{"id":null,"username":"microsoft-advertising","full_name":"Microsoft Advertising Advertising Services Redmond, WA"},{"id":null,"username":"microsoft-health","full_name":"Microsoft for Healthcare Software Development Redmond, WA"},{"id":null,"username":"microsoft-365-insider","full_name":"Microsoft 365 Insider Program Software Development Redmond, WA"},{"id":null,"username":"microsoft-reactor","full_name":"Microsoft Reactor Technology, Information and Internet Redmond, Washington"},{"id":null,"username":"microsoft-in-government","full_name":"Microsoft in Government Software Development Redmond, Washington"},{"id":null,"username":"microsoft-imagine-cup","full_name":"Microsoft Imagine Cup Technology, Information and Internet"},{"id":null,"username":"microsoft-news-and-stories","full_name":"Microsoft News and Stories Technology, Information and Internet Redmond, Washington"},{"id":null,"username":"microsoft-military-affairs","full_name":"Microsoft Military Affairs Information Technology & Services"},{"id":null,"username":"microsoft-viva","full_name":"Microsoft Viva Software Development Redmond, WA"},{"id":null,"username":"microsoft-for-nonprofits","full_name":"Microsoft for Nonprofits Software Development Redmond, Washington"},{"id":null,"username":"microsoft-windows","full_name":"Microsoft Windows Software Development Redmond, WA"},{"id":null,"username":"microsoft365dev","full_name":"Microsoft 365 Developer Technology, Information and Internet Remond, WA"},{"id":null,"username":"covid19-business-resource-center","full_name":"M Software Development"},{"id":null,"username":"microsoft-design","full_name":"Microsoft Design Technology, Information and Internet Redmond, Washington"},{"id":null,"username":"entrepreneurshipforpositiveimpact","full_name":"Microsoft's Entrepreneurship for Positive Impact Software Development"},{"id":null,"username":"microsoftinbusiness","full_name":"Microsoft in Business Technology, Information and Media"},{"id":null,"username":"msft-accessibility","full_name":"Microsoft Accessibility Technology, Information and Internet Redmond, WA"},{"id":null,"username":"go-china-connection","full_name":"Go China Connection IT Services and IT Consulting Beijing, Beijing"},{"id":null,"username":"microsoft-developers-365","full_name":"Microsoft Developers 365"},{"id":null,"username":"msft365","full_name":"Microsoft 365 Software Development"},{"id":null,"username":"humanist-review-of-ai","full_name":"The Humanist Review of AI Technology, Information and Internet Mountain View, California"},{"id":null,"username":"microsoft-for-energy","full_name":"Microsoft for Energy Technology, Information and Internet"},{"id":null,"username":"microsoft-for-life-sciences","full_name":"Microsoft for Life Sciences Technology, Information and Internet"},{"id":null,"username":"microsoft-for-retail-consumer-goods","full_name":"Microsoft for Retail & Consumer Goods Technology, Information and Internet"},{"id":null,"username":"microsoft-for-financial-services","full_name":"Microsoft for Financial Services Technology, Information and Internet"}]}},"meta":{"source":"live","fetched_at":"2026-10-27T20:38:47.416454+00:00","cost":"$0.0005","balance":"$0.9990","request_id":"req_e48d5bd49a4ed2e6d939da79f44328b7"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"404":{"description":"`cached=cache_only` found nothing saved for these arguments (`not_cached`; call again with `cached=auto` to fetch it), or the LinkedIn account or item does not exist (`not_found`). You are not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_cached","message":"no saved linkedin/company read for 'microsoft'. cached=cache_only never fetches, so call again with cached=auto to fetch it. You are not charged.","request_id":"req_5c10900e919bc7a3ff79b7501d582b4c"}}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/linkedin/company_full":{"get":{"tags":["LinkedIn"],"operationId":"liCompanyFull","summary":"company_full","x-dashboard-cost":"$0.0010","x-example-query":{"handle":"microsoft"},"description":"The company, every post its guest page shows, newest first, and posting cadence, engagement and format figures over them. Returns `LinkedInCompanyFull` under `data`. LinkedIn is read as a signed-out guest and every upstream document is an HTML page, so `get_raw` is not available.\n\nA field LinkedIn does not carry is null, a list it does not carry is `[]`, and LinkedIn-only facts sit under `extra`. Unknown, unsupported, and repeated query parameters return 400 before acquisition or billing.","security":[{"bearerAuth":[]}],"parameters":[{"name":"handle","in":"query","required":true,"description":"A member or company slug, or its linkedin.com/in or /company URL.","example":"microsoft","schema":{"type":"string"}},{"name":"cached","in":"query","required":false,"description":"`auto` (default) serves a read saved within the last 24 hours for these exact arguments, otherwise fetches. `cache_only` never contacts LinkedIn (404 `not_cached` when nothing is saved, whatever its age). `live` always fetches. Anything else is a `400`.","schema":{"type":"string","enum":["auto","cache_only","live"],"default":"auto"},"examples":{"default":{"value":"auto","x-disabled":true}}},{"name":"get_raw","in":"query","required":false,"description":"Not available on this operation: the upstream document is an HTML page, and `true` answers 400. The default `false` returns the normalized type.","schema":{"type":"boolean","default":false},"examples":{"default":{"value":false,"x-disabled":true}}}],"responses":{"200":{"description":"`LinkedInCompanyFull` under `data`.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/LinkedInCompanyFull"},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"profile":{"id":"1035","username":"microsoft","full_name":"Microsoft","biography":"Every company has a mission. What's ours? To empower every person and every organization to achieve more. We believe technology can and should be a force for good and that meaningful innovation contributes to a brighter world in the future and today. Our culture doesn’t just encourage curiosity; it embraces it. Each day we make progress together by showing up as our authentic selves. We show up with a learn-it-all mentality. We show up cheering on others, knowing their success doesn't diminish our own. We show up every day open to learning our own biases, changing our behavior, and inviting in differences. Because impact matters. \n\nMicrosoft operates in 190 countries and is made up of approximately 228,000 passionate employees worldwide.","followers":29386865,"following":null,"posts":null,"is_verified":null,"is_private":false,"avatar_url":"https://media.licdn.com/dms/image/v2/D560BAQH32RJQCl3dDQ/company-logo_200_200/B56ZYQ0mrGGoAM-/0/1744038948046/microsoft_logo?e=2147483647&v=beta&t=ts9MGrTk7Lz3R1bmAfzCL8euuuuPWPCoXfdiLA2_IzM","external_url":"https://www.linkedin.com/redir/redirect?url=https%3A%2F%2Fnews%2Emicrosoft%2Ecom%2F&urlhash=sqqa&trk=about_website","links":[{"url":"https://www.linkedin.com/redir/redirect?url=https%3A%2F%2Fnews%2Emicrosoft%2Ecom%2F&urlhash=sqqa&trk=about_website","title":null}],"category":"Software Development","business_category":null,"is_business":true,"is_professional":null,"business_email":null,"business_phone":null,"business_address":"Redmond, Washington","pronouns":[],"highlight_reel_count":null,"has_clips":null,"is_recently_joined":null,"fbid":null,"extra":{"account_kind":"company","canonical_urn":"urn:li:organization:1035","url":"https://www.linkedin.com/company/microsoft/","followers_approximate":false,"company":{"size_text":"10,001+ employees","size_min":null,"size_max":null,"employee_count":231136,"organization_type":"Public Company","founded_year":null,"specialties":["Business Software","Developer Tools","Home & Educational Software","Tablets","Search","Advertising","Servers","Windows Operating System","Windows Applications & Platforms","Smartphones","Cloud Computing","Quantum Computing","Future of Work","Productivity","AI","Artificial Intelligence","Machine Learning","Laptops","Mixed Reality","Virtual Reality","Gaming","Developers","and IT Professional"],"locations":[],"funding":{},"job_count":null,"affiliate_parent_id":null},"affiliated_pages":[{"id":null,"username":"github","full_name":"GitHub Software Development San Francisco, CA"},{"id":null,"username":"microsoft-ai","full_name":"Microsoft AI Software Development Redmond, Washington"},{"id":null,"username":"xbox","full_name":"XBOX Entertainment Providers"},{"id":null,"username":"halostudios","full_name":"Halo Studios Computer Games Redmond, WA"},{"id":null,"username":"m12vc","full_name":"M12, Microsoft's Venture Fund Venture Capital and Private Equity Principals San Francisco, California"},{"id":null,"username":"microsoftflip","full_name":"Flip E-Learning Providers Minneapolis, MN"},{"id":null,"username":"studios-quality","full_name":"Studios Quality - Xbox Game Studios Computer Games Redmond, WA"},{"id":null,"username":"microsoftlearn","full_name":"Microsoft Learn IT Services and IT Consulting Redmond, Washington"},{"id":null,"username":"microsoft-azure","full_name":"Microsoft Azure Technology, Information and Internet"},{"id":null,"username":"microsoft-developers","full_name":"Microsoft Developer Software Development Redmond, WA"},{"id":null,"username":"microsoftcopilot","full_name":"Microsoft Copilot Software Development Redmond, Washington"},{"id":null,"username":"microsoft-cloud-platform","full_name":"Microsoft Cloud Software Development Redmond, Washington"},{"id":null,"username":"vs-code","full_name":"Visual Studio Code Software Development Redmond, Washington"},{"id":null,"username":"microsoft-security","full_name":"Microsoft Security Computer and Network Security"},{"id":null,"username":"microsoftresearch","full_name":"Microsoft Research Think Tanks Redmond, Washington"},{"id":null,"username":"windows-developers","full_name":"Windows Developer"},{"id":null,"username":"microsoft-cloud-partner-program","full_name":"Microsoft AI Cloud Partner Program Information Technology & Services Redmond, Washington"},{"id":null,"username":"microsoft-dynamics","full_name":"Microsoft Dynamics 365 Software Development Redmond, Washington"},{"id":null,"username":"microsoft-visual-studio","full_name":"Microsoft Visual Studio Software Development Redmond, Washington"},{"id":null,"username":"microsoft-power-platform","full_name":"Microsoft Power Platform Software Development Redmond, WA"},{"id":null,"username":"microsoft-threat-intelligence","full_name":"Microsoft Threat Intelligence Computer and Network Security Redmond, Washington"},{"id":null,"username":"microsoftfabric","full_name":"Microsoft Fabric Data Infrastructure and Analytics"},{"id":null,"username":"msft-sql-server","full_name":"Microsoft SQL Software Development Redmond, WA"},{"id":null,"username":"microsoft-on-the-issues","full_name":"Microsoft On the Issues Technology, Information and Internet Redmond, Washington"},{"id":null,"username":"microsoft-events","full_name":"Microsoft Events Technology, Information and Internet"},{"id":null,"username":"microsoft-security-response-center","full_name":"Microsoft Security Response Center Computer and Network Security"},{"id":null,"username":"microsoft-surface","full_name":"Microsoft Surface Computer Hardware Redmond, WA"},{"id":null,"username":"microsoft-advertising","full_name":"Microsoft Advertising Advertising Services Redmond, WA"},{"id":null,"username":"microsoft-health","full_name":"Microsoft for Healthcare Software Development Redmond, WA"},{"id":null,"username":"microsoft-365-insider","full_name":"Microsoft 365 Insider Program Software Development Redmond, WA"},{"id":null,"username":"microsoft-reactor","full_name":"Microsoft Reactor Technology, Information and Internet Redmond, Washington"},{"id":null,"username":"microsoft-in-government","full_name":"Microsoft in Government Software Development Redmond, Washington"},{"id":null,"username":"microsoft-imagine-cup","full_name":"Microsoft Imagine Cup Technology, Information and Internet"},{"id":null,"username":"microsoft-news-and-stories","full_name":"Microsoft News and Stories Technology, Information and Internet Redmond, Washington"},{"id":null,"username":"microsoft-military-affairs","full_name":"Microsoft Military Affairs Information Technology & Services"},{"id":null,"username":"microsoft-viva","full_name":"Microsoft Viva Software Development Redmond, WA"},{"id":null,"username":"microsoft-for-nonprofits","full_name":"Microsoft for Nonprofits Software Development Redmond, Washington"},{"id":null,"username":"microsoft-windows","full_name":"Microsoft Windows Software Development Redmond, WA"},{"id":null,"username":"microsoft365dev","full_name":"Microsoft 365 Developer Technology, Information and Internet Remond, WA"},{"id":null,"username":"covid19-business-resource-center","full_name":"M Software Development"},{"id":null,"username":"microsoft-design","full_name":"Microsoft Design Technology, Information and Internet Redmond, Washington"},{"id":null,"username":"entrepreneurshipforpositiveimpact","full_name":"Microsoft's Entrepreneurship for Positive Impact Software Development"},{"id":null,"username":"microsoftinbusiness","full_name":"Microsoft in Business Technology, Information and Media"},{"id":null,"username":"msft-accessibility","full_name":"Microsoft Accessibility Technology, Information and Internet Redmond, WA"},{"id":null,"username":"go-china-connection","full_name":"Go China Connection IT Services and IT Consulting Beijing, Beijing"},{"id":null,"username":"microsoft-developers-365","full_name":"Microsoft Developers 365"},{"id":null,"username":"msft365","full_name":"Microsoft 365 Software Development"},{"id":null,"username":"humanist-review-of-ai","full_name":"The Humanist Review of AI Technology, Information and Internet Mountain View, California"},{"id":null,"username":"microsoft-for-energy","full_name":"Microsoft for Energy Technology, Information and Internet"},{"id":null,"username":"microsoft-for-life-sciences","full_name":"Microsoft for Life Sciences Technology, Information and Internet"},{"id":null,"username":"microsoft-for-retail-consumer-goods","full_name":"Microsoft for Retail & Consumer Goods Technology, Information and Internet"},{"id":null,"username":"microsoft-for-financial-services","full_name":"Microsoft for Financial Services Technology, Information and Internet"}]}},"posts":[{"id":"7520878131965091840","shortcode":null,"taken_at":"2026-10-27T16:04:37.817000+00:00","kind":null,"product_type":"text","caption":"Information overload is real. What if you could lighten it?\n \nIn the October edition of The Monthly Tech-In, we explore how AI is increasingly helping people turn mounds of data into action.\n \nAt the office, the new Microsoft Copilot is changing how work gets done. In the field, emergency responders are using Microsoft's HASTE system to analyze cities after natural disasters to see which neighborhoods and roads were hit the hardest. And with an eye toward the moon, NASA is increasingly turning to the technology to extract new insights from its decades of data.\n \nRead on to learn how AI can help distill data in the real world – and beyond it.","hashtags":[],"mentions":[],"accessibility_caption":null,"likes":336,"comments":14,"views":null,"counts_hidden":null,"comments_disabled":null,"is_pinned":null,"is_paid_partnership":null,"owner":{"id":"1035","username":"microsoft","full_name":"Microsoft","is_verified":null,"is_private":null,"avatar_url":"https://media.licdn.com/dms/image/v2/D560BAQH32RJQCl3dDQ/company-logo_200_200/B56ZYQ0mrGGoAM-/0/1744038948046/microsoft_logo?e=2147483647&v=beta&t=ts9MGrTk7Lz3R1bmAfzCL8euuuuPWPCoXfdiLA2_IzM","latest_story_at":null,"extra":{"account_kind":"company"}},"coauthors":[],"sponsors":[],"tagged":[],"location":null,"audio":null,"thumbnail_url":null,"video_duration":null,"media":[],"media_urls":[],"extra":{"url":"https://www.linkedin.com/posts/microsoft_october-2026-the-new-copilot-activity-7520878131965091840-mCcZ","canonical_urn":"urn:li:activity:7520878131965091840","reposts":null,"likes_approximate":false,"comments_approximate":false}},{"id":"7516505833061474305","shortcode":null,"taken_at":"2026-10-15T14:30:40.526000+00:00","kind":null,"product_type":"text","caption":"This month, the Microsoft Atlanta team, in partnership with Black in Technology, hosted the 404 Tech Summit (BitCon) for two days of conversations on AI and the future of work with Atlanta's tech community. Great to learn alongside the technologists, students, and leaders shaping what's next.","hashtags":[],"mentions":[],"accessibility_caption":null,"likes":274,"comments":44,"views":null,"counts_hidden":null,"comments_disabled":null,"is_pinned":null,"is_paid_partnership":null,"owner":{"id":"1035","username":"microsoft","full_name":"Microsoft","is_verified":null,"is_private":null,"avatar_url":"https://media.licdn.com/dms/image/v2/D560BAQH32RJQCl3dDQ/company-logo_200_200/B56ZYQ0mrGGoAM-/0/1744038948046/microsoft_logo?e=2147483647&v=beta&t=ts9MGrTk7Lz3R1bmAfzCL8euuuuPWPCoXfdiLA2_IzM","latest_story_at":null,"extra":{"account_kind":"company"}},"coauthors":[],"sponsors":[],"tagged":[],"location":null,"audio":null,"thumbnail_url":null,"video_duration":null,"media":[],"media_urls":[],"extra":{"url":"https://www.linkedin.com/posts/microsoft_this-month-the-microsoft-atlanta-team-in-activity-7516505833061474305-T6ou","canonical_urn":"urn:li:activity:7516505833061474305","reposts":null,"likes_approximate":false,"comments_approximate":false}}],"computed":{"engagement_rate_mean":null,"posting_cadence_per_week":0.5801787841068322,"top_post":null,"format_mix":{"text":{"count":2,"share":1}},"window":{"requested_post_count":2,"observed_post_count":2,"oldest_posted_at":"2026-10-15T14:30:40.526000+00:00","newest_posted_at":"2026-10-27T16:04:37.817000+00:00"},"status":"partial"}},"meta":{"source":"live","fetched_at":"2026-10-27T20:38:47.323485+00:00","cost":"$0.0010","balance":"$0.9985","request_id":"req_9c22db17803d3d057f2f6eed707cc01b"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"404":{"description":"`cached=cache_only` found nothing saved for these arguments (`not_cached`; call again with `cached=auto` to fetch it), or the LinkedIn account or item does not exist (`not_found`). You are not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_cached","message":"no saved linkedin/company_full read for 'microsoft'. cached=cache_only never fetches, so call again with cached=auto to fetch it. You are not charged.","request_id":"req_5c10900e919bc7a3ff79b7501d582b4c"}}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/linkedin/company_job_count":{"get":{"tags":["LinkedIn"],"operationId":"liCompanyJobCount","summary":"company_job_count","x-dashboard-cost":"$0.0005","x-example-query":{"company_id":"1035"},"description":"How many jobs a company has open worldwide; `count_exact` is false for a rounded figure. Returns `LinkedInJobCount` under `data`. LinkedIn is read as a signed-out guest and every upstream document is an HTML page, so `get_raw` is not available.\n\nA field LinkedIn does not carry is null, a list it does not carry is `[]`, and LinkedIn-only facts sit under `extra`. Unknown, unsupported, and repeated query parameters return 400 before acquisition or billing.","security":[{"bearerAuth":[]}],"parameters":[{"name":"company_id","in":"query","required":true,"description":"The numeric LinkedIn company id, `id` of `/v1/linkedin/company`.","example":"1035","schema":{"type":"string"}},{"name":"cached","in":"query","required":false,"description":"`auto` (default) serves a read saved within the last 24 hours for these exact arguments, otherwise fetches. `cache_only` never contacts LinkedIn (404 `not_cached` when nothing is saved, whatever its age). `live` always fetches. Anything else is a `400`.","schema":{"type":"string","enum":["auto","cache_only","live"],"default":"auto"},"examples":{"default":{"value":"auto","x-disabled":true}}},{"name":"get_raw","in":"query","required":false,"description":"Not available on this operation: the upstream document is an HTML page, and `true` answers 400. The default `false` returns the normalized type.","schema":{"type":"boolean","default":false},"examples":{"default":{"value":false,"x-disabled":true}}}],"responses":{"200":{"description":"`LinkedInJobCount` under `data`.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/LinkedInJobCount"},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"company_id":"1035","count":2000,"count_exact":false,"count_lower_bound":true},"meta":{"source":"live","fetched_at":"2026-10-27T20:38:46.342554+00:00","cost":"$0.0005","balance":"$0.9990","request_id":"req_617da451c8c85b4b30c9b36325bb18dc"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"404":{"description":"`cached=cache_only` found nothing saved for these arguments (`not_cached`; call again with `cached=auto` to fetch it), or the LinkedIn account or item does not exist (`not_found`). You are not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_cached","message":"no saved linkedin/company_job_count read for '1035'. cached=cache_only never fetches, so call again with cached=auto to fetch it. You are not charged.","request_id":"req_5c10900e919bc7a3ff79b7501d582b4c"}}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/linkedin/company_jobs":{"get":{"tags":["LinkedIn"],"operationId":"liCompanyJobs","summary":"company_jobs","x-dashboard-cost":"$0.0005/10","x-example-query":{"company_id":"1035","max_pages":"1"},"description":"A company's open jobs, 10 a page, up to 100 pages. `since` needs `sort_by=recent`. Returns `Page[LinkedInJob]` under `data`. LinkedIn is read as a signed-out guest and every upstream document is an HTML page, so `get_raw` is not available.\n\nThe default request creates a durable job (202). Use max_pages=1 for one synchronous Page response (200). Poll status_url, then read results_url with its opaque cursor. Acquisition stops at the first of since, max_pages, or exhaustion. Jobs continue after disconnects. Result responses are bounded to 3 MiB; this does not limit the crawl. Supply Idempotency-Key to recover a lost submission response; reuse it with the same inputs. LinkedIn sets every page’s size, so there is no `page_size`.\n\nA field LinkedIn does not carry is null, a list it does not carry is `[]`, and LinkedIn-only facts sit under `extra`. Unknown, unsupported, and repeated query parameters return 400 before acquisition or billing.\n\nBilling: $0.0005 per 10 unique returned items (one native page), rounded up to a minimum of one billing unit. Jobs settle once after successful completion. Submission, polling and repeat downloads are free.","security":[{"bearerAuth":[]}],"parameters":[{"name":"company_id","in":"query","required":true,"description":"The numeric LinkedIn company id, `id` of `/v1/linkedin/company`.","example":"1035","schema":{"type":"string"}},{"name":"date_posted","in":"query","required":false,"description":"Only jobs posted in the last `day`, `week` or `month`.","schema":{"type":"string","enum":["day","week","month"]}},{"name":"experience_level","in":"query","required":false,"description":"Comma-separated levels. Values: `internship`, `entry`, `associate`, `mid_senior`, `director`, `executive`.","schema":{"type":"string"}},{"name":"job_type","in":"query","required":false,"description":"Comma-separated job types. Values: `full_time`, `part_time`, `contract`, `temporary`, `volunteer`.","schema":{"type":"string"}},{"name":"remote","in":"query","required":false,"description":"Comma-separated workplace types. Values: `on_site`, `remote`, `hybrid`.","schema":{"type":"string"}},{"name":"easy_apply","in":"query","required":false,"description":"`true` answers only jobs that take LinkedIn Easy Apply.","schema":{"type":"boolean","default":false},"examples":{"default":{"value":false,"x-disabled":true}}},{"name":"sort_by","in":"query","required":false,"description":"`relevance` or `recent`; omitted is `relevance`.","schema":{"type":"string","enum":["relevance","recent"]}},{"name":"since","in":"query","required":false,"description":"Stop at this date. `2025-09-21` means midnight UTC (2025-09-21T00:00:00Z). Datetimes must use RFC3339 with a timezone, for example `2025-09-21T09:00:00+09:00`. `365d` means 365 days before submission. Invalid calendar dates return 400. With max_pages, the first boundary reached stops the walk. since alone creates a job.","schema":{"type":"string"},"examples":{"default":{"value":"2025-09-21","x-disabled":true},"date":{"value":"2025-09-21","x-disabled":true},"datetime":{"value":"2025-09-21T00:00:00Z","x-disabled":true},"duration":{"value":"365d","x-disabled":true}}},{"name":"max_pages","in":"query","required":false,"example":1,"description":"Maximum pages to fetch. -1 walks until exhaustion or since with no page cap, and must be written. Omitted, since alone bounds the walk; with neither, the job stops after 10 pages. Any positive integer is accepted. 1 returns one page synchronously with HTTP 200; any other value creates a durable job with HTTP 202.","schema":{"type":"integer","anyOf":[{"enum":[-1]},{"minimum":1}]}},{"name":"cursor","in":"query","required":false,"description":"Opaque next_cursor from an earlier answer of this operation, also with `get_raw=true`. A native LinkedIn cursor from a raw page answers 400. Result download cursors belong to the results route.","schema":{"type":"string","minLength":1}},{"name":"cached","in":"query","required":false,"description":"`auto` (default) serves a read saved within the last 24 hours for these exact arguments, otherwise fetches. `cache_only` never contacts LinkedIn (404 `not_cached` when nothing is saved, whatever its age). `live` always fetches. Anything else is a `400`. `cache_only` reads one saved page per request: omit `max_pages` or pass 1, and continue with `next_cursor`.","schema":{"type":"string","enum":["auto","cache_only","live"],"default":"auto"},"examples":{"default":{"value":"auto","x-disabled":true}}},{"name":"get_raw","in":"query","required":false,"description":"Not available on this operation: the upstream document is an HTML page, and `true` answers 400. The default `false` returns the normalized type.","schema":{"type":"boolean","default":false},"examples":{"default":{"value":false,"x-disabled":true}}},{"name":"Idempotency-Key","in":"header","required":false,"description":"Reuse this key with the same inputs to recover a lost job submission. A different input with the same key returns 409.","schema":{"type":"string","minLength":1,"maxLength":200}}],"responses":{"200":{"description":"`Page[LinkedInJob]` under `data`.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","required":["items","pages","next_cursor","has_more","stop_reason","coverage"],"properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/LinkedInJob"},"description":"`LinkedInJob` of every page walked, in page order."},"pages":{"type":"array","items":{"$ref":"#/components/schemas/PageRead"},"description":"One entry per page walked."},"next_cursor":{"type":"string","nullable":true,"description":"Opaque; pass back as `cursor` to continue."},"has_more":{"type":"boolean","description":"True when `next_cursor` is set, and when the walk stopped `cursor_stalled` on a page that said more results exist but gave no cursor to send back."},"stop_reason":{"type":"string","enum":["pages","since","exhausted","cursor_stalled","repeated_content","deadline","blocked","caught_up"],"description":"Why the walk stopped. `pages`: the page budget is spent and `next_cursor` continues it. `deadline`: the call ran out of time before its next page; `next_cursor` continues it. `since`: a whole page was older than `since`. `exhausted`: LinkedIn reported the end. `cursor_stalled`: LinkedIn claimed more but repeated or omitted its cursor. `repeated_content`: a page held only items already seen. `blocked`: LinkedIn refused a later page; `next_cursor` is the page it refused. `caught_up`: only watch passes the crawler runs for itself stop this way."},"coverage":{"$ref":"#/components/schemas/Coverage"}}},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"items":[{"id":"4474182677","title":"Principal Applied Scientist-Ads Monetization","company":{"id":"1035","username":"microsoft","full_name":"Microsoft","is_verified":null,"is_private":null,"avatar_url":null,"latest_story_at":null,"extra":{"account_kind":"company"}},"location":"Redmond, WA","employment_type":null,"seniority_level":null,"workplace_type":null,"description":null,"skills":[],"published_at":"2026-10-22T00:00:00+00:00","expires_at":null,"applicants":null,"url":"https://www.linkedin.com/jobs/view/principal-applied-scientist-ads-monetization-at-microsoft-4474182677","apply_url":null,"extra":{"benefits":"Be an early applicant","partial":true,"published_at_approximate":false}},{"id":"4478794710","title":"Principal Applied Scientist- M365 Copilot","company":{"id":"1035","username":"microsoft","full_name":"Microsoft","is_verified":null,"is_private":null,"avatar_url":null,"latest_story_at":null,"extra":{"account_kind":"company"}},"location":"Redmond, WA","employment_type":null,"seniority_level":null,"workplace_type":null,"description":null,"skills":[],"published_at":"2026-10-13T00:00:00+00:00","expires_at":null,"applicants":null,"url":"https://www.linkedin.com/jobs/view/principal-applied-scientist-m365-copilot-at-microsoft-4478794710","apply_url":null,"extra":{"benefits":"Be an early applicant","partial":true,"published_at_approximate":false}}],"pages":[{"cursor":null,"fetched_at":"2026-10-27T20:38:45.884547+00:00","count":2}],"next_cursor":"eyJvcCI6ImNvbXBhbnlfam9icyIsInN0YXJ0IjoiMTAifQ","has_more":true,"stop_reason":"pages","coverage":{"since":null,"oldest_at":"2026-10-09T00:00:00+00:00","since_reached":false}},"meta":{"source":"live","fetched_at":"2026-10-27T20:38:45.884547+00:00","cost":"$0.0005","balance":"$0.9990","request_id":"req_7555148cf2f93ac85b94052d454f20a2"}}}}},"202":{"description":"Durable job accepted. No completed-result charge. Save batch_id; poll status_url. Retry submission with the same Idempotency-Key after a lost response. An account may have five queued, running or payment-required jobs. A sixth new job returns 429 rate_limited. Matching idempotent replays still work at the limit. Ready and failed jobs release their slots; pages within a job remain unbounded. This is a synthetic contract example, not a live capture.","x-example-provenance":"synthetic-contract","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","required":["batch_id","status","status_url","results_url","cost","item_count","error","retry_at","total","done_count","failed_count","created_at","started_at","finished_at"],"properties":{"batch_id":{"type":"string"},"status":{"type":"string","enum":["queued","running","payment_required","ready","failed"]},"status_url":{"type":"string"},"results_url":{"type":"string"},"cost":{"type":"string"},"item_count":{"type":"integer","nullable":true},"error":{"type":"string","nullable":true,"description":"Null unless failed. A failed target carries its own code; incomplete_result appears only when it has none and pages of the result are missing. profile_not_found, post_not_found, upstream_not_found or not_found: the target does not exist or is not visible. not_visible: The account exists, but its posts are not visible to logged-out readers (private, restricted, or hidden by Instagram). Retrying will not change the result until the account changes. not_cached: cached=cache_only found no saved read. incomplete_result: pages of the result are missing. temporarily_unavailable: the target could not be read for now (no capacity, a pause or repeated refusals); retry later with a new job. result_item_too_large: one result unit exceeds the delivery budget. result_snapshot_missing or result_snapshot_corrupt: the crawler could not serve the retained result of a paid job, and its charge is refunded; if the crawler serves it again, a later results read returns it and charges the job again. crawler_submit_400, crawler_submit_404 or crawler_submit_422: the crawl service refused the job request. crawler_job_failed: any other failure; the same job is not expected to succeed if resubmitted. cancelled: the job was cancelled with POST /v1/jobs/{job_id}/cancel. No failed job costs anything: only result_snapshot_missing and result_snapshot_corrupt follow a charge, and that charge is refunded."},"retry_at":{"type":"string","format":"date-time","nullable":true,"description":"Null unless the job failed temporarily_unavailable because a crawl route was closed for every caller. Then it is when the route opens again, and the response carries the same time as a Retry-After header in seconds. Submit a new job after it."},"total":{"type":"integer","description":"Targets in the job. A job submitted through a /v1 route has one."},"done_count":{"type":"integer","description":"Targets the crawler finished."},"failed_count":{"type":"integer","description":"Targets that failed."},"created_at":{"type":"string","format":"date-time","description":"When the job was submitted."},"started_at":{"type":"string","format":"date-time","nullable":true,"description":"When the crawler started the job. Null until it starts."},"finished_at":{"type":"string","format":"date-time","nullable":true,"description":"When the job finished or failed. Null while it is queued or running."}}},"meta":{"type":"object","required":["cost","request_id"],"properties":{"cost":{"type":"string","example":"$0.0000"},"request_id":{"type":"string"}}}}},"example":{"data":{"batch_id":"job_7641d5f0-717d-4b70-a2f1-f58d846d7242","status":"queued","status_url":"/v1/jobs/job_7641d5f0-717d-4b70-a2f1-f58d846d7242","results_url":"/v1/jobs/job_7641d5f0-717d-4b70-a2f1-f58d846d7242/results","cost":"$0.0000","item_count":null,"error":null,"retry_at":null,"total":1,"done_count":0,"failed_count":0,"created_at":"2026-10-12T12:56:17.403Z","started_at":null,"finished_at":null},"meta":{"cost":"$0.0000","request_id":"req_job_example"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"404":{"description":"`cached=cache_only` found nothing saved for these arguments (`not_cached`; call again with `cached=auto` to fetch it), or the LinkedIn account or item does not exist (`not_found`). You are not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_cached","message":"no saved linkedin/company_jobs read for '1035'. cached=cache_only never fetches, so call again with cached=auto to fetch it. You are not charged.","request_id":"req_5c10900e919bc7a3ff79b7501d582b4c"}}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/linkedin/search_jobs":{"get":{"tags":["LinkedIn"],"operationId":"liSearchJobs","summary":"search_jobs","x-dashboard-cost":"$0.0005/10","x-example-query":{"query":"engineer","max_pages":"1"},"description":"LinkedIn's guest job search, 10 a page, up to 100 pages. `since` needs `sort_by=recent`. Returns `Page[LinkedInJob]` under `data`. LinkedIn is read as a signed-out guest and every upstream document is an HTML page, so `get_raw` is not available.\n\nThe default request creates a durable job (202). Use max_pages=1 for one synchronous Page response (200). Poll status_url, then read results_url with its opaque cursor. Acquisition stops at the first of since, max_pages, or exhaustion. Jobs continue after disconnects. Result responses are bounded to 3 MiB; this does not limit the crawl. Supply Idempotency-Key to recover a lost submission response; reuse it with the same inputs. LinkedIn sets every page’s size, so there is no `page_size`.\n\nA field LinkedIn does not carry is null, a list it does not carry is `[]`, and LinkedIn-only facts sit under `extra`. Unknown, unsupported, and repeated query parameters return 400 before acquisition or billing.\n\nBilling: $0.0005 per 10 unique returned items (one native page), rounded up to a minimum of one billing unit. Jobs settle once after successful completion. Submission, polling and repeat downloads are free.","security":[{"bearerAuth":[]}],"parameters":[{"name":"query","in":"query","required":true,"description":"Job search keywords, such as a title or skill, up to 300 characters.","example":"engineer","schema":{"type":"string"}},{"name":"date_posted","in":"query","required":false,"description":"Only jobs posted in the last `day`, `week` or `month`.","schema":{"type":"string","enum":["day","week","month"]}},{"name":"experience_level","in":"query","required":false,"description":"Comma-separated levels. Values: `internship`, `entry`, `associate`, `mid_senior`, `director`, `executive`.","schema":{"type":"string"}},{"name":"job_type","in":"query","required":false,"description":"Comma-separated job types. Values: `full_time`, `part_time`, `contract`, `temporary`, `volunteer`.","schema":{"type":"string"}},{"name":"remote","in":"query","required":false,"description":"Comma-separated workplace types. Values: `on_site`, `remote`, `hybrid`.","schema":{"type":"string"}},{"name":"easy_apply","in":"query","required":false,"description":"`true` answers only jobs that take LinkedIn Easy Apply.","schema":{"type":"boolean","default":false},"examples":{"default":{"value":false,"x-disabled":true}}},{"name":"sort_by","in":"query","required":false,"description":"`relevance` or `recent`; omitted is `relevance`.","schema":{"type":"string","enum":["relevance","recent"]}},{"name":"company","in":"query","required":false,"description":"Comma-separated numeric company ids.","schema":{"type":"string"}},{"name":"geocode","in":"query","required":false,"description":"A numeric LinkedIn geo id.","schema":{"type":"string"}},{"name":"industry_ids","in":"query","required":false,"description":"Comma-separated numeric industry ids.","schema":{"type":"string"}},{"name":"since","in":"query","required":false,"description":"Stop at this date. `2025-09-21` means midnight UTC (2025-09-21T00:00:00Z). Datetimes must use RFC3339 with a timezone, for example `2025-09-21T09:00:00+09:00`. `365d` means 365 days before submission. Invalid calendar dates return 400. With max_pages, the first boundary reached stops the walk. since alone creates a job.","schema":{"type":"string"},"examples":{"default":{"value":"2025-09-21","x-disabled":true},"date":{"value":"2025-09-21","x-disabled":true},"datetime":{"value":"2025-09-21T00:00:00Z","x-disabled":true},"duration":{"value":"365d","x-disabled":true}}},{"name":"max_pages","in":"query","required":false,"example":1,"description":"Maximum pages to fetch. -1 walks until exhaustion or since with no page cap, and must be written. Omitted, since alone bounds the walk; with neither, the job stops after 10 pages. Any positive integer is accepted. 1 returns one page synchronously with HTTP 200; any other value creates a durable job with HTTP 202.","schema":{"type":"integer","anyOf":[{"enum":[-1]},{"minimum":1}]}},{"name":"cursor","in":"query","required":false,"description":"Opaque next_cursor from an earlier answer of this operation, also with `get_raw=true`. A native LinkedIn cursor from a raw page answers 400. Result download cursors belong to the results route.","schema":{"type":"string","minLength":1}},{"name":"cached","in":"query","required":false,"description":"`auto` (default) serves a read saved within the last 24 hours for these exact arguments, otherwise fetches. `cache_only` never contacts LinkedIn (404 `not_cached` when nothing is saved, whatever its age). `live` always fetches. Anything else is a `400`. `cache_only` reads one saved page per request: omit `max_pages` or pass 1, and continue with `next_cursor`.","schema":{"type":"string","enum":["auto","cache_only","live"],"default":"auto"},"examples":{"default":{"value":"auto","x-disabled":true}}},{"name":"get_raw","in":"query","required":false,"description":"Not available on this operation: the upstream document is an HTML page, and `true` answers 400. The default `false` returns the normalized type.","schema":{"type":"boolean","default":false},"examples":{"default":{"value":false,"x-disabled":true}}},{"name":"Idempotency-Key","in":"header","required":false,"description":"Reuse this key with the same inputs to recover a lost job submission. A different input with the same key returns 409.","schema":{"type":"string","minLength":1,"maxLength":200}}],"responses":{"200":{"description":"`Page[LinkedInJob]` under `data`.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","required":["items","pages","next_cursor","has_more","stop_reason","coverage"],"properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/LinkedInJob"},"description":"`LinkedInJob` of every page walked, in page order."},"pages":{"type":"array","items":{"$ref":"#/components/schemas/PageRead"},"description":"One entry per page walked."},"next_cursor":{"type":"string","nullable":true,"description":"Opaque; pass back as `cursor` to continue."},"has_more":{"type":"boolean","description":"True when `next_cursor` is set, and when the walk stopped `cursor_stalled` on a page that said more results exist but gave no cursor to send back."},"stop_reason":{"type":"string","enum":["pages","since","exhausted","cursor_stalled","repeated_content","deadline","blocked","caught_up"],"description":"Why the walk stopped. `pages`: the page budget is spent and `next_cursor` continues it. `deadline`: the call ran out of time before its next page; `next_cursor` continues it. `since`: a whole page was older than `since`. `exhausted`: LinkedIn reported the end. `cursor_stalled`: LinkedIn claimed more but repeated or omitted its cursor. `repeated_content`: a page held only items already seen. `blocked`: LinkedIn refused a later page; `next_cursor` is the page it refused. `caught_up`: only watch passes the crawler runs for itself stop this way."},"coverage":{"$ref":"#/components/schemas/Coverage"}}},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"items":[{"id":"4369199005","title":"Powertrain Performance Engineer - Screamin' Eagle","company":{"id":null,"username":"harley-davidson-motor-company","full_name":"Harley-Davidson Motor Company","is_verified":null,"is_private":null,"avatar_url":null,"latest_story_at":null,"extra":{"account_kind":"company"}},"location":"Wauwatosa, WI","employment_type":null,"seniority_level":null,"workplace_type":null,"description":null,"skills":[],"published_at":"2026-08-17T00:00:00+00:00","expires_at":null,"applicants":null,"url":"https://www.linkedin.com/jobs/view/powertrain-performance-engineer-screamin-eagle-at-harley-davidson-motor-company-4369199005","apply_url":null,"extra":{"benefits":null,"partial":true,"published_at_approximate":false}},{"id":"4425748422","title":"Professional Engineer - Public Works - Traffic Engineering","company":null,"location":"Springfield, MO","employment_type":null,"seniority_level":null,"workplace_type":null,"description":null,"skills":[],"published_at":"2026-05-29T00:00:00+00:00","expires_at":null,"applicants":null,"url":"https://www.linkedin.com/jobs/view/professional-engineer-public-works-traffic-engineering-at-city-of-santa-fe-springs-4425748422","apply_url":null,"extra":{"benefits":"Be an early applicant","partial":true,"published_at_approximate":false}}],"pages":[{"cursor":null,"fetched_at":"2026-10-27T20:38:46.009857+00:00","count":2}],"next_cursor":"eyJvcCI6InNlYXJjaF9qb2JzIiwic3RhcnQiOiIxMCJ9","has_more":true,"stop_reason":"pages","coverage":{"since":null,"oldest_at":"2026-05-29T00:00:00+00:00","since_reached":false}},"meta":{"source":"live","fetched_at":"2026-10-27T20:38:46.009857+00:00","cost":"$0.0005","balance":"$0.9990","request_id":"req_ceeb5e5e6bafe3e8f33e911189f1ea07"}}}}},"202":{"description":"Durable job accepted. No completed-result charge. Save batch_id; poll status_url. Retry submission with the same Idempotency-Key after a lost response. An account may have five queued, running or payment-required jobs. A sixth new job returns 429 rate_limited. Matching idempotent replays still work at the limit. Ready and failed jobs release their slots; pages within a job remain unbounded. This is a synthetic contract example, not a live capture.","x-example-provenance":"synthetic-contract","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","required":["batch_id","status","status_url","results_url","cost","item_count","error","retry_at","total","done_count","failed_count","created_at","started_at","finished_at"],"properties":{"batch_id":{"type":"string"},"status":{"type":"string","enum":["queued","running","payment_required","ready","failed"]},"status_url":{"type":"string"},"results_url":{"type":"string"},"cost":{"type":"string"},"item_count":{"type":"integer","nullable":true},"error":{"type":"string","nullable":true,"description":"Null unless failed. A failed target carries its own code; incomplete_result appears only when it has none and pages of the result are missing. profile_not_found, post_not_found, upstream_not_found or not_found: the target does not exist or is not visible. not_visible: The account exists, but its posts are not visible to logged-out readers (private, restricted, or hidden by Instagram). Retrying will not change the result until the account changes. not_cached: cached=cache_only found no saved read. incomplete_result: pages of the result are missing. temporarily_unavailable: the target could not be read for now (no capacity, a pause or repeated refusals); retry later with a new job. result_item_too_large: one result unit exceeds the delivery budget. result_snapshot_missing or result_snapshot_corrupt: the crawler could not serve the retained result of a paid job, and its charge is refunded; if the crawler serves it again, a later results read returns it and charges the job again. crawler_submit_400, crawler_submit_404 or crawler_submit_422: the crawl service refused the job request. crawler_job_failed: any other failure; the same job is not expected to succeed if resubmitted. cancelled: the job was cancelled with POST /v1/jobs/{job_id}/cancel. No failed job costs anything: only result_snapshot_missing and result_snapshot_corrupt follow a charge, and that charge is refunded."},"retry_at":{"type":"string","format":"date-time","nullable":true,"description":"Null unless the job failed temporarily_unavailable because a crawl route was closed for every caller. Then it is when the route opens again, and the response carries the same time as a Retry-After header in seconds. Submit a new job after it."},"total":{"type":"integer","description":"Targets in the job. A job submitted through a /v1 route has one."},"done_count":{"type":"integer","description":"Targets the crawler finished."},"failed_count":{"type":"integer","description":"Targets that failed."},"created_at":{"type":"string","format":"date-time","description":"When the job was submitted."},"started_at":{"type":"string","format":"date-time","nullable":true,"description":"When the crawler started the job. Null until it starts."},"finished_at":{"type":"string","format":"date-time","nullable":true,"description":"When the job finished or failed. Null while it is queued or running."}}},"meta":{"type":"object","required":["cost","request_id"],"properties":{"cost":{"type":"string","example":"$0.0000"},"request_id":{"type":"string"}}}}},"example":{"data":{"batch_id":"job_7641d5f0-717d-4b70-a2f1-f58d846d7242","status":"queued","status_url":"/v1/jobs/job_7641d5f0-717d-4b70-a2f1-f58d846d7242","results_url":"/v1/jobs/job_7641d5f0-717d-4b70-a2f1-f58d846d7242/results","cost":"$0.0000","item_count":null,"error":null,"retry_at":null,"total":1,"done_count":0,"failed_count":0,"created_at":"2026-10-12T12:56:17.403Z","started_at":null,"finished_at":null},"meta":{"cost":"$0.0000","request_id":"req_job_example"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"404":{"description":"`cached=cache_only` found nothing saved for these arguments (`not_cached`; call again with `cached=auto` to fetch it), or the LinkedIn account or item does not exist (`not_found`). You are not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_cached","message":"no saved linkedin/search_jobs read for 'engineer'. cached=cache_only never fetches, so call again with cached=auto to fetch it. You are not charged.","request_id":"req_5c10900e919bc7a3ff79b7501d582b4c"}}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/linkedin/job":{"get":{"tags":["LinkedIn"],"operationId":"liJob","summary":"job","x-dashboard-cost":"$0.0005","x-example-query":{"id":"4426792692"},"description":"One job posting with its description, criteria, applicants and company. A closed job answers with `extra.closed` true. Returns `LinkedInJob` under `data`. LinkedIn is read as a signed-out guest and every upstream document is an HTML page, so `get_raw` is not available.\n\nA field LinkedIn does not carry is null, a list it does not carry is `[]`, and LinkedIn-only facts sit under `extra`. Unknown, unsupported, and repeated query parameters return 400 before acquisition or billing.","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"query","required":true,"description":"The numeric LinkedIn job id.","example":"4426792692","schema":{"type":"string"}},{"name":"cached","in":"query","required":false,"description":"`auto` (default) serves a read saved within the last 24 hours for these exact arguments, otherwise fetches. `cache_only` never contacts LinkedIn (404 `not_cached` when nothing is saved, whatever its age). `live` always fetches. Anything else is a `400`.","schema":{"type":"string","enum":["auto","cache_only","live"],"default":"auto"},"examples":{"default":{"value":"auto","x-disabled":true}}},{"name":"get_raw","in":"query","required":false,"description":"Not available on this operation: the upstream document is an HTML page, and `true` answers 400. The default `false` returns the normalized type.","schema":{"type":"boolean","default":false},"examples":{"default":{"value":false,"x-disabled":true}}}],"responses":{"200":{"description":"`LinkedInJob` under `data`.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/LinkedInJob"},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"id":"4426792692","title":"Principal Applied Scientist - CoreAI","company":{"id":"1035","username":"microsoft","full_name":"Microsoft","is_verified":null,"is_private":null,"avatar_url":null,"latest_story_at":null,"extra":{"account_kind":"company"}},"location":"Redmond, WA","employment_type":"Full-time","seniority_level":"Not Applicable","workplace_type":null,"description":"Overview The CoreAI organization at Microsoft builds the end-to-end Artificial Intelligence (AI) stack and is core to Azure AI innovation and differentiation, as well as all of Microsoft’s flagship products, from GitHub, to Office, Teams, and Xbox. We are the team building Responsible AI, Azure OpenAI, Model as a Service, Azure Machine Learning (ML), Cognitive Services, and the global Azure AI infrastructure for running the largest AI workloads on the planet. We ensure Microsoft ships AI systems that are safe, secure, and trustworthy—empowering every person and organization on the planet to achieve more. Our team sits at the intersection of cutting-edge AI research and planet-scale production systems, powering technologies like GitHub Copilot and Azure OpenAI. We are looking for a Principal Applied Scientist to join our team! Microsoft’s mission is to empower every person and every organization on the planet to achieve more. As employees we come together with a growth mindset, innovate to empower others, and collaborate to realize our shared goals. Each day we build on our values of respect, integrity, and accountability to create a culture of inclusion where everyone can thrive at work and beyond. In alignment with our Microsoft values, we are committed to cultivating an inclusive work environment for all employees to positively impact our culture every day. Responsibilities In this role you’ll develop machine learning techniques that push the boundaries of safety, alignment, and trustworthy AI. You’ll collaborate across product, research, and engineering teams to design, build, and maintain responsible AI systems that make an impact at scale—from early-stage development and experimentation to production, monitoring, and continuous iteration. Qualifications Required Qualifications: Bachelor's Degree in Computer Science, Computational Linguistics, or related field AND 6+ years related experience (e.g., statistics, predictive analytics, research) OR Master's Degree in Computer Science, Computational Linguistics or related field AND 4+ years related experience (e.g., statistics, predictive analytics, research) OR Doctorate in Computer Science, Computational Linguistics, or related field AND 3+ years related experience (e.g., statistics, predictive analytics, research) OR equivalent experience. Other Requirements Ability to meet Microsoft, customer and/or government security screening requirements are required for this role. These requirements include but are not limited to the following specialized security screenings: Microsoft Cloud Background Check: This position will be required to pass the Microsoft Cloud background check upon hire/transfer and every two years thereafter. Preferred Qualifications Experience and familiarity with large language models (LLMs). Experience with and a solid foundation in large distributed systems, algorithms, and software engineering principles. Master’s or PhD in Computer Science, Machine Learning, Data Science, or a related field. 5+ years of experience in a research/ML engineering or an applied research scientist position, ideally with a focus on AI safety. Have hands-on experience with deep learning and transformer-based models Excel at problem-solving and analytics, with a proactive approach to challenges Thrive in fast-moving environments where priorities shift and definitions evolve. Enjoy taking ownership end-to-end and learning whatever is necessary to get results. Comfortable working independently while thriving in cross-team collaborations. Understand methods for training and fine-tuning LLMs, including distillation, supervised fine-tuning, and policy optimization. #coreai Applied Sciences IC5 - The typical base pay range for this role across the U.S. is USD $142,800 - $274,800 per year. There is a different range applicable to specific work locations, within the San Francisco Bay area and New York City metropolitan area, and the base pay range for this role in those locations is USD $188,000 - $304,200 per year. Certain roles may be eligible for benefits and other compensation. Find additional benefits and pay information here: https://careers.microsoft.com/us/en/us-corporate-pay Applied Sciences IC6 - The typical base pay range for this role across the U.S. is USD $165,600 - $296,400 per year. There is a different range applicable to specific work locations, within the San Francisco Bay area and New York City metropolitan area, and the base pay range for this role in those locations is USD $220,800 - $331,200 per year. Certain roles may be eligible for benefits and other compensation. Find additional benefits and pay information here: https://careers.microsoft.com/us/en/us-corporate-pay This position will be open for a minimum of 5 days, with applications accepted on an ongoing basis until the position is filled. Microsoft is an equal opportunity employer. All qualified applicants will receive consideration for employment without regard to age, ancestry, citizenship, color, family or medical care leave, gender identity or expression, genetic information, immigration status, marital status, medical condition, national origin, physical or mental disability, political affiliation, protected veteran or military status, race, ethnicity, religion, sex (including pregnancy), sexual orientation, or any other characteristic protected by applicable local laws, regulations and ordinances. If you need assistance with religious accommodations and/or a reasonable accommodation due to a disability during the application process, read more about requesting accommodations.","skills":[],"published_at":"2026-10-20T20:38:51.093805+00:00","expires_at":null,"applicants":91,"url":"https://www.linkedin.com/jobs/view/4426792692","apply_url":null,"extra":{"criteria":{"seniority level":"Not Applicable","employment type":"Full-time","industries":"Software Development"},"include_skills_available":false,"closed":false,"posted_text":"1 week ago","published_at_approximate":true,"applicants_text":"91 applicants","applicant_count_min":null,"applicant_count_below":null}},"meta":{"source":"live","fetched_at":"2026-10-27T20:38:51.099726+00:00","cost":"$0.0005","balance":"$0.9990","request_id":"req_cac21f5aa06e0c7c499ce2a56283b682"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"404":{"description":"`cached=cache_only` found nothing saved for these arguments (`not_cached`; call again with `cached=auto` to fetch it), or the LinkedIn account or item does not exist (`not_found`). You are not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_cached","message":"no saved linkedin/job read for '4426792692'. cached=cache_only never fetches, so call again with cached=auto to fetch it. You are not charged.","request_id":"req_5c10900e919bc7a3ff79b7501d582b4c"}}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/linkedin/post":{"get":{"tags":["LinkedIn"],"operationId":"liPost","summary":"post","x-dashboard-cost":"$0.0005","x-example-query":{"url":"https://www.linkedin.com/posts/openai_openai-bio-bug-bounty-activity-7481413628601229312-Lbc7"},"description":"One post with its author, reactions, comments and reposts. `extra.comments` holds the first comments the guest page shows; LinkedIn pages no further comments to a signed-out reader. Returns `Post` under `data`. LinkedIn is read as a signed-out guest and every upstream document is an HTML page, so `get_raw` is not available.\n\nA field LinkedIn does not carry is null, a list it does not carry is `[]`, and LinkedIn-only facts sit under `extra`. Unknown, unsupported, and repeated query parameters return 400 before acquisition or billing.","security":[{"bearerAuth":[]}],"parameters":[{"name":"url","in":"query","required":true,"description":"A linkedin.com/posts or /feed/update URL, or the numeric activity id.","example":"https://www.linkedin.com/posts/openai_openai-bio-bug-bounty-activity-7481413628601229312-Lbc7","schema":{"type":"string"}},{"name":"cached","in":"query","required":false,"description":"`auto` (default) serves a read saved within the last 24 hours for these exact arguments, otherwise fetches. `cache_only` never contacts LinkedIn (404 `not_cached` when nothing is saved, whatever its age). `live` always fetches. Anything else is a `400`.","schema":{"type":"string","enum":["auto","cache_only","live"],"default":"auto"},"examples":{"default":{"value":"auto","x-disabled":true}}},{"name":"get_raw","in":"query","required":false,"description":"Not available on this operation: the upstream document is an HTML page, and `true` answers 400. The default `false` returns the normalized type.","schema":{"type":"boolean","default":false},"examples":{"default":{"value":false,"x-disabled":true}}}],"responses":{"200":{"description":"`Post` under `data`.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/Post"},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"id":"7481413628601229312","shortcode":null,"taken_at":"2026-07-10T18:26:46.986000+00:00","kind":null,"product_type":"text","caption":"As part of our ongoing efforts to strengthen our safeguards for advanced AI capabilities in biology, we’re evolving our Bio Bug Bounty into an ongoing private program, known as the OpenAI Bio Bug Bounty program and doubling rewards to $50K. We’re inviting researchers with experience in AI red teaming, security, or biosecurity to try to find a universal jailbreak that can defeat our predefined biosafety challenge against OpenAI’s frontier models. https://lnkd.in/eb8_Y_NB","hashtags":[],"mentions":[],"accessibility_caption":null,"likes":961,"comments":135,"views":null,"counts_hidden":null,"comments_disabled":null,"is_pinned":null,"is_paid_partnership":null,"owner":{"id":"11130470","username":"openai","full_name":"OpenAI 12,056,703 followers 3mo","is_verified":null,"is_private":null,"avatar_url":null,"latest_story_at":null,"extra":{"account_kind":"company"}},"coauthors":[],"sponsors":[],"tagged":[],"location":null,"audio":null,"thumbnail_url":null,"video_duration":null,"media":[],"media_urls":[],"extra":{"url":"https://www.linkedin.com/feed/update/urn:li:activity:7481413628601229312/","canonical_urn":"urn:li:activity:7481413628601229312","reposts":null,"likes_approximate":false,"comments_approximate":false,"comments":[{"id":"7481415220238884865","text":"$50K for a universal biosafety jailbreak is a serious signal. OpenAI are acknowledging the threat is real enough to put significant money behind finding it before someone else does. SPECTER ORACLE runs autonomous LLM-vs-LLM jailbreaking — DeepSeek R1 as the attacker, 10 strategies, 97.14% ASR across frontier models. The biosafety challenge is a constrained version of what SPECTER COGBURN and SPECTER JACKAL do systematically. The question worth asking is whether a private bug bounty programme with pre-defined challenge parameters actually finds the most dangerous jailbreaks — or whether the most dangerous ones are the ones that bypass the challenge definition itself. Red Specter Security Research","created_at":"2026-07-10T18:33:06.479000+00:00","likes":32,"replies":null,"liked_by_owner":null,"owner":{"id":null,"username":"richard-b-42469439b","full_name":"Richard B","is_verified":null,"is_private":null,"avatar_url":null,"latest_story_at":null,"extra":{"account_kind":"member"}},"extra":{"canonical_urn":"urn:li:comment:(urn:li:activity:7481413628601229312,7481415220238884865)","is_partial":true}},{"id":"7481416140829868033","text":"The success criterion is doing a lot of work here. \"Universal jailbreak\" assumes one pattern that breaks the guardrail across contexts. In security audits I almost never see that vector in the wild. What actually works is multi-turn escalation, closer to manipulation psychology than to a single magic prompt. Foot-in-the-door works on models much like it works on people. A predefined challenge will measure the spectacular scenario. Whether it measures the common one is the harder question.","created_at":"2026-07-10T18:36:45.965000+00:00","likes":3,"replies":null,"liked_by_owner":null,"owner":{"id":null,"username":"marek-porycki","full_name":"Marek Porycki","is_verified":null,"is_private":null,"avatar_url":null,"latest_story_at":null,"extra":{"account_kind":"member"}},"extra":{"canonical_urn":"urn:li:comment:(urn:li:activity:7481413628601229312,7481416140829868033)","is_partial":true}}]}},"meta":{"source":"live","fetched_at":"2026-10-27T20:38:50.818781+00:00","cost":"$0.0005","balance":"$0.9990","request_id":"req_5554851f6bceac105431187cc61b2e91"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"404":{"description":"`cached=cache_only` found nothing saved for these arguments (`not_cached`; call again with `cached=auto` to fetch it), or the LinkedIn account or item does not exist (`not_found`). You are not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_cached","message":"no saved linkedin/post read for 'https://www.linkedin.com/posts/openai_openai-bio-bug-bounty-activity-7481413628601229312-Lbc7'. cached=cache_only never fetches, so call again with cached=auto to fetch it. You are not charged.","request_id":"req_5c10900e919bc7a3ff79b7501d582b4c"}}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/linkedin/ad":{"get":{"tags":["LinkedIn"],"operationId":"liAd","summary":"ad","x-dashboard-cost":"$0.0025","x-example-query":{"ad":"1498307266"},"description":"One Ad Library ad: advertiser, payer, format, copy, run dates, impressions and targeting. Returns `LinkedInAd` under `data`. LinkedIn is read as a signed-out guest and every upstream document is an HTML page, so `get_raw` is not available.\n\nA field LinkedIn does not carry is null, a list it does not carry is `[]`, and LinkedIn-only facts sit under `extra`. Unknown, unsupported, and repeated query parameters return 400 before acquisition or billing.","security":[{"bearerAuth":[]}],"parameters":[{"name":"ad","in":"query","required":true,"description":"The numeric Ad Library ad id, or its ad-library detail URL.","example":"1498307266","schema":{"type":"string"}},{"name":"cached","in":"query","required":false,"description":"`auto` (default) serves a read saved within the last 24 hours for these exact arguments, otherwise fetches. `cache_only` never contacts LinkedIn (404 `not_cached` when nothing is saved, whatever its age). `live` always fetches. Anything else is a `400`.","schema":{"type":"string","enum":["auto","cache_only","live"],"default":"auto"},"examples":{"default":{"value":"auto","x-disabled":true}}},{"name":"get_raw","in":"query","required":false,"description":"Not available on this operation: the upstream document is an HTML page, and `true` answers 400. The default `false` returns the normalized type.","schema":{"type":"boolean","default":false},"examples":{"default":{"value":false,"x-disabled":true}}}],"responses":{"200":{"description":"`LinkedInAd` under `data`.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/LinkedInAd"},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"id":"1498307266","advertiser":null,"advertiser_type":"member","payer":"KLK Consulting","format":"Single Image Ad","ad_copy":"Two AI Stumbles in One Week: Why Values-Based Leadership Must Be Distributed\n\nIn the space of just three days this month, two major AI companies highlighted a critical weakness in how leadership is practiced today.\n\nOn July 10, Apple filed a lawsuit alleging that OpenAI's hardware division, led by former Apple executive Tang Tan, engaged in a coordinated effort to steal trade secrets. Just three days earlier, Meta launched a feature in its new Muse Image tool that allowed users to generate AI images of people by simply tagging their public Instagram accounts — with the feature turned on by default and no notification to the person whose likeness was used. Meta removed the feature days later after widespread backlash.\n\nThese incidents are very different in nature. The allegations against OpenAI, if true, point to something deeper than a miscalculation. They suggest a potential breakdown in ethical boundaries at a leadership level inside a high-growth organization. Meta's case, while serious, looks more like a failure of judgment — moving fast under competitive pressure without properly accounting for user expectations around consent and likeness rights.\n\nWhat connects both cases is this: when the financial and competitive stakes are extremely high, internal pressure can distort decision-making. Even experienced leaders are influenced by the culture and incentives around them. Company culture is not neutral — it either reinforces ethical guardrails or makes it easier to overlook them.\n\nIn my book AI L4IR: Leadership and the 4th Industrial Revolution, I argue that ethical leadership in this era cannot remain concentrated at the top. It must be highly distributed — embedded in how product teams, engineers, recruiters, and middle managers make decisions every day.\n\nWhen billions of dollars and strategic positioning are on the line, relying on a small group of senior leaders to catch every ethical risk is unrealistic. Organizations that build cultures where people at all levels feel empowered (and expected) to ask \"Should we?\" — not just \"Can we?\" — will be far better positioned to innovate responsibly and maintain trust.\n\n#AI #Leadership #AIISV AI Institute of Silicon Valley Manoj Fernando Farooq Ali\n\nI explore both incidents and the broader leadership implications in more detail here:\nhttps://radi8.it/nqanzN8\n\nHow are you thinking about building stronger ethical decision-making into your teams as AI capabilities continue to advance?","media_urls":["https://media.licdn.com/dms/image/v2/D5622AQHBziNgyJBv3g/feedshare-image-high-res/B56Z9THumEGUAU-/0/1783805962934?e=2147483647&v=beta&t=9FRvZ2QyiNGOqxpEoef85QqhwgJ5NoHDVXvMcMP_now"],"destination_urls":["https://radi8.it/nqanzN8"],"impression_start":null,"impression_end":null,"impressions_exact":null,"impressions_min":null,"impressions_max":null,"targeting":{},"restricted":false,"url":"https://www.linkedin.com/ad-library/detail/1498307266","extra":{"advertiser_url":"https://www.linkedin.com/in/kent-kaufman-b475552","partial":false,"creative_type":"SPONSORED_STATUS_UPDATE","advertiser_logo_url":"https://media.licdn.com/dms/image/v2/C5603AQHwWB-2oxc3OQ/profile-displayphoto-shrink_100_100/profile-displayphoto-shrink_100_100/0/1516271492041?e=1794441600&v=beta&t=z0k8gBUVO4Ksog1yUmV5jVTJJ1kJOIKRSyIlu7bUt9A"}},"meta":{"source":"live","fetched_at":"2026-10-27T20:40:21.268630+00:00","cost":"$0.0025","balance":"$0.9875","request_id":"req_cbbb1feb8c5b5caa7e3ac95f4f183b9c"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"404":{"description":"`cached=cache_only` found nothing saved for these arguments (`not_cached`; call again with `cached=auto` to fetch it), or the LinkedIn account or item does not exist (`not_found`). You are not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_cached","message":"no saved linkedin/ad read for '1498307266'. cached=cache_only never fetches, so call again with cached=auto to fetch it. You are not charged.","request_id":"req_5c10900e919bc7a3ff79b7501d582b4c"}}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/linkedin/ads_search":{"get":{"tags":["LinkedIn"],"operationId":"liAdsSearch","summary":"ads_search","x-dashboard-cost":"$0.0025/24","x-example-query":{"keyword":"software","max_pages":"1"},"description":"The Ad Library's search for a keyword, 24 ads a page, each read from its detail page. Returns `Page[LinkedInAd]` under `data`. LinkedIn is read as a signed-out guest and every upstream document is an HTML page, so `get_raw` is not available.\n\nThe default request creates a durable job (202). Use max_pages=1 for one synchronous Page response (200). Poll status_url, then read results_url with its opaque cursor. Acquisition stops at the first of since, max_pages, or exhaustion. Jobs continue after disconnects. Result responses are bounded to 3 MiB; this does not limit the crawl. Supply Idempotency-Key to recover a lost submission response; reuse it with the same inputs. LinkedIn sets every page’s size, so there is no `page_size`.\n\nA field LinkedIn does not carry is null, a list it does not carry is `[]`, and LinkedIn-only facts sit under `extra`. Unknown, unsupported, and repeated query parameters return 400 before acquisition or billing.\n\nBilling: $0.0025 per 24 unique returned items (one native page), rounded up to a minimum of one billing unit. Jobs settle once after successful completion. Submission, polling and repeat downloads are free.","security":[{"bearerAuth":[]}],"parameters":[{"name":"keyword","in":"query","required":true,"description":"The words to search ad copy for, up to 200 characters.","example":"software","schema":{"type":"string"}},{"name":"countries","in":"query","required":false,"description":"Comma-separated two-letter country codes.","schema":{"type":"string"}},{"name":"start_date","in":"query","required":false,"description":"Only ads shown on or after this date, `YYYY-MM-DD`.","schema":{"type":"string","format":"date"}},{"name":"end_date","in":"query","required":false,"description":"Only ads shown on or before this date, `YYYY-MM-DD`.","schema":{"type":"string","format":"date"}},{"name":"since","in":"query","required":false,"description":"Not accepted on this operation: its items carry no timestamp, so since returns 400 before billing.","schema":{"type":"string"}},{"name":"max_pages","in":"query","required":false,"example":1,"description":"Maximum pages to fetch. -1 walks until exhaustion or since with no page cap, and must be written. Omitted, since alone bounds the walk; with neither, the job stops after 10 pages. Any positive integer is accepted. 1 returns one page synchronously with HTTP 200; any other value creates a durable job with HTTP 202.","schema":{"type":"integer","anyOf":[{"enum":[-1]},{"minimum":1}]}},{"name":"cursor","in":"query","required":false,"description":"Opaque next_cursor from an earlier answer of this operation, also with `get_raw=true`. A native LinkedIn cursor from a raw page answers 400. Result download cursors belong to the results route.","schema":{"type":"string","minLength":1}},{"name":"cached","in":"query","required":false,"description":"`auto` (default) serves a read saved within the last 24 hours for these exact arguments, otherwise fetches. `cache_only` never contacts LinkedIn (404 `not_cached` when nothing is saved, whatever its age). `live` always fetches. Anything else is a `400`. `cache_only` reads one saved page per request: omit `max_pages` or pass 1, and continue with `next_cursor`.","schema":{"type":"string","enum":["auto","cache_only","live"],"default":"auto"},"examples":{"default":{"value":"auto","x-disabled":true}}},{"name":"get_raw","in":"query","required":false,"description":"Not available on this operation: the upstream document is an HTML page, and `true` answers 400. The default `false` returns the normalized type.","schema":{"type":"boolean","default":false},"examples":{"default":{"value":false,"x-disabled":true}}},{"name":"Idempotency-Key","in":"header","required":false,"description":"Reuse this key with the same inputs to recover a lost job submission. A different input with the same key returns 409.","schema":{"type":"string","minLength":1,"maxLength":200}}],"responses":{"200":{"description":"`Page[LinkedInAd]` under `data`.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","required":["items","pages","next_cursor","has_more","stop_reason","coverage"],"properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/LinkedInAd"},"description":"`LinkedInAd` of every page walked, in page order."},"pages":{"type":"array","items":{"$ref":"#/components/schemas/PageRead"},"description":"One entry per page walked."},"next_cursor":{"type":"string","nullable":true,"description":"Opaque; pass back as `cursor` to continue."},"has_more":{"type":"boolean","description":"True when `next_cursor` is set, and when the walk stopped `cursor_stalled` on a page that said more results exist but gave no cursor to send back."},"stop_reason":{"type":"string","enum":["pages","since","exhausted","cursor_stalled","repeated_content","deadline","blocked","caught_up"],"description":"Why the walk stopped. `pages`: the page budget is spent and `next_cursor` continues it. `deadline`: the call ran out of time before its next page; `next_cursor` continues it. `since`: a whole page was older than `since`. `exhausted`: LinkedIn reported the end. `cursor_stalled`: LinkedIn claimed more but repeated or omitted its cursor. `repeated_content`: a page held only items already seen. `blocked`: LinkedIn refused a later page; `next_cursor` is the page it refused. `caught_up`: only watch passes the crawler runs for itself stop this way."},"coverage":{"$ref":"#/components/schemas/Coverage"}}},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"items":[{"id":"1659333856","advertiser":{"id":"18034307","username":null,"full_name":"Proa Energy","is_verified":null,"is_private":null,"avatar_url":null,"latest_story_at":null,"extra":{"account_kind":"company"}},"advertiser_type":"company","payer":"PROA ENERGY AUSTRALIA PTY LTD","format":"Single Image Ad","ad_copy":"Two stands. One connected platform.\n\nProa is heading to All Energy Australia in Melbourne this week, showcasing how NEXO connects technology in the field with intelligence in the cloud.\n\nOn 28–29 October, find us at:\n\nNEXO Site – Stand CC119\nExplore our hardware solutions, including MetCube weather stations and MetProtect technology.\n\nNEXO Cloud – Stand BB102\nSee how our software transforms asset data into better forecasting, bidding and dispatch decisions.\n\nVisit both stands to experience the full NEXO ecosystem, from data collection at the asset to smarter operational and market decisions.\n\nMeet our team, including founder and CEO Dr Victor Depoorter, and discover how NEXO can help you get more from your energy assets.\n\nWant to meet with the team? Book a time with us in advance or simply drop by either stand.\n\n👉 Book a meeting with us here: https://lnkd.in/g6TXUT8Y\n\nSee you all at All Energy Australia!\n\nVictor Depoorter Taylor Gleeson (Corder) Denis Silva Cam Hodkinson\n\n#AllEnergyAustralia #NEXO #RenewableEnergy #EnergyIntelligence #EnergyTechnology","media_urls":["https://media.licdn.com/dms/image/v2/D5622AQHXl2JqosGg-g/feedshare-shrink_1280/B56aF1F3SpGgAM-/0/1792965834406?e=2147483647&v=beta&t=7lPwRbalrI13SkwEUnF9gQZhTKN9qeAPSbluHLbn0LQ"],"destination_urls":["https://lnkd.in/g6TXUT8Y"],"impression_start":null,"impression_end":null,"impressions_exact":null,"impressions_min":null,"impressions_max":null,"targeting":{},"restricted":false,"url":"https://www.linkedin.com/ad-library/detail/1659333856","extra":{"advertiser_url":"https://www.linkedin.com/company/18034307","partial":false,"creative_type":"SPONSORED_STATUS_UPDATE","advertiser_logo_url":"https://media.licdn.com/dms/image/v2/D560BAQGRbQEZQ3Be5w/company-logo_100_100/B56aFcTzL3GgAI-/0/1792550056944/proa_energy_logo?e=1794441600&v=beta&t=_TMGmyan-I57viorZqpzvxpkAROHFiYmsbJPfGeSlpo"}},{"id":"1611783824","advertiser":{"id":"31431064","username":null,"full_name":"SWEEP","is_verified":null,"is_private":null,"avatar_url":null,"latest_story_at":null,"extra":{"account_kind":"company"}},"advertiser_type":"company","payer":"SWEEP","format":"Single Image Ad","ad_copy":"Verifiable ESG data is what unlocks green financing and stronger valuations.\n\nSweep keeps yours audit-ready before investors ever ask.","media_urls":["https://media.licdn.com/dms/image/v2/D4E10AQFdsTUz-0OgFw/image-shrink_1280/B4EaF1Fto0JgAc-/0/1792965794669/1440x1440-t1-d31png?e=2147483647&v=beta&t=bbC1OrzBPyxRWEnSDd_XB5dnWeKr1zXJ32dFbYwI0T0"],"destination_urls":["https://www.sweep.net/?utm_source=linkedin&utm_medium=paid_social&utm_campaign=tam_2026_q4_eu_awareness&utm_content=awareness_refresh_fs_intro-1_head-1_t1-d3_light-blue_cta-learn-more&utm_id=1210200664&hsa_acc=510063887&hsa_cam=1210200664&hsa_grp=887357294&hsa_ad=1611783824&hsa_net=linkedin&hsa_ver=3"],"impression_start":"2026-10-25","impression_end":"2026-10-27","impressions_exact":null,"impressions_min":1000,"impressions_max":5000,"targeting":{"language":{"includes":["English"]},"location":{"includes":["Finland","Germany","Luxembourg","Luxembourg","Switzerland","Netherlands","France","Denmark","Sweden","Austria","Belgium","Norway"]},"parameters":{"audience":{"targeted":false,"excluded":true},"demographic":{"targeted":false,"excluded":false},"company":{"targeted":true,"excluded":true},"education":{"targeted":false,"excluded":false},"job":{"targeted":true,"excluded":true},"member_interests_and_traits":{"targeted":false,"excluded":false}}},"restricted":false,"url":"https://www.linkedin.com/ad-library/detail/1611783824","extra":{"advertiser_url":"https://www.linkedin.com/company/31431064","partial":false,"headline":"Turn ESG Data Into Financing Leverage","creative_type":"SPONSORED_STATUS_UPDATE","advertiser_logo_url":"https://media.licdn.com/dms/image/v2/D4E0BAQFO01Qi-WK2oQ/company-logo_100_100/company-logo_100_100/0/1720392364255/sweep_softwareforsustainability_logo?e=1794441600&v=beta&t=AR8cPzHJG9SJD3B9qZiBdFL7LOK7wtDm8LxvoID0aIM","impressions_label":"1k-5k","impressions_by_country":[{"country":"Sweden","share":"100%","percent":100}]}}],"pages":[{"cursor":null,"fetched_at":"2026-10-27T20:38:49.650301+00:00","count":2}],"next_cursor":"eyJvcCI6ImFkc19zZWFyY2giLCJwYWdpbmF0aW9uX3Rva2VuIjoiMTYxMTc0NjIxNC0xNzkyOTY1NjcyMTE0In0","has_more":true,"stop_reason":"pages","coverage":{"since":null,"oldest_at":null,"since_reached":false}},"meta":{"source":"live","fetched_at":"2026-10-27T20:38:49.650301+00:00","cost":"$0.0025","balance":"$0.9970","request_id":"req_99c54409d98a97601f5f67e4e35e72a5"}}}}},"202":{"description":"Durable job accepted. No completed-result charge. Save batch_id; poll status_url. Retry submission with the same Idempotency-Key after a lost response. An account may have five queued, running or payment-required jobs. A sixth new job returns 429 rate_limited. Matching idempotent replays still work at the limit. Ready and failed jobs release their slots; pages within a job remain unbounded. This is a synthetic contract example, not a live capture.","x-example-provenance":"synthetic-contract","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","required":["batch_id","status","status_url","results_url","cost","item_count","error","retry_at","total","done_count","failed_count","created_at","started_at","finished_at"],"properties":{"batch_id":{"type":"string"},"status":{"type":"string","enum":["queued","running","payment_required","ready","failed"]},"status_url":{"type":"string"},"results_url":{"type":"string"},"cost":{"type":"string"},"item_count":{"type":"integer","nullable":true},"error":{"type":"string","nullable":true,"description":"Null unless failed. A failed target carries its own code; incomplete_result appears only when it has none and pages of the result are missing. profile_not_found, post_not_found, upstream_not_found or not_found: the target does not exist or is not visible. not_visible: The account exists, but its posts are not visible to logged-out readers (private, restricted, or hidden by Instagram). Retrying will not change the result until the account changes. not_cached: cached=cache_only found no saved read. incomplete_result: pages of the result are missing. temporarily_unavailable: the target could not be read for now (no capacity, a pause or repeated refusals); retry later with a new job. result_item_too_large: one result unit exceeds the delivery budget. result_snapshot_missing or result_snapshot_corrupt: the crawler could not serve the retained result of a paid job, and its charge is refunded; if the crawler serves it again, a later results read returns it and charges the job again. crawler_submit_400, crawler_submit_404 or crawler_submit_422: the crawl service refused the job request. crawler_job_failed: any other failure; the same job is not expected to succeed if resubmitted. cancelled: the job was cancelled with POST /v1/jobs/{job_id}/cancel. No failed job costs anything: only result_snapshot_missing and result_snapshot_corrupt follow a charge, and that charge is refunded."},"retry_at":{"type":"string","format":"date-time","nullable":true,"description":"Null unless the job failed temporarily_unavailable because a crawl route was closed for every caller. Then it is when the route opens again, and the response carries the same time as a Retry-After header in seconds. Submit a new job after it."},"total":{"type":"integer","description":"Targets in the job. A job submitted through a /v1 route has one."},"done_count":{"type":"integer","description":"Targets the crawler finished."},"failed_count":{"type":"integer","description":"Targets that failed."},"created_at":{"type":"string","format":"date-time","description":"When the job was submitted."},"started_at":{"type":"string","format":"date-time","nullable":true,"description":"When the crawler started the job. Null until it starts."},"finished_at":{"type":"string","format":"date-time","nullable":true,"description":"When the job finished or failed. Null while it is queued or running."}}},"meta":{"type":"object","required":["cost","request_id"],"properties":{"cost":{"type":"string","example":"$0.0000"},"request_id":{"type":"string"}}}}},"example":{"data":{"batch_id":"job_7641d5f0-717d-4b70-a2f1-f58d846d7242","status":"queued","status_url":"/v1/jobs/job_7641d5f0-717d-4b70-a2f1-f58d846d7242","results_url":"/v1/jobs/job_7641d5f0-717d-4b70-a2f1-f58d846d7242/results","cost":"$0.0000","item_count":null,"error":null,"retry_at":null,"total":1,"done_count":0,"failed_count":0,"created_at":"2026-10-12T12:56:17.403Z","started_at":null,"finished_at":null},"meta":{"cost":"$0.0000","request_id":"req_job_example"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"404":{"description":"`cached=cache_only` found nothing saved for these arguments (`not_cached`; call again with `cached=auto` to fetch it), or the LinkedIn account or item does not exist (`not_found`). You are not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_cached","message":"no saved linkedin/ads_search read for 'software'. cached=cache_only never fetches, so call again with cached=auto to fetch it. You are not charged.","request_id":"req_5c10900e919bc7a3ff79b7501d582b4c"}}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/linkedin/company_ads":{"get":{"tags":["LinkedIn"],"operationId":"liCompanyAds","summary":"company_ads","x-dashboard-cost":"$0.0025/24","x-example-query":{"company":"Microsoft","max_pages":"1"},"description":"The ads one advertiser ran, 24 a page, each read from its detail page. Returns `Page[LinkedInAd]` under `data`. LinkedIn is read as a signed-out guest and every upstream document is an HTML page, so `get_raw` is not available.\n\nThe default request creates a durable job (202). Use max_pages=1 for one synchronous Page response (200). Poll status_url, then read results_url with its opaque cursor. Acquisition stops at the first of since, max_pages, or exhaustion. Jobs continue after disconnects. Result responses are bounded to 3 MiB; this does not limit the crawl. Supply Idempotency-Key to recover a lost submission response; reuse it with the same inputs. LinkedIn sets every page’s size, so there is no `page_size`.\n\nA field LinkedIn does not carry is null, a list it does not carry is `[]`, and LinkedIn-only facts sit under `extra`. Unknown, unsupported, and repeated query parameters return 400 before acquisition or billing.\n\nBilling: $0.0025 per 24 unique returned items (one native page), rounded up to a minimum of one billing unit. Jobs settle once after successful completion. Submission, polling and repeat downloads are free.","security":[{"bearerAuth":[]}],"parameters":[{"name":"company","in":"query","required":true,"description":"The advertiser’s numeric company id, or a name, which matches every advertiser whose Ad Library name holds it.","example":"Microsoft","schema":{"type":"string"}},{"name":"countries","in":"query","required":false,"description":"Comma-separated two-letter country codes.","schema":{"type":"string"}},{"name":"start_date","in":"query","required":false,"description":"Only ads shown on or after this date, `YYYY-MM-DD`.","schema":{"type":"string","format":"date"}},{"name":"end_date","in":"query","required":false,"description":"Only ads shown on or before this date, `YYYY-MM-DD`.","schema":{"type":"string","format":"date"}},{"name":"since","in":"query","required":false,"description":"Not accepted on this operation: its items carry no timestamp, so since returns 400 before billing.","schema":{"type":"string"}},{"name":"max_pages","in":"query","required":false,"example":1,"description":"Maximum pages to fetch. -1 walks until exhaustion or since with no page cap, and must be written. Omitted, since alone bounds the walk; with neither, the job stops after 10 pages. Any positive integer is accepted. 1 returns one page synchronously with HTTP 200; any other value creates a durable job with HTTP 202.","schema":{"type":"integer","anyOf":[{"enum":[-1]},{"minimum":1}]}},{"name":"cursor","in":"query","required":false,"description":"Opaque next_cursor from an earlier answer of this operation, also with `get_raw=true`. A native LinkedIn cursor from a raw page answers 400. Result download cursors belong to the results route.","schema":{"type":"string","minLength":1}},{"name":"cached","in":"query","required":false,"description":"`auto` (default) serves a read saved within the last 24 hours for these exact arguments, otherwise fetches. `cache_only` never contacts LinkedIn (404 `not_cached` when nothing is saved, whatever its age). `live` always fetches. Anything else is a `400`. `cache_only` reads one saved page per request: omit `max_pages` or pass 1, and continue with `next_cursor`.","schema":{"type":"string","enum":["auto","cache_only","live"],"default":"auto"},"examples":{"default":{"value":"auto","x-disabled":true}}},{"name":"get_raw","in":"query","required":false,"description":"Not available on this operation: the upstream document is an HTML page, and `true` answers 400. The default `false` returns the normalized type.","schema":{"type":"boolean","default":false},"examples":{"default":{"value":false,"x-disabled":true}}},{"name":"Idempotency-Key","in":"header","required":false,"description":"Reuse this key with the same inputs to recover a lost job submission. A different input with the same key returns 409.","schema":{"type":"string","minLength":1,"maxLength":200}}],"responses":{"200":{"description":"`Page[LinkedInAd]` under `data`.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","required":["items","pages","next_cursor","has_more","stop_reason","coverage"],"properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/LinkedInAd"},"description":"`LinkedInAd` of every page walked, in page order."},"pages":{"type":"array","items":{"$ref":"#/components/schemas/PageRead"},"description":"One entry per page walked."},"next_cursor":{"type":"string","nullable":true,"description":"Opaque; pass back as `cursor` to continue."},"has_more":{"type":"boolean","description":"True when `next_cursor` is set, and when the walk stopped `cursor_stalled` on a page that said more results exist but gave no cursor to send back."},"stop_reason":{"type":"string","enum":["pages","since","exhausted","cursor_stalled","repeated_content","deadline","blocked","caught_up"],"description":"Why the walk stopped. `pages`: the page budget is spent and `next_cursor` continues it. `deadline`: the call ran out of time before its next page; `next_cursor` continues it. `since`: a whole page was older than `since`. `exhausted`: LinkedIn reported the end. `cursor_stalled`: LinkedIn claimed more but repeated or omitted its cursor. `repeated_content`: a page held only items already seen. `blocked`: LinkedIn refused a later page; `next_cursor` is the page it refused. `caught_up`: only watch passes the crawler runs for itself stop this way."},"coverage":{"$ref":"#/components/schemas/Coverage"}}},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"items":[{"id":"1658527466","advertiser":{"id":"107855954","username":null,"full_name":"Microsoft in Business","is_verified":null,"is_private":null,"avatar_url":null,"latest_story_at":null,"extra":{"account_kind":"company"}},"advertiser_type":"company","payer":"Starcom Mediavest Group, Inc","format":"Carousel Ad","ad_copy":"Real demos. Real results. Real people. Real ROI. #MicrosoftFrontierTour is a one day, in-person experience for leaders like you. Request to attend.","media_urls":["https://media.licdn.com/dms/image/v2/D5610AQHoFff0Kyfyhg/image-pad_1200_1200/B4DaFqojGmJcAQ-/0/1792790377167?e=1793739600&v=beta&t=OHE99kfx3SyctzbVduX4BQkSw7pWgYvzGx0m_RaQQ5c","https://media.licdn.com/dms/image/v2/D5610AQGS7fdY0qJE2w/image-pad_1200_1200/B4DaFqojHAIwAU-/0/1792790377118?e=1793739600&v=beta&t=Uwt0B0RP9pDmQnSeG1IMxToxGNlXQItAGMwUN7RWuaE","https://media.licdn.com/dms/image/v2/D5610AQFLtVkNzLcFFQ/image-pad_1200_1200/B4DaFqojHpKUAQ-/0/1792790377190?e=1793739600&v=beta&t=USda3hfY4dkXz-oMCmmSKWuLvN0WaSCQB8p30EKv4-E","https://media.licdn.com/dms/image/v2/D5610AQGqrbv703Br8Q/image-pad_1200_1200/B4DaFqojIFHkAM-/0/1792790377261?e=1793739600&v=beta&t=lf7hBpkyerHYmN5cHTi6UD_Cm1bqL-Jqi5bqHE3BOpU"],"destination_urls":[],"impression_start":null,"impression_end":null,"impressions_exact":null,"impressions_min":null,"impressions_max":null,"targeting":{},"restricted":false,"url":"https://www.linkedin.com/ad-library/detail/1658527466","extra":{"advertiser_url":"https://www.linkedin.com/company/107855954","partial":false,"creative_type":"SPONSORED_UPDATE_CAROUSEL","advertiser_logo_url":"https://media.licdn.com/dms/image/v2/D560BAQGfxIUgUdeVww/company-logo_100_100/B56ZgZynj1HQAQ-/0/1752779356692?e=1794441600&v=beta&t=bBUsTdPotSMRELuKplZoxINU0E82LfVzbR-grzoT0fo"}},{"id":"1593053133","advertiser":{"id":"18224890","username":null,"full_name":"INKUBIT - Microsoft AI & Business Applications Partner","is_verified":null,"is_private":null,"avatar_url":null,"latest_story_at":null,"extra":{"account_kind":"company"}},"advertiser_type":"company","payer":"Inkubit Business Solutions GmbH","format":"Single Image Ad","ad_copy":"Ein KI-Agent für Deine Organisation. Nicht als Demo, sondern selbst gebaut.\n\nIm November laden wir Nonprofits gemeinsam mit Microsoft zu unserem 𝗢𝗻𝗹𝗶𝗻𝗲 𝗔𝗜 𝗔𝗴𝗲𝗻𝘁 𝗶𝗻 𝗮 𝗗𝗮𝘆 𝗪𝗼𝗿𝗸𝘀𝗵𝗼𝗽 ein.\n\nDu arbeitest hands-on an einem konkreten Use Case und baust selbst einen KI-Agenten. Zur Auswahl stehen der Spenden amp; Supporter Care Agent, der Recruiting amp; Onboarding Agent und der Service amp; FAQ Agent.\n\nDabei siehst Du direkt, was heute möglich ist und welche Daten, Prozesse und Informationen ein Agent braucht, um im Arbeitsalltag wirklich zu unterstützen.\n\nDer Workshop findet vollständig online statt. Du kannst also unabhängig von Deinem Standort teilnehmen.\n\nDie Teilnahme ist für Nonprofits kostenfrei. Die Plätze sind bewusst begrenzt.\n\nSichere Dir Deinen Platz und melde Dich direkt über unsere Website an:\n👉 https://lnkd.in/ej_faEwu","media_urls":["https://media.licdn.com/dms/image/v2/D4E22AQFsDzgdiPpmuw/feedshare-shrink_1280/B4EaFj4cj1JoAM-/0/1792677104162?e=2147483647&v=beta&t=chp9vSE2TRVbaFktfWllNQ4CoXmYmLwb4JD_nLi8yRI"],"destination_urls":["https://lnkd.in/ej_faEwu"],"impression_start":"2026-10-23","impression_end":"2026-10-27","impressions_exact":null,"impressions_min":1000,"impressions_max":5000,"targeting":{"language":{"includes":["English"]},"location":{"includes":["Germany","Switzerland","Austria"]},"parameters":{"audience":{"targeted":false,"excluded":false},"demographic":{"targeted":false,"excluded":false},"company":{"targeted":true,"excluded":false},"education":{"targeted":false,"excluded":false},"job":{"targeted":true,"excluded":false},"member_interests_and_traits":{"targeted":false,"excluded":false}}},"restricted":false,"url":"https://www.linkedin.com/ad-library/detail/1593053133","extra":{"advertiser_url":"https://www.linkedin.com/company/18224890","partial":false,"creative_type":"SPONSORED_STATUS_UPDATE","impressions_label":"1k-5k","impressions_by_country":[{"country":"Switzerland","share":"61%","percent":61},{"country":"Germany","share":"22%","percent":22},{"country":"Austria","share":"18%","percent":18}]}}],"pages":[{"cursor":null,"fetched_at":"2026-10-27T20:38:57.137087+00:00","count":2}],"next_cursor":"eyJvcCI6ImNvbXBhbnlfYWRzIiwicGFnaW5hdGlvbl90b2tlbiI6IjE2MTE1NjMzNDQtMTc5Mjc1NTM3NzcyNCJ9","has_more":true,"stop_reason":"pages","coverage":{"since":null,"oldest_at":null,"since_reached":false}},"meta":{"source":"live","fetched_at":"2026-10-27T20:38:57.137087+00:00","cost":"$0.0025","balance":"$0.9970","request_id":"req_930a531a1898c4d3cc72cba39fcdcd5c"}}}}},"202":{"description":"Durable job accepted. No completed-result charge. Save batch_id; poll status_url. Retry submission with the same Idempotency-Key after a lost response. An account may have five queued, running or payment-required jobs. A sixth new job returns 429 rate_limited. Matching idempotent replays still work at the limit. Ready and failed jobs release their slots; pages within a job remain unbounded. This is a synthetic contract example, not a live capture.","x-example-provenance":"synthetic-contract","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","required":["batch_id","status","status_url","results_url","cost","item_count","error","retry_at","total","done_count","failed_count","created_at","started_at","finished_at"],"properties":{"batch_id":{"type":"string"},"status":{"type":"string","enum":["queued","running","payment_required","ready","failed"]},"status_url":{"type":"string"},"results_url":{"type":"string"},"cost":{"type":"string"},"item_count":{"type":"integer","nullable":true},"error":{"type":"string","nullable":true,"description":"Null unless failed. A failed target carries its own code; incomplete_result appears only when it has none and pages of the result are missing. profile_not_found, post_not_found, upstream_not_found or not_found: the target does not exist or is not visible. not_visible: The account exists, but its posts are not visible to logged-out readers (private, restricted, or hidden by Instagram). Retrying will not change the result until the account changes. not_cached: cached=cache_only found no saved read. incomplete_result: pages of the result are missing. temporarily_unavailable: the target could not be read for now (no capacity, a pause or repeated refusals); retry later with a new job. result_item_too_large: one result unit exceeds the delivery budget. result_snapshot_missing or result_snapshot_corrupt: the crawler could not serve the retained result of a paid job, and its charge is refunded; if the crawler serves it again, a later results read returns it and charges the job again. crawler_submit_400, crawler_submit_404 or crawler_submit_422: the crawl service refused the job request. crawler_job_failed: any other failure; the same job is not expected to succeed if resubmitted. cancelled: the job was cancelled with POST /v1/jobs/{job_id}/cancel. No failed job costs anything: only result_snapshot_missing and result_snapshot_corrupt follow a charge, and that charge is refunded."},"retry_at":{"type":"string","format":"date-time","nullable":true,"description":"Null unless the job failed temporarily_unavailable because a crawl route was closed for every caller. Then it is when the route opens again, and the response carries the same time as a Retry-After header in seconds. Submit a new job after it."},"total":{"type":"integer","description":"Targets in the job. A job submitted through a /v1 route has one."},"done_count":{"type":"integer","description":"Targets the crawler finished."},"failed_count":{"type":"integer","description":"Targets that failed."},"created_at":{"type":"string","format":"date-time","description":"When the job was submitted."},"started_at":{"type":"string","format":"date-time","nullable":true,"description":"When the crawler started the job. Null until it starts."},"finished_at":{"type":"string","format":"date-time","nullable":true,"description":"When the job finished or failed. Null while it is queued or running."}}},"meta":{"type":"object","required":["cost","request_id"],"properties":{"cost":{"type":"string","example":"$0.0000"},"request_id":{"type":"string"}}}}},"example":{"data":{"batch_id":"job_7641d5f0-717d-4b70-a2f1-f58d846d7242","status":"queued","status_url":"/v1/jobs/job_7641d5f0-717d-4b70-a2f1-f58d846d7242","results_url":"/v1/jobs/job_7641d5f0-717d-4b70-a2f1-f58d846d7242/results","cost":"$0.0000","item_count":null,"error":null,"retry_at":null,"total":1,"done_count":0,"failed_count":0,"created_at":"2026-10-12T12:56:17.403Z","started_at":null,"finished_at":null},"meta":{"cost":"$0.0000","request_id":"req_job_example"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"404":{"description":"`cached=cache_only` found nothing saved for these arguments (`not_cached`; call again with `cached=auto` to fetch it), or the LinkedIn account or item does not exist (`not_found`). You are not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_cached","message":"no saved linkedin/company_ads read for 'Microsoft'. cached=cache_only never fetches, so call again with cached=auto to fetch it. You are not charged.","request_id":"req_5c10900e919bc7a3ff79b7501d582b4c"}}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/xiaohongshu/stored/note":{"get":{"tags":["Xiaohongshu"],"operationId":"xhsStoredNote","summary":"Stored note","x-dashboard-cost":"$0.0005","description":"The canonical RED note read model over the tracked corpus, including engagement, ordered source/mirrored media, author identity, and partial/full state. Strictly DB: a miss is 404 and never triggers acquisition. Read a fresh note with `/v1/xiaohongshu/note_detail`.","security":[{"bearerAuth":[]}],"parameters":[{"name":"q","in":"query","required":true,"description":"Bare lowercase 24-hex Xiaohongshu note ID. Never submit a Xiaohongshu URL: copied URLs may contain private `xsec_token` values and edge access logs run before application validation.","schema":{"type":"string","pattern":"^[0-9a-f]{24}$","minLength":24,"maxLength":24},"example":"6a4c1b350000000021023a9e"}],"responses":{"200":{"description":"Canonical stored Xiaohongshu note.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/XiaohongshuStoredNoteResponseData"},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"id":33,"note_id":"64469b250000000013016860","title":"探店/邯郸","caption":"推荐一家经常去的咖啡店 新世纪九楼 SOLOS\nCAFE\n两层工业风的装修风格 很安静 适合聊天学习谈\n事情～\n有饮品，小吃还有 意面（是推荐）~\n喜欢拍照的姐妹可以沖一下\nSOLOS CAFE：新世纪九层\n某音现在有团购 很合适\n#周末探店[话题]# #邯郸美食探店[话题]#","likes":169,"comments":16,"collected":31,"shares":8,"posted_at":"2023-04-24T15:07:17Z","note_type":"normal","is_video":false,"image_url":"https://api.virev.ai/v1/media/xiaohongshu_note/33/post_image","image_urls":["https://api.virev.ai/v1/media/xiaohongshu_note/33/post_image","https://api.virev.ai/v1/media/xiaohongshu_note/33/post_image_1","https://api.virev.ai/v1/media/xiaohongshu_note/33/post_image_2","https://api.virev.ai/v1/media/xiaohongshu_note/33/post_image_3","https://api.virev.ai/v1/media/xiaohongshu_note/33/post_image_4","https://api.virev.ai/v1/media/xiaohongshu_note/33/post_image_5","https://api.virev.ai/v1/media/xiaohongshu_note/33/post_image_6"],"video_url":null,"tags":["周末探店","邯郸美食探店"],"is_partial":false,"first_seen_at":"2026-10-27T21:29:02.878963Z","last_seen_at":"2026-10-27T21:29:22.985079Z","user_id":"5ea195610000000001000374","author_name":"Xxxx辛","author_profile_pic_url":"https://api.virev.ai/v1/media/xiaohongshu_account/24/profile_pic","media":[]},"meta":{"cost":"$0.0005","balance":"$9.9935","request_id":"req_9b515bb37f488a644de87ab6ca1dadb6"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"404":{"description":"Note not in the tracked corpus.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_found","message":"XHS note not found","request_id":"req_5c10900e919bc7a3ff79b7501d582b4c"}}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/xiaohongshu/stored/profile":{"get":{"tags":["Xiaohongshu"],"operationId":"xhsStoredProfile","summary":"Stored creator","x-dashboard-cost":"$0.0005","description":"A stored Xiaohongshu creator: name, red id, bio, avatar, follower and following counts with their precision, whether a creator page (`is_authoritative`) or only a note card named it, and when we last read it. Strictly DB: a creator we never stored is a `404`, never a crawl. Read a fresh one with `/v1/xiaohongshu/user_profile`.","security":[{"bearerAuth":[]}],"parameters":[{"name":"q","in":"query","required":true,"description":"Bare lowercase 24-hex Xiaohongshu user ID. Never submit a Xiaohongshu URL: copied URLs may contain private `xsec_token` values and edge access logs run before application validation.","schema":{"type":"string","pattern":"^[0-9a-f]{24}$","minLength":24,"maxLength":24},"example":"5ea195610000000001000374"}],"responses":{"200":{"description":"The stored creator.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object"},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"id":24,"profile_id":31,"user_id":"5ea195610000000001000374","red_id":"829461029","full_name":"Xxxx辛","biography":"分享日常～\n  连赞拉黑！！","profile_pic_url":"https://api.virev.ai/v1/media/xiaohongshu_account/24/profile_pic","followers":10000,"following":10,"is_authoritative":true,"metric_precision":{"followers":"approximate","following":"approximate"},"first_scraped_at":"2026-10-27T21:29:02.780030Z","last_scraped_at":"2026-10-27T21:29:22.980717Z","scrape_count":9},"meta":{"cost":"$0.0005","balance":"$9.9930","request_id":"req_1707c43da9fd15140d33b2887e391503"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"404":{"description":"Creator not in the tracked corpus.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_found","message":"XHS creator not found","request_id":"req_5c10900e919bc7a3ff79b7501d582b4c"}}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/xiaohongshu/stored/profile/notes":{"get":{"tags":["Xiaohongshu"],"operationId":"xhsStoredProfileNotes","summary":"Stored notes","x-dashboard-cost":"$0.0005","description":"One page of a stored creator's notes, newest first, a note read only from an explore card (`is_partial`) last. Pass `next_cursor` back as `cursor` for the next page; `has_more` is true exactly when it is set. Flat price per page. Strictly DB: a creator we never stored is a `404`, never a crawl.","security":[{"bearerAuth":[]}],"parameters":[{"name":"q","in":"query","required":true,"description":"Bare lowercase 24-hex Xiaohongshu user ID. Never submit a Xiaohongshu URL: copied URLs may contain private `xsec_token` values and edge access logs run before application validation.","schema":{"type":"string","pattern":"^[0-9a-f]{24}$","minLength":24,"maxLength":24},"example":"5ea195610000000001000374"},{"name":"limit","in":"query","required":false,"description":"How many videos to return (1–100). Flat price regardless of count.","schema":{"type":"integer","default":30,"minimum":1,"maximum":100},"examples":{"default":{"value":30,"x-disabled":true}}},{"name":"cursor","in":"query","required":false,"description":"Opaque `next_cursor` from the previous page.","schema":{"type":"string","minLength":1}}],"responses":{"200":{"description":"One page of stored notes.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","required":["notes","next_cursor","has_more"],"properties":{"notes":{"type":"array","items":{"type":"object"}},"next_cursor":{"type":"string","nullable":true,"description":"Opaque; pass back as `cursor`."},"has_more":{"type":"boolean","description":"True exactly when `next_cursor` is set."}}},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"notes":[{"id":33,"note_id":"64469b250000000013016860","title":"探店/邯郸","caption":"推荐一家经常去的咖啡店 新世纪九楼 SOLOS\nCAFE\n两层工业风的装修风格 很安静 适合聊天学习谈\n事情～\n有饮品，小吃还有 意面（是推荐）~\n喜欢拍照的姐妹可以沖一下\nSOLOS CAFE：新世纪九层\n某音现在有团购 很合适\n#周末探店[话题]# #邯郸美食探店[话题]#","likes":169,"comments":16,"collected":31,"shares":8,"posted_at":"2023-04-24T15:07:17Z","note_type":"normal","is_video":false,"image_url":"https://api.virev.ai/v1/media/xiaohongshu_note/33/post_image","image_urls":["https://api.virev.ai/v1/media/xiaohongshu_note/33/post_image","https://api.virev.ai/v1/media/xiaohongshu_note/33/post_image_1","https://api.virev.ai/v1/media/xiaohongshu_note/33/post_image_2","https://api.virev.ai/v1/media/xiaohongshu_note/33/post_image_3","https://api.virev.ai/v1/media/xiaohongshu_note/33/post_image_4","https://api.virev.ai/v1/media/xiaohongshu_note/33/post_image_5","https://api.virev.ai/v1/media/xiaohongshu_note/33/post_image_6"],"video_url":null,"tags":["周末探店","邯郸美食探店"],"is_partial":false,"metric_precision":{},"first_seen_at":"2026-10-27T21:29:02.878963Z","last_seen_at":"2026-10-27T21:29:22.985079Z"}],"next_cursor":null,"has_more":false},"meta":{"cost":"$0.0005","balance":"$9.9925","request_id":"req_bbaa0b40fe8fc047155d60f279f48c7b"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"404":{"description":"Creator not in the tracked corpus.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_found","message":"XHS creator not found","request_id":"req_5c10900e919bc7a3ff79b7501d582b4c"}}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/xiaohongshu/explore":{"get":{"tags":["Xiaohongshu"],"operationId":"xhsExplore","summary":"explore","x-dashboard-cost":"$0.0005/30","x-example-query":{"channel":"homefeed.food_v3","max_pages":"1"},"description":"One explore page of about 30 notes, each a feed card with its title, like count, cover and author (`extra.is_partial` is true). Each first page is a fresh draw, and `next_cursor` reads the pages after it. Returns `Page[Post]` under `data`.\n\nThe default request creates a durable job (202). Use max_pages=1 for one synchronous Page response (200). Poll status_url, then read results_url with its opaque cursor. Acquisition stops at the first of since, max_pages, or exhaustion. Jobs continue after disconnects. Result responses are bounded to 3 MiB; this does not limit the crawl. Supply Idempotency-Key to recover a lost submission response; reuse it with the same inputs.\n\nA field Xiaohongshu does not carry is null, a list it does not carry is `[]`, and Xiaohongshu-only facts sit under `extra`. Unknown, unsupported, and repeated query parameters return 400 before acquisition or billing.\n\nBilling: $0.0005 per 30 unique returned items (one native page), rounded up to a minimum of one billing unit. Jobs settle once after successful completion. Submission, polling and repeat downloads are free.","security":[{"bearerAuth":[]}],"parameters":[{"name":"channel","in":"query","required":true,"description":"The explore channel: `homefeed_recommend`, or a topic channel such as `homefeed.food_v3`, `homefeed.fashion_v3` or `homefeed.cosmetics_v3`.","example":"homefeed.food_v3","schema":{"type":"string"}},{"name":"since","in":"query","required":false,"description":"Not accepted on this operation: its items carry no timestamp, so since returns 400 before billing.","schema":{"type":"string"}},{"name":"max_pages","in":"query","required":false,"example":1,"description":"Maximum pages to fetch. -1 walks until exhaustion or since with no page cap, and must be written. Omitted, since alone bounds the walk; with neither, the job stops after 10 pages. Any positive integer is accepted. 1 returns one page synchronously with HTTP 200; any other value creates a durable job with HTTP 202.","schema":{"type":"integer","anyOf":[{"enum":[-1]},{"minimum":1}]}},{"name":"cursor","in":"query","required":false,"description":"Opaque next_cursor from an earlier answer of this operation, also with `get_raw=true`. A native Xiaohongshu cursor from a raw page answers 400. Result download cursors belong to the results route.","schema":{"type":"string","minLength":1}},{"name":"page_size","in":"query","required":false,"description":"Native num, default 30. Billed per 30 unique returned items, one native page.","schema":{"type":"integer","default":30,"minimum":1},"examples":{"default":{"value":30,"x-disabled":true}}},{"name":"cached","in":"query","required":false,"description":"`auto` (default) serves a read saved within the last 24 hours for these exact arguments, otherwise fetches. `cache_only` never contacts Xiaohongshu (404 `not_cached` when nothing is saved, whatever its age). `live` always fetches. Anything else is a `400`. `cache_only` reads one saved page per request: omit `max_pages` or pass 1, and continue with `next_cursor`.","schema":{"type":"string","enum":["auto","cache_only","live"],"default":"auto"},"examples":{"default":{"value":"auto","x-disabled":true}}},{"name":"get_raw","in":"query","required":false,"description":"`true` returns the upstream JSON exactly as Xiaohongshu answered it instead of the normalized `Page[Post]`.","schema":{"type":"boolean","default":false},"examples":{"default":{"value":false,"x-disabled":true}}},{"name":"Idempotency-Key","in":"header","required":false,"description":"Reuse this key with the same inputs to recover a lost job submission. A different input with the same key returns 409.","schema":{"type":"string","minLength":1,"maxLength":200}}],"responses":{"200":{"description":"`Page[Post]` under `data`; with `get_raw=true` the upstream JSON.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"anyOf":[{"type":"object","required":["items","pages","next_cursor","has_more","stop_reason","coverage"],"properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/Post"},"description":"`Post` of every page walked, in page order."},"pages":{"type":"array","items":{"$ref":"#/components/schemas/PageRead"},"description":"One entry per page walked."},"next_cursor":{"type":"string","nullable":true,"description":"Opaque; pass back as `cursor` to continue."},"has_more":{"type":"boolean","description":"True when `next_cursor` is set, and when the walk stopped `cursor_stalled` on a page that said more results exist but gave no cursor to send back."},"stop_reason":{"type":"string","enum":["pages","since","exhausted","cursor_stalled","repeated_content","deadline","blocked","caught_up"],"description":"Why the walk stopped. `pages`: the page budget is spent and `next_cursor` continues it. `deadline`: the call ran out of time before its next page; `next_cursor` continues it. `since`: a whole page was older than `since`. `exhausted`: Xiaohongshu reported the end. `cursor_stalled`: Xiaohongshu claimed more but repeated or omitted its cursor. `repeated_content`: a page held only items already seen. `blocked`: Xiaohongshu refused a later page; `next_cursor` is the page it refused. `caught_up`: only watch passes the crawler runs for itself stop this way."},"coverage":{"$ref":"#/components/schemas/Coverage"}}},{"type":"object","required":["pages","next_cursor","has_more","stop_reason"],"description":"`get_raw=true`: every native page walked, exactly as Xiaohongshu answered it, plus the opaque `next_cursor` and `stop_reason` of the walk.","properties":{"pages":{"type":"array","items":{"type":"object","additionalProperties":true,"required":["data.items"],"properties":{"data.items":{"type":"array","items":{"type":"object","additionalProperties":true}}}},"description":"One native page per page walked, upstream bytes unchanged."},"next_cursor":{"type":"string","nullable":true,"description":"Opaque; pass back as `cursor`."},"has_more":{"type":"boolean","description":"True when `next_cursor` is set, and when the walk stopped `cursor_stalled` on a page that said more results exist but gave no cursor to send back."},"stop_reason":{"type":"string","enum":["pages","since","exhausted","cursor_stalled","repeated_content","deadline","blocked","caught_up"],"description":"Why the walk stopped. `pages`: the page budget is spent and `next_cursor` continues it. `deadline`: the call ran out of time before its next page; `next_cursor` continues it. `since`: a whole page was older than `since`. `exhausted`: Xiaohongshu reported the end. `cursor_stalled`: Xiaohongshu claimed more but repeated or omitted its cursor. `repeated_content`: a page held only items already seen. `blocked`: Xiaohongshu refused a later page; `next_cursor` is the page it refused. `caught_up`: only watch passes the crawler runs for itself stop this way."}}}],"description":"`Page[Post]`, or the upstream JSON when `get_raw=true`."},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"items":[{"id":"64469b250000000013016860","shortcode":null,"taken_at":null,"kind":"image","product_type":null,"caption":"探店/邯郸","hashtags":[],"mentions":[],"accessibility_caption":null,"likes":169,"comments":null,"views":null,"counts_hidden":null,"comments_disabled":null,"is_pinned":null,"is_paid_partnership":null,"owner":{"id":"5ea195610000000001000374","username":null,"full_name":"Xxxx辛","is_verified":null,"is_private":null,"avatar_url":"https://sns-avatar-qc.xhscdn.com/avatar/6420eb8a1633662142007601.jpg","latest_story_at":null,"extra":{}},"coauthors":[],"sponsors":[],"tagged":[],"location":null,"audio":null,"thumbnail_url":"https://sns-webpic-qc.xhscdn.com/202610280528/89629440de54abc7a8e61889221d9903/1000g0082d2f2am8gu0405n2b09sk3nmfiq8p8r0!nc_n_nwebp_mw_1","video_duration":null,"media":[],"media_urls":[],"extra":{"url":"https://www.xiaohongshu.com/explore/64469b250000000013016860","title":null,"saves":null,"shares":null,"note_type":"normal","mentioned_users":[],"is_partial":true,"approximate_metrics":[]}},{"id":"643662db000000001300e048","shortcode":null,"taken_at":null,"kind":"image","product_type":null,"caption":"台北市政府｜信義區高cp值日式義大利麵","hashtags":[],"mentions":[],"accessibility_caption":null,"likes":1952,"comments":null,"views":null,"counts_hidden":null,"comments_disabled":null,"is_pinned":null,"is_paid_partnership":null,"owner":{"id":"62188e0c000000001000c434","username":null,"full_name":"欸欸，呷罷未","is_verified":null,"is_private":null,"avatar_url":"https://sns-avatar-qc.xhscdn.com/avatar/621a41fe317d48f2d83bae3f.jpg","latest_story_at":null,"extra":{}},"coauthors":[],"sponsors":[],"tagged":[],"location":null,"audio":null,"thumbnail_url":"https://sns-webpic-qc.xhscdn.com/202610280528/78f5cbc327875aeed50d7c406daa22d2/1000g0082b36kqjcgm05g5ogoho641h1k1m8v0t8!nc_n_nwebp_mw_1","video_duration":null,"media":[],"media_urls":[],"extra":{"url":"https://www.xiaohongshu.com/explore/643662db000000001300e048","title":null,"saves":null,"shares":null,"note_type":"normal","mentioned_users":[],"is_partial":true,"approximate_metrics":[]}}],"pages":[{"cursor":null,"fetched_at":"2026-11-02T22:17:02.145828+00:00","count":29,"signed_in":false}],"next_cursor":"eyJjdXJzb3IiOiI6MjkiLCJvcCI6ImV4cGxvcmUifQ","has_more":true,"stop_reason":"pages","coverage":{"since":null,"oldest_at":null,"since_reached":false}},"meta":{"source":"live","fetched_at":"2026-10-27T21:28:43.794374+00:00","cost":"$0.0005","balance":"$9.9950","request_id":"req_fd901072f0e3141ef195de8005e37235"}}}}},"202":{"description":"Durable job accepted. No completed-result charge. Save batch_id; poll status_url. Retry submission with the same Idempotency-Key after a lost response. An account may have five queued, running or payment-required jobs. A sixth new job returns 429 rate_limited. Matching idempotent replays still work at the limit. Ready and failed jobs release their slots; pages within a job remain unbounded. This is a synthetic contract example, not a live capture.","x-example-provenance":"synthetic-contract","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","required":["batch_id","status","status_url","results_url","cost","item_count","error","retry_at","total","done_count","failed_count","created_at","started_at","finished_at"],"properties":{"batch_id":{"type":"string"},"status":{"type":"string","enum":["queued","running","payment_required","ready","failed"]},"status_url":{"type":"string"},"results_url":{"type":"string"},"cost":{"type":"string"},"item_count":{"type":"integer","nullable":true},"error":{"type":"string","nullable":true,"description":"Null unless failed. A failed target carries its own code; incomplete_result appears only when it has none and pages of the result are missing. profile_not_found, post_not_found, upstream_not_found or not_found: the target does not exist or is not visible. not_visible: The account exists, but its posts are not visible to logged-out readers (private, restricted, or hidden by Instagram). Retrying will not change the result until the account changes. not_cached: cached=cache_only found no saved read. incomplete_result: pages of the result are missing. temporarily_unavailable: the target could not be read for now (no capacity, a pause or repeated refusals); retry later with a new job. result_item_too_large: one result unit exceeds the delivery budget. result_snapshot_missing or result_snapshot_corrupt: the crawler could not serve the retained result of a paid job, and its charge is refunded; if the crawler serves it again, a later results read returns it and charges the job again. crawler_submit_400, crawler_submit_404 or crawler_submit_422: the crawl service refused the job request. crawler_job_failed: any other failure; the same job is not expected to succeed if resubmitted. cancelled: the job was cancelled with POST /v1/jobs/{job_id}/cancel. No failed job costs anything: only result_snapshot_missing and result_snapshot_corrupt follow a charge, and that charge is refunded."},"retry_at":{"type":"string","format":"date-time","nullable":true,"description":"Null unless the job failed temporarily_unavailable because a crawl route was closed for every caller. Then it is when the route opens again, and the response carries the same time as a Retry-After header in seconds. Submit a new job after it."},"total":{"type":"integer","description":"Targets in the job. A job submitted through a /v1 route has one."},"done_count":{"type":"integer","description":"Targets the crawler finished."},"failed_count":{"type":"integer","description":"Targets that failed."},"created_at":{"type":"string","format":"date-time","description":"When the job was submitted."},"started_at":{"type":"string","format":"date-time","nullable":true,"description":"When the crawler started the job. Null until it starts."},"finished_at":{"type":"string","format":"date-time","nullable":true,"description":"When the job finished or failed. Null while it is queued or running."}}},"meta":{"type":"object","required":["cost","request_id"],"properties":{"cost":{"type":"string","example":"$0.0000"},"request_id":{"type":"string"}}}}},"example":{"data":{"batch_id":"job_7641d5f0-717d-4b70-a2f1-f58d846d7242","status":"queued","status_url":"/v1/jobs/job_7641d5f0-717d-4b70-a2f1-f58d846d7242","results_url":"/v1/jobs/job_7641d5f0-717d-4b70-a2f1-f58d846d7242/results","cost":"$0.0000","item_count":null,"error":null,"retry_at":null,"total":1,"done_count":0,"failed_count":0,"created_at":"2026-10-12T12:56:17.403Z","started_at":null,"finished_at":null},"meta":{"cost":"$0.0000","request_id":"req_job_example"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"404":{"description":"`cached=cache_only` found nothing saved for these arguments (`not_cached`; call again with `cached=auto` to fetch it), or the Xiaohongshu account or item does not exist (`not_found`). You are not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_cached","message":"no saved xiaohongshu/explore read for 'homefeed.food_v3'. cached=cache_only never fetches, so call again with cached=auto to fetch it. You are not charged.","request_id":"req_5c10900e919bc7a3ff79b7501d582b4c"}}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/xiaohongshu/user_profile":{"get":{"tags":["Xiaohongshu"],"operationId":"xhsUserProfile","summary":"user_profile","x-dashboard-cost":"$0.0005","x-example-query":{"user_id":"5ea195610000000001000374"},"description":"A creator's page: name, bio, avatar, follower and following counts. `extra` carries `red_id`, `ip_location`, `gender`, `professions`, `likes_and_collects` and the grid's note cards, which Xiaohongshu serves without note ids. Rounded counts are named in `extra.approximate_metrics`. Returns `Profile` under `data`.\n\nA field Xiaohongshu does not carry is null, a list it does not carry is `[]`, and Xiaohongshu-only facts sit under `extra`. Unknown, unsupported, and repeated query parameters return 400 before acquisition or billing.","security":[{"bearerAuth":[]}],"parameters":[{"name":"user_id","in":"query","required":true,"description":"A creator's bare lowercase 24-hex user id. Never submit a Xiaohongshu URL: a copied URL can carry a private `xsec_token`.","example":"5ea195610000000001000374","schema":{"type":"string"}},{"name":"cached","in":"query","required":false,"description":"`auto` (default) serves a read saved within the last 24 hours for these exact arguments, otherwise fetches. `cache_only` never contacts Xiaohongshu (404 `not_cached` when nothing is saved, whatever its age). `live` always fetches. Anything else is a `400`.","schema":{"type":"string","enum":["auto","cache_only","live"],"default":"auto"},"examples":{"default":{"value":"auto","x-disabled":true}}},{"name":"get_raw","in":"query","required":false,"description":"Not available on this operation: the upstream document is an HTML page, and `true` answers 400. The default `false` returns the normalized type.","schema":{"type":"boolean","default":false},"examples":{"default":{"value":false,"x-disabled":true}}}],"responses":{"200":{"description":"`Profile` under `data`.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/Profile"},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"id":"616426120000000002022987","username":"4233446044","full_name":"华子爆笑社","biography":"开心万岁！","followers":10000,"following":7,"posts":null,"is_verified":null,"is_private":null,"avatar_url":"https://sns-avatar-qc.rednotecdn.com/avatar/1040g2jo3216akv1rna005ob44o90kac77ch4keo?imageView2/2/w/540/format/webp","external_url":null,"links":[],"category":null,"business_category":null,"is_business":null,"is_professional":null,"business_email":null,"business_phone":null,"business_address":null,"pronouns":[],"highlight_reel_count":null,"has_clips":null,"is_recently_joined":null,"fbid":null,"extra":{"red_id":"4233446044","ip_location":"浙江","gender":null,"professions":[],"tags":{},"likes_and_collects":10000,"approximate_metrics":["followers","likes_and_collects"],"notes":[{"title":"误拧油门的瞬间，停车记得拔掉钥匙，不然一不小心就飞出去了！骑行 电瓶车 倒霉瞬间","likes":183,"likes_approximate":false,"note_type":"video","cover_url":"https://sns-web-i10.rednotecdn.com/202611082000/7677bcd37018005ded53b86e080aac23/1040g2sg32790gjdon8e05ob44o90kac75548rno!nc_n_nwebp_mw_1","cover_width":1080,"cover_height":1440,"note_id":null},{"title":"让男人崩溃的双十一来了，看看女人的购买力到底有多强！双十一 购物 快递","likes":66,"likes_approximate":false,"note_type":"video","cover_url":"https://sns-web-i10.rednotecdn.com/202611082000/f174d4e7676b3491728ed87a21046e3f/1040g2sg3277n8k6l76e05ob44o90kac702nsnp8!nc_n_nwebp_mw_1","cover_width":1080,"cover_height":1080,"note_id":null},{"title":"那些女生骑车的失误倒霉瞬间，这车咱要不还是不骑了吧搞笑 骑行 倒霉蛋","likes":584,"likes_approximate":false,"note_type":"video","cover_url":"https://sns-web-i10.rednotecdn.com/202611082000/6e1a4a2440c906d3f73e1bb7a0cf5595/1040g00832750c9pb7g005ob44o90kac7uq7rl40!nc_n_nwebp_mw_1","cover_width":1080,"cover_height":1440,"note_id":null},{"title":"骑行失误瞬间，既心疼又好笑！骑行失误 搞笑 翻车现场","likes":1370,"likes_approximate":false,"note_type":"video","cover_url":"https://sns-web-i10.rednotecdn.com/202611082000/c3ba08c25cb01ffc9e628259c2f28541/1040g0083272mqgqcn6005ob44o90kac77dshruo!nc_n_nwebp_mw_1","cover_width":1080,"cover_height":1440,"note_id":null}]}},"meta":{"source":"db","fetched_at":"2026-11-08T12:00:29.194916+00:00","cost":"$0.0005","balance":"$423.7939","request_id":"req_cf5174aa65155910716ffe53774ee2ef"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"404":{"description":"`cached=cache_only` found nothing saved for these arguments (`not_cached`; call again with `cached=auto` to fetch it), or the Xiaohongshu account or item does not exist (`not_found`). You are not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_cached","message":"no saved xiaohongshu/user_profile read for '5ea195610000000001000374'. cached=cache_only never fetches, so call again with cached=auto to fetch it. You are not charged.","request_id":"req_5c10900e919bc7a3ff79b7501d582b4c"}}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/xiaohongshu/note_detail":{"get":{"tags":["Xiaohongshu"],"operationId":"xhsNoteDetail","summary":"note_detail","x-dashboard-cost":"$0.0005","x-example-query":{"note_id":"64469b250000000013016860"},"description":"One note: title, text, posted time, like, comment, save and share counts, tags, mentions, images or video and author. Call `/v1/xiaohongshu/explore` first and pass a `note_id` from its answer: Xiaohongshu serves a note only with the token its feed issued, and the crawler keeps that token from the explore read. Any other id, the example included, fails at once with 400 `invalid_request` and is not billed. Returns `Post` under `data`.\n\nA field Xiaohongshu does not carry is null, a list it does not carry is `[]`, and Xiaohongshu-only facts sit under `extra`. Unknown, unsupported, and repeated query parameters return 400 before acquisition or billing.","security":[{"bearerAuth":[]}],"parameters":[{"name":"note_id","in":"query","required":true,"description":"A bare lowercase 24-hex note id from a `/v1/xiaohongshu/explore` answer (`data.items[].id`). The example is an id from an earlier explore read that the crawler no longer holds a token for, so it answers 400. Never submit a Xiaohongshu URL: a copied URL can carry a private `xsec_token`.","example":"64469b250000000013016860","schema":{"type":"string"}},{"name":"cached","in":"query","required":false,"description":"`auto` (default) serves a read saved within the last 24 hours for these exact arguments, otherwise fetches. `cache_only` never contacts Xiaohongshu (404 `not_cached` when nothing is saved, whatever its age). `live` always fetches. Anything else is a `400`.","schema":{"type":"string","enum":["auto","cache_only","live"],"default":"auto"},"examples":{"default":{"value":"auto","x-disabled":true}}},{"name":"get_raw","in":"query","required":false,"description":"Not available on this operation: the upstream document is an HTML page, and `true` answers 400. The default `false` returns the normalized type.","schema":{"type":"boolean","default":false},"examples":{"default":{"value":false,"x-disabled":true}}}],"responses":{"200":{"description":"`Post` under `data`.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/Post"},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"id":"64469b250000000013016860","shortcode":null,"taken_at":"2023-04-24T15:07:17+00:00","kind":"carousel","product_type":null,"caption":"推荐一家经常去的咖啡店 新世纪九楼 SOLOS\nCAFE\n两层工业风的装修风格 很安静 适合聊天学习谈\n事情～\n有饮品，小吃还有 意面（是推荐）~\n喜欢拍照的姐妹可以沖一下\nSOLOS CAFE：新世纪九层\n某音现在有团购 很合适\n#周末探店[话题]# #邯郸美食探店[话题]#","hashtags":["周末探店","邯郸美食探店"],"mentions":[],"accessibility_caption":null,"likes":169,"comments":16,"views":null,"counts_hidden":null,"comments_disabled":null,"is_pinned":null,"is_paid_partnership":null,"owner":{"id":"5ea195610000000001000374","username":null,"full_name":"Xxxx辛","is_verified":null,"is_private":null,"avatar_url":"https://sns-avatar-qc.xhscdn.com/avatar/6420eb8a1633662142007601.jpg","latest_story_at":null,"extra":{}},"coauthors":[],"sponsors":[],"tagged":[],"location":null,"audio":null,"thumbnail_url":"https://sns-webpic-qc.xhscdn.com/202610280528/b4b3a7e83337aeca3853737f4e4851c3/1000g0082d2f2am8gu0405n2b09sk3nmfiq8p8r0!nd_dft_wlteh_jpg_3","video_duration":null,"media":[{"kind":"image","url":"https://sns-webpic-qc.xhscdn.com/202610280528/b4b3a7e83337aeca3853737f4e4851c3/1000g0082d2f2am8gu0405n2b09sk3nmfiq8p8r0!nd_dft_wlteh_jpg_3","width":null,"height":null,"duration":null},{"kind":"image","url":"https://sns-webpic-qc.xhscdn.com/202610280528/85a3497302e01d48adc5e24a9d097186/1000g0082d2f2am8gu04g5n2b09sk3nmfibc7ms8!nd_dft_wlteh_jpg_3","width":null,"height":null,"duration":null},{"kind":"image","url":"https://sns-webpic-qc.xhscdn.com/202610280528/51883b4fd6ba0e9167d887f6158ca069/1000g0082d2f2am8gu0505n2b09sk3nmfpl2kndo!nd_dft_wlteh_jpg_3","width":null,"height":null,"duration":null},{"kind":"image","url":"https://sns-webpic-qc.xhscdn.com/202610280528/b0dbe98a5d97ad8a29187ea31660f429/1000g0082d2f2am8gu05g5n2b09sk3nmfcggh24o!nd_dft_wlteh_jpg_3","width":null,"height":null,"duration":null},{"kind":"image","url":"https://sns-webpic-qc.xhscdn.com/202610280528/6902800eb57d8c298e2a5e856b154030/1000g0082d2f2am8gu0605n2b09sk3nmfg8j9k6o!nd_dft_wgth_jpg_3","width":null,"height":null,"duration":null},{"kind":"image","url":"https://sns-webpic-qc.xhscdn.com/202610280528/47968f1f9daae8570c47ed4a5a6dfd7d/1000g0082d2f2am8gu06g5n2b09sk3nmf4bbk6l8!nd_dft_wlteh_jpg_3","width":null,"height":null,"duration":null},{"kind":"image","url":"https://sns-webpic-qc.xhscdn.com/202610280528/8701c79f6bec729b1c66639af69ff0a0/1000g0082d2incu2h40005nl1ilgg80rk653a1c0!nd_dft_wlteh_jpg_3","width":null,"height":null,"duration":null}],"media_urls":["https://sns-webpic-qc.xhscdn.com/202610280528/b4b3a7e83337aeca3853737f4e4851c3/1000g0082d2f2am8gu0405n2b09sk3nmfiq8p8r0!nd_dft_wlteh_jpg_3","https://sns-webpic-qc.xhscdn.com/202610280528/85a3497302e01d48adc5e24a9d097186/1000g0082d2f2am8gu04g5n2b09sk3nmfibc7ms8!nd_dft_wlteh_jpg_3","https://sns-webpic-qc.xhscdn.com/202610280528/51883b4fd6ba0e9167d887f6158ca069/1000g0082d2f2am8gu0505n2b09sk3nmfpl2kndo!nd_dft_wlteh_jpg_3","https://sns-webpic-qc.xhscdn.com/202610280528/b0dbe98a5d97ad8a29187ea31660f429/1000g0082d2f2am8gu05g5n2b09sk3nmfcggh24o!nd_dft_wlteh_jpg_3","https://sns-webpic-qc.xhscdn.com/202610280528/6902800eb57d8c298e2a5e856b154030/1000g0082d2f2am8gu0605n2b09sk3nmfg8j9k6o!nd_dft_wgth_jpg_3","https://sns-webpic-qc.xhscdn.com/202610280528/47968f1f9daae8570c47ed4a5a6dfd7d/1000g0082d2f2am8gu06g5n2b09sk3nmf4bbk6l8!nd_dft_wlteh_jpg_3","https://sns-webpic-qc.xhscdn.com/202610280528/8701c79f6bec729b1c66639af69ff0a0/1000g0082d2incu2h40005nl1ilgg80rk653a1c0!nd_dft_wlteh_jpg_3"],"extra":{"url":"https://www.xiaohongshu.com/explore/64469b250000000013016860","title":"探店/邯郸","saves":31,"shares":8,"note_type":"normal","mentioned_users":[],"is_partial":false,"approximate_metrics":[]}},"meta":{"source":"live","fetched_at":"2026-10-27T21:28:45.230197+00:00","cost":"$0.0005","balance":"$9.9940","request_id":"req_9048ae9361bfaed37ed2b0411ceddca9"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"404":{"description":"`cached=cache_only` found nothing saved for these arguments (`not_cached`; call again with `cached=auto` to fetch it), or the Xiaohongshu account or item does not exist (`not_found`). You are not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_cached","message":"no saved xiaohongshu/note_detail read for '64469b250000000013016860'. cached=cache_only never fetches, so call again with cached=auto to fetch it. You are not charged.","request_id":"req_5c10900e919bc7a3ff79b7501d582b4c"}}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/douyin/user_profile":{"get":{"tags":["Douyin"],"operationId":"douyinUserProfile","summary":"user_profile","x-dashboard-cost":"$0.0005","x-example-query":{"sec_uid":"MS4wLjABAAAArDVBosPJF3eIWVEFp0szuJ-e1V_-rK0ieJeWwpE77E8"},"description":"A profile: name, bio, follower, following, post and like counts, verification and avatar. `extra` carries `sec_uid`, `total_favorited` and `favoriting_count`. Returns `Profile` under `data`; with `get_raw=true` returns the upstream JSON.\n\nA field Douyin does not carry is null, a list it does not carry is `[]`, and Douyin-only facts sit under `extra`. Unknown, unsupported, and repeated query parameters return 400 before acquisition or billing.","security":[{"bearerAuth":[]}],"parameters":[{"name":"sec_uid","in":"query","required":true,"description":"A Douyin `sec_uid`, or the `https://www.douyin.com/user/{sec_uid}` profile URL.","example":"MS4wLjABAAAArDVBosPJF3eIWVEFp0szuJ-e1V_-rK0ieJeWwpE77E8","schema":{"type":"string"}},{"name":"cached","in":"query","required":false,"description":"`auto` (default) serves a read saved within the last 24 hours for these exact arguments, otherwise fetches. `cache_only` never contacts Douyin (404 `not_cached` when nothing is saved, whatever its age). `live` always fetches. Anything else is a `400`.","schema":{"type":"string","enum":["auto","cache_only","live"],"default":"auto"},"examples":{"default":{"value":"auto","x-disabled":true}}},{"name":"get_raw","in":"query","required":false,"description":"`true` returns the upstream JSON exactly as Douyin answered it instead of the normalized `Profile`.","schema":{"type":"boolean","default":false},"examples":{"default":{"value":false,"x-disabled":true}}}],"responses":{"200":{"description":"`Profile` under `data`; with `get_raw=true` the upstream JSON.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"anyOf":[{"$ref":"#/components/schemas/Profile"},{"type":"object","additionalProperties":true}],"description":"`Profile`, or the upstream JSON when `get_raw=true`."},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"id":"97523645652","username":"nishuihan163","full_name":"网易逆水寒","biography":"世界焕新，万物出金。\n《逆水寒：新世界》预约现已开启：https://h.163.com/h5/20260520/xsjyy/","followers":2924823,"following":186,"posts":3684,"is_verified":true,"is_private":false,"avatar_url":"https://p3-pc.douyinpic.com/aweme/100x100/aweme-avatar/tos-cn-i-23auat310x_4944ebf6f11d4cefb393fc1c135d0b76.jpeg?from=2956013662","external_url":null,"links":[],"category":null,"business_category":null,"is_business":true,"is_professional":null,"business_email":null,"business_phone":null,"business_address":null,"pronouns":[],"highlight_reel_count":null,"has_clips":true,"is_recently_joined":null,"fbid":null,"extra":{"sec_uid":"MS4wLjABAAAAsO7ytzQSxOjL9tqK5sqrA7E8-VjwYj_2TbObDS_ZOb4","total_favorited":77011726,"favoriting_count":0}},"meta":{"source":"live","fetched_at":"2026-11-08T11:56:13.394597+00:00","cost":"$0.0005","balance":"$424.1746","request_id":"req_7e84831485054d16e38aa3bb3513d249"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"404":{"description":"`cached=cache_only` found nothing saved for these arguments (`not_cached`; call again with `cached=auto` to fetch it), or the Douyin account or item does not exist (`not_found`). You are not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_cached","message":"no saved douyin/user_profile read for 'MS4wLjABAAAArDVBosPJF3eIWVEFp0szuJ-e1V_-rK0ieJeWwpE77E8'. cached=cache_only never fetches, so call again with cached=auto to fetch it. You are not charged.","request_id":"req_5c10900e919bc7a3ff79b7501d582b4c"}}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/douyin/aweme_post":{"get":{"tags":["Douyin"],"operationId":"douyinAwemePost","summary":"aweme_post","x-dashboard-cost":"$0.0005/42","x-example-query":{"sec_uid":"MS4wLjABAAAArDVBosPJF3eIWVEFp0szuJ-e1V_-rK0ieJeWwpE77E8","max_pages":"1"},"description":"The account's newest posts, up to 42. Douyin withholds every later page from a logged-out reader, so a longer feed stops with `stop_reason` `cursor_stalled` and no `next_cursor`. With max_pages=1, returns `Page[Post]` under `data`; with `get_raw=true` returns the upstream JSON.\n\nThe default request creates a durable job (202). Use max_pages=1 for one synchronous Page response (200). Poll status_url, then read results_url with its opaque cursor. Acquisition stops at the first of since, max_pages, or exhaustion. Jobs continue after disconnects. Supply Idempotency-Key to recover a lost submission response; reuse it with the same inputs.\n\nA field Douyin does not carry is null, a list it does not carry is `[]`, and Douyin-only facts sit under `extra`. Unknown, unsupported, and repeated query parameters return 400 before acquisition or billing.\n\nBilling: $0.0005 per 42 unique returned items (one native page), rounded up to a minimum of one billing unit. Jobs settle once after successful completion.","security":[{"bearerAuth":[]}],"parameters":[{"name":"sec_uid","in":"query","required":true,"description":"A Douyin `sec_uid`, or the `https://www.douyin.com/user/{sec_uid}` profile URL.","example":"MS4wLjABAAAArDVBosPJF3eIWVEFp0szuJ-e1V_-rK0ieJeWwpE77E8","schema":{"type":"string"}},{"name":"since","in":"query","required":false,"description":"Stop at this date. `2025-09-21` means midnight UTC (2025-09-21T00:00:00Z). Datetimes must use RFC3339 with a timezone, for example `2025-09-21T09:00:00+09:00`. `365d` means 365 days before submission. Invalid calendar dates return 400. With max_pages, the first boundary reached stops the walk. since alone creates a job.","schema":{"type":"string"},"examples":{"default":{"value":"2025-09-21","x-disabled":true},"date":{"value":"2025-09-21","x-disabled":true},"datetime":{"value":"2025-09-21T00:00:00Z","x-disabled":true},"duration":{"value":"365d","x-disabled":true}}},{"name":"max_pages","in":"query","required":false,"example":1,"description":"Maximum pages to fetch. -1 walks until exhaustion or since with no page cap, and must be written. Omitted, since alone bounds the walk; with neither, the job stops after 10 pages. Any positive integer is accepted. 1 returns one page synchronously with HTTP 200; any other value creates a durable job with HTTP 202.","schema":{"type":"integer","anyOf":[{"enum":[-1]},{"minimum":1}]}},{"name":"cursor","in":"query","required":false,"description":"Opaque next_cursor from an earlier answer of this operation, also with `get_raw=true`. A native Douyin cursor from a raw page answers 400. Result download cursors belong to the results route.","schema":{"type":"string","minLength":1}},{"name":"page_size","in":"query","required":false,"description":"Native count, default 42. Douyin answers at most 42. Billed per 42 unique returned items, one native page.","schema":{"type":"integer","default":42,"minimum":1,"maximum":42},"examples":{"default":{"value":42,"x-disabled":true}}},{"name":"cached","in":"query","required":false,"description":"`auto` (default) serves a read saved within the last 24 hours for these exact arguments, otherwise fetches. `cache_only` never contacts Douyin (404 `not_cached` when nothing is saved, whatever its age). `live` always fetches. Anything else is a `400`. `cache_only` reads one saved page per request: omit `max_pages` or pass 1, and continue with `next_cursor`.","schema":{"type":"string","enum":["auto","cache_only","live"],"default":"auto"},"examples":{"default":{"value":"auto","x-disabled":true}}},{"name":"get_raw","in":"query","required":false,"description":"`true` returns the upstream JSON exactly as Douyin answered it instead of the normalized `Page[Post]`.","schema":{"type":"boolean","default":false},"examples":{"default":{"value":false,"x-disabled":true}}},{"name":"Idempotency-Key","in":"header","required":false,"description":"Reuse this key with the same inputs to recover a lost job submission. A different input with the same key returns 409.","schema":{"type":"string","minLength":1,"maxLength":200}}],"responses":{"200":{"description":"`Page[Post]` under `data`; with `get_raw=true` the upstream JSON.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"anyOf":[{"type":"object","required":["items","pages","next_cursor","has_more","stop_reason","coverage"],"properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/Post"},"description":"`Post` of every page walked, in page order."},"pages":{"type":"array","items":{"$ref":"#/components/schemas/PageRead"},"description":"One entry per page walked."},"next_cursor":{"type":"string","nullable":true,"description":"Opaque; pass back as `cursor` to continue."},"has_more":{"type":"boolean","description":"True when `next_cursor` is set, and when the walk stopped `cursor_stalled` on a page that said more results exist but gave no cursor to send back."},"stop_reason":{"type":"string","enum":["pages","since","exhausted","cursor_stalled","repeated_content","deadline","blocked","caught_up"],"description":"Why the walk stopped. `pages`: the page budget is spent and `next_cursor` continues it. `deadline`: the call ran out of time before its next page; `next_cursor` continues it. `since`: a whole page was older than `since`. `exhausted`: Douyin reported the end. `cursor_stalled`: Douyin claimed more but repeated or omitted its cursor. `repeated_content`: a page held only items already seen. `blocked`: Douyin refused a later page; `next_cursor` is the page it refused. `caught_up`: only watch passes the crawler runs for itself stop this way."},"coverage":{"$ref":"#/components/schemas/Coverage"}}},{"type":"object","required":["pages","next_cursor","has_more","stop_reason"],"description":"`get_raw=true`: every native page walked, exactly as Douyin answered it, plus the opaque `next_cursor` and `stop_reason` of the walk.","properties":{"pages":{"type":"array","items":{"type":"object","additionalProperties":true,"required":["aweme_list"],"properties":{"aweme_list":{"type":"array","items":{"type":"object","additionalProperties":true}}}},"description":"One native page per page walked, upstream bytes unchanged."},"next_cursor":{"type":"string","nullable":true,"description":"Opaque; pass back as `cursor`."},"has_more":{"type":"boolean","description":"True when `next_cursor` is set, and when the walk stopped `cursor_stalled` on a page that said more results exist but gave no cursor to send back."},"stop_reason":{"type":"string","enum":["pages","since","exhausted","cursor_stalled","repeated_content","deadline","blocked","caught_up"],"description":"Why the walk stopped. `pages`: the page budget is spent and `next_cursor` continues it. `deadline`: the call ran out of time before its next page; `next_cursor` continues it. `since`: a whole page was older than `since`. `exhausted`: Douyin reported the end. `cursor_stalled`: Douyin claimed more but repeated or omitted its cursor. `repeated_content`: a page held only items already seen. `blocked`: Douyin refused a later page; `next_cursor` is the page it refused. `caught_up`: only watch passes the crawler runs for itself stop this way."}}}],"description":"`Page[Post]`, or the upstream JSON when `get_raw=true`."},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"items":[{"id":"7699846003989499170","shortcode":null,"taken_at":"2026-10-23T12:55:11+00:00","kind":"video","product_type":"0","caption":"新版本终极“警告”：不要轻信里世界！莫奈主题外观抢先看！ 10月30日，中式民俗季【苗疆蛊事】正式开启。您眼前那些看似熟悉的事物，或许藏着来自另一个“世界”的面孔…… #逆水寒手游  #逆水寒表里世界","hashtags":["逆水寒手游","逆水寒表里世界"],"mentions":[],"accessibility_caption":null,"likes":8731,"comments":1142,"views":null,"counts_hidden":null,"comments_disabled":null,"is_pinned":true,"is_paid_partnership":null,"owner":{"id":"97523645652","username":null,"full_name":"网易逆水寒","is_verified":true,"is_private":null,"avatar_url":"https://p3-pc.douyinpic.com/aweme/100x100/aweme-avatar/tos-cn-i-23auat310x_4944ebf6f11d4cefb393fc1c135d0b76.jpeg?from=327834062","latest_story_at":null,"extra":{"sec_uid":"MS4wLjABAAAAsO7ytzQSxOjL9tqK5sqrA7E8-VjwYj_2TbObDS_ZOb4"}},"coauthors":[],"sponsors":[],"tagged":[],"location":null,"audio":{"id":"7699846203294829350","title":"@网易逆水寒创作的原声","artist":"网易逆水寒","is_original":false},"thumbnail_url":"https://p3-pc-sign.douyinpic.com/tos-cn-i-dy/3d49f53a1b874836b3a6899627f14491~tplv-dy-cropcenter:323:430.jpeg?lk3s=138a59ce&x-expires=2109495600&x-signature=q7av9zE3pETSHc2sIunQ24c6aLE%3D&from=327834062&s=PackSourceEnum_PUBLISH&se=true&sh=323_430&sc=cover&biz_tag=pcweb_cover&l=20261108195653951D2C02FD9A8B60652B","video_duration":504.067,"media":[{"kind":"video","url":"https://v26-webf.douyinvod.com/dd50599696ec3a3c144792823bc9853c/6af08fad/video/tos/cn/tos-cn-ve-15/oQ0BPwjfTbDqiAA6Ifp19X8BgiRADnSRjQ2qEH/?a=6383&ch=10010&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C3&cv=1&br=2325&bt=2325&cs=0&ds=6&ft=zkMrh76a99xx~o-sdd~_hzrllc-i_vv2bLXofvODZmkaY3&mime_type=video_mp4&qs=0&rc=ODtlNDVkOzw8ZDQ5MzM5aUBpanY2bnQ5cmtuZTMzNGkzM0AzNWE1XzYyNl4xNjRiYDNeYSNuLl5lMmRzc2FhLS1kLTBzcw%3D%3D&btag=c0000e00030000&cquery=100o_101r_100B_100H_100K&dy_q=1794139013&feature_id=f0150a16a324336cda5d6dd0b69ed299&l=20261108195653951D2C02FD9A8B60652B","width":2560,"height":1440,"duration":504.067}],"media_urls":["https://v26-webf.douyinvod.com/dd50599696ec3a3c144792823bc9853c/6af08fad/video/tos/cn/tos-cn-ve-15/oQ0BPwjfTbDqiAA6Ifp19X8BgiRADnSRjQ2qEH/?a=6383&ch=10010&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C3&cv=1&br=2325&bt=2325&cs=0&ds=6&ft=zkMrh76a99xx~o-sdd~_hzrllc-i_vv2bLXofvODZmkaY3&mime_type=video_mp4&qs=0&rc=ODtlNDVkOzw8ZDQ5MzM5aUBpanY2bnQ5cmtuZTMzNGkzM0AzNWE1XzYyNl4xNjRiYDNeYSNuLl5lMmRzc2FhLS1kLTBzcw%3D%3D&btag=c0000e00030000&cquery=100o_101r_100B_100H_100K&dy_q=1794139013&feature_id=f0150a16a324336cda5d6dd0b69ed299&l=20261108195653951D2C02FD9A8B60652B"],"extra":{"url":"https://www.douyin.com/video/7699846003989499170","shares":2042,"saves":359,"region":null}},{"id":"7697607804957265190","shortcode":null,"taken_at":"2026-10-17T12:09:48+00:00","kind":"video","product_type":"0","caption":"【新地图月见岭】月光光，心慌慌。10月30日， 走进月见岭，一桩牵系你身世的苗疆蛊事，正待你亲手揭开真相。#逆水寒手游  #逆水寒表里世界  #逆水寒月见岭","hashtags":["逆水寒手游","逆水寒月见岭","逆水寒表里世界"],"mentions":[],"accessibility_caption":null,"likes":19098,"comments":1095,"views":null,"counts_hidden":null,"comments_disabled":null,"is_pinned":true,"is_paid_partnership":null,"owner":{"id":"97523645652","username":null,"full_name":"网易逆水寒","is_verified":true,"is_private":null,"avatar_url":"https://p3-pc.douyinpic.com/aweme/100x100/aweme-avatar/tos-cn-i-23auat310x_4944ebf6f11d4cefb393fc1c135d0b76.jpeg?from=327834062","latest_story_at":null,"extra":{"sec_uid":"MS4wLjABAAAAsO7ytzQSxOjL9tqK5sqrA7E8-VjwYj_2TbObDS_ZOb4"}},"coauthors":[],"sponsors":[],"tagged":[],"location":null,"audio":{"id":"7697607893790509866","title":"@网易逆水寒创作的原声","artist":"网易逆水寒","is_original":false},"thumbnail_url":"https://p3-pc-sign.douyinpic.com/tos-cn-i-dy/07b1d3fcfb0b4541b4a24627348ee5b9~tplv-dy-cropcenter:323:430.jpeg?lk3s=138a59ce&x-expires=2109495600&x-signature=qppbYR2RpdsjvTgFtv%2FOj39DY4Q%3D&from=327834062&s=PackSourceEnum_PUBLISH&se=true&sh=323_430&sc=cover&biz_tag=pcweb_cover&l=20261108195653951D2C02FD9A8B60652B","video_duration":184.8,"media":[{"kind":"video","url":"https://v26-webf.douyinvod.com/9286b24283f6de9f2d0781bf132fb044/6af08e6d/video/tos/cn/tos-cn-ve-15/oQIFjsSqGR9fgObTAQLDE97FvCefVXBgINAGBp/?a=6383&ch=10010&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C3&cv=1&br=2384&bt=2384&cs=0&ds=6&ft=zkMrh76a99xx~o-sdd~_hzrllc-i_vv2bLXofvODZmkaY3&mime_type=video_mp4&qs=0&rc=Ojw1OzlpM2k7Z2Y6OTs0ZUBpM2U4O3A5cnJwZTMzNGkzM0AwYzUzYzAzNS8xNl4uLTReYSNwNWBxMmRrMTZhLS1kLS9zcw%3D%3D&btag=80000e00028000&cquery=100B_100H_100K_100o_101r&dy_q=1794139013&feature_id=f0150a16a324336cda5d6dd0b69ed299&l=20261108195653951D2C02FD9A8B60652B","width":3118,"height":1440,"duration":184.8}],"media_urls":["https://v26-webf.douyinvod.com/9286b24283f6de9f2d0781bf132fb044/6af08e6d/video/tos/cn/tos-cn-ve-15/oQIFjsSqGR9fgObTAQLDE97FvCefVXBgINAGBp/?a=6383&ch=10010&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C3&cv=1&br=2384&bt=2384&cs=0&ds=6&ft=zkMrh76a99xx~o-sdd~_hzrllc-i_vv2bLXofvODZmkaY3&mime_type=video_mp4&qs=0&rc=Ojw1OzlpM2k7Z2Y6OTs0ZUBpM2U4O3A5cnJwZTMzNGkzM0AwYzUzYzAzNS8xNl4uLTReYSNwNWBxMmRrMTZhLS1kLS9zcw%3D%3D&btag=80000e00028000&cquery=100B_100H_100K_100o_101r&dy_q=1794139013&feature_id=f0150a16a324336cda5d6dd0b69ed299&l=20261108195653951D2C02FD9A8B60652B"],"extra":{"url":"https://www.douyin.com/video/7697607804957265190","shares":2513,"saves":578,"region":null}}],"pages":[{"cursor":null,"fetched_at":"2026-11-08T11:57:01.010529+00:00","count":41,"signed_in":false}],"next_cursor":null,"has_more":false,"stop_reason":"cursor_stalled","coverage":{"since":null,"oldest_at":"2026-10-07T10:00:01+00:00","since_reached":false}},"meta":{"source":"live","fetched_at":"2026-11-08T11:57:01.010529+00:00","cost":"$0.0005","balance":"$424.0699","request_id":"req_b39cc65c0d4a1082b79c37f3ef5fc2b6"}}}}},"202":{"description":"Durable job accepted. No completed-result charge. Save batch_id; poll status_url. Retry submission with the same Idempotency-Key after a lost response. An account may have five queued, running or payment-required jobs. A sixth new job returns 429 rate_limited. Matching idempotent replays still work at the limit. Ready and failed jobs release their slots; pages within a job remain unbounded. This is a synthetic contract example, not a live capture.","x-example-provenance":"synthetic-contract","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","required":["batch_id","status","status_url","results_url","cost","item_count","error","retry_at","total","done_count","failed_count","created_at","started_at","finished_at"],"properties":{"batch_id":{"type":"string"},"status":{"type":"string","enum":["queued","running","payment_required","ready","failed"]},"status_url":{"type":"string"},"results_url":{"type":"string"},"cost":{"type":"string"},"item_count":{"type":"integer","nullable":true},"error":{"type":"string","nullable":true,"description":"Null unless failed. A failed target carries its own code; incomplete_result appears only when it has none and pages of the result are missing. profile_not_found, post_not_found, upstream_not_found or not_found: the target does not exist or is not visible. not_visible: The account exists, but its posts are not visible to logged-out readers (private, restricted, or hidden by Instagram). Retrying will not change the result until the account changes. not_cached: cached=cache_only found no saved read. incomplete_result: pages of the result are missing. temporarily_unavailable: the target could not be read for now (no capacity, a pause or repeated refusals); retry later with a new job. result_item_too_large: one result unit exceeds the delivery budget. result_snapshot_missing or result_snapshot_corrupt: the crawler could not serve the retained result of a paid job, and its charge is refunded; if the crawler serves it again, a later results read returns it and charges the job again. crawler_submit_400, crawler_submit_404 or crawler_submit_422: the crawl service refused the job request. crawler_job_failed: any other failure; the same job is not expected to succeed if resubmitted. cancelled: the job was cancelled with POST /v1/jobs/{job_id}/cancel. No failed job costs anything: only result_snapshot_missing and result_snapshot_corrupt follow a charge, and that charge is refunded."},"retry_at":{"type":"string","format":"date-time","nullable":true,"description":"Null unless the job failed temporarily_unavailable because a crawl route was closed for every caller. Then it is when the route opens again, and the response carries the same time as a Retry-After header in seconds. Submit a new job after it."},"total":{"type":"integer","description":"Targets in the job. A job submitted through a /v1 route has one."},"done_count":{"type":"integer","description":"Targets the crawler finished."},"failed_count":{"type":"integer","description":"Targets that failed."},"created_at":{"type":"string","format":"date-time","description":"When the job was submitted."},"started_at":{"type":"string","format":"date-time","nullable":true,"description":"When the crawler started the job. Null until it starts."},"finished_at":{"type":"string","format":"date-time","nullable":true,"description":"When the job finished or failed. Null while it is queued or running."}}},"meta":{"type":"object","required":["cost","request_id"],"properties":{"cost":{"type":"string","example":"$0.0000"},"request_id":{"type":"string"}}}}},"example":{"data":{"batch_id":"job_7641d5f0-717d-4b70-a2f1-f58d846d7242","status":"queued","status_url":"/v1/jobs/job_7641d5f0-717d-4b70-a2f1-f58d846d7242","results_url":"/v1/jobs/job_7641d5f0-717d-4b70-a2f1-f58d846d7242/results","cost":"$0.0000","item_count":null,"error":null,"retry_at":null,"total":1,"done_count":0,"failed_count":0,"created_at":"2026-10-12T12:56:17.403Z","started_at":null,"finished_at":null},"meta":{"cost":"$0.0000","request_id":"req_job_example"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"404":{"description":"`cached=cache_only` found nothing saved for these arguments (`not_cached`; call again with `cached=auto` to fetch it), or the Douyin account or item does not exist (`not_found`). You are not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_cached","message":"no saved douyin/aweme_post read for 'MS4wLjABAAAArDVBosPJF3eIWVEFp0szuJ-e1V_-rK0ieJeWwpE77E8'. cached=cache_only never fetches, so call again with cached=auto to fetch it. You are not charged.","request_id":"req_5c10900e919bc7a3ff79b7501d582b4c"}}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/douyin/aweme_detail":{"get":{"tags":["Douyin"],"operationId":"douyinAwemeDetail","summary":"aweme_detail","x-dashboard-cost":"$0.0005","x-example-query":{"aweme_id":"7626744113161170259"},"description":"One video or image post: caption, counts, hashtags, sound, location and author. An unknown or removed video answers 404 and is not billed. Returns `Post` under `data`; with `get_raw=true` returns the upstream JSON.\n\nA field Douyin does not carry is null, a list it does not carry is `[]`, and Douyin-only facts sit under `extra`. Unknown, unsupported, and repeated query parameters return 400 before acquisition or billing.","security":[{"bearerAuth":[]}],"parameters":[{"name":"aweme_id","in":"query","required":true,"description":"A numeric Douyin video id, or the `https://www.douyin.com/video/{id}` URL.","example":"7626744113161170259","schema":{"type":"string"}},{"name":"cached","in":"query","required":false,"description":"`auto` (default) serves a read saved within the last 24 hours for these exact arguments, otherwise fetches. `cache_only` never contacts Douyin (404 `not_cached` when nothing is saved, whatever its age). `live` always fetches. Anything else is a `400`.","schema":{"type":"string","enum":["auto","cache_only","live"],"default":"auto"},"examples":{"default":{"value":"auto","x-disabled":true}}},{"name":"get_raw","in":"query","required":false,"description":"`true` returns the upstream JSON exactly as Douyin answered it instead of the normalized `Post`.","schema":{"type":"boolean","default":false},"examples":{"default":{"value":false,"x-disabled":true}}}],"responses":{"200":{"description":"`Post` under `data`; with `get_raw=true` the upstream JSON.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"anyOf":[{"$ref":"#/components/schemas/Post"},{"type":"object","additionalProperties":true}],"description":"`Post`, or the upstream JSON when `get_raw=true`."},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"id":"7626744113161170259","shortcode":null,"taken_at":"2026-04-09T13:02:21+00:00","kind":"video","product_type":"0","caption":"小城市的神人很多，大城市的神人很神#直播录屏回放 #魏辰宇 #炸裂","hashtags":["炸裂","直播录屏回放","魏辰宇"],"mentions":[],"accessibility_caption":null,"likes":47877,"comments":2245,"views":null,"counts_hidden":null,"comments_disabled":null,"is_pinned":null,"is_paid_partnership":null,"owner":{"id":"92823093519336","username":"62334810861","full_name":"失败的魏","is_verified":false,"is_private":null,"avatar_url":"https://p3-pc.douyinpic.com/aweme/100x100/aweme-avatar/tos-cn-avt-0015_7a028112dd524d8f29b4f146abec6e65.jpeg?from=327834062","latest_story_at":null,"extra":{"sec_uid":"MS4wLjABAAAArDVBosPJF3eIWVEFp0szuJ-e1V_-rK0ieJeWwpE77E8"}},"coauthors":[],"sponsors":[],"tagged":[],"location":null,"audio":{"id":"7626744109184699187","title":"@失败的魏创作的原声","artist":"失败的魏","is_original":false},"thumbnail_url":"https://p3-pc-sign.douyinpic.com/image-cut-tos-priv/98fc2facc12910cd9ad016a2ed55522d~tplv-dy-resize-origshort-autoq-75:330.jpeg?lk3s=138a59ce&x-expires=2108494800&x-signature=Z%2F2Sdo9OLBWiBjL1W454MzcEOkw%3D&from=327834062&s=PackSourceEnum_AWEME_DETAIL&se=false&sc=cover&biz_tag=pcweb_cover&l=202610280505133F941A051E6F69756B2D","video_duration":471.534,"media":[{"kind":"video","url":"https://v5-hl-zenl-ov.zjcdn.com/9b0c826ae5fbd09d1488d3ac0762e9b0/6ae13e11/video/tos/cn/tos-cn-ve-15/ocTGB1vQ7G48eZeEhAD0xRrrgAzTTVMiSXeBXC/?a=6383&ch=26&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C3&cv=1&br=1067&bt=1067&cs=0&ds=4&ft=CZdgCYlIDyjNHvVQ9wAFjKHhd.ZuWkK73-ApQX&mime_type=video_mp4&qs=0&rc=ZThoM2hmOzNmPDNlPDo2Z0BpajQ8OnQ5cmR0OjMzNGkzM0BjXy8vYy9gX2MxYzViLjFhYSNkc2xrMmRzM19hLS1kLTBzcw%3D%3D&btag=c0000e00030000&cquery=100z_100o_100w_100B_100x&dy_q=1793135114&feature_id=37f92ebd2877ae8e7eba995d406c5150&l=202610280505133F941A051E6F69756B2D","width":1080,"height":1920,"duration":471.534}],"media_urls":["https://v5-hl-zenl-ov.zjcdn.com/9b0c826ae5fbd09d1488d3ac0762e9b0/6ae13e11/video/tos/cn/tos-cn-ve-15/ocTGB1vQ7G48eZeEhAD0xRrrgAzTTVMiSXeBXC/?a=6383&ch=26&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C3&cv=1&br=1067&bt=1067&cs=0&ds=4&ft=CZdgCYlIDyjNHvVQ9wAFjKHhd.ZuWkK73-ApQX&mime_type=video_mp4&qs=0&rc=ZThoM2hmOzNmPDNlPDo2Z0BpajQ8OnQ5cmR0OjMzNGkzM0BjXy8vYy9gX2MxYzViLjFhYSNkc2xrMmRzM19hLS1kLTBzcw%3D%3D&btag=c0000e00030000&cquery=100z_100o_100w_100B_100x&dy_q=1793135114&feature_id=37f92ebd2877ae8e7eba995d406c5150&l=202610280505133F941A051E6F69756B2D"],"extra":{"url":"https://www.douyin.com/video/7626744113161170259","shares":109901,"saves":2922,"region":"CN"}},"meta":{"source":"live","fetched_at":"2026-10-27T21:05:14.442907+00:00","cost":"$0.0005","balance":"$9.9965","request_id":"req_477ddadf8f47626653e6ca588cc613ae"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"404":{"description":"`cached=cache_only` found nothing saved for these arguments (`not_cached`; call again with `cached=auto` to fetch it), or the Douyin account or item does not exist (`not_found`). You are not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_cached","message":"no saved douyin/aweme_detail read for '7626744113161170259'. cached=cache_only never fetches, so call again with cached=auto to fetch it. You are not charged.","request_id":"req_5c10900e919bc7a3ff79b7501d582b4c"}}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/douyin/comment_list":{"get":{"tags":["Douyin"],"operationId":"douyinCommentList","summary":"comment_list","x-dashboard-cost":"$0.0005/20","x-example-query":{"aweme_id":"7626744113161170259","max_pages":"1"},"description":"A video's top-level comments, hottest first, with each commenter's region in `extra.ip_label`. With max_pages=1, returns `Page[Comment]` under `data`; with `get_raw=true` returns the upstream JSON.\n\nThe default request creates a durable job (202). Use max_pages=1 for one synchronous Page response (200). Poll status_url, then read results_url with its opaque cursor. Acquisition stops at the first of since, max_pages, or exhaustion. Jobs continue after disconnects. Supply Idempotency-Key to recover a lost submission response; reuse it with the same inputs.\n\nA field Douyin does not carry is null, a list it does not carry is `[]`, and Douyin-only facts sit under `extra`. Unknown, unsupported, and repeated query parameters return 400 before acquisition or billing.\n\nBilling: $0.0005 per 20 unique returned items (one native page), rounded up to a minimum of one billing unit. Jobs settle once after successful completion.","security":[{"bearerAuth":[]}],"parameters":[{"name":"aweme_id","in":"query","required":true,"description":"A numeric Douyin video id, or the `https://www.douyin.com/video/{id}` URL.","example":"7626744113161170259","schema":{"type":"string"}},{"name":"since","in":"query","required":false,"description":"Not accepted on this operation: its items carry no timestamp, so since returns 400 before billing.","schema":{"type":"string"}},{"name":"max_pages","in":"query","required":false,"example":1,"description":"Maximum pages to fetch. -1 walks until exhaustion or since with no page cap, and must be written. Omitted, since alone bounds the walk; with neither, the job stops after 10 pages. Any positive integer is accepted. 1 returns one page synchronously with HTTP 200; any other value creates a durable job with HTTP 202.","schema":{"type":"integer","anyOf":[{"enum":[-1]},{"minimum":1}]}},{"name":"cursor","in":"query","required":false,"description":"Opaque next_cursor from an earlier answer of this operation, also with `get_raw=true`. A native Douyin cursor from a raw page answers 400. Result download cursors belong to the results route.","schema":{"type":"string","minLength":1}},{"name":"page_size","in":"query","required":false,"description":"Native count, default 20. Douyin answers at most 50. Billed per 20 unique returned items, one native page.","schema":{"type":"integer","default":20,"minimum":1,"maximum":50},"examples":{"default":{"value":20,"x-disabled":true}}},{"name":"cached","in":"query","required":false,"description":"`auto` (default) serves a read saved within the last 24 hours for these exact arguments, otherwise fetches. `cache_only` never contacts Douyin (404 `not_cached` when nothing is saved, whatever its age). `live` always fetches. Anything else is a `400`. `cache_only` reads one saved page per request: omit `max_pages` or pass 1, and continue with `next_cursor`.","schema":{"type":"string","enum":["auto","cache_only","live"],"default":"auto"},"examples":{"default":{"value":"auto","x-disabled":true}}},{"name":"get_raw","in":"query","required":false,"description":"`true` returns the upstream JSON exactly as Douyin answered it instead of the normalized `Page[Comment]`.","schema":{"type":"boolean","default":false},"examples":{"default":{"value":false,"x-disabled":true}}},{"name":"Idempotency-Key","in":"header","required":false,"description":"Reuse this key with the same inputs to recover a lost job submission. A different input with the same key returns 409.","schema":{"type":"string","minLength":1,"maxLength":200}}],"responses":{"200":{"description":"`Page[Comment]` under `data`; with `get_raw=true` the upstream JSON.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"anyOf":[{"type":"object","required":["items","pages","next_cursor","has_more","stop_reason","coverage"],"properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/Comment"},"description":"`Comment` of every page walked, in page order."},"pages":{"type":"array","items":{"$ref":"#/components/schemas/PageRead"},"description":"One entry per page walked."},"next_cursor":{"type":"string","nullable":true,"description":"Opaque; pass back as `cursor` to continue."},"has_more":{"type":"boolean","description":"True when `next_cursor` is set, and when the walk stopped `cursor_stalled` on a page that said more results exist but gave no cursor to send back."},"stop_reason":{"type":"string","enum":["pages","since","exhausted","cursor_stalled","repeated_content","deadline","blocked","caught_up"],"description":"Why the walk stopped. `pages`: the page budget is spent and `next_cursor` continues it. `deadline`: the call ran out of time before its next page; `next_cursor` continues it. `since`: a whole page was older than `since`. `exhausted`: Douyin reported the end. `cursor_stalled`: Douyin claimed more but repeated or omitted its cursor. `repeated_content`: a page held only items already seen. `blocked`: Douyin refused a later page; `next_cursor` is the page it refused. `caught_up`: only watch passes the crawler runs for itself stop this way."},"coverage":{"$ref":"#/components/schemas/Coverage"}}},{"type":"object","required":["pages","next_cursor","has_more","stop_reason"],"description":"`get_raw=true`: every native page walked, exactly as Douyin answered it, plus the opaque `next_cursor` and `stop_reason` of the walk.","properties":{"pages":{"type":"array","items":{"type":"object","additionalProperties":true,"required":["comments"],"properties":{"comments":{"type":"array","items":{"type":"object","additionalProperties":true}}}},"description":"One native page per page walked, upstream bytes unchanged."},"next_cursor":{"type":"string","nullable":true,"description":"Opaque; pass back as `cursor`."},"has_more":{"type":"boolean","description":"True when `next_cursor` is set, and when the walk stopped `cursor_stalled` on a page that said more results exist but gave no cursor to send back."},"stop_reason":{"type":"string","enum":["pages","since","exhausted","cursor_stalled","repeated_content","deadline","blocked","caught_up"],"description":"Why the walk stopped. `pages`: the page budget is spent and `next_cursor` continues it. `deadline`: the call ran out of time before its next page; `next_cursor` continues it. `since`: a whole page was older than `since`. `exhausted`: Douyin reported the end. `cursor_stalled`: Douyin claimed more but repeated or omitted its cursor. `repeated_content`: a page held only items already seen. `blocked`: Douyin refused a later page; `next_cursor` is the page it refused. `caught_up`: only watch passes the crawler runs for itself stop this way."}}}],"description":"`Page[Comment]`, or the upstream JSON when `get_raw=true`."},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"items":[{"id":"7626917599154668346","text":"我们这的gay就是比我们想象中的要多，我朋友下载小蓝打开定位发现附近都是！","created_at":"2026-04-10T00:15:37+00:00","likes":1628,"replies":23,"liked_by_owner":false,"owner":{"id":"107784388189","username":null,"full_name":"永恒დ","is_verified":null,"is_private":null,"avatar_url":null,"latest_story_at":null,"extra":{"sec_uid":"MS4wLjABAAAAARWGYL5dehexhDWxcxqzPnaQFe8xeFnyt32Hwha9ngQ"}},"extra":{"ip_label":"山东"}},{"id":"7634600795917501243","text":"感觉说的这么像绝情电工啊，而且他也是湖北的[憨笑]","created_at":"2026-04-30T17:10:21+00:00","likes":3,"replies":3,"liked_by_owner":false,"owner":{"id":"2516126428313956","username":"Joker36836","full_name":"周可儿.","is_verified":null,"is_private":null,"avatar_url":null,"latest_story_at":null,"extra":{"sec_uid":"MS4wLjABAAAAv53LYISXn58eERN3yPa1MhWkd--rNqsqW35746RemS8O72ALY4KFT2nS5aURKGVD"}},"extra":{"ip_label":"安徽"}}],"pages":[{"cursor":null,"fetched_at":"2026-10-27T21:05:15.438109+00:00","count":19}],"next_cursor":"eyJjdXJzb3IiOiIyMCIsIm9wIjoiY29tbWVudF9saXN0In0","has_more":true,"stop_reason":"pages","coverage":{"since":null,"oldest_at":null,"since_reached":false}},"meta":{"source":"live","fetched_at":"2026-10-27T21:05:15.438109+00:00","cost":"$0.0005","balance":"$9.9960","request_id":"req_0f70712d13cdec5c83f3d4d3aea9efb4"}}}}},"202":{"description":"Durable job accepted. No completed-result charge. Save batch_id; poll status_url. Retry submission with the same Idempotency-Key after a lost response. An account may have five queued, running or payment-required jobs. A sixth new job returns 429 rate_limited. Matching idempotent replays still work at the limit. Ready and failed jobs release their slots; pages within a job remain unbounded. This is a synthetic contract example, not a live capture.","x-example-provenance":"synthetic-contract","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","required":["batch_id","status","status_url","results_url","cost","item_count","error","retry_at","total","done_count","failed_count","created_at","started_at","finished_at"],"properties":{"batch_id":{"type":"string"},"status":{"type":"string","enum":["queued","running","payment_required","ready","failed"]},"status_url":{"type":"string"},"results_url":{"type":"string"},"cost":{"type":"string"},"item_count":{"type":"integer","nullable":true},"error":{"type":"string","nullable":true,"description":"Null unless failed. A failed target carries its own code; incomplete_result appears only when it has none and pages of the result are missing. profile_not_found, post_not_found, upstream_not_found or not_found: the target does not exist or is not visible. not_visible: The account exists, but its posts are not visible to logged-out readers (private, restricted, or hidden by Instagram). Retrying will not change the result until the account changes. not_cached: cached=cache_only found no saved read. incomplete_result: pages of the result are missing. temporarily_unavailable: the target could not be read for now (no capacity, a pause or repeated refusals); retry later with a new job. result_item_too_large: one result unit exceeds the delivery budget. result_snapshot_missing or result_snapshot_corrupt: the crawler could not serve the retained result of a paid job, and its charge is refunded; if the crawler serves it again, a later results read returns it and charges the job again. crawler_submit_400, crawler_submit_404 or crawler_submit_422: the crawl service refused the job request. crawler_job_failed: any other failure; the same job is not expected to succeed if resubmitted. cancelled: the job was cancelled with POST /v1/jobs/{job_id}/cancel. No failed job costs anything: only result_snapshot_missing and result_snapshot_corrupt follow a charge, and that charge is refunded."},"retry_at":{"type":"string","format":"date-time","nullable":true,"description":"Null unless the job failed temporarily_unavailable because a crawl route was closed for every caller. Then it is when the route opens again, and the response carries the same time as a Retry-After header in seconds. Submit a new job after it."},"total":{"type":"integer","description":"Targets in the job. A job submitted through a /v1 route has one."},"done_count":{"type":"integer","description":"Targets the crawler finished."},"failed_count":{"type":"integer","description":"Targets that failed."},"created_at":{"type":"string","format":"date-time","description":"When the job was submitted."},"started_at":{"type":"string","format":"date-time","nullable":true,"description":"When the crawler started the job. Null until it starts."},"finished_at":{"type":"string","format":"date-time","nullable":true,"description":"When the job finished or failed. Null while it is queued or running."}}},"meta":{"type":"object","required":["cost","request_id"],"properties":{"cost":{"type":"string","example":"$0.0000"},"request_id":{"type":"string"}}}}},"example":{"data":{"batch_id":"job_7641d5f0-717d-4b70-a2f1-f58d846d7242","status":"queued","status_url":"/v1/jobs/job_7641d5f0-717d-4b70-a2f1-f58d846d7242","results_url":"/v1/jobs/job_7641d5f0-717d-4b70-a2f1-f58d846d7242/results","cost":"$0.0000","item_count":null,"error":null,"retry_at":null,"total":1,"done_count":0,"failed_count":0,"created_at":"2026-10-12T12:56:17.403Z","started_at":null,"finished_at":null},"meta":{"cost":"$0.0000","request_id":"req_job_example"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"404":{"description":"`cached=cache_only` found nothing saved for these arguments (`not_cached`; call again with `cached=auto` to fetch it), or the Douyin account or item does not exist (`not_found`). You are not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_cached","message":"no saved douyin/comment_list read for '7626744113161170259'. cached=cache_only never fetches, so call again with cached=auto to fetch it. You are not charged.","request_id":"req_5c10900e919bc7a3ff79b7501d582b4c"}}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/douyin/aweme_related":{"get":{"tags":["Douyin"],"operationId":"douyinAwemeRelated","summary":"aweme_related","x-dashboard-cost":"$0.0005","x-example-query":{"aweme_id":"7626744113161170259"},"description":"The videos Douyin ranks as related to one video, with their authors. Douyin picks them by similar content, so they find creators in the same niche; they are not collaborations. Returns `Post[]` under `data`; with `get_raw=true` returns the upstream JSON.\n\nA field Douyin does not carry is null, a list it does not carry is `[]`, and Douyin-only facts sit under `extra`. Unknown, unsupported, and repeated query parameters return 400 before acquisition or billing.","security":[{"bearerAuth":[]}],"parameters":[{"name":"aweme_id","in":"query","required":true,"description":"A numeric Douyin video id, or the `https://www.douyin.com/video/{id}` URL.","example":"7626744113161170259","schema":{"type":"string"}},{"name":"cached","in":"query","required":false,"description":"`auto` (default) serves a read saved within the last 24 hours for these exact arguments, otherwise fetches. `cache_only` never contacts Douyin (404 `not_cached` when nothing is saved, whatever its age). `live` always fetches. Anything else is a `400`.","schema":{"type":"string","enum":["auto","cache_only","live"],"default":"auto"},"examples":{"default":{"value":"auto","x-disabled":true}}},{"name":"get_raw","in":"query","required":false,"description":"`true` returns the upstream JSON exactly as Douyin answered it instead of the normalized `Post[]`.","schema":{"type":"boolean","default":false},"examples":{"default":{"value":false,"x-disabled":true}}}],"responses":{"200":{"description":"`Post[]` under `data`; with `get_raw=true` the upstream JSON.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"anyOf":[{"type":"array","items":{"$ref":"#/components/schemas/Post"}},{"type":"object","additionalProperties":true}],"description":"`Post[]`, or the upstream JSON when `get_raw=true`."},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":[{"id":"7690075080454182378","shortcode":null,"taken_at":"2026-09-27T04:58:51+00:00","kind":"video","product_type":"0","caption":"喜人四大名著之二吕严去酷滕家过年 最强吐槽役吕严没有吐槽空间，只弱弱反驳了几句豆奶没有乳糖#名场面连麦 #吕严 #酷酷的天放 #喜人 #酷滕","hashtags":["名场面连麦","吕严","喜人","酷滕","酷酷的天放"],"mentions":[],"accessibility_caption":null,"likes":119345,"comments":2036,"views":null,"counts_hidden":null,"comments_disabled":null,"is_pinned":null,"is_paid_partnership":null,"owner":{"id":"84915326471","username":"wenrou_xiaohu","full_name":"温柔小狐","is_verified":false,"is_private":null,"avatar_url":"https://p3-pc.douyinpic.com/aweme/100x100/aweme-avatar/tos-cn-avt-0015_73dd13af4f098c1bd1d45e98755a5e0c.jpeg?from=327834062","latest_story_at":null,"extra":{"sec_uid":"MS4wLjABAAAAXabozy4mboxKCKoEAsyUeWVbxpDOfe3uFbpkptyAY_I"}},"coauthors":[],"sponsors":[],"tagged":[],"location":null,"audio":{"id":"7690075035825883944","title":"@温柔小狐创作的原声","artist":"温柔小狐","is_original":false},"thumbnail_url":"https://p3-pc-sign.douyinpic.com/image-cut-tos/b1b87dc52bb81daaee72dfc7bce12037~tplv-dy-resize-origshort-autoq-75:330.jpeg?lk3s=138a59ce&x-expires=2108494800&x-signature=OLx9ORlOFN5Ze1xBEkZEQfQGNFw%3D&from=327834062&s=PackSourceEnum_WEBPC_RELATED_AWEME&se=false&sc=cover&biz_tag=pcweb_cover&l=20261028050516131731C88728BF9C6000","video_duration":345.734,"media":[{"kind":"video","url":"https://v3-web-prime.douyinvod.com/video/tos/cn/tos-cn-ve-15c000-ce/os4M9LbBIEWIgucFU4eSfmnA7upDVGOeJQU0DX/?a=6383&ch=164&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C3&cv=1&br=917&bt=917&cs=0&ds=4&ft=L~zg4YX1DyjNHvVQ9wnFjKHhd.ZuWkK73-ApQX&mime_type=video_mp4&qs=0&rc=MztmNzpnPGZnOTg6MzY8ZEBpanh2aG05cm5kZDMzbGkzNUAuYDQzNmEyNWAxYDIwYTUzYSNzMmcwMmRzMXBhLS1kLTRzcw%3D%3D&btag=c0000e00030000&cquery=100o_101s_100B_100x_100z&dy_q=1793135116&expire=1793146261&feature_id=37f92ebd2877ae8e7eba995d406c5150&l=20261028050516131731C88728BF9C6000&ply_type=4&policy=4&signature=2ed45d27802c4e36ea40930d500a4662&tk=webid","width":1206,"height":1142,"duration":345.734}],"media_urls":["https://v3-web-prime.douyinvod.com/video/tos/cn/tos-cn-ve-15c000-ce/os4M9LbBIEWIgucFU4eSfmnA7upDVGOeJQU0DX/?a=6383&ch=164&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C3&cv=1&br=917&bt=917&cs=0&ds=4&ft=L~zg4YX1DyjNHvVQ9wnFjKHhd.ZuWkK73-ApQX&mime_type=video_mp4&qs=0&rc=MztmNzpnPGZnOTg6MzY8ZEBpanh2aG05cm5kZDMzbGkzNUAuYDQzNmEyNWAxYDIwYTUzYSNzMmcwMmRzMXBhLS1kLTRzcw%3D%3D&btag=c0000e00030000&cquery=100o_101s_100B_100x_100z&dy_q=1793135116&expire=1793146261&feature_id=37f92ebd2877ae8e7eba995d406c5150&l=20261028050516131731C88728BF9C6000&ply_type=4&policy=4&signature=2ed45d27802c4e36ea40930d500a4662&tk=webid"],"extra":{"url":"https://www.douyin.com/video/7690075080454182378","shares":91117,"saves":7977,"region":"CN"}},{"id":"7692133500611361905","shortcode":null,"taken_at":"2026-10-02T18:06:36+00:00","kind":"video","product_type":"0","caption":"小何能有什么心思 只是想知道头发里面空心还是实心罢了@何秋亊 #何铮 #何秋亊 #李真棒 #何秋亊直播录屏 #直播录屏分享","hashtags":["何秋亊","何秋亊直播录屏","何铮","李真棒","直播录屏分享"],"mentions":["何秋亊"],"accessibility_caption":null,"likes":42669,"comments":341,"views":null,"counts_hidden":null,"comments_disabled":null,"is_pinned":null,"is_paid_partnership":null,"owner":{"id":"1097769915517945","username":"55355887971","full_name":"鱼鱼籽🍂","is_verified":false,"is_private":null,"avatar_url":"https://p3-pc.douyinpic.com/aweme/100x100/aweme-avatar/tos-cn-avt-0015_4ac59af5b5262c1978605865db63460a.jpeg?from=327834062","latest_story_at":null,"extra":{"sec_uid":"MS4wLjABAAAAp1sWYZxjx98DE8EmB8-J3gSYBRs_ZbMwh-aZUVLgo8_wYxnWRNXLFVEnK6m4x8Cb"}},"coauthors":[],"sponsors":[],"tagged":[],"location":null,"audio":{"id":"7692133265355852553","title":"@鱼鱼籽🍂创作的原声","artist":"鱼鱼籽🍂","is_original":false},"thumbnail_url":"https://p3-pc-sign.douyinpic.com/image-cut-tos-priv/f27decc36418e06a81505eb86daf0adb~tplv-dy-resize-origshort-autoq-75:330.jpeg?lk3s=138a59ce&x-expires=2108494800&x-signature=eqj2wNwc%2BMx9kAiFibu%2F5qd%2B6Y8%3D&from=327834062&s=PackSourceEnum_WEBPC_RELATED_AWEME&se=false&sc=cover&biz_tag=pcweb_cover&l=20261028050516131731C88728BF9C6000","video_duration":124.272,"media":[{"kind":"video","url":"https://v3-web-prime.douyinvod.com/video/tos/cn/tos-cn-ve-15c000-ce/oAlBUDwXvAIp7yvJQBe11UClHiEeiASScfTEK8/?a=6383&ch=164&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C3&cv=1&br=1271&bt=1271&cs=0&ds=4&ft=L~zg4YX1DyjNHvVQ9wnFjKHhd.ZuWkK73-ApQX&mime_type=video_mp4&qs=0&rc=PGZlZGU0ODRnNDY6NDM0ZEBpajZvZ3Y5cm55ZDMzbGkzNEBgNTIwX15fXjUxMzY2Mi0zYSNmMWBiMmRrMXNhLS1kLWJzcw%3D%3D&btag=c0000e00028000&cquery=100o_101s_100B_100x_100z&dy_q=1793135116&expire=1793146040&feature_id=37f92ebd2877ae8e7eba995d406c5150&l=20261028050516131731C88728BF9C6000&ply_type=4&policy=4&signature=36013ce58fda53bd70e7934f52a89e9d&tk=webid","width":1080,"height":1440,"duration":124.272}],"media_urls":["https://v3-web-prime.douyinvod.com/video/tos/cn/tos-cn-ve-15c000-ce/oAlBUDwXvAIp7yvJQBe11UClHiEeiASScfTEK8/?a=6383&ch=164&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C3&cv=1&br=1271&bt=1271&cs=0&ds=4&ft=L~zg4YX1DyjNHvVQ9wnFjKHhd.ZuWkK73-ApQX&mime_type=video_mp4&qs=0&rc=PGZlZGU0ODRnNDY6NDM0ZEBpajZvZ3Y5cm55ZDMzbGkzNEBgNTIwX15fXjUxMzY2Mi0zYSNmMWBiMmRrMXNhLS1kLWJzcw%3D%3D&btag=c0000e00028000&cquery=100o_101s_100B_100x_100z&dy_q=1793135116&expire=1793146040&feature_id=37f92ebd2877ae8e7eba995d406c5150&l=20261028050516131731C88728BF9C6000&ply_type=4&policy=4&signature=36013ce58fda53bd70e7934f52a89e9d&tk=webid"],"extra":{"url":"https://www.douyin.com/video/7692133500611361905","shares":61481,"saves":1555,"region":"CN"}}],"meta":{"source":"live","fetched_at":"2026-10-27T21:05:17.314411+00:00","cost":"$0.0005","balance":"$9.9955","request_id":"req_704c07d50a2709963f56358ce8b1aecf"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"404":{"description":"`cached=cache_only` found nothing saved for these arguments (`not_cached`; call again with `cached=auto` to fetch it), or the Douyin account or item does not exist (`not_found`). You are not charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_cached","message":"no saved douyin/aweme_related read for '7626744113161170259'. cached=cache_only never fetches, so call again with cached=auto to fetch it. You are not charged.","request_id":"req_5c10900e919bc7a3ff79b7501d582b4c"}}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/meta_ads/stored/search":{"post":{"tags":["Meta Ads"],"operationId":"maStoredSearch","summary":"Search stored ads","x-dashboard-cost":"$0.0010","description":"Full-text search over tracked Meta Ad Library ads with structured filters: advertiser name, page id, CTA type, link domain, publisher platform, media type, active-only, minimum days active, and start date. Sortable by start date, longevity (`daysActive`), or A/B-test breadth (`collation`).\n\nA POST — the filter object is a JSON body. Unknown fields are ignored; invalid types return `400` before billing.\n\nThe answer carries `total`, the exact count of every match, and `next_cursor` with `has_more` while more matches remain. `next_cursor` is an opaque string; send it back as `cursor`, with the same filters and `sortBy`, for the next page, at any depth. It is null on the last page.\n\nA search without `pageId` reads the ad search index: `query` matches whole words of the ad title and body, with no English stemming and no stop words, so every word you send must appear.","security":[{"bearerAuth":[]}],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string","description":"Full-text over ad title + body copy."},"pageId":{"type":"string"},"advertiser":{"type":"string","description":"Advertiser page-name substring."},"ctaType":{"type":"string","example":"SHOP_NOW"},"linkDomain":{"type":"string","example":"amazon.com"},"platform":{"type":"string","example":"INSTAGRAM"},"mediaType":{"type":"string","example":"VIDEO"},"activeOnly":{"type":"boolean"},"minDaysActive":{"type":"integer","minimum":0},"startedAfter":{"type":"string","example":"2026-01-01"},"sortBy":{"type":"string","enum":["startDate","daysActive","collation"],"default":"startDate"},"limit":{"type":"integer","default":30,"minimum":1,"maximum":200},"cursor":{"type":"string","description":"Opaque `next_cursor` from the previous page."}}},"example":{"pageId":"15087023444","activeOnly":true,"limit":2}}}},"responses":{"200":{"description":"Matching ads with creatives.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object"},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"ads":[{"adArchiveId":"1120113070497516","pageId":"15087023444","pageName":"Nike","pageProfilePicUrl":"https://api.virev.ai/v1/media/meta_advertiser/15087023444/profile_pic?e=1793750400&s=98b4bdad4fd7074de644339239015e70","igUsername":"nike","ctaType":"SHOP_NOW","ctaText":"Shop now","linkUrl":"https://www.nike.com/","linkDomain":"nike.com","title":"{{product.name}}","bodyText":"Get the gear not afraid to put in the work.","displayFormat":"DPA","publisherPlatforms":["facebook","instagram"],"startDate":"2026-10-23T07:00:00Z","isActive":true,"daysActive":4,"collationCount":null,"endedAt":null,"creatives":[{"creativeId":4395,"mediaType":"card","metaSrcUrl":"https://api.virev.ai/v1/media/meta_ad_creative/4395/creative?e=1793750400&s=c7ccfb5a4aaefaeddfb3b504498e7a70","b2Url":null,"media_state":"live"},{"creativeId":4396,"mediaType":"card","metaSrcUrl":"https://api.virev.ai/v1/media/meta_ad_creative/4396/creative?e=1793750400&s=ddb11cc45f38f4745e4ffec542e6b3fa","b2Url":null,"media_state":"live"},{"creativeId":4397,"mediaType":"card","metaSrcUrl":"https://api.virev.ai/v1/media/meta_ad_creative/4397/creative?e=1793750400&s=4f9840c411c5fbfc47f4a11f41784cc8","b2Url":null,"media_state":"live"},{"creativeId":4398,"mediaType":"card","metaSrcUrl":"https://api.virev.ai/v1/media/meta_ad_creative/4398/creative?e=1793750400&s=86919620b50697941970700f7cf95366","b2Url":null,"media_state":"live"},{"creativeId":4399,"mediaType":"card","metaSrcUrl":"https://api.virev.ai/v1/media/meta_ad_creative/4399/creative?e=1793750400&s=d19a0a18f7b01b5a743adf9ecc2a6e1b","b2Url":null,"media_state":"live"},{"creativeId":4400,"mediaType":"card","metaSrcUrl":"https://api.virev.ai/v1/media/meta_ad_creative/4400/creative?e=1793750400&s=cc391cd7c8320e92d28642c40833d564","b2Url":null,"media_state":"live"}]},{"adArchiveId":"1476143881043704","pageId":"15087023444","pageName":"Nike","pageProfilePicUrl":"https://api.virev.ai/v1/media/meta_advertiser/15087023444/profile_pic?e=1793750400&s=98b4bdad4fd7074de644339239015e70","igUsername":"nike","ctaType":"SHOP_NOW","ctaText":"Shop now","linkUrl":"https://www.nike.com/","linkDomain":"nike.com","title":"{{product.name}}","bodyText":"Get the gear that goes hard on and off the field.","displayFormat":"DPA","publisherPlatforms":["facebook","instagram"],"startDate":"2026-10-23T07:00:00Z","isActive":true,"daysActive":4,"collationCount":null,"endedAt":null,"creatives":[{"creativeId":4407,"mediaType":"card","metaSrcUrl":"https://api.virev.ai/v1/media/meta_ad_creative/4407/creative?e=1793750400&s=b5fe69728cf5cce311c8723c83a61107","b2Url":null,"media_state":"live"},{"creativeId":4408,"mediaType":"card","metaSrcUrl":"https://api.virev.ai/v1/media/meta_ad_creative/4408/creative?e=1793750400&s=53cbbe4d84e633f6ee5d3af20cfdfcd1","b2Url":null,"media_state":"live"},{"creativeId":4409,"mediaType":"card","metaSrcUrl":"https://api.virev.ai/v1/media/meta_ad_creative/4409/creative?e=1793750400&s=413d351393d9d36507b651045f84a6b7","b2Url":null,"media_state":"live"},{"creativeId":4410,"mediaType":"card","metaSrcUrl":"https://api.virev.ai/v1/media/meta_ad_creative/4410/creative?e=1793750400&s=e69040b92b23489c9927dc7a1f2f5a39","b2Url":null,"media_state":"live"},{"creativeId":4411,"mediaType":"card","metaSrcUrl":"https://api.virev.ai/v1/media/meta_ad_creative/4411/creative?e=1793750400&s=a6b3227e1625dc5d430189fd3d11bf51","b2Url":null,"media_state":"live"},{"creativeId":4412,"mediaType":"card","metaSrcUrl":"https://api.virev.ai/v1/media/meta_ad_creative/4412/creative?e=1793750400&s=5b9fd748430e20658d388d15a6e75787","b2Url":null,"media_state":"live"}]}],"total":36,"next_cursor":"eyJvZmZzZXQiOjJ9","has_more":true},"meta":{"cost":"$0.0010","balance":"$49.9775","request_id":"req_26a82ad75291478480626d4468944390"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/meta_ads/stored/advertiser":{"get":{"tags":["Meta Ads"],"operationId":"maStoredAdvertiser","summary":"Advertiser","x-dashboard-cost":"$0.0002","description":"A tracked advertiser (Meta Page): page name/username, category, verification, Instagram link, page likes, and total/active ad counts — the discovery pivot for per-advertiser monitoring.","security":[{"bearerAuth":[]}],"parameters":[{"name":"page_id","in":"query","required":true,"description":"Meta Page id of the advertiser (from `/v1/meta_ads/stored/search` or `/v1/meta_ads/search_companies`).","schema":{"type":"string"},"example":"9465008123"}],"responses":{"200":{"description":"Advertiser record.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object"},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"page_id":"9465008123","page_name":"Amazon.com","page_username":"61557458285618","category":"Business","verification":null,"profile_pic_url":"https://scontent.fdps2-1.fna.fbcdn.net/v/t39.35426-6/652509937_795416030301968_1974627614417241229_n.jpg?stp=dst-jpg_s60x60_tt6&_nc_cat=102&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=5SzjOYQZd9IQ7kNvwGxRPY1&_nc_oc=Adog-itRXhj4WlrVlpYJbMZHuJYdznsb4uS8lCyp_vmyQ26rFARe2iWvFKsTC4bFmwI&_nc_zt=14&_nc_ht=scontent.fdps2-1.fna&_nc_gid=jlPTf5GhPxAVWDbGW02SsQ&_nc_ss=79289&oh=00_AQA65UuGBJXZQY8V0pluXFyjQRv6rpofBsz66enD03JzKg&oe=6A54F6B2","profile_pic_cdn_url":null,"ig_username":null,"country":null,"likes":182227,"ig_followers":null,"is_tracked":true,"ad_count":1002,"active_ad_count":870,"first_seen_at":"2026-07-08T17:11:38.292306Z","last_crawled_at":"2026-07-09T03:49:33.779010Z","deep_crawled_at":"2026-07-08T21:35:31.714013Z","ads_seen":1002,"ads_active":870,"ads_counted_at":"2026-07-09T04:02:51.118000Z"},"meta":{"cost":"$0.0002","balance":"$0.7982","request_id":"req_00e8fc06398dc38618aec277bd9d0815"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"404":{"description":"Advertiser not tracked.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_found","message":"123","request_id":"req_5c10900e919bc7a3ff79b7501d582b4c"}}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/meta_ads/stored/insights":{"get":{"tags":["Meta Ads"],"operationId":"maStoredInsights","summary":"Advertiser insights","x-dashboard-cost":"$0.0010","description":"Aggregate ad-strategy insights for one advertiser: total/active ad counts, longevity (active ads age dynamically from `start_date`; ended ads use their recorded lifetime), display-format / CTA / publisher-platform distributions, top link domains, a 6-month launch series, and the 5 longest-running active ads.\n\n`last_checked_at` is the most recent ingest snapshot.","security":[{"bearerAuth":[]}],"parameters":[{"name":"page_id","in":"query","required":true,"description":"Meta Page id of the advertiser (from `/v1/meta_ads/stored/search` or `/v1/meta_ads/search_companies`).","schema":{"type":"string"},"example":"9465008123"}],"responses":{"200":{"description":"Ad-strategy aggregates.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object"},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"advertiser":{"page_id":"9465008123","page_name":"Amazon.com","page_username":"61557458285618","category":"Business","verification":null,"profile_pic_url":"https://scontent.fdps2-1.fna.fbcdn.net/v/t39.35426-6/652509937_795416030301968_1974627614417241229_n.jpg?stp=dst-jpg_s60x60_tt6&_nc_cat=102&ccb=1-7&_nc_sid=c53f8f&_nc_ohc=5SzjOYQZd9IQ7kNvwGxRPY1&_nc_oc=Adog-itRXhj4WlrVlpYJbMZHuJYdznsb4uS8lCyp_vmyQ26rFARe2iWvFKsTC4bFmwI&_nc_zt=14&_nc_ht=scontent.fdps2-1.fna&_nc_gid=jlPTf5GhPxAVWDbGW02SsQ&_nc_ss=79289&oh=00_AQA65UuGBJXZQY8V0pluXFyjQRv6rpofBsz66enD03JzKg&oe=6A54F6B2","profile_pic_cdn_url":null,"ig_username":null,"country":null,"likes":182227,"ig_followers":null,"is_tracked":true,"ad_count":1002,"active_ad_count":870,"first_seen_at":"2026-07-08T17:11:38.292306Z","last_crawled_at":"2026-07-09T03:49:33.779010Z","deep_crawled_at":"2026-07-08T21:35:31.714013Z","ads_seen":1002,"ads_active":870},"total_ads":1002,"active_ads":870,"avg_days_active":117.6,"max_days_active":2129,"avg_collation_count":1.8,"first_ad_started_at":"2020-08-31T07:00:00Z","last_checked_at":"2026-07-09T03:49:33.783463Z","display_format_distribution":{"VIDEO":484,"DPA":361,"DCO":126,"IMAGE":26,"CAROUSEL":5},"cta_type_distribution":{"SHOP_NOW":884,"LEARN_MORE":73,"UNKNOWN":45},"publisher_platform_distribution":{"INSTAGRAM":890,"FACEBOOK":823,"WHATSAPP":9,"AUDIENCE_NETWORK":9,"THREADS":9,"MESSENGER":5},"top_link_domains":{"amazon.com":889,"aboutamazon.com":43,"pharmacy.amazon.com":13,"blog.aboutamazon.com":10,"a.co":2},"ads_started_by_month":{"2026-02":32,"2026-03":292,"2026-04":276,"2026-05":35,"2026-06":194,"2026-07":10},"longest_running_active_ads":[{"ad_archive_id":"601761209218990","title":"Amazon.com","cta_type":"SHOP_NOW","link_domain":"amazon.com","display_format":"DPA","start_date":"2025-07-02T07:00:00Z","days_active_now":372,"collation_count":null},{"ad_archive_id":"1918530298971522","title":"Amazon.com","cta_type":"SHOP_NOW","link_domain":"amazon.com","display_format":"DPA","start_date":"2025-07-02T07:00:00Z","days_active_now":372,"collation_count":null}]},"meta":{"cost":"$0.0010","balance":"$0.7972","request_id":"req_d0f419a3ad0f40b16398594b122165ad"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"404":{"description":"Advertiser not tracked.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_found","message":"123","request_id":"req_5c10900e919bc7a3ff79b7501d582b4c"}}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/crawl/web-scraping-api":{"post":{"tags":["Crawl"],"operationId":"crawlWebScrapingApi","summary":"Scrape any public URL","x-dashboard-cost":"$0.0005","description":"Fetch any public `url` and get the document back. A call with no `geo` fetches from our own servers, and a `geo` target sends it through our residential proxy pool. Optional `extract` maps output fields to dot-paths in the parsed JSON. Optional `geo` targets the egress: `session` (8 lowercase alphanumerics — reuse the same value across calls to keep one exit IP), `lifetime` (minutes, 3–1440, requires `session`), and `type` (`residential`/`mobile`/`datacenter`). A `geo` target is either honoured or refused, never silently substituted — an egress we cannot serve returns 400 and is not charged. Optional `spoof` decides how the request PRESENTS itself: `render` executes the target page JavaScript in a real de-automated browser (for surfaces that serve no content to a plain HTTP client), `warm_url` establishes the target cookies first in the same browser context, `wait_for` is a CSS selector proving the page produced its content (echoed back as `wait_matched`), plus `headers`, `user_agent`, `locale`, `accept_consent`, `timeout_ms`. **The `/v1/search/*` SERP endpoints are exactly this door with a search-engine URL and a `spoof` block.** Only public destinations; http/https GET only; no credentials or arbitrary headers pass through; redirects, size, and time are bounded.","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["url"],"additionalProperties":false,"properties":{"url":{"type":"string","minLength":1,"maxLength":2048,"pattern":"\\S"},"extract":{"type":"object","maxProperties":64,"propertyNames":{"pattern":"\\S"},"additionalProperties":{"type":"string","pattern":"\\S"}},"geo":{"type":"object","additionalProperties":false,"properties":{"session":{"type":"string","pattern":"^[a-z0-9]{8}$","example":"a1b2c3d4"},"lifetime":{"type":"integer","minimum":3,"maximum":1440,"example":60},"type":{"type":"string","enum":["residential","mobile","datacenter"]}}},"spoof":{"type":"object","additionalProperties":false,"properties":{"render":{"type":"boolean","default":false,"description":"Execute the page's JavaScript in a real de-automated browser instead of taking raw bytes."},"warm_url":{"type":"string","maxLength":2048,"description":"Visited first in the same browser context so the target issues its cookies before the real navigation."},"wait_for":{"type":"string","maxLength":256,"description":"CSS selector proving the rendered page produced its content; echoed back as `wait_matched`."},"accept_consent":{"type":"boolean","default":true},"headers":{"type":"object","additionalProperties":{"type":"string"}},"user_agent":{"type":"string","maxLength":512},"locale":{"type":"string","maxLength":16,"example":"en-US"},"timeout_ms":{"type":"integer","minimum":1000,"maximum":180000}}}}},"example":{"url":"https://hacker-news.firebaseio.com/v0/item/1.json","extract":{"author":"by","title":"title"}}}}},"responses":{"200":{"description":"Fetched document with optional extracted fields.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":true},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"final_url":"https://hacker-news.firebaseio.com/v0/item/1.json","status":200,"content_type":"application/json; charset=utf-8","payload_kind":"json","response_headers":{"content-type":"application/json; charset=utf-8","cache-control":"no-cache"},"body":{"by":"pg","descendants":3,"id":1,"kids":[15,487171],"score":57,"time":1160418111,"title":"Y Combinator","type":"story","url":"http://ycombinator.com"}},"meta":{"cost":"$0.0005","balance":"$3.0795","request_id":"req_35145924f648947eb50334cc25a0dca7"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/crawl/hackernews/profile":{"get":{"tags":["Crawl"],"operationId":"crawlHnProfile","summary":"Hacker News user","x-dashboard-cost":"$0.0005","description":"A Hacker News user — karma, account age, about text, and their submissions. A username that does not exist returns no fields and is not billed.","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"query","required":true,"description":"The Hacker News username.","example":"pg","schema":{"type":"string"}}],"responses":{"200":{"description":"Fetched document with optional extracted fields.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":true},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"final_url":"https://hacker-news.firebaseio.com/v0/user/pg.json","status":200,"content_type":"application/json; charset=utf-8","payload_kind":"json","response_headers":{"content-type":"application/json; charset=utf-8","cache-control":"no-cache"},"body":{"about":"Bug fixer.","created":1160418092,"id":"pg","karma":157316,"submitted":[39667625,37278578]},"extracted":{"values":{"username":"pg","karma":157316,"created":1160418092,"about":"Bug fixer."},"errors":[]}},"meta":{"cost":"$0.0005","balance":"$3.0790","request_id":"req_b10e639af72b9319ae3c66658c2cc6ab"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"404":{"description":"No stored payload for this input (fetch one with `source=live`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_found","message":"nosuchuser","request_id":"req_5c10900e919bc7a3ff79b7501d582b4c"}}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/crawl/hackernews/story":{"get":{"tags":["Crawl"],"operationId":"crawlHnStory","summary":"Hacker News item","x-dashboard-cost":"$0.0005","description":"One Hacker News item — story, comment, poll, or job — by its numeric id. An id with no item returns no fields and is not billed.","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"query","required":true,"description":"The Hacker News item id (numeric).","example":"8863","schema":{"type":"string"}}],"responses":{"200":{"description":"Fetched document with optional extracted fields.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":true},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"final_url":"https://hacker-news.firebaseio.com/v0/item/8863.json","status":200,"content_type":"application/json; charset=utf-8","payload_kind":"json","response_headers":{"content-type":"application/json; charset=utf-8","cache-control":"no-cache"},"body":{"by":"dhouston","descendants":71,"id":8863,"kids":[9224,8917],"score":104,"time":1175714200,"title":"My YC app: Dropbox - Throw away your USB drive","type":"story","url":"http://www.getdropbox.com/u/2/screencast.html"},"extracted":{"values":{"by":"dhouston","title":"My YC app: Dropbox - Throw away your USB drive","score":104,"type":"story"},"errors":[]}},"meta":{"cost":"$0.0005","balance":"$3.0785","request_id":"req_eb27065c8b54e06e546e6329f69e100c"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"404":{"description":"No stored payload for this input (fetch one with `source=live`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_found","message":"nosuchuser","request_id":"req_5c10900e919bc7a3ff79b7501d582b4c"}}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/crawl/hackernews/story/comments":{"get":{"tags":["Crawl"],"operationId":"crawlHnStoryComments","summary":"Hacker News comment tree","x-dashboard-cost":"$0.0005","description":"An item's full nested comment tree, as served by the Algolia items API.","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"query","required":true,"description":"The Hacker News item id (numeric).","example":"8863","schema":{"type":"string"}}],"responses":{"200":{"description":"Fetched document with optional extracted fields.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":true},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"final_url":"https://hn.algolia.com/api/v1/items/8863","status":200,"content_type":"application/json","payload_kind":"json","response_headers":{"content-type":"application/json"},"body":{"author":"dhouston","children":[{"author":"dhouston","children":[{"author":"vlad","children":[],"created_at":"2007-04-05T01:48:11.000Z","created_at_i":1175737691,"id":9007,"options":[],"parent_id":8865,"points":null,"story_id":8863,"text":"Drew, this is awesome!  All of the features you mentioned are exactly what people need.","title":null,"type":"comment","url":null}],"created_at":"2007-04-04T19:22:55.000Z","created_at_i":1175714575,"id":8865,"options":[],"parent_id":8863,"points":null,"story_id":8863,"text":"oh, and a mac port is coming :)","title":null,"type":"comment","url":null},{"author":"zaidf","children":[{"author":"rwalker","children":[{"author":"zach","children":[],"created_at":"2007-04-04T23:17:47.000Z","created_at_i":1175728667,"id":8960,"options":[],"parent_id":8949,"points":null,"story_id":8863,"text":"I love that approach (my weblog is called \"Story-Driven\" after all) because it automatically breaks technical people out of a taxonomic, procedural mindset.  So many descriptions of things are on the order of \"well, it's a set of pliers with a light on it\" instead of \"it's how I change fuses in my rusty fusebox in the middle of the night.\"<p>You can't emphasize enough to people to tell a story, and the screencast is a great crucible for whether you have a good story to tell.  Screencasts aren't appreciated enough for the way they've helped people understand concepts that are a little more technical than they normally would sit still for.","title":null,"type":"comment","url":null}],"created_at":"2007-04-04T22:50:38.000Z","created_at_i":1175727038,"id":8949,"options":[],"parent_id":8869,"points":null,"story_id":8863,"text":"Looks like a great product, and I will second the parent comment.<p>One thing they teach at YC, and in one of pg's essays (<a href=\"http://www.paulgraham.com/investors.html),\">http://www.paulgraham.com/investors.html),</a> is to present a story instead of a list of features.  That way you answer the question of \"Why would I use this product?\" simultaneously to answering \"What does this product do?\".","title":null,"type":"comment","url":null}],"created_at":"2007-04-04T19:36:20.000Z","created_at_i":1175715380,"id":8869,"options":[],"parent_id":8863,"points":null,"story_id":8863,"text":"This has great potential!<p>Only suggestion I would have is go slower on the demo. I know you lost me very early into it switching between windows.<p>If you are looking for a wider audience than those who already know the context of dropbox, make a video where you lay out the case for use of dropbox using simple examples from user point of view(think a college student) and then in the demo show just the basic features. I got the feeling you tried to show too many features too quickly.<p>In general, I have realized it is much better to launch with something that does a few things REALLY well rather than a lot of things with little focus. When you launch with whole lot of features people assume you are competing with the big companies. When you launch small and do it well, it is easier to attract a user-base and THEN keep feeding it more advance features in form of updates.<p>Good luck! Looks slick from the UI.\n","title":null,"type":"comment","url":null}],"created_at":"2007-04-04T19:16:40.000Z","created_at_i":1175714200,"id":8863,"options":[],"parent_id":null,"points":104,"story_id":8863,"text":null,"title":"My YC app: Dropbox - Throw away your USB drive","type":"story","url":"http://www.getdropbox.com/u/2/screencast.html"}},"meta":{"cost":"$0.0005","balance":"$3.0780","request_id":"req_a8495d1e73735aadfba9886c43e79883"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"404":{"description":"No stored payload for this input (fetch one with `source=live`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_found","message":"nosuchuser","request_id":"req_5c10900e919bc7a3ff79b7501d582b4c"}}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/crawl/hackernews/search":{"get":{"tags":["Crawl"],"operationId":"crawlHnSearch","summary":"Hacker News search","x-dashboard-cost":"$0.0005","description":"Full-text Hacker News search over stories, via the Algolia search API. A search with no hits is not billed.","security":[{"bearerAuth":[]}],"parameters":[{"name":"q","in":"query","required":true,"description":"The search text.","example":"python","schema":{"type":"string"}}],"responses":{"200":{"description":"Fetched document with optional extracted fields.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":true},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"final_url":"https://hn.algolia.com/api/v1/search?query=python&tags=story","status":200,"content_type":"application/json","payload_kind":"json","response_headers":{"content-type":"application/json"},"body":{"exhaustive":{"nbHits":false,"typo":false},"exhaustiveNbHits":false,"exhaustiveTypo":false,"hits":[{"_highlightResult":{"author":{"matchLevel":"none","matchedWords":[],"value":"todsacerdoti"},"title":{"fullyHighlighted":false,"matchLevel":"full","matchedWords":["python"],"value":"Uv is the best thing to happen to the <em>Python</em> ecosystem in a decade"},"url":{"matchLevel":"none","matchedWords":[],"value":"https://emily.space/posts/251023-uv"}},"_tags":["story","author_todsacerdoti"],"author":"todsacerdoti","children":[45751484,45751497],"created_at":"2025-10-29T18:57:29Z","created_at_i":1761764249,"num_comments":1324,"objectID":"45751400","points":2214,"story_id":45751400,"title":"Uv is the best thing to happen to the Python ecosystem in a decade","updated_at":"2026-06-07T06:19:56Z","url":"https://emily.space/posts/251023-uv"},{"_highlightResult":{"author":{"matchLevel":"none","matchedWords":[],"value":"azizsaya"},"title":{"fullyHighlighted":false,"matchLevel":"full","matchedWords":["python"],"value":"Sunsetting <em>Python</em> 2"},"url":{"fullyHighlighted":false,"matchLevel":"full","matchedWords":["python"],"value":"https://www.<em>python</em>.org/doc/sunset-<em>python</em>-2/"}},"_tags":["story","author_azizsaya"],"author":"azizsaya","children":[20915983,20916014],"created_at":"2019-09-09T06:43:24Z","created_at_i":1568011404,"num_comments":704,"objectID":"20915746","points":1616,"story_id":20915746,"title":"Sunsetting Python 2","updated_at":"2026-06-27T13:51:58Z","url":"https://www.python.org/doc/sunset-python-2/"}],"hitsPerPage":20,"nbHits":540030,"nbPages":50,"page":0,"params":"query=python&tags=story&advancedSyntax=true&analyticsTags=backend","processingTimeMS":9,"processingTimingsMS":{"_request":{"roundTrip":21},"fetch":{"query":2,"scanning":5,"total":8},"total":9},"query":"python","serverTimeMS":10}},"meta":{"cost":"$0.0005","balance":"$3.0775","request_id":"req_67a32bac1fcd620967b92dfd88b867e3"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"404":{"description":"No stored payload for this input (fetch one with `source=live`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_found","message":"nosuchuser","request_id":"req_5c10900e919bc7a3ff79b7501d582b4c"}}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/crawl/bluesky/profile":{"get":{"tags":["Crawl"],"operationId":"crawlBskyProfile","summary":"Bluesky profile","x-dashboard-cost":"$0.0005","description":"A Bluesky account — handle, display name, description, and follower/post counts.","security":[{"bearerAuth":[]}],"parameters":[{"name":"actor","in":"query","required":true,"description":"A Bluesky handle or DID.","example":"bsky.app","schema":{"type":"string"}}],"responses":{"200":{"description":"Fetched document with optional extracted fields.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":true},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"final_url":"https://public.api.bsky.app/xrpc/app.bsky.actor.getProfile?actor=bsky.app","status":200,"content_type":"application/json; charset=utf-8","payload_kind":"json","response_headers":{"content-type":"application/json; charset=utf-8","cache-control":"public, max-age=30"},"body":{"did":"did:plc:z72i7hdynmk6r22z27h6tvur","handle":"bsky.app","displayName":"Bluesky","avatar":"https://cdn.bsky.app/img/avatar/plain/did:plc:z72i7hdynmk6r22z27h6tvur/bafkreihwihm6kpd6zuwhhlro75p5qks5qtrcu55jp3gddbfjsieiv7wuka","associated":{"lists":16,"feedgens":7,"starterPacks":13,"labeler":false,"chat":{"allowIncoming":"none"},"activitySubscription":{"allowSubscriptions":"followers"}},"labels":[],"createdAt":"2023-04-12T04:53:57.057Z","verification":{"verifications":[],"verifiedStatus":"none","trustedVerifierStatus":"valid"},"description":"official Bluesky account (check username👆)\n\nBugs, feature requests, feedback: support@bsky.app","indexedAt":"2025-10-27T21:05:26.152Z","banner":"https://cdn.bsky.app/img/banner/plain/did:plc:z72i7hdynmk6r22z27h6tvur/bafkreichzyovokfzmymz36p5jibbjrhsur6n7hjnzxrpbt5jaydp2szvna","followersCount":34206401,"followsCount":11,"postsCount":802,"pinnedPost":{"cid":"bafyreicnt42y6vo6pfpvyro234ac4o6ijug6adwwrh7awflgrqlt4zibxq","uri":"at://did:plc:z72i7hdynmk6r22z27h6tvur/app.bsky.feed.post/3l6oveex3ii2l"}},"extracted":{"values":{"handle":"bsky.app","display_name":"Bluesky","followers":34206401,"posts":802},"errors":[]}},"meta":{"cost":"$0.0005","balance":"$3.0770","request_id":"req_fa0a3b35ac35f5f9754332e99cae49d9"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"404":{"description":"No stored payload for this input (fetch one with `source=live`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_found","message":"nosuchuser","request_id":"req_5c10900e919bc7a3ff79b7501d582b4c"}}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/crawl/bluesky/post":{"get":{"tags":["Crawl"],"operationId":"crawlBskyPost","summary":"Bluesky post thread","x-dashboard-cost":"$0.0005","description":"One Bluesky post and its reply thread, by AT-URI.","security":[{"bearerAuth":[]}],"parameters":[{"name":"uri","in":"query","required":true,"description":"The post AT-URI (at://…), URL-encoded.","example":"at://did:plc:z72i7hdynmk6r22z27h6tvur/app.bsky.feed.post/3l6oveex3ii2l","schema":{"type":"string"}}],"responses":{"200":{"description":"Fetched document with optional extracted fields.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":true},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"final_url":"https://public.api.bsky.app/xrpc/app.bsky.feed.getPostThread?uri=at%3A%2F%2Fdid%3Aplc%3Az72i7hdynmk6r22z27h6tvur%2Fapp.bsky.feed.post%2F3l6oveex3ii2l","status":200,"content_type":"application/json; charset=utf-8","payload_kind":"json","response_headers":{"content-type":"application/json; charset=utf-8","cache-control":"public, max-age=30"},"body":{"thread":{"post":{"uri":"at://did:plc:z72i7hdynmk6r22z27h6tvur/app.bsky.feed.post/3l6oveex3ii2l","cid":"bafyreicnt42y6vo6pfpvyro234ac4o6ijug6adwwrh7awflgrqlt4zibxq","author":{"did":"did:plc:z72i7hdynmk6r22z27h6tvur","handle":"bsky.app","displayName":"Bluesky","avatar":"https://cdn.bsky.app/img/avatar/plain/did:plc:z72i7hdynmk6r22z27h6tvur/bafkreihwihm6kpd6zuwhhlro75p5qks5qtrcu55jp3gddbfjsieiv7wuka","associated":{"chat":{"allowIncoming":"none"},"activitySubscription":{"allowSubscriptions":"followers"}},"labels":[],"createdAt":"2023-04-12T04:53:57.057Z","verification":{"verifications":[],"verifiedStatus":"none","trustedVerifierStatus":"valid"}},"record":{"$type":"app.bsky.feed.post","createdAt":"2024-10-17T07:06:51.491Z","langs":["en"],"text":"👋  Bluesky is an open social network that gives creators independence from platforms, developers the freedom to build, and users a choice in their experience. We're so excited to have you here! \n\nWe share Bluesky updates & news from this account. A quick orientation thread: 🧵✨"},"bookmarkCount":223,"replyCount":8515,"repostCount":9532,"likeCount":63547,"quoteCount":705,"indexedAt":"2024-10-17T07:06:51.491Z","labels":[]},"replies":[{"post":{"uri":"at://did:plc:z72i7hdynmk6r22z27h6tvur/app.bsky.feed.post/3l6ovfftinx2m","cid":"bafyreid5gnc6nuo4jcnjkp52xu66otq3qioorrrowzlqrnc6l7pupii2eq","author":{"did":"did:plc:z72i7hdynmk6r22z27h6tvur","handle":"bsky.app","displayName":"Bluesky","avatar":"https://cdn.bsky.app/img/avatar/plain/did:plc:z72i7hdynmk6r22z27h6tvur/bafkreihwihm6kpd6zuwhhlro75p5qks5qtrcu55jp3gddbfjsieiv7wuka","associated":{"chat":{"allowIncoming":"none"},"activitySubscription":{"allowSubscriptions":"followers"}},"labels":[],"createdAt":"2023-04-12T04:53:57.057Z","verification":{"verifications":[],"verifiedStatus":"none","trustedVerifierStatus":"valid"}},"record":{"$type":"app.bsky.feed.post","createdAt":"2024-10-17T07:07:26.071Z","facets":[{"features":[{"$type":"app.bsky.richtext.facet#link","uri":"https://bsky.app/feeds"}],"index":{"byteEnd":134,"byteStart":120}}],"langs":["en"],"reply":{"parent":{"cid":"bafyreicnt42y6vo6pfpvyro234ac4o6ijug6adwwrh7awflgrqlt4zibxq","uri":"at://did:plc:z72i7hdynmk6r22z27h6tvur/app.bsky.feed.post/3l6oveex3ii2l"},"root":{"cid":"bafyreicnt42y6vo6pfpvyro234ac4o6ijug6adwwrh7awflgrqlt4zibxq","uri":"at://did:plc:z72i7hdynmk6r22z27h6tvur/app.bsky.feed.post/3l6oveex3ii2l"}},"text":"• Anyone can create and subscribe to feeds. There are 50k+ feeds here, like posts from mutuals, news, or cat photos!\n\nbsky.app/feeds\n\n• The Discover feed shows you posts that we think you'll like. Help us fine-tune it for you by using the \"Show more\" & \"Show less\" buttons in the three-dot menu."},"bookmarkCount":7,"replyCount":58,"repostCount":283,"likeCount":3256,"quoteCount":41,"indexedAt":"2024-10-17T07:07:26.071Z","labels":[]},"replies":[{"post":{"uri":"at://did:plc:zl2sg7ccu7ywvyeiv2amsuwr/app.bsky.feed.post/3laxvhomoau2n","cid":"bafyreib46pj2upiak4oztvyrlvfoxcp72ra2fl4jjvr3lnei6jxou3zg3i","author":{"did":"did:plc:zl2sg7ccu7ywvyeiv2amsuwr","handle":"hannahsmart.bsky.social","displayName":"Hannah Smart","avatar":"https://cdn.bsky.app/img/avatar/plain/did:plc:zl2sg7ccu7ywvyeiv2amsuwr/bafkreiduc55jd5zu7sr4ygvdflwn4q6i4wtb5fjnz322ujoatol4vjn6he","associated":{"activitySubscription":{"allowSubscriptions":"followers"}},"labels":[],"createdAt":"2024-11-15T06:34:38.543Z"},"record":{"$type":"app.bsky.feed.post","createdAt":"2024-11-15T07:53:03.352Z","langs":["en"],"reply":{"parent":{"cid":"bafyreid5gnc6nuo4jcnjkp52xu66otq3qioorrrowzlqrnc6l7pupii2eq","uri":"at://did:plc:z72i7hdynmk6r22z27h6tvur/app.bsky.feed.post/3l6ovfftinx2m"},"root":{"cid":"bafyreicnt42y6vo6pfpvyro234ac4o6ijug6adwwrh7awflgrqlt4zibxq","uri":"at://did:plc:z72i7hdynmk6r22z27h6tvur/app.bsky.feed.post/3l6oveex3ii2l"}},"text":"How do we make a custom feed? 🦋☁️"},"bookmarkCount":0,"replyCount":0,"repostCount":0,"likeCount":1,"quoteCount":0,"indexedAt":"2024-11-15T07:53:03.751Z","labels":[]},"replies":[],"threadContext":{},"$type":"app.bsky.feed.defs#threadViewPost"},{"post":{"uri":"at://did:plc:zasgwmt6anlxlihv2iu3huje/app.bsky.feed.post/3lf64dyrhhk2f","cid":"bafyreiacnglzyvoc7kux6tb4bvo2od4qymnqowzoth3y4otr5poqcgdcuu","author":{"did":"did:plc:zasgwmt6anlxlihv2iu3huje","handle":"bridgetbiden4ever.bsky.social","displayName":"BridgetBiden4ever","avatar":"https://cdn.bsky.app/img/avatar/plain/did:plc:zasgwmt6anlxlihv2iu3huje/bafkreifj2uax3peunxv2xxmecw653j77g7m6ebb2g7aor4nye3q4pwrvp4","associated":{"chat":{"allowIncoming":"all"},"activitySubscription":{"allowSubscriptions":"followers"}},"labels":[],"createdAt":"2024-11-13T16:29:43.176Z"},"record":{"$type":"app.bsky.feed.post","createdAt":"2025-01-07T16:53:00.911Z","langs":["en"],"reply":{"parent":{"cid":"bafyreid5gnc6nuo4jcnjkp52xu66otq3qioorrrowzlqrnc6l7pupii2eq","uri":"at://did:plc:z72i7hdynmk6r22z27h6tvur/app.bsky.feed.post/3l6ovfftinx2m"},"root":{"cid":"bafyreicnt42y6vo6pfpvyro234ac4o6ijug6adwwrh7awflgrqlt4zibxq","uri":"at://did:plc:z72i7hdynmk6r22z27h6tvur/app.bsky.feed.post/3l6oveex3ii2l"}},"text":"Yes, anyone, even a million hours named Sara. Fuck this shit."},"bookmarkCount":0,"replyCount":1,"repostCount":1,"likeCount":2,"quoteCount":0,"indexedAt":"2025-01-07T16:52:59.350Z","labels":[]},"replies":[{"post":{"uri":"at://did:plc:zasgwmt6anlxlihv2iu3huje/app.bsky.feed.post/3lwp4clsbcs2o","cid":"bafyreic5flkxkwoih3lafltjlnq3zlfmpcpmtf3fvwts23ium3t7kghjgq","author":{"did":"did:plc:zasgwmt6anlxlihv2iu3huje","handle":"bridgetbiden4ever.bsky.social","displayName":"BridgetBiden4ever","avatar":"https://cdn.bsky.app/img/avatar/plain/did:plc:zasgwmt6anlxlihv2iu3huje/bafkreifj2uax3peunxv2xxmecw653j77g7m6ebb2g7aor4nye3q4pwrvp4","associated":{"chat":{"allowIncoming":"all"},"activitySubscription":{"allowSubscriptions":"followers"}},"labels":[],"createdAt":"2024-11-13T16:29:43.176Z"},"record":{"$type":"app.bsky.feed.post","createdAt":"2025-08-18T19:15:46.975Z","langs":["en"],"reply":{"parent":{"cid":"bafyreiacnglzyvoc7kux6tb4bvo2od4qymnqowzoth3y4otr5poqcgdcuu","uri":"at://did:plc:zasgwmt6anlxlihv2iu3huje/app.bsky.feed.post/3lf64dyrhhk2f"},"root":{"cid":"bafyreicnt42y6vo6pfpvyro234ac4o6ijug6adwwrh7awflgrqlt4zibxq","uri":"at://did:plc:z72i7hdynmk6r22z27h6tvur/app.bsky.feed.post/3l6oveex3ii2l"}},"text":"Hoes."},"bookmarkCount":0,"replyCount":0,"repostCount":0,"likeCount":1,"quoteCount":0,"indexedAt":"2025-08-18T19:15:46.206Z","labels":[]},"replies":[],"threadContext":{},"$type":"app.bsky.feed.defs#threadViewPost"}],"threadContext":{},"$type":"app.bsky.feed.defs#threadViewPost"}],"threadContext":{},"$type":"app.bsky.feed.defs#threadViewPost"},{"post":{"uri":"at://did:plc:zzupknu3xnecblol3pb6qnk5/app.bsky.feed.post/3lawati66dc2z","cid":"bafyreifp566kshr7wf3g7isdme47y355quyv7xmooyex4whrmvrkuhfbdm","author":{"did":"did:plc:zzupknu3xnecblol3pb6qnk5","handle":"relentles99.bsky.social","displayName":"Elle Esse 🖇️","avatar":"https://cdn.bsky.app/img/avatar/plain/did:plc:zzupknu3xnecblol3pb6qnk5/bafkreicnjp62hg3mj7pmqcqcs2ikdvj6ru5gq3bbthnrawe2qcbbmojn44","associated":{"activitySubscription":{"allowSubscriptions":"followers"}},"labels":[],"createdAt":"2024-11-10T22:58:28.889Z"},"record":{"$type":"app.bsky.feed.post","createdAt":"2024-11-14T16:11:10.922Z","langs":["en"],"reply":{"parent":{"cid":"bafyreicnt42y6vo6pfpvyro234ac4o6ijug6adwwrh7awflgrqlt4zibxq","uri":"at://did:plc:z72i7hdynmk6r22z27h6tvur/app.bsky.feed.post/3l6oveex3ii2l"},"root":{"cid":"bafyreicnt42y6vo6pfpvyro234ac4o6ijug6adwwrh7awflgrqlt4zibxq","uri":"at://did:plc:z72i7hdynmk6r22z27h6tvur/app.bsky.feed.post/3l6oveex3ii2l"}},"text":"📌"},"bookmarkCount":0,"replyCount":1,"repostCount":0,"likeCount":6,"quoteCount":0,"indexedAt":"2024-11-14T16:11:10.637Z","labels":[]},"replies":[],"threadContext":{},"$type":"app.bsky.feed.defs#threadViewPost"}],"threadContext":{},"$type":"app.bsky.feed.defs#threadViewPost"}}},"meta":{"cost":"$0.0005","balance":"$3.0765","request_id":"req_3ca8de947b8f641d26dc5439c0104501"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"404":{"description":"No stored payload for this input (fetch one with `source=live`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_found","message":"nosuchuser","request_id":"req_5c10900e919bc7a3ff79b7501d582b4c"}}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/crawl/bluesky/user/posts":{"get":{"tags":["Crawl"],"operationId":"crawlBskyUserPosts","summary":"Bluesky author feed","x-dashboard-cost":"$0.0005","description":"A Bluesky account's recent posts (author feed).","security":[{"bearerAuth":[]}],"parameters":[{"name":"actor","in":"query","required":true,"description":"A Bluesky handle or DID.","example":"bsky.app","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"How many posts (1-100).","schema":{"type":"integer","minimum":1,"maximum":100}}],"responses":{"200":{"description":"Fetched document with optional extracted fields.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":true},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"final_url":"https://public.api.bsky.app/xrpc/app.bsky.feed.getAuthorFeed?actor=bsky.app&limit=5","status":200,"content_type":"application/json; charset=utf-8","payload_kind":"json","response_headers":{"content-type":"application/json; charset=utf-8","cache-control":"public, max-age=30"},"body":{"feed":[{"post":{"uri":"at://did:plc:6kos45lixtga3pdwuncvh32x/app.bsky.feed.post/3mqc36slinc2m","cid":"bafyreifp32ys6w6ayfu3f2ayw4hdpsyaa7kyjz6gk3kfeblfwr2kbnao7e","author":{"did":"did:plc:6kos45lixtga3pdwuncvh32x","handle":"paretooptimizer.bsky.social","displayName":"Pareto Optimizer","avatar":"https://cdn.bsky.app/img/avatar/plain/did:plc:6kos45lixtga3pdwuncvh32x/bafkreifvhi2e3intywaulvunc5wnva4fdrwhu7qjhwlnak77jbuzqiz7zq","associated":{"chat":{"allowIncoming":"none","allowGroupInvites":"none"},"activitySubscription":{"allowSubscriptions":"followers"}},"labels":[],"createdAt":"2023-06-29T16:47:43.607Z"},"record":{"$type":"app.bsky.feed.post","createdAt":"2026-07-10T11:46:11.858Z","embed":{"$type":"app.bsky.embed.record","record":{"cid":"bafyreigvw7va73oqr3vkv74dch3uw7xubmyxddxf7f2houk5wrs6csrs64","uri":"at://did:plc:yfzqc42lkdurwcpslq7yp3ud/app.bsky.feed.post/3mqbs2zzdi22y"}},"langs":["en"],"text":"I know this guy has a Bluesky account."},"embed":{"record":{"uri":"at://did:plc:yfzqc42lkdurwcpslq7yp3ud/app.bsky.feed.post/3mqbs2zzdi22y","cid":"bafyreigvw7va73oqr3vkv74dch3uw7xubmyxddxf7f2houk5wrs6csrs64","author":{"did":"did:plc:yfzqc42lkdurwcpslq7yp3ud","handle":"dexerto.bsky.social","displayName":"Dexerto","avatar":"https://cdn.bsky.app/img/avatar/plain/did:plc:yfzqc42lkdurwcpslq7yp3ud/bafkreialdpbyzldcsbk2knioy5uoz35oomx7pgacfzgh34kizoxmoj2ypm","associated":{"chat":{"allowIncoming":"none","allowGroupInvites":"none"},"activitySubscription":{"allowSubscriptions":"followers"}},"labels":[],"createdAt":"2023-04-27T17:42:28.330Z"},"value":{"$type":"app.bsky.feed.post","createdAt":"2026-07-10T09:03:00Z","embed":{"$type":"app.bsky.embed.images","images":[{"alt":"","aspectRatio":{"height":1600,"width":1400},"image":{"$type":"blob","ref":{"$link":"bafkreig4jkqjmn7mkivmhrk3rusqwbik4xgvkwxsux6wr7tbspz36nw4dy"},"mimeType":"image/jpeg","size":148913}},{"alt":"","aspectRatio":{"height":1600,"width":1400},"image":{"$type":"blob","ref":{"$link":"bafkreic6tc7c2kmawwk7yr5gtan2csfr3izt3qr5ffuqyjci33kfedk35i"},"mimeType":"image/jpeg","size":173646}}]},"text":"A Norway fan has gone viral for not taking part in their Row celebration after matches and won't do it if they win the World Cup\n\n\"It’s factually wrong; they didn’t row, they sailed over the Atlantic”"},"labels":[],"likeCount":5053,"replyCount":254,"repostCount":611,"quoteCount":916,"indexedAt":"2026-07-10T09:03:05.566Z","embeds":[{"images":[{"thumb":"https://cdn.bsky.app/img/feed_thumbnail/plain/did:plc:yfzqc42lkdurwcpslq7yp3ud/bafkreig4jkqjmn7mkivmhrk3rusqwbik4xgvkwxsux6wr7tbspz36nw4dy","fullsize":"https://cdn.bsky.app/img/feed_fullsize/plain/did:plc:yfzqc42lkdurwcpslq7yp3ud/bafkreig4jkqjmn7mkivmhrk3rusqwbik4xgvkwxsux6wr7tbspz36nw4dy","alt":"","aspectRatio":{"height":1600,"width":1400}},{"thumb":"https://cdn.bsky.app/img/feed_thumbnail/plain/did:plc:yfzqc42lkdurwcpslq7yp3ud/bafkreic6tc7c2kmawwk7yr5gtan2csfr3izt3qr5ffuqyjci33kfedk35i","fullsize":"https://cdn.bsky.app/img/feed_fullsize/plain/did:plc:yfzqc42lkdurwcpslq7yp3ud/bafkreic6tc7c2kmawwk7yr5gtan2csfr3izt3qr5ffuqyjci33kfedk35i","alt":"","aspectRatio":{"height":1600,"width":1400}}],"$type":"app.bsky.embed.images#view"}],"$type":"app.bsky.embed.record#viewRecord"},"$type":"app.bsky.embed.record#view"},"bookmarkCount":115,"replyCount":149,"repostCount":541,"likeCount":6531,"quoteCount":13,"indexedAt":"2026-07-10T11:46:12.181Z","labels":[]},"reason":{"by":{"did":"did:plc:z72i7hdynmk6r22z27h6tvur","handle":"bsky.app","displayName":"Bluesky","avatar":"https://cdn.bsky.app/img/avatar/plain/did:plc:z72i7hdynmk6r22z27h6tvur/bafkreihwihm6kpd6zuwhhlro75p5qks5qtrcu55jp3gddbfjsieiv7wuka","associated":{"chat":{"allowIncoming":"none"},"activitySubscription":{"allowSubscriptions":"followers"}},"labels":[],"createdAt":"2023-04-12T04:53:57.057Z","verification":{"verifications":[],"verifiedStatus":"none","trustedVerifierStatus":"valid"}},"uri":"at://did:plc:z72i7hdynmk6r22z27h6tvur/app.bsky.feed.repost/3mqcr3w3xru2d","cid":"bafyreieyetktyme4g7moqlzqv4t7kfff7xs7ykl6qbi7dmxb5ijdjffjxe","indexedAt":"2026-07-10T18:18:17.273Z","$type":"app.bsky.feed.defs#reasonRepost"}},{"post":{"uri":"at://did:plc:z72i7hdynmk6r22z27h6tvur/app.bsky.feed.post/3mqcp5qjdfs26","cid":"bafyreig6kgwgaixxenkfv62gkz43fgdyoe2ddbgqbfr2edkqv5ya5kginu","author":{"did":"did:plc:z72i7hdynmk6r22z27h6tvur","handle":"bsky.app","displayName":"Bluesky","avatar":"https://cdn.bsky.app/img/avatar/plain/did:plc:z72i7hdynmk6r22z27h6tvur/bafkreihwihm6kpd6zuwhhlro75p5qks5qtrcu55jp3gddbfjsieiv7wuka","associated":{"chat":{"allowIncoming":"none"},"activitySubscription":{"allowSubscriptions":"followers"}},"labels":[],"createdAt":"2023-04-12T04:53:57.057Z","verification":{"verifications":[],"verifiedStatus":"none","trustedVerifierStatus":"valid"}},"record":{"$type":"app.bsky.feed.post","createdAt":"2026-07-10T17:43:30.972Z","embed":{"$type":"app.bsky.embed.record","record":{"cid":"bafyreigov2ns6elnyiksqufzr6ctfg4i4eiodharfupyoc5sq23tvyew4a","uri":"at://did:plc:cwf4mmm7mpzistinx3ox2zhj/app.bsky.feed.post/3mqcp425edfgx"}},"facets":[{"$type":"app.bsky.richtext.facet","features":[{"$type":"app.bsky.richtext.facet#mention","did":"did:plc:cwf4mmm7mpzistinx3ox2zhj"}],"index":{"byteEnd":31,"byteStart":16}}],"langs":["en"],"text":"Personnel news: @toni.bsky.team is dropping the “interim” from his title and will serve as our permanent CEO!"},"embed":{"record":{"uri":"at://did:plc:cwf4mmm7mpzistinx3ox2zhj/app.bsky.feed.post/3mqcp425edfgx","cid":"bafyreigov2ns6elnyiksqufzr6ctfg4i4eiodharfupyoc5sq23tvyew4a","author":{"did":"did:plc:cwf4mmm7mpzistinx3ox2zhj","handle":"toni.bsky.team","displayName":"Toni Schneider","avatar":"https://cdn.bsky.app/img/avatar/plain/did:plc:cwf4mmm7mpzistinx3ox2zhj/bafkreicixoq23lsimr6cabhtss53jimjzouzkstif4xdjmvt4rcr5bjsku","associated":{"chat":{"allowIncoming":"none"},"activitySubscription":{"allowSubscriptions":"followers"}},"labels":[],"createdAt":"2023-11-28T19:15:32.965Z","verification":{"verifications":[{"issuer":"did:plc:z72i7hdynmk6r22z27h6tvur","issuerDisplayName":"Bluesky","issuerHandle":"bsky.app","uri":"at://did:plc:z72i7hdynmk6r22z27h6tvur/app.bsky.graph.verification/3mgngmgwfk62n","isValid":true,"createdAt":"2026-03-09T17:58:00.876Z"}],"verifiedStatus":"valid","trustedVerifierStatus":"none"}},"value":{"$type":"app.bsky.feed.post","createdAt":"2026-07-10T17:42:33.000Z","embed":{"$type":"app.bsky.embed.external","external":{"associatedRefs":[{"$type":"com.atproto.repo.strongRef","cid":"bafyreihczgmq2lnsyjkj7rtpwd3stjbfqa2yxpncbktehkxzyodxklgwra","uri":"at://did:plc:cwf4mmm7mpzistinx3ox2zhj/site.standard.publication/3mhgursihlhgq"},{"$type":"com.atproto.repo.strongRef","cid":"bafyreic2nnco7omjpz3yf343rmwbcbepybtxhv3how5jmz25y2lk7ksksu","uri":"at://did:plc:cwf4mmm7mpzistinx3ox2zhj/site.standard.document/3mqcp424z5wgx"}],"description":"I'm four months into my interim CEO role at Bluesky, and it's time for an update. Most importantly, as of today, the interim part of the title is gone. I'm loving the mission and the job, and I'm all in as Bluesky’s official CEO. This job has been energizing from day one, and the Bluesky...","title":"Staying in the game","uri":"https://toni.org/2026/07/10/staying-in-the-game/"}},"facets":[{"features":[{"$type":"app.bsky.richtext.facet#link","uri":"https://toni.org/2026/07/10/staying-in-the-game/"}],"index":{"byteEnd":229,"byteStart":181}}],"langs":["en"],"tags":["Bluesky"],"text":"Staying in the game\n\nI'm four months into my interim CEO role at Bluesky, and it's time for an update. Most importantly, as of today, the interim part of the title is gone. I'm...\n\nhttps://toni.org/2026/07/10/staying-in-the-game/"},"labels":[],"likeCount":711,"replyCount":102,"repostCount":92,"quoteCount":35,"indexedAt":"2026-07-10T17:42:34.171Z","embeds":[{"external":{"uri":"https://toni.org/2026/07/10/staying-in-the-game/","title":"Staying in the game","description":"I'm four months into my interim CEO role at Bluesky, and it's time for an update. Most importantly, as of today, the interim part of the title is gone. I'm loving the mission and the job, and I'm all in as Bluesky’s official CEO. This job has been energizing from day one, and the Bluesky...","createdAt":"2026-07-10T17:42:33.000Z","readingTime":3,"source":{"uri":"https://toni.org","icon":"https://cdn.bsky.app/img/avatar/plain/did:plc:cwf4mmm7mpzistinx3ox2zhj/bafkreidkmfyy5likpn4kvdb775rrviismf7lptkxhcbnkhimkzdgnazosq","title":"Toni.org","description":"Toni Schneider's blog","theme":{"backgroundRGB":{"r":249,"g":249,"b":249,"$type":"app.bsky.embed.external#colorRGB"},"foregroundRGB":{"r":99,"g":99,"b":99,"$type":"app.bsky.embed.external#colorRGB"},"accentRGB":{"r":17,"g":17,"b":17,"$type":"app.bsky.embed.external#colorRGB"},"accentForegroundRGB":{"r":255,"g":255,"b":255,"$type":"app.bsky.embed.external#colorRGB"}},"$type":"app.bsky.embed.external#viewExternalSource"},"associatedProfiles":[{"did":"did:plc:cwf4mmm7mpzistinx3ox2zhj","handle":"toni.bsky.team","displayName":"Toni Schneider","avatar":"https://cdn.bsky.app/img/avatar/plain/did:plc:cwf4mmm7mpzistinx3ox2zhj/bafkreicixoq23lsimr6cabhtss53jimjzouzkstif4xdjmvt4rcr5bjsku","associated":{"chat":{"allowIncoming":"none"},"activitySubscription":{"allowSubscriptions":"followers"}},"labels":[],"createdAt":"2023-11-28T19:15:32.965Z","verification":{"verifications":[{"issuer":"did:plc:z72i7hdynmk6r22z27h6tvur","issuerDisplayName":"Bluesky","issuerHandle":"bsky.app","uri":"at://did:plc:z72i7hdynmk6r22z27h6tvur/app.bsky.graph.verification/3mgngmgwfk62n","isValid":true,"createdAt":"2026-03-09T17:58:00.876Z"}],"verifiedStatus":"valid","trustedVerifierStatus":"none"}}],"associatedRefs":[{"$type":"com.atproto.repo.strongRef","cid":"bafyreihczgmq2lnsyjkj7rtpwd3stjbfqa2yxpncbktehkxzyodxklgwra","uri":"at://did:plc:cwf4mmm7mpzistinx3ox2zhj/site.standard.publication/3mhgursihlhgq"},{"$type":"com.atproto.repo.strongRef","cid":"bafyreic2nnco7omjpz3yf343rmwbcbepybtxhv3how5jmz25y2lk7ksksu","uri":"at://did:plc:cwf4mmm7mpzistinx3ox2zhj/site.standard.document/3mqcp424z5wgx"}]},"$type":"app.bsky.embed.external#view"}],"$type":"app.bsky.embed.record#viewRecord"},"$type":"app.bsky.embed.record#view"},"bookmarkCount":41,"replyCount":96,"repostCount":178,"likeCount":1661,"quoteCount":31,"indexedAt":"2026-07-10T17:43:31.572Z","labels":[]}}],"cursor":"2026-07-02T16:41:33.075Z"}},"meta":{"cost":"$0.0005","balance":"$3.0760","request_id":"req_795d02d70fac5d42b839ce1f307aba90"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"404":{"description":"No stored payload for this input (fetch one with `source=live`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_found","message":"nosuchuser","request_id":"req_5c10900e919bc7a3ff79b7501d582b4c"}}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/crawl/linktree/page":{"get":{"tags":["Crawl"],"operationId":"crawlLinktreePage","summary":"Linktree page","x-dashboard-cost":"$0.0005","description":"A Linktree creator page — the document, with the page's links available via HTML extraction.","security":[{"bearerAuth":[]}],"parameters":[{"name":"username","in":"query","required":true,"description":"The Linktree username.","example":"shawnmendes","schema":{"type":"string"}}],"responses":{"200":{"description":"Fetched document with optional extracted fields.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":true},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"final_url":"https://linktr.ee/shawnmendes","status":200,"content_type":"text/html; charset=utf-8","payload_kind":"text","response_headers":{"cache-control":"max-age=31536000, no-cache, stale-if-error=31536000","content-type":"text/html; charset=utf-8","etag":"W/\"10lwcascwds6blj\""},"body":"<!DOCTYPE html><html lang=\"en\"><head><meta name=\"description\" content=\"Linktree. Make your link do more.\" data-next-head=\"\"/><meta property=\"og:title\" content=\"Shawn Mendes Songs &amp; Music Videos Links | Linktree\" data-next-head=\"\"/><meta property=\"og:description\" content=\"Linktree. Make your link do more.\" data-next-head=\"\"/><meta property=\"og:url\" content=\"https://linktr.ee/shawnmendes\" data-next-head=\"\"/><meta property=\"og:image\" content=\"https://linktr.ee/og/image/shawnmendes.jpg\" data-next-head=\"\"/><meta property=\"og:image:secure_url\" content=\"https://linktr.ee/og/image/shawnmendes.jpg\" data-next-head=\"\"/><meta property=\"og:updated_time\" content=\"1783539560000\" data-next-head=\"\"/><meta property=\"og:type\" content=\"profile\" data-next-head=\"\"/><meta property=\"profile:username\" content=\"shawnmendes\" data-next-head=\"\"/><meta name=\"twitter:title\" content=\"Shawn Mendes Songs &amp; Music Videos Links | Linktree\" data-next-head=\"\"/><meta name=\"twitter:description\" content=\"Linktree. Make your link do more.\" data-next-head=\"\"/><meta name=\"twitter:image\" content=\"https://linktr.ee/og/image/shawnmendes.jpg\" data-next-head=\"\"/><meta property=\"snapchat:sticker\" content=\"https://linktr.ee/sticker/shawnmendes.png\" data-next-head=\"\"/><link rel=\"canonical\" href=\"https://linktr.ee/shawnmendes\" data-next-head=\"\"/><meta charSet=\"UTF-8\" data-next-head=\"\"/><meta content=\"ie=edge\" http-equiv=\"x-ua-compatible\" data-next-head=\"\"/><meta content=\"width=device-width, initial-scale=1, maximum-scale…"},"meta":{"cost":"$0.0005","balance":"$3.0755","request_id":"req_28304e4fe8e2cccc7cba5e028cce4295"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"404":{"description":"No stored payload for this input (fetch one with `source=live`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_found","message":"nosuchuser","request_id":"req_5c10900e919bc7a3ff79b7501d582b4c"}}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/crawl/x/tweet":{"get":{"tags":["Crawl"],"operationId":"crawlXTweet","summary":"X (Twitter) tweet","x-dashboard-cost":"$0.0005","description":"One tweet by numeric id — text, author, like count, and created date — via the public syndication CDN.","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"query","required":true,"description":"The numeric tweet id.","example":"20","schema":{"type":"string"}}],"responses":{"200":{"description":"Fetched document with optional extracted fields.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":true},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"final_url":"https://cdn.syndication.twimg.com/tweet-result?id=20&token=a","status":200,"content_type":"application/json; charset=utf-8","payload_kind":"json","response_headers":{"etag":"W/\"398-ZPvV33LRPRUKP5O5F0oixrLN/qE\"","content-type":"application/json; charset=utf-8","cache-control":"must-revalidate, max-age=60"},"body":{"__typename":"Tweet","favorite_count":307521,"lang":"en","created_at":"2006-03-21T20:50:14.000Z","display_text_range":[0,24],"entities":{},"id_str":"20","text":"just setting up my twttr","user":{"id_str":"12","name":"jack","screen_name":"jack","is_blue_verified":true,"profile_image_shape":"Circle","verified":false,"profile_image_url_https":"https://pbs.twimg.com/profile_images/1661201415899951105/azNjKOSH_normal.jpg","highlighted_label":{"badge":{"url":"https://pbs.twimg.com/profile_images/1285655593592791040/HtwPZgej_bigger.jpg"},"description":"Square","url":{"url":"https://twitter.com/Square","url_type":"DeepLink"},"user_label_display_type":"Badge","user_label_type":"BusinessLabel"}},"edit_control":{"edit_tweet_ids":["20"],"editable_until_msecs":"1142976014000","edits_remaining":"5","is_edit_eligible":true},"conversation_count":17962,"news_action_type":"conversation","isEdited":false,"isStaleEdit":false},"extracted":{"values":{"text":"just setting up my twttr","likes":307521,"author":"jack","name":"jack","created":"2006-03-21T20:50:14.000Z"},"errors":[]}},"meta":{"cost":"$0.0005","balance":"$3.0725","request_id":"req_e504efc1059c0ccd0bcea15edccca9fa"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"404":{"description":"No stored payload for this input (fetch one with `source=live`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_found","message":"nosuchuser","request_id":"req_5c10900e919bc7a3ff79b7501d582b4c"}}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/crawl/threads/profile":{"get":{"tags":["Crawl"],"operationId":"crawlThreadsProfile","summary":"Threads profile","x-dashboard-cost":"$0.0005","description":"A Threads profile page — the document, with bio and follower data embedded in the HTML. A page with no profile data is not billed.","security":[{"bearerAuth":[]}],"parameters":[{"name":"user","in":"query","required":true,"description":"The Threads handle, without the @.","example":"zuck","schema":{"type":"string"}}],"responses":{"200":{"description":"Fetched document with optional extracted fields.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":true},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"final_url":"https://www.threads.com/@zuck","status":200,"content_type":"text/html; charset=\"utf-8\"","payload_kind":"text","response_headers":{"cache-control":"private, no-cache, no-store, must-revalidate","expires":"Sat, 01 Jan 2000 00:00:00 GMT","content-type":"text/html; charset=\"utf-8\""},"body":"<!DOCTYPE html><html class=\"_9dls _aoqh\" lang=\"en\" dir=\"ltr\"><head><link data-default-icon=\"https://static.cdninstagram.com/rsrc.php/y4/r/pctUncuduBn.svg\" rel=\"icon\" type=\"image/svg+xml\" href=\"https://static.cdninstagram.com/rsrc.php/y4/r/pctUncuduBn.svg\" /><meta name=\"bingbot\" content=\"noarchive\" /><meta id=\"viewport\" name=\"viewport\" content=\"width=device-width, viewport-fit=cover, initial-scale=1, maximum-scale=2, shrink-to-fit=no\" /><link rel=\"apple-touch-icon\" sizes=\"57x57\" href=\"https://static.cdninstagram.com/rsrc.php/yc/r/-Y7SdpqJSl0.webp\" /><link rel=\"apple-touch-icon\" sizes=\"72x72\" href=\"https://static.cdninstagram.com/rsrc.php/yU/r/EvAz2IpMIRe.webp\" /><link rel=\"apple-touch-icon\" sizes=\"120x120\" href=\"https://static.cdninstagram.com/rsrc.php/y1/r/nPOGBtES96E.webp\" /><link rel=\"apple-touch-icon\" sizes=\"144x144\" href=\"https://static.cdninstagram.com/rsrc.php/yn/r/7SwW_oOu6u4.webp\" /><link rel=\"apple-touch-icon\" sizes=\"152x152\" href=\"https://static.cdninstagram.com/rsrc.php/yj/r/Z-TsZPmCWZr.webp\" /><link rel=\"apple-touch-icon\" sizes=\"180x180\" href=\"https://static.cdninstagram.com/rsrc.php/yG/r/Q7LVlwLasp7.webp\" /><link rel=\"apple-touch-icon\" sizes=\"256x256\" href=\"https://static.cdninstagram.com/rsrc.php/yn/r/fFvbm7ecCaM.webp\" /><meta property=\"al:android:app_name\" content=\"Threads\" /><meta property=\"al:android:package\" content=\"com.instagram.barcelona\" /><meta property=\"al:android:url\" content=\"https://www.threads.com/&#064;zuck\" /><meta property=\"al:ios:app_name\" cont…"},"meta":{"cost":"$0.0005","balance":"$3.0720","request_id":"req_2abb5ab4357f1d7f6dbf8668c6af2362"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"404":{"description":"No stored payload for this input (fetch one with `source=live`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_found","message":"nosuchuser","request_id":"req_5c10900e919bc7a3ff79b7501d582b4c"}}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/crawl/google/play-app":{"get":{"tags":["Crawl"],"operationId":"crawlGooglePlayApp","summary":"Google Play app","x-dashboard-cost":"$0.0005","description":"A Google Play store listing by package name — the document, with JSON-LD app metadata embedded.","security":[{"bearerAuth":[]}],"parameters":[{"name":"id","in":"query","required":true,"description":"The Android package name.","example":"com.spotify.music","schema":{"type":"string"}}],"responses":{"200":{"description":"Fetched document with optional extracted fields.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":true},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"final_url":"https://play.google.com/store/apps/details?id=com.spotify.music&hl=en&gl=US","status":200,"content_type":"text/html; charset=utf-8","payload_kind":"text","response_headers":{"content-type":"text/html; charset=utf-8","cache-control":"no-cache, no-store, max-age=0, must-revalidate","expires":"Mon, 01 Jan 1990 00:00:00 GMT"},"body":"<!doctype html><html lang=\"en\" dir=\"ltr\"><head><base href=\"https://play.google.com/\"><link rel=\"preconnect\" href=\"//www.gstatic.com\"><meta name=\"referrer\" content=\"origin\"><meta name=\"viewport\" content=\"width=device-width, initial-scale=1\"><meta name=\"mobile-web-app-capable\" content=\"yes\"><meta name=\"apple-mobile-web-app-capable\" content=\"yes\"><meta name=\"google-site-verification\" content=\"sBw2N8uateIzRr93vmFze5MF_35vMk5F1wG04L5JcJE\"><meta name=\"google-site-verification\" content=\"PJKdyVFC5jlu_l8Wo_hirJkhs1cmitmn44fgpOc3zFc\"><link rel=\"search\" href=\"/opensearch.xml\" type=\"application/opensearchdescription+xml\" title=\"Google Play\"><link rel=\"shortcut icon\" href=\"//www.gstatic.com/android/market_images/web/favicon_v3.ico\"><script data-id=\"_gd\" nonce=\"jJq1td33tGeXaoe6JI4Y8A\">window.WIZ_global_data = {\"AfY8Hf\":false,\"DMjf6c\":false,\"DpimGf\":false,\"EP1ykd\":[\"/_/*\",\"/covid19/exposurenotifications/select\",\"/covid19/exposurenotifications/select/*\",\"/exchange\",\"/exchange/*\",\"/store/ereview\",\"/store/ereview/\",\"/store/linkbuilder\",\"/store/linkbuilder/\",\"/store/movies/device\",\"/store/movies/device/\",\"/web/store/ereview\",\"/web/store/ereview/\",\"/web/store/linkbuilder\",\"/web/store/linkbuilder/\",\"/web/store/movies/device\",\"/web/store/movies/device/\"],\"FdrFJe\":\"8078274366180929910\",\"G8C1sd\":\"%.@.[[true,null,1],null,[[[]]],null,null,null,null,[null,2],null,null,null,null,null,null,null,null,null,null,null,null,null,null,[1]],[null,[[[]]],null,null,[true]],[null,[[[]]],null,[true]],[null,[[[]]]],…"},"meta":{"cost":"$0.0005","balance":"$3.0715","request_id":"req_6ddd0acbd267c7fa5b7d2b7793c40375"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"404":{"description":"No stored payload for this input (fetch one with `source=live`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_found","message":"nosuchuser","request_id":"req_5c10900e919bc7a3ff79b7501d582b4c"}}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/crawl/google/news":{"get":{"tags":["Crawl"],"operationId":"crawlGoogleNews","summary":"Google News search","x-dashboard-cost":"$0.0005","description":"Google News search results for a query, as the public RSS feed (XML). A search with no results is not billed.","security":[{"bearerAuth":[]}],"parameters":[{"name":"q","in":"query","required":true,"description":"The news search text.","example":"openai","schema":{"type":"string"}}],"responses":{"200":{"description":"Fetched document with optional extracted fields.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":true},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"final_url":"https://news.google.com/rss/search?q=openai&hl=en-US&gl=US&ceid=US%3Aen","status":200,"content_type":"application/xml; charset=utf-8","payload_kind":"text","response_headers":{"content-type":"application/xml; charset=utf-8","cache-control":"no-cache, no-store, max-age=0, must-revalidate","expires":"Mon, 01 Jan 1990 00:00:00 GMT"},"body":"<?xml version=\"1.0\" encoding=\"UTF-8\" standalone=\"yes\"?><rss version=\"2.0\" xmlns:media=\"http://search.yahoo.com/mrss/\"><channel><generator>NFE/5.0</generator><title>\"openai\" - Google News</title><link>https://news.google.com/search?q=openai&amp;hl=en-US&amp;gl=US&amp;ceid=US:en</link><language>en-US</language><webMaster>news-webmaster@google.com</webMaster><copyright>Copyright © 2026 Google. All rights reserved. This XML feed is made available solely for the purpose of rendering Google News results within a personal feed reader for personal, non-commercial use. Any other use of the feed is expressly prohibited. By accessing this feed or using these results in any manner whatsoever, you agree to be bound by the foregoing restrictions.</copyright><lastBuildDate>Thu, 23 Jul 2026 06:58:23 GMT</lastBuildDate><image><title>Google News</title><url>https://lh3.googleusercontent.com/-DR60l-K8vnyi99NZovm9HlXyZwQ85GMDxiwJWzoasZYCUrPuUM_P_4Rb7ei03j-0nRs0c4F=w256</url><link>https://news.google.com/</link><height>256</height><width>256</width></image><description>Google News</description><item><title>OpenAI cyber models broke out of training environment to hack Hugging Face - CNBC</title><link>https://news.google.com/rss/articles/CBMigAFBVV95cUxQS0Fzbkw4bWcyTTlMV1YzMlRzZmVzTDFJUkIxUVJxWFVlZjJVcjBHQ1RSaTZXOVZRclhkRkplY1ZDWFM1UVc0WEQ5Z0daUnFhZUpCa2xTMVJOaHVrZXNJbHNZWkMzNU9TSVMwc2JtcExHam9DTGdONHJFbkJaTzhFNtIBhgFBVV95cUxPdVNpQk40cDBmZWliMlZqX1drbFJNVkEwRUE2X19rT0l1WVFjcm5uQkxBaVhXSEk0M3Rvdk5aR…"},"meta":{"cost":"$0.0005","balance":"$3.0710","request_id":"req_c28de751e45adbac80d0028fcc65d1e5"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"404":{"description":"No stored payload for this input (fetch one with `source=live`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_found","message":"nosuchuser","request_id":"req_5c10900e919bc7a3ff79b7501d582b4c"}}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/crawl/biolink/page":{"get":{"tags":["Crawl"],"operationId":"crawlBiolinkPage","summary":"Bio Link page","x-dashboard-cost":"$0.0005","description":"A bio.link creator page — the document, with the page's links available via HTML extraction.","security":[{"bearerAuth":[]}],"parameters":[{"name":"user","in":"query","required":true,"description":"The bio.link username.","example":"spotify","schema":{"type":"string"}}],"responses":{"200":{"description":"Fetched document with optional extracted fields.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":true},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"final_url":"https://bio.link/spotify","status":200,"content_type":"text/html; charset=UTF-8","payload_kind":"text","response_headers":{"content-type":"text/html; charset=UTF-8","cache-control":"public","last-modified":"Thu, 23 Jul 2026 06:58:57 GMT"},"body":"<!doctype html>\n<html lang=\"en\">\n\n<head>\n    <meta charset=\"utf-8\">\n    <meta name='viewport' content='width=device-width, initial-scale=1.0, maximum-scale=1.0, user-scalable=0'>\n    <link rel=\"shortcut icon\" href=\"https://cdn.bio.link/biolink/default/user.png\" type=\"image/webp\">\n    <link rel=\"icon\" href=\"https://cdn.bio.link/biolink/default/user.png\" type=\"image/webp\">\n    <meta name=\"description\" content=\"Link to everywhere from your bio link.\" />\n    <meta property=\"og:title\" content=\"spotify\" />\n    <link rel=\"canonical\" href=\"https://spotify.bio.link\" />\n    <meta property=\"og:url\" content=\"https://spotify.bio.link\" />\n    <meta property=\"og:description\" content=\"Link to everywhere from your bio link.\" />\n    <meta property=\"og:image:secure_url\" content=\"https://cdn.bio.link/biolink/default/user.png\" />\n    <meta property=\"og:image\" content=\"https://cdn.bio.link/biolink/default/user.png\" />\n    <meta property=\"profile:username\" content=\"spotify\" />\n    <meta name=\"twitter:card\" content=\"summary\" />\n    <meta name=\"twitter:title\" content=\"spotify\" />\n    <meta name=\"twitter:image\" content=\"https://cdn.bio.link/biolink/default/user.png\" />\n    <meta name=\"twitter:url\" content=\"https://spotify.bio.link\" />\n    <link rel=\"preload\" as=\"image\" href=\"https://cdn.bio.link/biolink/default/user.png\" />\n    <title>spotify</title>\n    <meta name=\"robots\" content=\"index, follow\" />\n    <link rel=\"apple-touch-icon\" sizes=\"180x180\"\n          href=\"https://cdn.bio.link/biolink/default/…"},"meta":{"cost":"$0.0005","balance":"$3.0705","request_id":"req_0e7b7c4fe94305b8642a8b305b041d35"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"404":{"description":"No stored payload for this input (fetch one with `source=live`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_found","message":"nosuchuser","request_id":"req_5c10900e919bc7a3ff79b7501d582b4c"}}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/crawl/komi/page":{"get":{"tags":["Crawl"],"operationId":"crawlKomiPage","summary":"Komi page","x-dashboard-cost":"$0.0005","description":"A Komi creator profile from the JSON API the Komi page loads: name, bio, avatar, account status and social links. A username with no Komi page returns an error and is not billed.","security":[{"bearerAuth":[]}],"parameters":[{"name":"user","in":"query","required":true,"description":"The Komi username.","example":"lizzo","schema":{"type":"string"}}],"responses":{"200":{"description":"Fetched document with optional extracted fields.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":true},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"final_url":"https://komi.io/marbleroom","status":200,"content_type":"text/html","payload_kind":"text","response_headers":{"content-type":"text/html","last-modified":"Tue, 19 May 2026 16:54:58 GMT"},"body":"<!DOCTYPE html><html lang=\"en\"><head><meta charSet=\"utf-8\"/><script>!function(){window.semaphore=window.semaphore||[],window.ketch=function(){window.semaphore.push(arguments)};var e=new URLSearchParams(document.location.search),o=e.has(&quot;property&quot;)?e.get(&quot;property&quot;):&quot;website_smart_tag&quot;,n=document.createElement(&quot;script&quot;);n.type=&quot;text/javascript&quot;,n.src=&quot;https://global.ketchcdn.com/web/v2/config/komi/&quot;.concat(o,&quot;/boot.js&quot;),n.defer=n.async=!0,document.getElementsByTagName(&quot;head&quot;)[0]?.appendChild(n)}();</script><meta name=\"viewport\" content=\"height=device-height, width=device-width, initial-scale=1.0, minimum-scale=1.0, maximum-scale=1.0, user-scalable=no, target-densitydpi=device-dpi\"/><script type=\"module\" src=\"https://assets.cello.so/attribution/latest/cello-attribution.js\" async=\"\"></script><meta name=\"next-head-count\" content=\"4\"/><meta name=\"application-name\" content=\"Komi\"/><meta name=\"apple-mobile-web-app-capable\" content=\"yes\"/><meta name=\"apple-mobile-web-app-status-bar-style\" content=\"default\"/><meta name=\"apple-mobile-web-app-title\" content=\"Komi\"/><meta name=\"format-detection\" content=\"telephone=no\"/><meta name=\"mobile-web-app-capable\" content=\"yes\"/><meta name=\"theme-color\" content=\"#FFFFFF\"/><meta name=\"facebook-domain-verification\" content=\"f2qtqnj1ydnngr0acmbyn8uvfukhps\"/><link rel=\"apple-touch-icon\" sizes=\"180x180\" href=\"/apple-touch-icon.png\"/><link rel=\"icon\" type=\"image/png\" sizes=\"…"},"meta":{"cost":"$0.0005","balance":"$3.0700","request_id":"req_a74895f937518766331bebdaf905b743"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"404":{"description":"No stored payload for this input (fetch one with `source=live`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_found","message":"nosuchuser","request_id":"req_5c10900e919bc7a3ff79b7501d582b4c"}}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/crawl/snipfeed/page":{"get":{"tags":["Crawl"],"operationId":"crawlSnipfeedPage","summary":"Snipfeed page","x-dashboard-cost":"$0.0005","description":"A Snipfeed creator page — the document, with the page's links available via HTML extraction.","security":[{"bearerAuth":[]}],"parameters":[{"name":"user","in":"query","required":true,"description":"The Snipfeed username.","example":"planoly","schema":{"type":"string"}}],"responses":{"200":{"description":"Fetched document with optional extracted fields.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":true},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"final_url":"https://planoly.store/planoly","status":200,"content_type":"text/html; charset=utf-8","payload_kind":"text","response_headers":{"content-type":"text/html; charset=utf-8","cache-control":"public, max-age=0, must-revalidate"},"body":"<!DOCTYPE html><html lang=\"en\"><head><meta charSet=\"utf-8\" data-next-head=\"\"/><meta name=\"viewport\" content=\"width=device-width, initial-scale=1\" data-next-head=\"\"/><meta property=\"og:locale\" content=\"en_IE\" data-next-head=\"\"/><meta property=\"og:site_name\" content=\"Planoly Creator Store\" data-next-head=\"\"/><link rel=\"manifest\" href=\"/site.webmanifest\" data-next-head=\"\"/><link rel=\"apple-touch-icon\" sizes=\"180x180\" href=\"/apple-touch-icon.png\" data-next-head=\"\"/><link rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/favicon-32x32.png\" data-next-head=\"\"/><link rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/favicon-16x16.png\" data-next-head=\"\"/><meta name=\"theme-color\" content=\"#ffffff\" data-next-head=\"\"/><title data-next-head=\"\">Planoly Creator Store | Planoly</title><meta name=\"robots\" content=\"index,follow\" data-next-head=\"\"/><meta name=\"description\" content=\"Planoly Creator Store. Build your business from your bio link.\" data-next-head=\"\"/><meta name=\"twitter:card\" content=\"summary_large_image\" data-next-head=\"\"/><meta name=\"twitter:site\" content=\"@SnipfeedApp\" data-next-head=\"\"/><meta name=\"twitter:creator\" content=\"@SnipfeedApp\" data-next-head=\"\"/><meta property=\"og:title\" content=\"Planoly\" data-next-head=\"\"/><meta property=\"og:description\" content=\"Planoly Creator Store. Build your business from your bio link.\" data-next-head=\"\"/><meta property=\"og:url\" content=\"https://planoly.store/planoly\" data-next-head=\"\"/><meta property=\"og:type\" content=\"website\" data-next-head=\"…"},"meta":{"cost":"$0.0005","balance":"$3.0695","request_id":"req_675d0a7eac358f8269811a8a2fa9fe43"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"404":{"description":"No stored payload for this input (fetch one with `source=live`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_found","message":"nosuchuser","request_id":"req_5c10900e919bc7a3ff79b7501d582b4c"}}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/crawl/taplink/page":{"get":{"tags":["Crawl"],"operationId":"crawlTaplinkPage","summary":"Taplink page","x-dashboard-cost":"$0.0005","description":"A Taplink creator page — the document, with the page's links available via HTML extraction. A username with no Taplink page is not billed.","security":[{"bearerAuth":[]}],"parameters":[{"name":"user","in":"query","required":true,"description":"The Taplink username.","example":"durov","schema":{"type":"string"}}],"responses":{"200":{"description":"Fetched document with optional extracted fields.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":true},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"final_url":"https://taplink.cc/durov","status":200,"content_type":"text/html; charset=utf-8","payload_kind":"text","response_headers":{"content-type":"text/html; charset=utf-8","last-modified":"Thu, 23 Jul 2026 06:59:48 GMT","cache-control":"no-cache, must-revalidate"},"body":"<!DOCTYPE html>\n<html prefix=\"og: http://ogp.me/ns#\" lang=\"ru\" data-format-date=\"d.m.Y\" data-format-datetime=\"d.m.Y H:i\">\n<head>\n\t<title>Durov at Taplink</title>\n\t\t\t\t<meta name=\"viewport\" content=\"width=device-width, user-scalable=no, initial-scale=1, maximum-scale=1, shrink-to-fit=no\"/> <!-- viewport-fit=cover -->\n\n\n\t<meta name=\"HandheldFriendly\" content=\"true\">\n\t<meta http-equiv='Content-Type' content='text/html; charset=utf-8'>\n\t\n\t\t\t\t\t\t<link type='text/css' rel='stylesheet' href='//ca.x.taplink.st/s/css/frontend.css?1.2.10518'>\n\t\t\t\n\t\n\n\t<link rel=\"icon\" href=\"/favicon.ico\">\n\n\n\t<link rel=\"apple-touch-icon\" sizes=\"300x300\" href=\"/favicon.ico\" />\n\t<link rel=\"canonical\" href=\"https://taplink.cc/durov\" />\n\t<meta name=\"format-detection\" content=\"telephone=no,email=no,address=no\" />\n\n\t\n\n\t\n\n\n\n\t<meta name=\"referrer\" content=\"always\">\n\n\n\n\t<link rel=\"image_src\" href=\"\" />\n\t\n\t<meta property=\"og:image\" content=\"\">\n\t<meta property=\"og:type\" content=\"website\"/>\n\t<meta property=\"og:title\" content=\"Durov at Taplink\"/>\n\t\t<meta property=\"og:url\" content=\"https://taplink.cc/durov\"/>\n\t<meta property=\"og:site_name\" content=\"Taplink\"/>\n\n\t\n\n\n\t<link rel=\"manifest\" href=\"/7e982ba05955680.webmanifest\"></head> <body> <div class=\"main base-theme main-theme\">    <style> html {min-height: 100%}</style> <script>\n\twindow.account = {\"account_id\":5896412,\"language_id\":1,\"language_code\":\"ru\",\"language_code_account\":\"ru\",\"main_page_id\":7422746,\"profile_id\":5955680,\"is_hidelink\":false,\"is_plus\":0,\"is_trial\":0,\"…"},"meta":{"cost":"$0.0005","balance":"$3.0690","request_id":"req_203f01542d6a086ed7f1cadf7414d0c7"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"404":{"description":"No stored payload for this input (fetch one with `source=live`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_found","message":"nosuchuser","request_id":"req_5c10900e919bc7a3ff79b7501d582b4c"}}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/crawl/carrd/page":{"get":{"tags":["Crawl"],"operationId":"crawlCarrdPage","summary":"Carrd site","x-dashboard-cost":"$0.0005","description":"A Carrd one-page site by its subdomain — the document, with links available via HTML extraction.","security":[{"bearerAuth":[]}],"parameters":[{"name":"user","in":"query","required":true,"description":"The Carrd site name (the subdomain of carrd.co).","example":"sonny","schema":{"type":"string"}}],"responses":{"200":{"description":"Fetched document with optional extracted fields.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","additionalProperties":true},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"final_url":"https://sonny.carrd.co/","status":200,"content_type":"text/html","payload_kind":"text","response_headers":{"content-type":"text/html","last-modified":"Sat, 10 Sep 2016 05:51:34 GMT","cache-control":"max-age=0","expires":"Thu, 23 Jul 2026 07:00:14 GMT"},"body":"<!DOCTYPE HTML><html><head><title>Sonny Ganguly - Washington, DC</title><meta charset=\"utf-8\" /><meta name=\"viewport\" content=\"width=device-width,initial-scale=1,user-scalable=no\" /><meta name=\"description\" content=\"Co-founder and CMO at WeddingWire.\" /><meta property=\"og:site_name\" content=\"Sonny Ganguly - Washington, DC\" /><meta property=\"og:title\" content=\"Sonny Ganguly - Washington, DC\" /><meta property=\"og:type\" content=\"article\" /><meta property=\"og:image\" content=\"https://sonny.carrd.co/assets/images/card.jpg\" /><meta property=\"og:description\" content=\"Co-founder and CMO at WeddingWire.\" /><meta property=\"og:url\" content=\"https://sonny.carrd.co\" /><meta property=\"twitter:card\" content=\"summary_large_image\" /><link rel=\"stylesheet\" href=\"assets/fonts/CarrdIcons.min.css\" /><link href=\"//fonts.googleapis.com/css?family=Source+Sans+Pro:200,300\" rel=\"stylesheet\" type=\"text/css\" /><style>html,body,div,span,applet,object,iframe,h1,h2,h3,h4,h5,h6,p,blockquote,pre,a,abbr,acronym,address,big,cite,code,del,dfn,em,img,ins,kbd,q,s,samp,small,strike,strong,sub,sup,tt,var,b,u,i,center,dl,dt,dd,ol,ul,li,fieldset,form,label,legend,table,caption,tbody,tfoot,thead,tr,th,td,article,aside,canvas,details,embed,figure,figcaption,footer,header,hgroup,menu,nav,output,ruby,section,summary,time,mark,audio,video{margin:0;padding:0;border:0;font-size:100%;font:inherit;vertical-align:baseline;}article,aside,details,figcaption,figure,footer,header,hgroup,menu,nav,section{display:block;}body{line-hei…"},"meta":{"cost":"$0.0005","balance":"$3.0685","request_id":"req_6843d51c5b8a01e4391d42ad6dfd32e9"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"404":{"description":"No stored payload for this input (fetch one with `source=live`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_found","message":"nosuchuser","request_id":"req_5c10900e919bc7a3ff79b7501d582b4c"}}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/search/google":{"get":{"tags":["Web Search"],"operationId":"searchGoogle","summary":"Google web search","x-dashboard-cost":"$0.003","description":"Live Google organic SERP in the DataForSEO `serp/google/organic/live/regular` response shape (`data.tasks[].result[].items`), with pagination: `depth > 10` fans the query across result pages and each item carries its `page`.\n\nA blocked engine is a `502` `upstream_error`, never an empty result set, and a failed request is never billed. Search-engine chrome (help pages, redirect wrappers) is stripped, and wrapped result links are resolved to their real destination.","security":[{"bearerAuth":[]}],"parameters":[{"name":"q","in":"query","required":true,"description":"The search query, exactly as you would type it into the engine.","schema":{"type":"string","maxLength":700},"example":"best korean skincare creators instagram"},{"name":"depth","in":"query","required":false,"description":"Total organic results to return. Values above 10 paginate across result pages; each item carries the `page` it came from.","schema":{"type":"integer","minimum":1,"maximum":100,"default":10},"examples":{"default":{"value":20,"x-disabled":true}}},{"name":"location_code","in":"query","required":false,"description":"Market, as a DataForSEO location code (a Google Ads geo-target criterion id). OMIT IT for an unlocalised search — there is no default market, and the response reports `location_code: null` so you can tell. Use `gl` instead if you prefer country codes. Google searches that market. Bing does not: it searches in the country it sees the request come from, which the result names in `served_country`. Names for every code: `GET /v1/search/locations`.","schema":{"type":"integer","enum":[2032,2036,2040,2056,2076,2124,2152,2158,2170,2208,2246,2250,2276,2300,2344,2356,2360,2372,2380,2392,2410,2458,2484,2528,2554,2578,2608,2616,2620,2682,2702,2704,2710,2724,2752,2756,2764,2784,2792,2818,2826,2840],"x-enumDescriptions":{"2032":"Argentina","2036":"Australia","2040":"Austria","2056":"Belgium","2076":"Brazil","2124":"Canada","2152":"Chile","2158":"Taiwan","2170":"Colombia","2208":"Denmark","2246":"Finland","2250":"France","2276":"Germany","2300":"Greece","2344":"Hong Kong","2356":"India","2360":"Indonesia","2372":"Ireland","2380":"Italy","2392":"Japan","2410":"South Korea","2458":"Malaysia","2484":"Mexico","2528":"Netherlands","2554":"New Zealand","2578":"Norway","2608":"Philippines","2616":"Poland","2620":"Portugal","2682":"Saudi Arabia","2702":"Singapore","2704":"Vietnam","2710":"South Africa","2724":"Spain","2752":"Sweden","2756":"Switzerland","2764":"Thailand","2784":"United Arab Emirates","2792":"Turkey","2818":"Egypt","2826":"United Kingdom","2840":"United States"}},"examples":{"default":{"value":2840,"x-disabled":true}}},{"name":"gl","in":"query","required":false,"description":"Market as a 2-letter country code — the friendlier alternative to `location_code`. Give one or the other; if you give both they must name the same market or the call is a 400. Omit both for an unlocalised search. Bing does not search that market (see `location_code`).","schema":{"type":"string","enum":["ae","ar","at","au","be","br","ca","ch","cl","co","de","dk","eg","es","fi","fr","gb","gr","hk","id","ie","in","it","jp","kr","mx","my","nl","no","nz","ph","pl","pt","sa","se","sg","th","tr","tw","us","vn","za"]},"examples":{"default":{"value":"us","x-disabled":true}}},{"name":"language_code","in":"query","required":false,"description":"Result language, sent as Google's `hl` and Bing's `setlang`. Defaults to `en`. A code outside this list is rejected rather than forwarded, so you never get a market nobody serves. Names for every code: `GET /v1/search/languages`.","schema":{"type":"string","enum":["ar","da","de","el","en","es","fi","fr","hi","id","it","ja","ko","ms","nl","no","pl","pt","ru","sv","th","tr","vi","zh","zh-tw"],"default":"en"},"examples":{"default":{"value":"en","x-disabled":true}}},{"name":"time_range","in":"query","required":false,"description":"Only results from the past hour, day, week, month or year, sent as Google's `tbs=qdr:`. Omit it for results from any time. Google only; `/v1/search/bing` answers it with a 400.","schema":{"type":"string","enum":["hour","day","week","month","year"]},"examples":{"default":{"value":"week","x-disabled":true}}}],"responses":{"200":{"description":"Ranked organic results.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","description":"DataForSEO `serp/{engine}/organic/live/regular` response, with pagination.","properties":{"version":{"type":"string"},"status_code":{"type":"integer","example":20000},"status_message":{"type":"string","example":"Ok."},"time":{"type":"string"},"cost":{"type":"number"},"tasks_count":{"type":"integer"},"tasks_error":{"type":"integer"},"tasks":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"status_code":{"type":"integer","example":20000},"status_message":{"type":"string","example":"Ok."},"time":{"type":"string"},"cost":{"type":"number"},"result_count":{"type":"integer"},"path":{"type":"array","items":{"type":"string"}},"data":{"type":"object","description":"Echo of the request parameters."},"result":{"type":"array","items":{"type":"object","properties":{"keyword":{"type":"string"},"type":{"type":"string","enum":["organic"]},"se_domain":{"type":"string","example":"google.com"},"location_code":{"type":"integer"},"language_code":{"type":"string"},"served_country":{"type":"string","nullable":true,"description":"The country the engine searched in, as its page says (2 letters, lower case), or null when the page names none. Bing searches in the country it sees the request come from, whatever `location_code` says; Google names none."},"check_url":{"type":"string"},"datetime":{"type":"string"},"spell":{"type":"object","nullable":true,"description":"The engine's spelling fix on page 1, or null. `did_you_mean` suggests `keyword`; `showing_results_for` means the engine searched `keyword` instead of the query.","properties":{"keyword":{"type":"string"},"type":{"type":"string","enum":["did_you_mean","showing_results_for"]}}},"refinement_chips":{"type":"object","nullable":true},"item_types":{"type":"array","items":{"type":"string","enum":["organic","related_searches","local_pack","knowledge_graph"]},"description":"The item types present, in first-seen order."},"se_results_count":{"type":"integer","description":"The engine's own \"About N results\" figure. Always 0 for Google: the page we read prints none."},"pages_count":{"type":"integer","description":"Result pages fetched to satisfy `depth`."},"items_count":{"type":"integer"},"items":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["organic"]},"rank_group":{"type":"integer","description":"Rank within this result type."},"rank_absolute":{"type":"integer","description":"Rank across all items on the SERP."},"page":{"type":"integer","description":"Result page this item came from (1-based)."},"domain":{"type":"string","description":"Hostname of `url`, `www.` stripped."},"title":{"type":"string"},"description":{"type":"string","description":"Engine-supplied snippet; empty when omitted."},"url":{"type":"string","description":"Real destination, with redirect wrappers resolved, except when `url_resolved` is false: then it is Google's own redirect link."},"breadcrumb":{"type":"string","description":"Displayed URL breadcrumb."},"url_resolved":{"type":"boolean","description":"False when Google did not answer the result's link with its target in time. The item keeps its rank, `url` is Google's redirect link, `domain` and `breadcrumb` name the site the page shows, and the task's `status_message` counts such items."}}},{"type":"object","description":"The engine's query suggestions from page 1, such as Google's \"Related searches\".","properties":{"type":{"type":"string","enum":["related_searches"]},"rank_group":{"type":"integer","description":"Rank within this result type."},"rank_absolute":{"type":"integer","description":"Rank across all items on the SERP."},"page":{"type":"integer","description":"Result page this item came from (1-based)."},"items":{"type":"array","items":{"type":"string"},"description":"The suggested queries, in page order."}}},{"type":"object","description":"One place of the engine's local pack on page 1, such as Google's \"Places for\". The page carries no phone, domain or url for a place.","properties":{"type":{"type":"string","enum":["local_pack"]},"rank_group":{"type":"integer","description":"Rank within this result type."},"rank_absolute":{"type":"integer","description":"Rank across all items on the SERP."},"page":{"type":"integer","description":"Result page this item came from (1-based)."},"title":{"type":"string","description":"The place name."},"description":{"type":"string","description":"The place's own lines, such as its price, kind, address and hours."},"rating":{"type":"object","nullable":true,"properties":{"rating_type":{"type":"string","enum":["Max5"]},"value":{"type":"number"},"votes_count":{"type":"integer","nullable":true},"rating_max":{"type":"integer"}}}}},{"type":"object","description":"The engine's knowledge panel on page 1 for the entity the query names.","properties":{"type":{"type":"string","enum":["knowledge_graph"]},"rank_group":{"type":"integer","description":"Rank within this result type."},"rank_absolute":{"type":"integer","description":"Rank across all items on the SERP."},"page":{"type":"integer","description":"Result page this item came from (1-based)."},"title":{"type":"string","description":"The entity name."},"sub_title":{"type":"string","description":"The kind of entity, such as `Company`."},"description":{"type":"string"},"url":{"type":"string","nullable":true,"description":"The source of the description, such as Wikipedia."},"items":{"type":"array","description":"The panel's labelled facts.","items":{"type":"object","properties":{"type":{"type":"string","enum":["knowledge_graph_row_item"]},"title":{"type":"string","example":"CEO"},"text":{"type":"string"}}}}}}],"discriminator":{"propertyName":"type"}},"description":"Items in page order. `depth` counts `organic` items only. `local_pack` places, one `knowledge_graph` and one `related_searches` item come from page 1."}}}}}}}}},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"version":"0.1.20260806","status_code":20000,"status_message":"Ok.","time":"1.4210 sec.","cost":0,"tasks_count":1,"tasks_error":0,"tasks":[{"id":"08061200-0000-0000-0000-00000000abcd","status_code":20000,"status_message":"Ok.","time":"1.4100 sec.","cost":0,"result_count":1,"path":["v3","serp","google","organic","live","regular"],"data":{"api":"serp","function":"live","se":"google","se_type":"organic","keyword":"gymshark","location_code":2840,"language_code":"en","device":"desktop","os":"windows","depth":10},"result":[{"keyword":"gymshark","type":"organic","se_domain":"google.com","location_code":2840,"language_code":"en","served_country":null,"check_url":"https://www.google.com/search?q=gymshark","datetime":"2026-08-06 12:00:00 +00:00","spell":null,"refinement_chips":null,"item_types":["organic"],"se_results_count":0,"pages_count":1,"items_count":2,"items":[{"type":"organic","rank_group":1,"rank_absolute":1,"page":1,"domain":"gymshark.com","title":"Gymshark | Official Store","description":"Shop gym clothes and workout wear from Gymshark.","url":"https://www.gymshark.com/","breadcrumb":"gymshark.com"},{"type":"organic","rank_group":2,"rank_absolute":2,"page":1,"domain":"instagram.com","title":"Gymshark (@gymshark) · Instagram","description":"7.1M Followers · The official Gymshark Instagram.","url":"https://www.instagram.com/gymshark/","breadcrumb":"instagram.com › gymshark"}]}]}]},"meta":{"cost":"$0.003","balance":"$24.85","request_id":"req_a3f19c02b7d84e6510fc72a9b45d0e83"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"429":{"$ref":"#/components/responses/AcquisitionRateLimited"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/search/bing":{"get":{"tags":["Web Search"],"operationId":"searchBing","summary":"Bing web search","x-dashboard-cost":"$0.002","description":"Live Bing organic SERP in the same DataForSEO `serp/{engine}/organic/live/regular` response shape as `/v1/search/google` (with `se_domain: bing.com`), priced lower because Bing tolerates our egress better.\n\nUse both when coverage matters: the two indexes disagree often enough on long-tail queries that one engine alone under-reports.\n\n`location_code` and `gl` are checked and echoed, but Bing does not search that market: it answers a market that differs from the country it sees the request come from with off-query results. Results come from that country, which `served_country` names.","security":[{"bearerAuth":[]}],"parameters":[{"name":"q","in":"query","required":true,"description":"The search query, exactly as you would type it into the engine.","schema":{"type":"string","maxLength":700},"example":"best korean skincare creators instagram"},{"name":"depth","in":"query","required":false,"description":"Total organic results to return. Values above 10 paginate across result pages; each item carries the `page` it came from.","schema":{"type":"integer","minimum":1,"maximum":100,"default":10},"examples":{"default":{"value":20,"x-disabled":true}}},{"name":"location_code","in":"query","required":false,"description":"Market, as a DataForSEO location code (a Google Ads geo-target criterion id). OMIT IT for an unlocalised search — there is no default market, and the response reports `location_code: null` so you can tell. Use `gl` instead if you prefer country codes. Google searches that market. Bing does not: it searches in the country it sees the request come from, which the result names in `served_country`. Names for every code: `GET /v1/search/locations`.","schema":{"type":"integer","enum":[2032,2036,2040,2056,2076,2124,2152,2158,2170,2208,2246,2250,2276,2300,2344,2356,2360,2372,2380,2392,2410,2458,2484,2528,2554,2578,2608,2616,2620,2682,2702,2704,2710,2724,2752,2756,2764,2784,2792,2818,2826,2840],"x-enumDescriptions":{"2032":"Argentina","2036":"Australia","2040":"Austria","2056":"Belgium","2076":"Brazil","2124":"Canada","2152":"Chile","2158":"Taiwan","2170":"Colombia","2208":"Denmark","2246":"Finland","2250":"France","2276":"Germany","2300":"Greece","2344":"Hong Kong","2356":"India","2360":"Indonesia","2372":"Ireland","2380":"Italy","2392":"Japan","2410":"South Korea","2458":"Malaysia","2484":"Mexico","2528":"Netherlands","2554":"New Zealand","2578":"Norway","2608":"Philippines","2616":"Poland","2620":"Portugal","2682":"Saudi Arabia","2702":"Singapore","2704":"Vietnam","2710":"South Africa","2724":"Spain","2752":"Sweden","2756":"Switzerland","2764":"Thailand","2784":"United Arab Emirates","2792":"Turkey","2818":"Egypt","2826":"United Kingdom","2840":"United States"}},"examples":{"default":{"value":2840,"x-disabled":true}}},{"name":"gl","in":"query","required":false,"description":"Market as a 2-letter country code — the friendlier alternative to `location_code`. Give one or the other; if you give both they must name the same market or the call is a 400. Omit both for an unlocalised search. Bing does not search that market (see `location_code`).","schema":{"type":"string","enum":["ae","ar","at","au","be","br","ca","ch","cl","co","de","dk","eg","es","fi","fr","gb","gr","hk","id","ie","in","it","jp","kr","mx","my","nl","no","nz","ph","pl","pt","sa","se","sg","th","tr","tw","us","vn","za"]},"examples":{"default":{"value":"us","x-disabled":true}}},{"name":"language_code","in":"query","required":false,"description":"Result language, sent as Google's `hl` and Bing's `setlang`. Defaults to `en`. A code outside this list is rejected rather than forwarded, so you never get a market nobody serves. Names for every code: `GET /v1/search/languages`.","schema":{"type":"string","enum":["ar","da","de","el","en","es","fi","fr","hi","id","it","ja","ko","ms","nl","no","pl","pt","ru","sv","th","tr","vi","zh","zh-tw"],"default":"en"},"examples":{"default":{"value":"en","x-disabled":true}}}],"responses":{"200":{"description":"Ranked organic results.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","description":"DataForSEO `serp/{engine}/organic/live/regular` response, with pagination.","properties":{"version":{"type":"string"},"status_code":{"type":"integer","example":20000},"status_message":{"type":"string","example":"Ok."},"time":{"type":"string"},"cost":{"type":"number"},"tasks_count":{"type":"integer"},"tasks_error":{"type":"integer"},"tasks":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"status_code":{"type":"integer","example":20000},"status_message":{"type":"string","example":"Ok."},"time":{"type":"string"},"cost":{"type":"number"},"result_count":{"type":"integer"},"path":{"type":"array","items":{"type":"string"}},"data":{"type":"object","description":"Echo of the request parameters."},"result":{"type":"array","items":{"type":"object","properties":{"keyword":{"type":"string"},"type":{"type":"string","enum":["organic"]},"se_domain":{"type":"string","example":"google.com"},"location_code":{"type":"integer"},"language_code":{"type":"string"},"served_country":{"type":"string","nullable":true,"description":"The country the engine searched in, as its page says (2 letters, lower case), or null when the page names none. Bing searches in the country it sees the request come from, whatever `location_code` says; Google names none."},"check_url":{"type":"string"},"datetime":{"type":"string"},"spell":{"type":"object","nullable":true,"description":"The engine's spelling fix on page 1, or null. `did_you_mean` suggests `keyword`; `showing_results_for` means the engine searched `keyword` instead of the query.","properties":{"keyword":{"type":"string"},"type":{"type":"string","enum":["did_you_mean","showing_results_for"]}}},"refinement_chips":{"type":"object","nullable":true},"item_types":{"type":"array","items":{"type":"string","enum":["organic","related_searches","local_pack","knowledge_graph"]},"description":"The item types present, in first-seen order."},"se_results_count":{"type":"integer","description":"The engine's own \"About N results\" figure. Always 0 for Google: the page we read prints none."},"pages_count":{"type":"integer","description":"Result pages fetched to satisfy `depth`."},"items_count":{"type":"integer"},"items":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","enum":["organic"]},"rank_group":{"type":"integer","description":"Rank within this result type."},"rank_absolute":{"type":"integer","description":"Rank across all items on the SERP."},"page":{"type":"integer","description":"Result page this item came from (1-based)."},"domain":{"type":"string","description":"Hostname of `url`, `www.` stripped."},"title":{"type":"string"},"description":{"type":"string","description":"Engine-supplied snippet; empty when omitted."},"url":{"type":"string","description":"Real destination, with redirect wrappers resolved, except when `url_resolved` is false: then it is Google's own redirect link."},"breadcrumb":{"type":"string","description":"Displayed URL breadcrumb."},"url_resolved":{"type":"boolean","description":"False when Google did not answer the result's link with its target in time. The item keeps its rank, `url` is Google's redirect link, `domain` and `breadcrumb` name the site the page shows, and the task's `status_message` counts such items."}}},{"type":"object","description":"The engine's query suggestions from page 1, such as Google's \"Related searches\".","properties":{"type":{"type":"string","enum":["related_searches"]},"rank_group":{"type":"integer","description":"Rank within this result type."},"rank_absolute":{"type":"integer","description":"Rank across all items on the SERP."},"page":{"type":"integer","description":"Result page this item came from (1-based)."},"items":{"type":"array","items":{"type":"string"},"description":"The suggested queries, in page order."}}},{"type":"object","description":"One place of the engine's local pack on page 1, such as Google's \"Places for\". The page carries no phone, domain or url for a place.","properties":{"type":{"type":"string","enum":["local_pack"]},"rank_group":{"type":"integer","description":"Rank within this result type."},"rank_absolute":{"type":"integer","description":"Rank across all items on the SERP."},"page":{"type":"integer","description":"Result page this item came from (1-based)."},"title":{"type":"string","description":"The place name."},"description":{"type":"string","description":"The place's own lines, such as its price, kind, address and hours."},"rating":{"type":"object","nullable":true,"properties":{"rating_type":{"type":"string","enum":["Max5"]},"value":{"type":"number"},"votes_count":{"type":"integer","nullable":true},"rating_max":{"type":"integer"}}}}},{"type":"object","description":"The engine's knowledge panel on page 1 for the entity the query names.","properties":{"type":{"type":"string","enum":["knowledge_graph"]},"rank_group":{"type":"integer","description":"Rank within this result type."},"rank_absolute":{"type":"integer","description":"Rank across all items on the SERP."},"page":{"type":"integer","description":"Result page this item came from (1-based)."},"title":{"type":"string","description":"The entity name."},"sub_title":{"type":"string","description":"The kind of entity, such as `Company`."},"description":{"type":"string"},"url":{"type":"string","nullable":true,"description":"The source of the description, such as Wikipedia."},"items":{"type":"array","description":"The panel's labelled facts.","items":{"type":"object","properties":{"type":{"type":"string","enum":["knowledge_graph_row_item"]},"title":{"type":"string","example":"CEO"},"text":{"type":"string"}}}}}}],"discriminator":{"propertyName":"type"}},"description":"Items in page order. `depth` counts `organic` items only. `local_pack` places, one `knowledge_graph` and one `related_searches` item come from page 1."}}}}}}}}},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"version":"0.1.20260806","status_code":20000,"status_message":"Ok.","time":"1.4210 sec.","cost":0,"tasks_count":1,"tasks_error":0,"tasks":[{"id":"08061200-0000-0000-0000-00000000abcd","status_code":20000,"status_message":"Ok.","time":"1.4100 sec.","cost":0,"result_count":1,"path":["v3","serp","bing","organic","live","regular"],"data":{"api":"serp","function":"live","se":"bing","se_type":"organic","keyword":"gymshark","location_code":2840,"language_code":"en","device":"desktop","os":"windows","depth":10},"result":[{"keyword":"gymshark","type":"organic","se_domain":"bing.com","location_code":2840,"language_code":"en","served_country":"us","check_url":"https://www.bing.com/search?q=gymshark","datetime":"2026-08-06 12:00:00 +00:00","spell":null,"refinement_chips":null,"item_types":["organic"],"se_results_count":8460000,"pages_count":1,"items_count":2,"items":[{"type":"organic","rank_group":1,"rank_absolute":1,"page":1,"domain":"gymshark.com","title":"Gymshark | Official Store","description":"Shop gym clothes and workout wear from Gymshark.","url":"https://www.gymshark.com/","breadcrumb":"gymshark.com"},{"type":"organic","rank_group":2,"rank_absolute":2,"page":1,"domain":"instagram.com","title":"Gymshark (@gymshark) · Instagram","description":"7.1M Followers · The official Gymshark Instagram.","url":"https://www.instagram.com/gymshark/","breadcrumb":"instagram.com › gymshark"}]}]}]},"meta":{"cost":"$0.002","balance":"$24.85","request_id":"req_b7e24d915c0a4f38a2916b7de3c5108f"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"429":{"$ref":"#/components/responses/AcquisitionRateLimited"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/search/locations":{"get":{"tags":["Web Search"],"operationId":"searchLocations","summary":"Supported search markets","x-dashboard-cost":"Free","description":"Every market `/v1/search/*` accepts, as `{ location_code, location_name, country_iso_code }`. Google searches the market you name; Bing searches in the country it sees the request come from. Free and unbilled — you should never pay to discover which values the API accepts. `location_code` is a Google Ads geo-target criterion id, so this is the only way to map a country to one; the field names mirror DataForSEO, whose reference endpoint this matches.","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Supported markets.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"array","items":{"type":"object","properties":{"location_code":{"type":"integer","example":2840},"location_name":{"type":"string","example":"United States"},"country_iso_code":{"type":"string","example":"us"}}}},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":[{"location_code":2840,"location_name":"United States","country_iso_code":"us"},{"location_code":2410,"location_name":"South Korea","country_iso_code":"kr"},{"location_code":2392,"location_name":"Japan","country_iso_code":"jp"}],"meta":{"cost":"$0.00","balance":"$24.85","request_id":"req_5c1d90ab72e34f16b8d0e4a7c9315f28"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/search/languages":{"get":{"tags":["Web Search"],"operationId":"searchLanguages","summary":"Supported search languages","x-dashboard-cost":"Free","description":"Every language `/v1/search/*` can search, as `{ language_code, language_name }`. Free and unbilled. A code outside this list is rejected rather than forwarded to the engine, so a caller never receives results for a market nobody serves.","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Supported languages.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"array","items":{"type":"object","properties":{"language_code":{"type":"string","example":"en"},"language_name":{"type":"string","example":"English"}}}},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":[{"language_code":"en","language_name":"English"},{"language_code":"ko","language_name":"Korean"},{"language_code":"ja","language_name":"Japanese"}],"meta":{"cost":"$0.00","balance":"$24.85","request_id":"req_1f7b34c8e05a496d92c6b18df403a75e"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/intelligence/profile":{"get":{"tags":["Intelligence"],"operationId":"intelProfile","summary":"Profile intelligence","x-dashboard-cost":"from $0.05","description":"Returns the AI intelligence bundle for a profile: entity type, niche classification, commercial intent, brand safety, demographics, location, language, and AI summaries (bio, content, audience, brand fit). Null fields are omitted. For emails use `/v1/contacts/find`. Returns the cached bundle when available, otherwise runs enrichment (scraping the profile first if needed), persists it, and returns it.\n\n**Models**: `gpt-5.6-terra` (default, $0.05) or `gpt-5.4` (premium, $0.10). `force_refresh=true` skips cache and re-runs (2× cost).","security":[{"bearerAuth":[]}],"parameters":[{"name":"q","in":"query","required":true,"description":"Instagram username, @handle, or full profile URL (`instagram.com/username`).","schema":{"type":"string"},"example":"nike"},{"name":"model","in":"query","required":false,"description":"AI model. `gpt-5.6-terra` (default, $0.05) or `gpt-5.4` (premium, $0.10).","schema":{"type":"string","enum":["gpt-5.6-terra","gpt-5.4"],"default":"gpt-5.6-terra"},"examples":{"default":{"value":"gpt-5.6-terra","x-disabled":true}}},{"name":"force_refresh","in":"query","required":false,"description":"Skip cache and re-run enrichment. Doubles the cost.","schema":{"type":"string","enum":["true","false"],"default":"false"},"examples":{"default":{"value":"false","x-disabled":true}}}],"responses":{"200":{"description":"Profile intelligence bundle.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/EnrichmentResponseData"},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"entity_type":"brand","account_role":"brand","primary_niche":"Sportswear / Athletic Apparel","sub_niches":["Sneakers","Performance training"],"commercial_intent":"fully_commercial","brand_safety":"safe","gender":"unknown","country":"United States","primary_language":"English","tagline":"Just Do It.","bio_summary":"Nike is a global sportswear and athletic lifestyle brand focused on performance, innovation, and athlete storytelling. Its Instagram centers on major sports moments, product launches, and endorsements featuring elite athletes across football, basketball, tennis, and broader sports culture.","content_summary":"Posts highlight sponsored athletes, championship moments, new footwear and apparel releases, and branded storytelling around football and basketball. The account blends product marketing with aspirational sports content and cultural collaborations."},"meta":{"cost":"$0.0500","balance":"$0.4797","request_id":"req_f3238f5c2707e2f8adcc1ecb2b80546d","source":"db","version":"v3-gpt5.4mini","enriched_at":"2026-07-09 20:37:29.016981+00","model":"gpt-5.6-terra","force_refresh":false}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"404":{"description":"Profile not found on the selected platform.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"not_found","message":"nosuchuser","request_id":"req_5c10900e919bc7a3ff79b7501d582b4c"}}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/intelligence/brand/creators":{"get":{"tags":["Intelligence"],"operationId":"intelBrandCreators","summary":"Brand collab creators","description":"Creators who collaborated with a brand, ranked by distinct collab posts, with followers, `mention_count` and `last_collab_at` (null when no collab post was dated). Instagram edges are tags, co-authors, brand tags and paid partnerships; TikTok edges are caption @mentions.\n\nPage with `offset` until a page comes back shorter than `limit`. An empty page is free.","x-dashboard-cost":"$0.001","x-example-query":{"q":"celimax.korea","limit":"3"},"security":[{"bearerAuth":[]}],"parameters":[{"name":"q","in":"query","required":true,"description":"Brand username, @handle, or profile URL.","example":"celimax.korea","schema":{"type":"string","maxLength":200,"example":"celimax.korea"}},{"name":"platform","in":"query","required":false,"description":"Which collab edges answer.","schema":{"type":"string","enum":["instagram","tiktok"],"default":"instagram"},"examples":{"default":{"value":"instagram","x-disabled":true}}},{"name":"limit","in":"query","required":false,"description":"Creators per page.","schema":{"type":"integer","minimum":1,"maximum":1000,"default":100},"examples":{"default":{"value":100,"x-disabled":true}}},{"name":"offset","in":"query","required":false,"description":"Creators to skip.","schema":{"type":"integer","minimum":0,"maximum":1000000,"default":0},"examples":{"default":{"value":0,"x-disabled":true}}}],"responses":{"200":{"description":"Success. The example is a captured response; long lists are truncated.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"array","items":{"type":"object","additionalProperties":true}},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":[{"username":"skincarerelief","full_name":"Skincare Relief","followers":98169,"profile_pic_url":"https://scontent-lga3-2.cdninstagram.com/v/t51.82787-19/610658136_18391508929178705_4934542462729278746_n.jpg?stp=dst-jpg_s320x320_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby4xMDgwLmMyIn0&_nc_ht=scontent-lga3-2.cdninstagram.com&_nc_cat=105&_nc_oc=Q6cZ2gEHJvA7_g6n0RbMBE9r9eRtm841Z6mGBkx5hRKIV70SKTk4a9g76p8CqaGgtTtNSeo&_nc_ohc=QDPfdDclWkIQ7kNvwFkGc2F&_nc_gid=D8TPC-yORn_J4j3qJMLlvw&edm=AOQ1c0wBAAAA&ccb=7-5&oh=00_AQNQu7sehJG-7PLJUTOGm5ZEoLoWaoph62A2Kc04Srdybg&oe=6AD25BBD&_nc_sid=8b3546","mention_count":48,"last_collab_at":"2026-10-08T15:50:54Z"},{"username":"michlopez.hjs","full_name":"Mich","followers":1321,"profile_pic_url":"https://instagram.fman1-2.fna.fbcdn.net/v/t51.2885-19/347469170_3617013081912709_5765044170353899033_n.jpg?stp=dst-jpg_e0_s150x150_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby4xMDgwLmMyIn0&_nc_ht=instagram.fman1-2.fna.fbcdn.net&_nc_cat=101&_nc_oc=Q6cZ2gEDMw_HbPhM0MuJVo9vShNsuolBQ1Kcl8aTWosqHXOJmRWzmtbiSxVUMih7M8YV_TI&_nc_ohc=TOaDuNw0zigQ7kNvwEJWemm&_nc_gid=QHiE5KdL6EPvz822BH2kEQ&edm=ACWDqb8BAAAA&ccb=7-5&oh=00_AQP-ajCzP0gP6n67PnSomEVxmIKkBf03PiDJPAuFm1o8Pw&oe=6ACFBAA0&_nc_sid=ee9879","mention_count":21,"last_collab_at":"2025-12-05T02:20:23Z"},{"username":"sujana_suju_","full_name":"Sujana Jaman | UGC creator | Bangladesh 🇧🇩","followers":884,"profile_pic_url":"https://instagram.fman1-1.fna.fbcdn.net/v/t51.82787-19/636865773_18325701379247152_575507823501394879_n.jpg?stp=dst-jpg_e0_s150x150_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby4xMDgwLmMyIn0&_nc_ht=instagram.fman1-1.fna.fbcdn.net&_nc_cat=104&_nc_oc=Q6cZ2gEnMXtYX16lNyPlrUTl3CvMGy9NuTUFR-Eg4fJ43B4lKabFJ0SmQsyFSHZACcJX9dM&_nc_ohc=fIbibyhBNnIQ7kNvwGzenB-&_nc_gid=tjEoz56-lDfdKUgh1382Ww&edm=ACWDqb8BAAAA&ccb=7-5&oh=00_AQN9iC3crCHAw5ByvMHJsYDa6ZG-NFQ4EFwH5IcrEmNDsQ&oe=6AD26DD3&_nc_sid=ee9879","mention_count":21,"last_collab_at":"2026-06-20T06:36:06Z"}],"meta":{"cost":"$0.0010","balance":"$474.5888","request_id":"req_43084ce00f80f621645c423528fa191f"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/contacts/find/fast":{"post":{"tags":["Contacts"],"operationId":"contactsFindFast","summary":"Find contacts (fast)","x-dashboard-cost":"$0.02","description":"Everything you know about one creator or brand goes in: handles, profile URLs, emails, websites, phones or a name.\n\nThe fast level answers within 2 seconds. It reads the stored answer first, the profile when that is missing or older than 21 days, then the link pages the profile declares, and types and ranks what it finds by rule. It calls no model. Measured 2026-11-07 on a 60-subject hand-annotated validation set: precision 1.00, recall 0.52, top-1 0.72, p90 1.82 s.\n\nThe answer is one subject: every email with its rank, type (`business`, `management`, `press`, …), `contactable` flag, confidence, owner, the evidence pages it came from and its MX/SMTP check; `best_email` is the first active contactable one. It also carries the linked social handles, websites, link pages and phones, and a `run` report of the pages read, any model call and its cost. An answer with no contactable email (`best_email` null) is free.\n\n`freshness`: `auto` (default) answers from the stored answer when it is fresh enough and runs otherwise, `refresh` always runs, `stored` never runs. The price is the same.","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContactFindRequest"},"example":{"handles":[{"platform":"instagram","handle":"everydayoc"}],"freshness":"auto"}}}},"responses":{"200":{"description":"One contact finder result.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/ContactFindResult"},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"outcome":"found","subject":{"profile_id":884688,"linked_profile_ids":[50764491],"kind":"creator","private":false,"display_name":"Claire O’Callaghan","primary":{"platform":"instagram","handle":"everydayoc"}},"best_email":"teamclaire@pontefirm.com","emails":[{"address":"teamclaire@pontefirm.com","rank":1,"type":"management","contactable":true,"confidence":0.95,"owner":"representative","status":"active","link":"declared_by_subject","evidence":[{"url":"https://www.instagram.com/everydayoc/","where":"ig_bio","quote":"Collabs: teamclaire@pontefirm.com | Styling: Claire.styledbyclaire@gmail.com","kind":"declared_by_subject","hops":0,"seen_at":"2026-11-07T09:11:44Z"}],"verification":{"mx":"present","smtp":"risky","checked_at":"2026-11-07T09:11:44Z"},"shared_with":0,"first_seen_at":"2026-10-18T05:35:40Z","last_seen_at":"2026-11-07T09:11:44Z"},{"address":"talent@pontefirm.com","rank":2,"type":"management","contactable":true,"confidence":0.9,"owner":"representative","status":"active","link":"declared_by_linked","evidence":[{"url":"https://www.tiktok.com/@everydayoc","where":"tt_bio","quote":"Collaborations: Talent@pontefirm.com","kind":"declared_by_linked","hops":1,"seen_at":"2026-11-07T10:05:00Z"}],"verification":{"mx":"present","smtp":"risky","checked_at":null},"shared_with":68,"first_seen_at":"2026-10-07T02:38:08Z","last_seen_at":"2026-11-07T10:05:00Z"},{"address":"claire.styledbyclaire@gmail.com","rank":3,"type":"business","contactable":true,"confidence":0.85,"owner":"subject","status":"active","link":"declared_by_subject","evidence":[{"url":"https://www.instagram.com/everydayoc/","where":"ig_bio","quote":"Collabs: teamclaire@pontefirm.com | Styling: Claire.styledbyclaire@gmail.com","kind":"declared_by_subject","hops":0,"seen_at":"2026-11-07T09:11:44Z"}],"verification":{"mx":"present","smtp":"deliverable","checked_at":"2026-11-07T09:11:44Z"},"shared_with":0,"first_seen_at":"2026-10-18T05:35:40Z","last_seen_at":"2026-11-07T09:11:44Z"},{"address":"claire.everydayoc@gmail.com","rank":4,"type":"business","contactable":true,"confidence":0.8,"owner":"subject","status":"active","link":"declared_by_linked","evidence":[{"url":"https://www.tiktok.com/@everydayoc","where":"tt_bio","quote":"Styling: Claire.everydayoc@gmail.com","kind":"declared_by_linked","hops":1,"seen_at":"2026-11-07T10:05:00Z"}],"verification":{"mx":"present","smtp":"deliverable","checked_at":null},"shared_with":1,"first_seen_at":"2026-10-07T02:38:08Z","last_seen_at":"2026-11-07T10:05:00Z"}],"handles":{"instagram":[{"handle":"everydayoc","url":"https://www.instagram.com/everydayoc/","link":"input","confidence":1,"tracked":true,"evidence":[]}],"tiktok":[{"handle":"everydayoc","url":"https://www.tiktok.com/@everydayoc","link":"guessed_page_reciprocal","confidence":0.9,"tracked":true,"evidence":[{"url":"https://www.tiktok.com/@everydayoc","where":"tt_bio","quote":"✨More on my IG @everydayoc✨ links too!","kind":"guessed_page_reciprocal","hops":1,"seen_at":"2026-11-07T10:05:00Z"}]}],"youtube":[],"x":[],"facebook":[],"threads":[],"linkedin":[],"pinterest":[],"snapchat":[],"twitch":[]},"websites":[{"url":"https://shopmy.us/everydayoc","kind":"shop","link":"declared_by_subject","evidence":[{"url":"https://www.instagram.com/everydayoc/","where":"ig_bio","quote":"link in bio: shopmy.us/everydayoc","kind":"declared_by_subject","hops":0,"seen_at":"2026-11-07T09:11:44Z"}]}],"link_pages":[{"url":"https://coreli.ai/everydayoc","host":"coreli.ai","link":"declared_by_subject","evidence":[{"url":"https://www.instagram.com/everydayoc/","where":"ig_bio","quote":"link in bio: coreli.ai/everydayoc","kind":"declared_by_subject","hops":0,"seen_at":"2026-11-07T09:11:44Z"}]},{"url":"https://linktr.ee/Styledbyclaire","host":"linktr.ee","link":"declared_by_linked","evidence":[{"url":"https://www.tiktok.com/@everydayoc","where":"tt_bio","quote":"bio link: linktr.ee/Styledbyclaire","kind":"declared_by_linked","hops":1,"seen_at":"2026-11-07T10:05:00Z"}]}],"phones":[],"run":{"level":"fast","freshness":"auto","budget_ms":2000,"elapsed_ms":1290,"partial":false,"stored":{"hit":false,"read_ms":90,"last_run_at":"2026-11-07T09:11:44Z","last_run_level":"fast"},"pages_read":4,"pages":[{"url":"https://www.tiktok.com/@everydayoc","why":"sibling_profile","outcome":"ok","status":200,"ms":340},{"url":"https://coreli.ai/everydayoc","why":"declared_link","outcome":"ok","status":200,"ms":1160},{"url":"https://shopmy.us/everydayoc","why":"declared_link","outcome":"ok","status":200,"ms":160},{"url":"https://everydayoc.my.canva.site/","why":"guessed_hub","outcome":"not_owned","status":200,"ms":70},{"url":"https://linktr.ee/Styledbyclaire","why":"declared_link","outcome":"blocked","status":403,"ms":0}],"ai_calls":[],"search_calls":[],"cost_usd":0,"skipped":[{"step":"own_profile_live_read","reason":"not_needed"},{"step":"pool_read https://linktr.ee/Styledbyclaire","reason":"budget"},{"step":"adjudicate_guessed_page https://everydayoc.my.canva.site/","reason":"level"}],"engine_version":"contact-find-v1"}},"meta":{"cost":"$0.0200","balance":"$0.9800","request_id":"req_8ae11a03840a4ea9c8e106e41176f50d"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/contacts/find/thorough":{"post":{"tags":["Contacts"],"operationId":"contactsFindThorough","summary":"Find contacts (thorough)","x-dashboard-cost":"$0.05","description":"Everything you know about one creator or brand goes in: handles, profile URLs, emails, websites, phones or a name.\n\nThe thorough level answers within about 30 seconds. It runs the deep walk (sibling accounts, contact pages on proven domains, a web search) beside the fast gather, pools both sets of candidates with their source pages, and has one model call type, rank and drop them; it can only return addresses present on those pages. Measured on the same set: precision 0.97, recall 0.77, top-1 0.87, p99 27.5 s.\n\nThe answer is one subject: every email with its rank, type (`business`, `management`, `press`, …), `contactable` flag, confidence, owner, the evidence pages it came from and its MX/SMTP check; `best_email` is the first active contactable one. It also carries the linked social handles, websites, link pages and phones, and a `run` report of the pages read, any model call and its cost. An answer with no contactable email (`best_email` null) is free.\n\n`freshness`: `auto` (default) answers from the stored answer when it is fresh enough and runs otherwise, `refresh` always runs, `stored` never runs. The price is the same.","security":[{"bearerAuth":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContactFindRequest"},"example":{"handles":[{"platform":"instagram","handle":"everydayoc"}],"freshness":"auto"}}}},"responses":{"200":{"description":"One contact finder result.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/ContactFindResult"},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"outcome":"found","subject":{"profile_id":884688,"linked_profile_ids":[50764491],"kind":"creator","private":false,"display_name":"Claire O’Callaghan","primary":{"platform":"instagram","handle":"everydayoc"}},"best_email":"teamclaire@pontefirm.com","emails":[{"address":"teamclaire@pontefirm.com","rank":1,"type":"management","contactable":true,"confidence":0.95,"owner":"representative","status":"active","link":"declared_by_subject","evidence":[{"url":"https://www.instagram.com/everydayoc/","where":"ig_bio","quote":"Collabs: teamclaire@pontefirm.com | Styling: Claire.styledbyclaire@gmail.com","kind":"declared_by_subject","hops":0,"seen_at":"2026-11-07T09:11:44Z"}],"verification":{"mx":"present","smtp":"risky","checked_at":"2026-11-07T09:11:44Z"},"shared_with":0,"first_seen_at":"2026-10-18T05:35:40Z","last_seen_at":"2026-11-07T09:11:44Z"},{"address":"talent@pontefirm.com","rank":2,"type":"management","contactable":true,"confidence":0.9,"owner":"representative","status":"active","link":"declared_by_linked","evidence":[{"url":"https://www.tiktok.com/@everydayoc","where":"tt_bio","quote":"Collaborations: Talent@pontefirm.com","kind":"declared_by_linked","hops":1,"seen_at":"2026-11-07T10:05:00Z"}],"verification":{"mx":"present","smtp":"risky","checked_at":null},"shared_with":68,"first_seen_at":"2026-10-07T02:38:08Z","last_seen_at":"2026-11-07T10:05:00Z"},{"address":"claire.styledbyclaire@gmail.com","rank":3,"type":"business","contactable":true,"confidence":0.85,"owner":"subject","status":"active","link":"declared_by_subject","evidence":[{"url":"https://www.instagram.com/everydayoc/","where":"ig_bio","quote":"Collabs: teamclaire@pontefirm.com | Styling: Claire.styledbyclaire@gmail.com","kind":"declared_by_subject","hops":0,"seen_at":"2026-11-07T09:11:44Z"}],"verification":{"mx":"present","smtp":"deliverable","checked_at":"2026-11-07T09:11:44Z"},"shared_with":0,"first_seen_at":"2026-10-18T05:35:40Z","last_seen_at":"2026-11-07T09:11:44Z"},{"address":"claire.everydayoc@gmail.com","rank":4,"type":"business","contactable":true,"confidence":0.8,"owner":"subject","status":"active","link":"declared_by_linked","evidence":[{"url":"https://www.tiktok.com/@everydayoc","where":"tt_bio","quote":"Styling: Claire.everydayoc@gmail.com","kind":"declared_by_linked","hops":1,"seen_at":"2026-11-07T10:05:00Z"}],"verification":{"mx":"present","smtp":"deliverable","checked_at":null},"shared_with":1,"first_seen_at":"2026-10-07T02:38:08Z","last_seen_at":"2026-11-07T10:05:00Z"}],"handles":{"instagram":[{"handle":"everydayoc","url":"https://www.instagram.com/everydayoc/","link":"input","confidence":1,"tracked":true,"evidence":[]}],"tiktok":[{"handle":"everydayoc","url":"https://www.tiktok.com/@everydayoc","link":"guessed_page_reciprocal","confidence":0.9,"tracked":true,"evidence":[{"url":"https://www.tiktok.com/@everydayoc","where":"tt_bio","quote":"✨More on my IG @everydayoc✨ links too!","kind":"guessed_page_reciprocal","hops":1,"seen_at":"2026-11-07T10:05:00Z"}]}],"youtube":[],"x":[],"facebook":[],"threads":[],"linkedin":[],"pinterest":[],"snapchat":[],"twitch":[]},"websites":[{"url":"https://shopmy.us/everydayoc","kind":"shop","link":"declared_by_subject","evidence":[{"url":"https://www.instagram.com/everydayoc/","where":"ig_bio","quote":"link in bio: shopmy.us/everydayoc","kind":"declared_by_subject","hops":0,"seen_at":"2026-11-07T09:11:44Z"}]}],"link_pages":[{"url":"https://coreli.ai/everydayoc","host":"coreli.ai","link":"declared_by_subject","evidence":[{"url":"https://www.instagram.com/everydayoc/","where":"ig_bio","quote":"link in bio: coreli.ai/everydayoc","kind":"declared_by_subject","hops":0,"seen_at":"2026-11-07T09:11:44Z"}]},{"url":"https://linktr.ee/Styledbyclaire","host":"linktr.ee","link":"declared_by_linked","evidence":[{"url":"https://www.tiktok.com/@everydayoc","where":"tt_bio","quote":"bio link: linktr.ee/Styledbyclaire","kind":"declared_by_linked","hops":1,"seen_at":"2026-11-07T10:05:00Z"}]}],"phones":[],"run":{"level":"thorough","freshness":"auto","budget_ms":30000,"elapsed_ms":1290,"partial":false,"stored":{"hit":false,"read_ms":90,"last_run_at":"2026-11-07T09:11:44Z","last_run_level":"fast"},"pages_read":4,"pages":[{"url":"https://www.tiktok.com/@everydayoc","why":"sibling_profile","outcome":"ok","status":200,"ms":340},{"url":"https://coreli.ai/everydayoc","why":"declared_link","outcome":"ok","status":200,"ms":1160},{"url":"https://shopmy.us/everydayoc","why":"declared_link","outcome":"ok","status":200,"ms":160},{"url":"https://everydayoc.my.canva.site/","why":"guessed_hub","outcome":"not_owned","status":200,"ms":70},{"url":"https://linktr.ee/Styledbyclaire","why":"declared_link","outcome":"blocked","status":403,"ms":0}],"ai_calls":[],"search_calls":[],"cost_usd":0,"skipped":[{"step":"own_profile_live_read","reason":"not_needed"},{"step":"pool_read https://linktr.ee/Styledbyclaire","reason":"budget"}],"engine_version":"contact-find-v1"}},"meta":{"cost":"$0.0500","balance":"$0.9500","request_id":"req_8ae11a03840a4ea9c8e106e41176f50d"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/contacts/find-from-instagram/fast":{"get":{"tags":["Contacts"],"operationId":"contactsFindFromInstagramFast","summary":"Find contacts from Instagram (fast)","x-dashboard-cost":"$0.02","description":"The general find with one Instagram account as the subject.\n\nThe fast level answers within 2 seconds. It reads the stored answer first, the profile when that is missing or older than 21 days, then the link pages the profile declares, and types and ranks what it finds by rule. It calls no model. Measured 2026-11-07 on a 60-subject hand-annotated validation set: precision 1.00, recall 0.52, top-1 0.72, p90 1.82 s.\n\nThe answer is one subject: every email with its rank, type (`business`, `management`, `press`, …), `contactable` flag, confidence, owner, the evidence pages it came from and its MX/SMTP check; `best_email` is the first active contactable one. It also carries the linked social handles, websites, link pages and phones, and a `run` report of the pages read, any model call and its cost. An answer with no contactable email (`best_email` null) is free.\n\n`freshness`: `auto` (default) answers from the stored answer when it is fresh enough and runs otherwise, `refresh` always runs, `stored` never runs. The price is the same.","security":[{"bearerAuth":[]}],"parameters":[{"name":"q","in":"query","required":true,"description":"Handle, @handle or profile URL.","schema":{"type":"string"},"example":"everydayoc"},{"name":"freshness","in":"query","required":false,"description":"`auto`, `refresh` or `stored`. Same price.","schema":{"type":"string","enum":["auto","refresh","stored"],"default":"auto"},"examples":{"default":{"value":"auto","x-disabled":true}}}],"responses":{"200":{"description":"One contact finder result.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/ContactFindResult"},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"outcome":"found","subject":{"profile_id":884688,"linked_profile_ids":[50764491],"kind":"creator","private":false,"display_name":"Claire O’Callaghan","primary":{"platform":"instagram","handle":"everydayoc"}},"best_email":"teamclaire@pontefirm.com","emails":[{"address":"teamclaire@pontefirm.com","rank":1,"type":"management","contactable":true,"confidence":0.95,"owner":"representative","status":"active","link":"declared_by_subject","evidence":[{"url":"https://www.instagram.com/everydayoc/","where":"ig_bio","quote":"Collabs: teamclaire@pontefirm.com | Styling: Claire.styledbyclaire@gmail.com","kind":"declared_by_subject","hops":0,"seen_at":"2026-11-07T09:11:44Z"}],"verification":{"mx":"present","smtp":"risky","checked_at":"2026-11-07T09:11:44Z"},"shared_with":0,"first_seen_at":"2026-10-18T05:35:40Z","last_seen_at":"2026-11-07T09:11:44Z"},{"address":"talent@pontefirm.com","rank":2,"type":"management","contactable":true,"confidence":0.9,"owner":"representative","status":"active","link":"declared_by_linked","evidence":[{"url":"https://www.tiktok.com/@everydayoc","where":"tt_bio","quote":"Collaborations: Talent@pontefirm.com","kind":"declared_by_linked","hops":1,"seen_at":"2026-11-07T10:05:00Z"}],"verification":{"mx":"present","smtp":"risky","checked_at":null},"shared_with":68,"first_seen_at":"2026-10-07T02:38:08Z","last_seen_at":"2026-11-07T10:05:00Z"},{"address":"claire.styledbyclaire@gmail.com","rank":3,"type":"business","contactable":true,"confidence":0.85,"owner":"subject","status":"active","link":"declared_by_subject","evidence":[{"url":"https://www.instagram.com/everydayoc/","where":"ig_bio","quote":"Collabs: teamclaire@pontefirm.com | Styling: Claire.styledbyclaire@gmail.com","kind":"declared_by_subject","hops":0,"seen_at":"2026-11-07T09:11:44Z"}],"verification":{"mx":"present","smtp":"deliverable","checked_at":"2026-11-07T09:11:44Z"},"shared_with":0,"first_seen_at":"2026-10-18T05:35:40Z","last_seen_at":"2026-11-07T09:11:44Z"},{"address":"claire.everydayoc@gmail.com","rank":4,"type":"business","contactable":true,"confidence":0.8,"owner":"subject","status":"active","link":"declared_by_linked","evidence":[{"url":"https://www.tiktok.com/@everydayoc","where":"tt_bio","quote":"Styling: Claire.everydayoc@gmail.com","kind":"declared_by_linked","hops":1,"seen_at":"2026-11-07T10:05:00Z"}],"verification":{"mx":"present","smtp":"deliverable","checked_at":null},"shared_with":1,"first_seen_at":"2026-10-07T02:38:08Z","last_seen_at":"2026-11-07T10:05:00Z"}],"handles":{"instagram":[{"handle":"everydayoc","url":"https://www.instagram.com/everydayoc/","link":"input","confidence":1,"tracked":true,"evidence":[]}],"tiktok":[{"handle":"everydayoc","url":"https://www.tiktok.com/@everydayoc","link":"guessed_page_reciprocal","confidence":0.9,"tracked":true,"evidence":[{"url":"https://www.tiktok.com/@everydayoc","where":"tt_bio","quote":"✨More on my IG @everydayoc✨ links too!","kind":"guessed_page_reciprocal","hops":1,"seen_at":"2026-11-07T10:05:00Z"}]}],"youtube":[],"x":[],"facebook":[],"threads":[],"linkedin":[],"pinterest":[],"snapchat":[],"twitch":[]},"websites":[{"url":"https://shopmy.us/everydayoc","kind":"shop","link":"declared_by_subject","evidence":[{"url":"https://www.instagram.com/everydayoc/","where":"ig_bio","quote":"link in bio: shopmy.us/everydayoc","kind":"declared_by_subject","hops":0,"seen_at":"2026-11-07T09:11:44Z"}]}],"link_pages":[{"url":"https://coreli.ai/everydayoc","host":"coreli.ai","link":"declared_by_subject","evidence":[{"url":"https://www.instagram.com/everydayoc/","where":"ig_bio","quote":"link in bio: coreli.ai/everydayoc","kind":"declared_by_subject","hops":0,"seen_at":"2026-11-07T09:11:44Z"}]},{"url":"https://linktr.ee/Styledbyclaire","host":"linktr.ee","link":"declared_by_linked","evidence":[{"url":"https://www.tiktok.com/@everydayoc","where":"tt_bio","quote":"bio link: linktr.ee/Styledbyclaire","kind":"declared_by_linked","hops":1,"seen_at":"2026-11-07T10:05:00Z"}]}],"phones":[],"run":{"level":"fast","freshness":"auto","budget_ms":2000,"elapsed_ms":1290,"partial":false,"stored":{"hit":false,"read_ms":90,"last_run_at":"2026-11-07T09:11:44Z","last_run_level":"fast"},"pages_read":4,"pages":[{"url":"https://www.tiktok.com/@everydayoc","why":"sibling_profile","outcome":"ok","status":200,"ms":340},{"url":"https://coreli.ai/everydayoc","why":"declared_link","outcome":"ok","status":200,"ms":1160},{"url":"https://shopmy.us/everydayoc","why":"declared_link","outcome":"ok","status":200,"ms":160},{"url":"https://everydayoc.my.canva.site/","why":"guessed_hub","outcome":"not_owned","status":200,"ms":70},{"url":"https://linktr.ee/Styledbyclaire","why":"declared_link","outcome":"blocked","status":403,"ms":0}],"ai_calls":[],"search_calls":[],"cost_usd":0,"skipped":[{"step":"own_profile_live_read","reason":"not_needed"},{"step":"pool_read https://linktr.ee/Styledbyclaire","reason":"budget"},{"step":"adjudicate_guessed_page https://everydayoc.my.canva.site/","reason":"level"}],"engine_version":"contact-find-v1"}},"meta":{"cost":"$0.0200","balance":"$0.9800","request_id":"req_8ae11a03840a4ea9c8e106e41176f50d"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/contacts/find-from-instagram/thorough":{"get":{"tags":["Contacts"],"operationId":"contactsFindFromInstagramThorough","summary":"Find contacts from Instagram (thorough)","x-dashboard-cost":"$0.05","description":"The general find with one Instagram account as the subject.\n\nThe thorough level answers within about 30 seconds. It runs the deep walk (sibling accounts, contact pages on proven domains, a web search) beside the fast gather, pools both sets of candidates with their source pages, and has one model call type, rank and drop them; it can only return addresses present on those pages. Measured on the same set: precision 0.97, recall 0.77, top-1 0.87, p99 27.5 s.\n\nThe answer is one subject: every email with its rank, type (`business`, `management`, `press`, …), `contactable` flag, confidence, owner, the evidence pages it came from and its MX/SMTP check; `best_email` is the first active contactable one. It also carries the linked social handles, websites, link pages and phones, and a `run` report of the pages read, any model call and its cost. An answer with no contactable email (`best_email` null) is free.\n\n`freshness`: `auto` (default) answers from the stored answer when it is fresh enough and runs otherwise, `refresh` always runs, `stored` never runs. The price is the same.","security":[{"bearerAuth":[]}],"parameters":[{"name":"q","in":"query","required":true,"description":"Handle, @handle or profile URL.","schema":{"type":"string"},"example":"everydayoc"},{"name":"freshness","in":"query","required":false,"description":"`auto`, `refresh` or `stored`. Same price.","schema":{"type":"string","enum":["auto","refresh","stored"],"default":"auto"},"examples":{"default":{"value":"auto","x-disabled":true}}}],"responses":{"200":{"description":"One contact finder result.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/ContactFindResult"},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"outcome":"found","subject":{"profile_id":884688,"linked_profile_ids":[50764491],"kind":"creator","private":false,"display_name":"Claire O’Callaghan","primary":{"platform":"instagram","handle":"everydayoc"}},"best_email":"teamclaire@pontefirm.com","emails":[{"address":"teamclaire@pontefirm.com","rank":1,"type":"management","contactable":true,"confidence":0.95,"owner":"representative","status":"active","link":"declared_by_subject","evidence":[{"url":"https://www.instagram.com/everydayoc/","where":"ig_bio","quote":"Collabs: teamclaire@pontefirm.com | Styling: Claire.styledbyclaire@gmail.com","kind":"declared_by_subject","hops":0,"seen_at":"2026-11-07T09:11:44Z"}],"verification":{"mx":"present","smtp":"risky","checked_at":"2026-11-07T09:11:44Z"},"shared_with":0,"first_seen_at":"2026-10-18T05:35:40Z","last_seen_at":"2026-11-07T09:11:44Z"},{"address":"talent@pontefirm.com","rank":2,"type":"management","contactable":true,"confidence":0.9,"owner":"representative","status":"active","link":"declared_by_linked","evidence":[{"url":"https://www.tiktok.com/@everydayoc","where":"tt_bio","quote":"Collaborations: Talent@pontefirm.com","kind":"declared_by_linked","hops":1,"seen_at":"2026-11-07T10:05:00Z"}],"verification":{"mx":"present","smtp":"risky","checked_at":null},"shared_with":68,"first_seen_at":"2026-10-07T02:38:08Z","last_seen_at":"2026-11-07T10:05:00Z"},{"address":"claire.styledbyclaire@gmail.com","rank":3,"type":"business","contactable":true,"confidence":0.85,"owner":"subject","status":"active","link":"declared_by_subject","evidence":[{"url":"https://www.instagram.com/everydayoc/","where":"ig_bio","quote":"Collabs: teamclaire@pontefirm.com | Styling: Claire.styledbyclaire@gmail.com","kind":"declared_by_subject","hops":0,"seen_at":"2026-11-07T09:11:44Z"}],"verification":{"mx":"present","smtp":"deliverable","checked_at":"2026-11-07T09:11:44Z"},"shared_with":0,"first_seen_at":"2026-10-18T05:35:40Z","last_seen_at":"2026-11-07T09:11:44Z"},{"address":"claire.everydayoc@gmail.com","rank":4,"type":"business","contactable":true,"confidence":0.8,"owner":"subject","status":"active","link":"declared_by_linked","evidence":[{"url":"https://www.tiktok.com/@everydayoc","where":"tt_bio","quote":"Styling: Claire.everydayoc@gmail.com","kind":"declared_by_linked","hops":1,"seen_at":"2026-11-07T10:05:00Z"}],"verification":{"mx":"present","smtp":"deliverable","checked_at":null},"shared_with":1,"first_seen_at":"2026-10-07T02:38:08Z","last_seen_at":"2026-11-07T10:05:00Z"}],"handles":{"instagram":[{"handle":"everydayoc","url":"https://www.instagram.com/everydayoc/","link":"input","confidence":1,"tracked":true,"evidence":[]}],"tiktok":[{"handle":"everydayoc","url":"https://www.tiktok.com/@everydayoc","link":"guessed_page_reciprocal","confidence":0.9,"tracked":true,"evidence":[{"url":"https://www.tiktok.com/@everydayoc","where":"tt_bio","quote":"✨More on my IG @everydayoc✨ links too!","kind":"guessed_page_reciprocal","hops":1,"seen_at":"2026-11-07T10:05:00Z"}]}],"youtube":[],"x":[],"facebook":[],"threads":[],"linkedin":[],"pinterest":[],"snapchat":[],"twitch":[]},"websites":[{"url":"https://shopmy.us/everydayoc","kind":"shop","link":"declared_by_subject","evidence":[{"url":"https://www.instagram.com/everydayoc/","where":"ig_bio","quote":"link in bio: shopmy.us/everydayoc","kind":"declared_by_subject","hops":0,"seen_at":"2026-11-07T09:11:44Z"}]}],"link_pages":[{"url":"https://coreli.ai/everydayoc","host":"coreli.ai","link":"declared_by_subject","evidence":[{"url":"https://www.instagram.com/everydayoc/","where":"ig_bio","quote":"link in bio: coreli.ai/everydayoc","kind":"declared_by_subject","hops":0,"seen_at":"2026-11-07T09:11:44Z"}]},{"url":"https://linktr.ee/Styledbyclaire","host":"linktr.ee","link":"declared_by_linked","evidence":[{"url":"https://www.tiktok.com/@everydayoc","where":"tt_bio","quote":"bio link: linktr.ee/Styledbyclaire","kind":"declared_by_linked","hops":1,"seen_at":"2026-11-07T10:05:00Z"}]}],"phones":[],"run":{"level":"thorough","freshness":"auto","budget_ms":30000,"elapsed_ms":1290,"partial":false,"stored":{"hit":false,"read_ms":90,"last_run_at":"2026-11-07T09:11:44Z","last_run_level":"fast"},"pages_read":4,"pages":[{"url":"https://www.tiktok.com/@everydayoc","why":"sibling_profile","outcome":"ok","status":200,"ms":340},{"url":"https://coreli.ai/everydayoc","why":"declared_link","outcome":"ok","status":200,"ms":1160},{"url":"https://shopmy.us/everydayoc","why":"declared_link","outcome":"ok","status":200,"ms":160},{"url":"https://everydayoc.my.canva.site/","why":"guessed_hub","outcome":"not_owned","status":200,"ms":70},{"url":"https://linktr.ee/Styledbyclaire","why":"declared_link","outcome":"blocked","status":403,"ms":0}],"ai_calls":[],"search_calls":[],"cost_usd":0,"skipped":[{"step":"own_profile_live_read","reason":"not_needed"},{"step":"pool_read https://linktr.ee/Styledbyclaire","reason":"budget"}],"engine_version":"contact-find-v1"}},"meta":{"cost":"$0.0500","balance":"$0.9500","request_id":"req_8ae11a03840a4ea9c8e106e41176f50d"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/contacts/find-from-tiktok/fast":{"get":{"tags":["Contacts"],"operationId":"contactsFindFromTiktokFast","summary":"Find contacts from TikTok (fast)","x-dashboard-cost":"$0.02","description":"The general find with one TikTok account as the subject.\n\nThe fast level answers within 2 seconds. It reads the stored answer first, the profile when that is missing or older than 21 days, then the link pages the profile declares, and types and ranks what it finds by rule. It calls no model. Measured 2026-11-07 on a 60-subject hand-annotated validation set: precision 1.00, recall 0.52, top-1 0.72, p90 1.82 s.\n\nThe answer is one subject: every email with its rank, type (`business`, `management`, `press`, …), `contactable` flag, confidence, owner, the evidence pages it came from and its MX/SMTP check; `best_email` is the first active contactable one. It also carries the linked social handles, websites, link pages and phones, and a `run` report of the pages read, any model call and its cost. An answer with no contactable email (`best_email` null) is free.\n\n`freshness`: `auto` (default) answers from the stored answer when it is fresh enough and runs otherwise, `refresh` always runs, `stored` never runs. The price is the same.","security":[{"bearerAuth":[]}],"parameters":[{"name":"q","in":"query","required":true,"description":"Handle, @handle or profile URL.","schema":{"type":"string"},"example":"everydayoc"},{"name":"freshness","in":"query","required":false,"description":"`auto`, `refresh` or `stored`. Same price.","schema":{"type":"string","enum":["auto","refresh","stored"],"default":"auto"},"examples":{"default":{"value":"auto","x-disabled":true}}}],"responses":{"200":{"description":"One contact finder result.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/ContactFindResult"},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"outcome":"found","subject":{"profile_id":50764491,"linked_profile_ids":[],"kind":"unknown","private":false,"display_name":"Everydayoc","primary":{"platform":"tiktok","handle":"everydayoc"}},"best_email":"claire.everydayoc@gmail.com","emails":[{"address":"claire.everydayoc@gmail.com","rank":1,"type":"business","contactable":true,"confidence":0.9900000095367432,"owner":"subject","status":"active","link":"declared_by_subject","evidence":[{"url":"https://www.tiktok.com/@everydayoc","where":"other","quote":"engine surface own_profile: ✨More on my IG @everydayoc✨ links too! Collaborations: Talent@pontefirm.com Styling: Claire.everydayoc@gmail.com","kind":"declared_by_subject","hops":0,"seen_at":"2026-11-10T01:47:06.904237Z"}],"verification":{"mx":"present","smtp":"unchecked","checked_at":"2026-11-13T14:26:44.914698Z"},"shared_with":1,"first_seen_at":"2026-10-21T20:08:29.141185Z","last_seen_at":"2026-11-13T14:26:44.914698Z"},{"address":"talent@pontefirm.com","rank":2,"type":"management","contactable":true,"confidence":0.9900000095367432,"owner":"representative","status":"active","link":"declared_by_subject","evidence":[{"url":"https://www.tiktok.com/@everydayoc","where":"other","quote":"engine surface own_profile: ✨More on my IG @everydayoc✨ links too! Collaborations: Talent@pontefirm.com Styling: Claire.everydayoc@gmail.com","kind":"declared_by_subject","hops":0,"seen_at":"2026-11-10T01:47:06.904237Z"}],"verification":{"mx":"present","smtp":"unchecked","checked_at":"2026-11-13T14:26:44.914698Z"},"shared_with":56,"first_seen_at":"2026-10-21T20:08:29.141185Z","last_seen_at":"2026-11-13T14:26:44.914698Z"}],"handles":{"instagram":[],"tiktok":[{"handle":"everydayoc","url":"https://www.tiktok.com/@everydayoc","link":"declared_by_linked","confidence":0.94,"tracked":true,"evidence":[{"url":"https://www.tiktok.com/@everydayoc","where":"other","quote":"","kind":"declared_by_linked","hops":1,"seen_at":"2026-11-13T14:26:44.914698Z"}]}],"youtube":[],"x":[],"facebook":[],"threads":[],"linkedin":[],"pinterest":[],"snapchat":[],"twitch":[]},"websites":[],"link_pages":[],"phones":[],"run":{"level":"fast","freshness":"auto","budget_ms":1900,"elapsed_ms":107,"partial":false,"stored":{"hit":true,"read_ms":15,"last_run_at":"2026-11-10T01:47:06.892198Z","last_run_level":"thorough"},"pages_read":0,"pages":[],"ai_calls":[],"search_calls":[],"cost_usd":0,"skipped":[],"engine_version":"contact-find-v1"}},"meta":{"cost":"$0.0200","balance":"$355.7317","request_id":"req_59ab13a7da8d6102d473e0a8af1f4ebb"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/contacts/find-from-tiktok/thorough":{"get":{"tags":["Contacts"],"operationId":"contactsFindFromTiktokThorough","summary":"Find contacts from TikTok (thorough)","x-dashboard-cost":"$0.05","description":"The general find with one TikTok account as the subject.\n\nThe thorough level answers within about 30 seconds. It runs the deep walk (sibling accounts, contact pages on proven domains, a web search) beside the fast gather, pools both sets of candidates with their source pages, and has one model call type, rank and drop them; it can only return addresses present on those pages. Measured on the same set: precision 0.97, recall 0.77, top-1 0.87, p99 27.5 s.\n\nThe answer is one subject: every email with its rank, type (`business`, `management`, `press`, …), `contactable` flag, confidence, owner, the evidence pages it came from and its MX/SMTP check; `best_email` is the first active contactable one. It also carries the linked social handles, websites, link pages and phones, and a `run` report of the pages read, any model call and its cost. An answer with no contactable email (`best_email` null) is free.\n\n`freshness`: `auto` (default) answers from the stored answer when it is fresh enough and runs otherwise, `refresh` always runs, `stored` never runs. The price is the same.","security":[{"bearerAuth":[]}],"parameters":[{"name":"q","in":"query","required":true,"description":"Handle, @handle or profile URL.","schema":{"type":"string"},"example":"everydayoc"},{"name":"freshness","in":"query","required":false,"description":"`auto`, `refresh` or `stored`. Same price.","schema":{"type":"string","enum":["auto","refresh","stored"],"default":"auto"},"examples":{"default":{"value":"auto","x-disabled":true}}}],"responses":{"200":{"description":"One contact finder result.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/ContactFindResult"},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"outcome":"found","subject":{"profile_id":50764491,"linked_profile_ids":[],"kind":"unknown","private":false,"display_name":"Everydayoc","primary":{"platform":"tiktok","handle":"everydayoc"}},"best_email":"claire.everydayoc@gmail.com","emails":[{"address":"claire.everydayoc@gmail.com","rank":1,"type":"business","contactable":true,"confidence":0.9900000095367432,"owner":"subject","status":"active","link":"declared_by_subject","evidence":[{"url":"https://www.tiktok.com/@everydayoc","where":"other","quote":"engine surface own_profile: ✨More on my IG @everydayoc✨ links too! Collaborations: Talent@pontefirm.com Styling: Claire.everydayoc@gmail.com","kind":"declared_by_subject","hops":0,"seen_at":"2026-11-10T01:47:06.904237Z"}],"verification":{"mx":"present","smtp":"unchecked","checked_at":"2026-11-13T14:26:45.579629Z"},"shared_with":1,"first_seen_at":"2026-10-21T20:08:29.141185Z","last_seen_at":"2026-11-13T14:26:45.579629Z"},{"address":"talent@pontefirm.com","rank":2,"type":"management","contactable":true,"confidence":0.9900000095367432,"owner":"representative","status":"active","link":"declared_by_subject","evidence":[{"url":"https://www.tiktok.com/@everydayoc","where":"other","quote":"engine surface own_profile: ✨More on my IG @everydayoc✨ links too! Collaborations: Talent@pontefirm.com Styling: Claire.everydayoc@gmail.com","kind":"declared_by_subject","hops":0,"seen_at":"2026-11-10T01:47:06.904237Z"}],"verification":{"mx":"present","smtp":"unchecked","checked_at":"2026-11-13T14:26:45.579629Z"},"shared_with":56,"first_seen_at":"2026-10-21T20:08:29.141185Z","last_seen_at":"2026-11-13T14:26:45.579629Z"}],"handles":{"instagram":[],"tiktok":[{"handle":"everydayoc","url":"https://www.tiktok.com/@everydayoc","link":"declared_by_linked","confidence":0.94,"tracked":true,"evidence":[{"url":"https://www.tiktok.com/@everydayoc","where":"other","quote":"","kind":"declared_by_linked","hops":1,"seen_at":"2026-11-13T14:26:45.579629Z"}]}],"youtube":[],"x":[],"facebook":[],"threads":[],"linkedin":[],"pinterest":[],"snapchat":[],"twitch":[]},"websites":[],"link_pages":[],"phones":[],"run":{"level":"thorough","freshness":"auto","budget_ms":30000,"elapsed_ms":23,"partial":false,"stored":{"hit":true,"read_ms":7,"last_run_at":"2026-11-10T01:47:06.892198Z","last_run_level":"thorough"},"pages_read":0,"pages":[],"ai_calls":[],"search_calls":[],"cost_usd":0,"skipped":[],"engine_version":"contact-find-v1"}},"meta":{"cost":"$0.0500","balance":"$355.6817","request_id":"req_b4e99b437b38ac73f06666e629c5c2e7"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/contacts/find-from-youtube/fast":{"get":{"tags":["Contacts"],"operationId":"contactsFindFromYoutubeFast","summary":"Find contacts from YouTube (fast)","x-dashboard-cost":"$0.02","description":"The general find with one YouTube account as the subject.\n\nThe fast level answers within 2 seconds. It reads the stored answer first, the profile when that is missing or older than 21 days, then the link pages the profile declares, and types and ranks what it finds by rule. It calls no model. Measured 2026-11-07 on a 60-subject hand-annotated validation set: precision 1.00, recall 0.52, top-1 0.72, p90 1.82 s.\n\nThe answer is one subject: every email with its rank, type (`business`, `management`, `press`, …), `contactable` flag, confidence, owner, the evidence pages it came from and its MX/SMTP check; `best_email` is the first active contactable one. It also carries the linked social handles, websites, link pages and phones, and a `run` report of the pages read, any model call and its cost. An answer with no contactable email (`best_email` null) is free.\n\n`freshness`: `auto` (default) answers from the stored answer when it is fresh enough and runs otherwise, `refresh` always runs, `stored` never runs. The price is the same.","security":[{"bearerAuth":[]}],"parameters":[{"name":"q","in":"query","required":true,"description":"Handle, @handle, channel URL or `UC…` channel id. Case is kept.","schema":{"type":"string"},"example":"mkbhd"},{"name":"freshness","in":"query","required":false,"description":"`auto`, `refresh` or `stored`. Same price.","schema":{"type":"string","enum":["auto","refresh","stored"],"default":"auto"},"examples":{"default":{"value":"auto","x-disabled":true}}}],"responses":{"200":{"description":"One contact finder result.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/ContactFindResult"},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"outcome":"found","subject":{"profile_id":538,"linked_profile_ids":[],"kind":"unknown","private":false,"display_name":"Marques Brownlee","primary":{"platform":"youtube","handle":"mkbhd"}},"best_email":"business@mkbhd.com","emails":[{"address":"business@mkbhd.com","rank":1,"type":"business","contactable":true,"confidence":0.94,"owner":"subject","status":"active","link":"declared_by_subject","evidence":[{"url":"https://www.youtube.com/@mkbhd","where":"yt_about","quote":"| Consumer Electronics | Tech Head | Internet Personality! business@MKBHD.com","kind":"declared_by_subject","hops":0,"seen_at":"2026-11-13T14:27:25.874892Z"}],"verification":{"mx":"present","smtp":"risky","checked_at":"2026-11-13T14:27:25.874892Z"},"shared_with":0,"first_seen_at":"2026-09-29T03:48:43.009638Z","last_seen_at":"2026-11-13T14:27:25.874892Z"},{"address":"podcast@mkbhd.com","rank":2,"type":"management","contactable":true,"confidence":0.94,"owner":"subject","status":"active","link":"declared_by_subject","evidence":[{"url":"https://linktr.ee/mkbhd","where":"other","quote":"","kind":"declared_by_subject","hops":1,"seen_at":"2026-10-12T07:46:02.779193Z"}],"verification":{"mx":"present","smtp":"risky","checked_at":"2026-11-13T14:27:25.877104Z"},"shared_with":0,"first_seen_at":"2026-10-12T07:46:02.779193Z","last_seen_at":"2026-11-13T14:27:25.877104Z"},{"address":"privacy@fourthwall.com","rank":3,"type":"other_role","contactable":false,"confidence":1,"owner":"other","status":"active","link":"own_domain_page","evidence":[{"url":"https://mkbhd.com/pages/privacy-policy","where":"own_site_footer","quote":"icy, please contact us at contact@support.mkbhd.com. For questions about Fourthwall’s own processing of your Personal Information, please contact Fourthwall at privacy@fourthwall.com.</p> </div> </div> </div> </div> </section> </div> <aside data-drawer=\"product\" class=\"drawer\"> <div data-drawer-trig","kind":"own_domain_page","hops":2,"seen_at":"2026-11-13T14:27:10.757117Z"}],"verification":{"mx":"present","smtp":"unchecked","checked_at":"2026-11-13T14:27:25.877104Z"},"shared_with":0,"first_seen_at":"2026-11-13T14:27:10.757117Z","last_seen_at":"2026-11-13T14:27:25.877104Z"},{"address":"contact@support.mkbhd.com","rank":4,"type":"support","contactable":false,"confidence":0.9800000190734863,"owner":"subject","status":"active","link":"own_domain_page","evidence":[{"url":"https://mkbhd.com/pages/contact","where":"own_site_contact","quote":"text\"> <div class=\"html-formatter html-formatter--center\"> <p style=\"text-align: left;\">For all store inquiries, contact&nbsp;<a href=\"mailto:contact@support.mkbhd.com\" rel=\"noopener noreferrer\" target=\"_blank\">contact@support.mkbhd.com</a></p> </div> </div> </div> </div> </section> </div> <aside","kind":"own_domain_page","hops":2,"seen_at":"2026-11-13T14:27:10.757117Z"},{"url":"https://mkbhd.com/pages/privacy-policy","where":"own_site_footer","quote":"and whether we are subject to the applicable data privacy laws of such jurisdiction. To learn more about your rights or to exercise them, please contact us at contact@support.mkbhd.com. We may request you provide us with information necessary to confirm your identity before responding to your reques","kind":"own_domain_page","hops":2,"seen_at":"2026-11-13T14:27:10.757117Z"},{"url":"https://mkbhd.com/pages/terms-of-service","where":"own_site_footer","quote":"for all activities that occur under your account. If you believe that your account is no longer secure, then you must immediately notify us at <a href=\"mailto:contact@support.mkbhd.com\">contact@support.mkbhd.com</a>.</p> <h3 style=\"text-align: left;\">4. Licenses</h3> <p style=\"text-align: left;\"><st","kind":"own_domain_page","hops":2,"seen_at":"2026-11-13T14:27:10.757117Z"}],"verification":{"mx":"present","smtp":"unchecked","checked_at":"2026-11-13T14:27:25.877104Z"},"shared_with":0,"first_seen_at":"2026-11-13T14:27:10.757117Z","last_seen_at":"2026-11-13T14:27:25.877104Z"}],"handles":{"instagram":[{"handle":"mkbhd","url":"https://www.instagram.com/mkbhd/","link":"declared_by_linked","confidence":0.94,"tracked":true,"evidence":[{"url":"https://www.instagram.com/mkbhd/","where":"other","quote":"","kind":"declared_by_linked","hops":1,"seen_at":"2026-11-13T14:27:25.874892Z"}]}],"tiktok":[{"handle":"mkbhd","url":"https://www.tiktok.com/@mkbhd","link":"declared_by_linked","confidence":0.94,"tracked":true,"evidence":[{"url":"https://www.tiktok.com/@mkbhd","where":"other","quote":"","kind":"declared_by_linked","hops":1,"seen_at":"2026-11-13T14:27:25.874892Z"}]}],"youtube":[{"handle":"mkbhd","url":"https://www.youtube.com/@mkbhd","link":"input","confidence":1,"tracked":true,"evidence":[]}],"x":[{"handle":"mkbhd","url":"https://x.com/mkbhd","link":"declared_by_subject","confidence":0.94,"tracked":false,"evidence":[{"url":"https://www.youtube.com/@mkbhd","where":"other","quote":"","kind":"declared_by_subject","hops":0,"seen_at":"2026-11-13T14:27:25.874892Z"}]}],"facebook":[],"threads":[],"linkedin":[],"pinterest":[],"snapchat":[],"twitch":[]},"websites":[{"url":"https://mkbhd.com","kind":"own_site","link":"declared_by_subject","evidence":[{"url":"https://www.youtube.com/@mkbhd","where":"other","quote":"","kind":"declared_by_subject","hops":0,"seen_at":"2026-11-13T14:27:25.874892Z"}]},{"url":"https://discord.gg/MKBHD","kind":"other","link":"declared_by_subject","evidence":[{"url":"https://www.youtube.com/@mkbhd","where":"yt_about","quote":"https://discord.gg/MKBHD","kind":"declared_by_subject","hops":0,"seen_at":"2026-11-13T14:27:10.757117Z"}]},{"url":"https://mkbhd.com/","kind":"own_site","link":"declared_by_subject","evidence":[{"url":"https://www.youtube.com/@mkbhd","where":"other","quote":"","kind":"declared_by_subject","hops":0,"seen_at":"2026-11-13T14:27:02.391117Z"},{"url":"https://www.instagram.com/mkbhd/","where":"ig_bio","quote":"https://mkbhd.com/","kind":"declared_by_linked","hops":1,"seen_at":"2026-11-13T14:27:10.757117Z"}]},{"url":"https://reddit.com/r/MKBHD","kind":"other","link":"declared_by_subject","evidence":[{"url":"https://www.youtube.com/@mkbhd","where":"yt_about","quote":"https://reddit.com/r/MKBHD","kind":"declared_by_subject","hops":0,"seen_at":"2026-11-13T14:27:10.757117Z"}]}],"link_pages":[],"phones":[],"run":{"level":"fast","freshness":"refresh","budget_ms":1900,"elapsed_ms":1351,"partial":false,"stored":{"hit":false,"read_ms":59,"last_run_at":"2026-11-13T14:27:10.732954Z","last_run_level":"thorough"},"pages_read":6,"pages":[{"url":"live profile read","why":"own_profile","outcome":"ok","status":null,"ms":981},{"url":"https://mkbhd.com/","why":"declared_link","outcome":"ok","status":200,"ms":114},{"url":"http://reddit.com/r/MKBHD","why":"declared_link","outcome":"error","status":null,"ms":92},{"url":"http://discord.gg/MKBHD","why":"declared_link","outcome":"ok","status":200,"ms":139},{"url":"https://discord.gg/MKBHD","why":"declared_link","outcome":"ok","status":200,"ms":149},{"url":"https://reddit.com/r/MKBHD","why":"declared_link","outcome":"error","status":null,"ms":85}],"ai_calls":[],"search_calls":[],"cost_usd":0,"skipped":[{"step":"sibling reads","reason":"not_needed"},{"step":"social reads","reason":"not_needed"},{"step":"site walk","reason":"not_needed"}],"engine_version":"contact-find-v1"}},"meta":{"cost":"$0.0200","balance":"$355.5217","request_id":"req_6b1d5cc3f1cc367f9584b813e3b8bab1"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/contacts/find-from-youtube/thorough":{"get":{"tags":["Contacts"],"operationId":"contactsFindFromYoutubeThorough","summary":"Find contacts from YouTube (thorough)","x-dashboard-cost":"$0.05","description":"The general find with one YouTube account as the subject.\n\nThe thorough level answers within about 30 seconds. It runs the deep walk (sibling accounts, contact pages on proven domains, a web search) beside the fast gather, pools both sets of candidates with their source pages, and has one model call type, rank and drop them; it can only return addresses present on those pages. Measured on the same set: precision 0.97, recall 0.77, top-1 0.87, p99 27.5 s.\n\nThe answer is one subject: every email with its rank, type (`business`, `management`, `press`, …), `contactable` flag, confidence, owner, the evidence pages it came from and its MX/SMTP check; `best_email` is the first active contactable one. It also carries the linked social handles, websites, link pages and phones, and a `run` report of the pages read, any model call and its cost. An answer with no contactable email (`best_email` null) is free.\n\n`freshness`: `auto` (default) answers from the stored answer when it is fresh enough and runs otherwise, `refresh` always runs, `stored` never runs. The price is the same.","security":[{"bearerAuth":[]}],"parameters":[{"name":"q","in":"query","required":true,"description":"Handle, @handle, channel URL or `UC…` channel id. Case is kept.","schema":{"type":"string"},"example":"mkbhd"},{"name":"freshness","in":"query","required":false,"description":"`auto`, `refresh` or `stored`. Same price.","schema":{"type":"string","enum":["auto","refresh","stored"],"default":"auto"},"examples":{"default":{"value":"auto","x-disabled":true}}}],"responses":{"200":{"description":"One contact finder result.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/ContactFindResult"},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"outcome":"found","subject":{"profile_id":538,"linked_profile_ids":[],"kind":"unknown","private":false,"display_name":"Marques Brownlee","primary":{"platform":"youtube","handle":"mkbhd"}},"best_email":"business@mkbhd.com","emails":[{"address":"business@mkbhd.com","rank":1,"type":"business","contactable":true,"confidence":1,"owner":"subject","status":"active","link":"declared_by_subject","evidence":[{"url":"https://www.youtube.com/@mkbhd","where":"yt_about","quote":"MKBHD: Quality Tech Videos | YouTuber | Geek | Consumer Electronics | Tech Head | Internet Personality! business@MKBHD.com NYC","kind":"declared_by_subject","hops":0,"seen_at":"2026-11-13T14:27:10.728335Z"},{"url":"https://www.youtube.com/@mkbhd","where":"other","quote":"engine surface own_profile: MKBHD: Quality Tech Videos | YouTuber | Geek | Consumer Electronics | Tech Head | Internet Personality! business@MKBHD.com NYC","kind":"declared_by_subject","hops":0,"seen_at":"2026-11-13T14:27:10.728335Z"}],"verification":{"mx":"present","smtp":"risky","checked_at":"2026-11-13T14:27:10.728335Z"},"shared_with":0,"first_seen_at":"2026-09-29T03:48:43.009638Z","last_seen_at":"2026-11-13T14:27:10.728335Z"},{"address":"podcast@mkbhd.com","rank":2,"type":"management","contactable":true,"confidence":0.94,"owner":"subject","status":"active","link":"declared_by_subject","evidence":[{"url":"https://linktr.ee/mkbhd","where":"other","quote":"","kind":"declared_by_subject","hops":1,"seen_at":"2026-10-12T07:46:02.779193Z"}],"verification":{"mx":"present","smtp":"risky","checked_at":"2026-11-13T14:27:10.733888Z"},"shared_with":0,"first_seen_at":"2026-10-12T07:46:02.779193Z","last_seen_at":"2026-11-13T14:27:10.733888Z"},{"address":"privacy@fourthwall.com","rank":3,"type":"other_role","contactable":false,"confidence":1,"owner":"other","status":"active","link":"own_domain_page","evidence":[{"url":"https://mkbhd.com/pages/privacy-policy","where":"own_site_footer","quote":"icy, please contact us at contact@support.mkbhd.com. For questions about Fourthwall’s own processing of your Personal Information, please contact Fourthwall at privacy@fourthwall.com.</p> </div> </div> </div> </div> </section> </div> <aside data-drawer=\"product\" class=\"drawer\"> <div data-drawer-trig","kind":"own_domain_page","hops":2,"seen_at":"2026-11-13T14:27:10.728335Z"},{"url":"https://mkbhd.com/pages/privacy-policy","where":"own_site_footer","quote":"icy, please contact us at contact@support.mkbhd.com. For questions about Fourthwall’s own processing of your Personal Information, please contact Fourthwall at privacy@fourthwall.com.</p> </div> </div> </div> </div> </section> </div> <aside data-drawer=\"product\" class=\"drawer\"> <div data-drawer-trig","kind":"own_domain_page","hops":2,"seen_at":"2026-11-13T14:27:10.728335Z"}],"verification":{"mx":"present","smtp":"unchecked","checked_at":"2026-11-13T14:27:10.728335Z"},"shared_with":0,"first_seen_at":"2026-11-13T14:27:10.728335Z","last_seen_at":"2026-11-13T14:27:10.728335Z"},{"address":"contact@support.mkbhd.com","rank":4,"type":"support","contactable":false,"confidence":0.98,"owner":"subject","status":"active","link":"own_domain_page","evidence":[{"url":"https://mkbhd.com/pages/contact","where":"own_site_contact","quote":"text\"> <div class=\"html-formatter html-formatter--center\"> <p style=\"text-align: left;\">For all store inquiries, contact&nbsp;<a href=\"mailto:contact@support.mkbhd.com\" rel=\"noopener noreferrer\" target=\"_blank\">contact@support.mkbhd.com</a></p> </div> </div> </div> </div> </section> </div> <aside","kind":"own_domain_page","hops":2,"seen_at":"2026-11-13T14:27:10.728335Z"},{"url":"https://mkbhd.com/pages/privacy-policy","where":"own_site_footer","quote":"and whether we are subject to the applicable data privacy laws of such jurisdiction. To learn more about your rights or to exercise them, please contact us at contact@support.mkbhd.com. We may request you provide us with information necessary to confirm your identity before responding to your reques","kind":"own_domain_page","hops":2,"seen_at":"2026-11-13T14:27:10.728335Z"},{"url":"https://mkbhd.com/pages/terms-of-service","where":"own_site_footer","quote":"for all activities that occur under your account. If you believe that your account is no longer secure, then you must immediately notify us at <a href=\"mailto:contact@support.mkbhd.com\">contact@support.mkbhd.com</a>.</p> <h3 style=\"text-align: left;\">4. Licenses</h3> <p style=\"text-align: left;\"><st","kind":"own_domain_page","hops":2,"seen_at":"2026-11-13T14:27:10.728335Z"},{"url":"https://mkbhd.com/pages/privacy-policy","where":"own_site_footer","quote":"and whether we are subject to the applicable data privacy laws of such jurisdiction. To learn more about your rights or to exercise them, please contact us at contact@support.mkbhd.com. We may request you provide us with information necessary to confirm your identity before responding to your reques","kind":"own_domain_page","hops":2,"seen_at":"2026-11-13T14:27:10.728335Z"}],"verification":{"mx":"present","smtp":"unchecked","checked_at":"2026-11-13T14:27:10.728335Z"},"shared_with":0,"first_seen_at":"2026-11-13T14:27:10.728335Z","last_seen_at":"2026-11-13T14:27:10.728335Z"}],"handles":{"instagram":[{"handle":"mkbhd","url":"https://instagram.com/MKBHD","link":"declared_by_subject","confidence":0.94,"tracked":true,"evidence":[{"url":"https://www.youtube.com/@mkbhd","where":"yt_about","quote":"https://instagram.com/MKBHD","kind":"declared_by_subject","hops":0,"seen_at":"2026-11-13T14:27:10.728335Z"},{"url":"https://mkbhd.com/","where":"other","quote":"https://instagram.com/MKBHD","kind":"own_domain_page","hops":1,"seen_at":"2026-11-13T14:27:10.728335Z"},{"url":"https://mkbhd.com/pages/contact","where":"own_site_contact","quote":"https://instagram.com/MKBHD","kind":"own_domain_page","hops":2,"seen_at":"2026-11-13T14:27:10.728335Z"},{"url":"https://mkbhd.com/pages/privacy-policy","where":"own_site_footer","quote":"https://instagram.com/MKBHD","kind":"own_domain_page","hops":2,"seen_at":"2026-11-13T14:27:10.728335Z"},{"url":"https://mkbhd.com/pages/terms-of-service","where":"own_site_footer","quote":"https://instagram.com/MKBHD","kind":"own_domain_page","hops":2,"seen_at":"2026-11-13T14:27:10.728335Z"},{"url":"https://mkbhd.com/pages/privacy-policy","where":"own_site_footer","quote":"https://instagram.com/MKBHD","kind":"own_domain_page","hops":2,"seen_at":"2026-11-13T14:27:10.728335Z"},{"url":"https://www.youtube.com/@mkbhd","where":"other","quote":"http://instagram.com/MKBHD","kind":"declared_by_subject","hops":0,"seen_at":"2026-11-13T14:27:10.728335Z"}]}],"tiktok":[{"handle":"mkbhd","url":"https://www.tiktok.com/@mkbhd","link":"declared_by_linked","confidence":0.94,"tracked":true,"evidence":[{"url":"https://www.tiktok.com/@mkbhd","where":"other","quote":"same crawler profile","kind":"declared_by_linked","hops":1,"seen_at":"2026-11-13T14:27:10.728335Z"}]}],"youtube":[{"handle":"mkbhd","url":"https://www.youtube.com/@mkbhd","link":"input","confidence":1,"tracked":true,"evidence":[]},{"handle":"ucbjycsmduvyel83r_u4jriq","url":"https://youtube.com/channel/UCBJycsmduvYEL83R_U4JriQ","link":"own_domain_page","confidence":0.94,"tracked":true,"evidence":[{"url":"https://mkbhd.com/","where":"other","quote":"https://youtube.com/channel/UCBJycsmduvYEL83R_U4JriQ","kind":"own_domain_page","hops":1,"seen_at":"2026-11-13T14:27:10.728335Z"},{"url":"https://mkbhd.com/","where":"other","quote":"MKBHD","kind":"own_domain_page","hops":1,"seen_at":"2026-11-13T14:27:10.728335Z"},{"url":"https://mkbhd.com/pages/contact","where":"own_site_contact","quote":"https://youtube.com/channel/UCBJycsmduvYEL83R_U4JriQ","kind":"own_domain_page","hops":2,"seen_at":"2026-11-13T14:27:10.728335Z"},{"url":"https://mkbhd.com/pages/contact","where":"own_site_contact","quote":"MKBHD","kind":"own_domain_page","hops":2,"seen_at":"2026-11-13T14:27:10.728335Z"},{"url":"https://mkbhd.com/pages/privacy-policy","where":"own_site_footer","quote":"https://youtube.com/channel/UCBJycsmduvYEL83R_U4JriQ","kind":"own_domain_page","hops":2,"seen_at":"2026-11-13T14:27:10.728335Z"},{"url":"https://mkbhd.com/pages/privacy-policy","where":"own_site_footer","quote":"MKBHD","kind":"own_domain_page","hops":2,"seen_at":"2026-11-13T14:27:10.728335Z"},{"url":"https://mkbhd.com/pages/terms-of-service","where":"own_site_footer","quote":"https://youtube.com/channel/UCBJycsmduvYEL83R_U4JriQ","kind":"own_domain_page","hops":2,"seen_at":"2026-11-13T14:27:10.728335Z"},{"url":"https://mkbhd.com/pages/terms-of-service","where":"own_site_footer","quote":"MKBHD","kind":"own_domain_page","hops":2,"seen_at":"2026-11-13T14:27:10.728335Z"},{"url":"https://mkbhd.com/pages/privacy-policy","where":"own_site_footer","quote":"https://youtube.com/channel/UCBJycsmduvYEL83R_U4JriQ","kind":"own_domain_page","hops":2,"seen_at":"2026-11-13T14:27:10.728335Z"},{"url":"https://mkbhd.com/pages/privacy-policy","where":"own_site_footer","quote":"MKBHD","kind":"own_domain_page","hops":2,"seen_at":"2026-11-13T14:27:10.728335Z"}]},{"handle":"ucg7j20lhuell6y_emi7ojra","url":"https://www.youtube.com/channel/UCG7J20LhUeLl6y_Emi7OJrA","link":"own_domain_page","confidence":0.94,"tracked":false,"evidence":[{"url":"https://mkbhd.com/","where":"other","quote":"The Studio","kind":"own_domain_page","hops":1,"seen_at":"2026-11-13T14:27:10.728335Z"},{"url":"https://mkbhd.com/pages/contact","where":"own_site_contact","quote":"The Studio","kind":"own_domain_page","hops":2,"seen_at":"2026-11-13T14:27:10.728335Z"},{"url":"https://mkbhd.com/pages/privacy-policy","where":"own_site_footer","quote":"The Studio","kind":"own_domain_page","hops":2,"seen_at":"2026-11-13T14:27:10.728335Z"},{"url":"https://mkbhd.com/pages/terms-of-service","where":"own_site_footer","quote":"The Studio","kind":"own_domain_page","hops":2,"seen_at":"2026-11-13T14:27:10.728335Z"},{"url":"https://mkbhd.com/pages/privacy-policy","where":"own_site_footer","quote":"The Studio","kind":"own_domain_page","hops":2,"seen_at":"2026-11-13T14:27:10.728335Z"}]}],"x":[{"handle":"mkbhd","url":"https://twitter.com/MKBHD","link":"declared_by_subject","confidence":0.94,"tracked":false,"evidence":[{"url":"https://www.youtube.com/@mkbhd","where":"yt_about","quote":"https://twitter.com/MKBHD","kind":"declared_by_subject","hops":0,"seen_at":"2026-11-13T14:27:10.728335Z"},{"url":"https://mkbhd.com/","where":"other","quote":"https://twitter.com/MKBHD","kind":"own_domain_page","hops":1,"seen_at":"2026-11-13T14:27:10.728335Z"},{"url":"https://mkbhd.com/pages/contact","where":"own_site_contact","quote":"https://twitter.com/MKBHD","kind":"own_domain_page","hops":2,"seen_at":"2026-11-13T14:27:10.728335Z"},{"url":"https://mkbhd.com/pages/privacy-policy","where":"own_site_footer","quote":"https://twitter.com/MKBHD","kind":"own_domain_page","hops":2,"seen_at":"2026-11-13T14:27:10.728335Z"},{"url":"https://mkbhd.com/pages/terms-of-service","where":"own_site_footer","quote":"https://twitter.com/MKBHD","kind":"own_domain_page","hops":2,"seen_at":"2026-11-13T14:27:10.728335Z"},{"url":"https://mkbhd.com/pages/privacy-policy","where":"own_site_footer","quote":"https://twitter.com/MKBHD","kind":"own_domain_page","hops":2,"seen_at":"2026-11-13T14:27:10.728335Z"},{"url":"https://www.youtube.com/@mkbhd","where":"other","quote":"http://twitter.com/MKBHD","kind":"declared_by_subject","hops":0,"seen_at":"2026-11-13T14:27:10.728335Z"},{"url":"https://www.youtube.com/@mkbhd","where":"other","quote":"https://twitter.com/MKBHD","kind":"declared_by_subject","hops":0,"seen_at":"2026-11-13T14:27:10.728335Z"}]}],"facebook":[],"threads":[],"linkedin":[],"pinterest":[],"snapchat":[],"twitch":[]},"websites":[{"url":"https://reddit.com/r/MKBHD","kind":"other","link":"declared_by_subject","evidence":[{"url":"https://www.youtube.com/@mkbhd","where":"yt_about","quote":"https://reddit.com/r/MKBHD","kind":"declared_by_subject","hops":0,"seen_at":"2026-11-13T14:27:10.728335Z"}]},{"url":"https://discord.gg/MKBHD","kind":"other","link":"declared_by_subject","evidence":[{"url":"https://www.youtube.com/@mkbhd","where":"yt_about","quote":"https://discord.gg/MKBHD","kind":"declared_by_subject","hops":0,"seen_at":"2026-11-13T14:27:10.728335Z"}]},{"url":"https://mkbhd.com/","kind":"own_site","link":"declared_by_linked","evidence":[{"url":"https://www.instagram.com/mkbhd/","where":"ig_bio","quote":"https://mkbhd.com/","kind":"declared_by_linked","hops":1,"seen_at":"2026-11-13T14:27:10.728335Z"}]},{"url":"https://mkbhd.com","kind":"own_site","link":"declared_by_subject","evidence":[{"url":"https://www.youtube.com/@mkbhd","where":"other","quote":"","kind":"declared_by_subject","hops":0,"seen_at":"2026-11-13T14:27:02.391117Z"}]}],"link_pages":[],"phones":[],"run":{"level":"thorough","freshness":"refresh","budget_ms":30000,"elapsed_ms":7687,"partial":false,"stored":{"hit":false,"read_ms":50,"last_run_at":"2026-11-13T14:27:02.364518Z","last_run_level":"fast"},"pages_read":18,"pages":[{"url":"live profile read","why":"own_profile","outcome":"ok","status":null,"ms":1008},{"url":"https://mkbhd.com/","why":"declared_link","outcome":"ok","status":200,"ms":215},{"url":"https://discord.gg/MKBHD","why":"declared_link","outcome":"ok","status":200,"ms":65},{"url":"https://reddit.com/r/MKBHD","why":"declared_link","outcome":"error","status":null,"ms":28},{"url":"http://discord.gg/MKBHD","why":"declared_link","outcome":"ok","status":200,"ms":74},{"url":"http://reddit.com/r/MKBHD","why":"declared_link","outcome":"error","status":null,"ms":32},{"url":"https://mkbhd.com/contact","why":"own_site_path","outcome":"ok","status":200,"ms":98},{"url":"https://mkbhd.com/pages/terms-of-service","why":"own_site_path","outcome":"ok","status":200,"ms":77},{"url":"https://mkbhd.com/privacy-policy","why":"own_site_path","outcome":"ok","status":200,"ms":54},{"url":"https://mkbhd.com/pages/privacy-policy","why":"own_site_path","outcome":"ok","status":200,"ms":13},{"url":"https://mkbhd.com/pages/contact","why":"own_site_path","outcome":"ok","status":200,"ms":99}],"ai_calls":[{"model":"gpt-6-luna","purpose":"classify_types","fresh_input_tokens":2996,"cache_read_tokens":0,"cache_write_tokens":0,"output_tokens":179,"cost_usd":0.0003891}],"search_calls":[],"cost_usd":0.0003891,"skipped":[],"engine_version":"contact-find-v1"}},"meta":{"cost":"$0.0500","balance":"$355.6117","request_id":"req_bb065a3a56c0fea900bf9dec45ac7e7f"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/batch/trigger":{"post":{"tags":["Batch"],"operationId":"batch.trigger","summary":"Submit a batch job","description":"Run an array of inputs against any batchable catalog operation. Each row is EXACTLY the input the single-call route takes — a JSON object of query params for GET operations, the request body for POST operations. Free to call; a flat pre-authorization (rows × single-call price) must fit your balance, and each row bills individually as it executes (failed rows are free). At most 10,000 rows, 4 MB body, and 5 active jobs per organization.","security":[{"bearerAuth":[]}],"parameters":[{"name":"operation","in":"query","required":true,"schema":{"type":"string","example":"instagram.web_profile_info"},"description":"A batchable catalog operation id, e.g. `instagram.web_profile_info`."},{"name":"format","in":"query","schema":{"type":"string","enum":["ndjson","json","csv"],"default":"ndjson"},"description":"Materialized result format (overridable again at download).","examples":{"default":{"value":"ndjson","x-disabled":true}}},{"name":"include_errors","in":"query","schema":{"type":"boolean","default":false},"description":"Failed rows appear in the download as `{input, error}` instead of being dropped.","examples":{"default":{"value":false,"x-disabled":true}}},{"name":"notify","in":"query","schema":{"type":"string","format":"uri"},"description":"HTTPS webhook POSTed once when the job reaches a terminal status."},{"name":"auth_header","in":"query","schema":{"type":"string"},"description":"Sent verbatim as `Authorization` on the webhook. Stored encrypted."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"array","minItems":1,"maxItems":10000,"items":{"type":"object","additionalProperties":true}},"example":[{"handle":"nike"},{"handle":"adidas"},{"handle":"puma"}]}}},"responses":{"200":{"description":"Job accepted — poll `/v1/batch/progress/{snapshot_id}`.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","required":["snapshot_id","operation","status","rows_total","rows_ready","rows_failed"],"properties":{"snapshot_id":{"type":"string","example":"s_9f3c1ab27de40155"},"operation":{"type":"string","example":"instagram.web_profile_info"},"status":{"type":"string","enum":["starting","running","ready","failed","canceled"]},"rows_total":{"type":"integer"},"rows_ready":{"type":"integer"},"rows_failed":{"type":"integer"},"cost":{"type":"string","description":"Accrued so far — successful rows only.","example":"$0.0010"},"estimated_cost":{"type":"string","description":"Pre-authorized at trigger, never charged up front."},"format":{"type":"string","enum":["ndjson","json","csv"]},"include_errors":{"type":"boolean"},"created_at":{"type":"string","format":"date-time"},"finished_at":{"type":"string","format":"date-time","nullable":true},"expires_at":{"type":"string","format":"date-time"}}},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"snapshot_id":"s_d6da32a64a4df4ad","operation":"live.instagram.profile","status":"starting","rows_total":3,"estimated_cost":"$0.0015","created_at":"2026-08-03T18:24:27.241Z","expires_at":"2026-08-17T18:24:27.241Z"},"meta":{"cost":"$0.0000","balance":"$6.5985","request_id":"req_b764aa69114b62c09b6ef64d044e0fed"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"413":{"description":"Too many rows (max 10,000) or body over 4 MB.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"description":"This account already has 5 active batch jobs.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/batch/progress/{snapshot_id}":{"get":{"tags":["Batch"],"operationId":"batch.progress","summary":"Poll a batch job","description":"Free. `status` walks `starting → running → ready` (or `failed` / `canceled`); `cost` accrues as successful rows bill. A snapshot this key does not own is a 404.","security":[{"bearerAuth":[]}],"parameters":[{"name":"snapshot_id","in":"path","required":true,"schema":{"type":"string"},"description":"The id returned by `POST /v1/batch/trigger`."}],"responses":{"200":{"description":"Current job progress.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","required":["snapshot_id","operation","status","rows_total","rows_ready","rows_failed"],"properties":{"snapshot_id":{"type":"string","example":"s_9f3c1ab27de40155"},"operation":{"type":"string","example":"instagram.web_profile_info"},"status":{"type":"string","enum":["starting","running","ready","failed","canceled"]},"rows_total":{"type":"integer"},"rows_ready":{"type":"integer"},"rows_failed":{"type":"integer"},"cost":{"type":"string","description":"Accrued so far — successful rows only.","example":"$0.0010"},"estimated_cost":{"type":"string","description":"Pre-authorized at trigger, never charged up front."},"format":{"type":"string","enum":["ndjson","json","csv"]},"include_errors":{"type":"boolean"},"created_at":{"type":"string","format":"date-time"},"finished_at":{"type":"string","format":"date-time","nullable":true},"expires_at":{"type":"string","format":"date-time"}}},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"snapshot_id":"s_e26fd0bb3183ab1b","operation":"live.instagram.profile","status":"ready","rows_total":50,"rows_ready":50,"rows_failed":0,"cost":"$0.0250","estimated_cost":"$0.0250","format":"ndjson","include_errors":false,"created_at":"2026-08-03T18:42:57.717Z","finished_at":"2026-08-03T18:43:49.993Z","expires_at":"2026-08-17T18:42:57.717Z"},"meta":{"cost":"$0.0000","balance":"$6.5720","request_id":"req_fb599aae7e61365c2f2326928565b9e7"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"404":{"description":"No such snapshot (or expired).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/batch/snapshot/{snapshot_id}":{"get":{"tags":["Batch"],"operationId":"batch.snapshot","summary":"Download batch results","description":"Streams results in submission order once the job is terminal; 409 `snapshot_not_ready` while it runs. Every row carries its `input` alongside `data` (or `error`, with `include_errors=true`). Completed rows of `failed`/`canceled` jobs stay downloadable until expiry. For very large snapshots page with `batch_size` + `part` — each page is one bounded response.","security":[{"bearerAuth":[]}],"parameters":[{"name":"snapshot_id","in":"path","required":true,"schema":{"type":"string"},"description":"The id returned by `POST /v1/batch/trigger`."},{"name":"format","in":"query","schema":{"type":"string","enum":["ndjson","json","csv"]},"description":"Override the job's format. CSV columns are dot-flattened keys; nested arrays/objects are JSON-encoded cells."},{"name":"batch_size","in":"query","schema":{"type":"integer","minimum":1,"maximum":10000},"description":"Rows per page for paged download; with it, `part` selects the page."},{"name":"part","in":"query","schema":{"type":"integer","minimum":0,"default":0},"description":"Zero-based page index. Without `batch_size` the whole snapshot is part 0, so a later part needs `batch_size`.","examples":{"default":{"value":0,"x-disabled":true}}}],"responses":{"200":{"description":"Result rows (`application/x-ndjson`, `application/json`, or `text/csv`). Examples are a real captured download with the bulk `raw`/`extra` payload fields projected out.","content":{"application/x-ndjson":{"schema":{"type":"string"},"example":"{\"input\":{\"handle\":\"nike\"},\"data\":{\"id\":\"13460080\",\"username\":\"nike\",\"full_name\":\"Nike\",\"biography\":\"Just Do It.\",\"followers\":290883678,\"following\":267,\"posts\":1677,\"is_verified\":true,\"is_private\":false,\"avatar_url\":\"https://scontent-gru1-2.cdninstagram.com/v/t51.82787-19/551608484_18567162979020081_1135468084872726555_n.jpg?stp=dst-jpg_s320x320_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby4zOTkuYzIifQ&_nc_ht=scontent-gru1-2.cdninstagram.com&_nc_cat=1&_nc_oc=Q6cZ2gHC4Nik0gg8y1nEyf204PLsfYXZ5BFiWfiTlZtYZV3DOr68ePjQhWr9fM3Iexw91C0&_nc_ohc=4E2UsSUAjnYQ7kNvwH_U2Ru&_nc_gid=nLnFTyxL1eDG5p2C-lmn_A&edm=AOQ1c0wBAAAA&ccb=7-5&oh=00_AQQJNXwVsaGkSRKbeEAu-6UfcqopykkUrslfLr6NbTTjBw&oe=6AE8C5FA&_nc_sid=8b3546\",\"external_url\":\"http://empli.fi/nike\",\"links\":[{\"url\":\"http://empli.fi/nike\",\"title\":null}],\"category\":null,\"business_category\":null,\"is_business\":true,\"is_professional\":true,\"business_email\":null,\"business_phone\":null,\"business_address\":\"One Bowerman Dr, Beaverton, Oregon, 97005\",\"pronouns\":[],\"highlight_reel_count\":5,\"has_clips\":true,\"is_recently_joined\":false,\"fbid\":\"17841400602400210\",\"extra\":{}}}\n{\"input\":{\"handle\":\"adidas\"},\"data\":{\"id\":\"20269764\",\"username\":\"adidas\",\"full_name\":\"adidas\",\"biography\":\"Through Sport We Have The Power To Change Lives #YouGotThis\",\"followers\":29837145,\"following\":1059,\"posts\":null,\"is_verified\":true,\"is_private\":false,\"avatar_url\":\"https://scontent.cdninstagram.com/v/t51.82787-19/839334195_18666329605045765_5263068549495526888_n.jpg?stp=dst-jpg_s150x150_tt6&_nc_cat=1&ccb=7-5&_nc_sid=f7ccc5&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLnd3dy4xMDgwLkMzIn0%3D&_nc_ohc=pyx9E6Wz7ocQ7kNvwF-4B5f&_nc_oc=Adr4uRyiUJhvMGl2Nho6Z5Wv4svIf6gfdNTFcI55LhV2zcpCm2cFtABQ8fIks3L_BCw&_nc_zt=24&_nc_ht=scontent.cdninstagram.com&_nc_gid=UxQ9-xXqxsROdC4mDYrADw&_nc_ss=7ba8c&oh=00_AQQDIvbZ5E2XrBp6oe_pFRgfjSnSPGMY37cBeoSRJT-2vQ&oe=6AE8BCC5\",\"external_url\":\"https://linktr.ee/adidas\",\"links\":[{\"url\":\"https://linktr.ee/adidas\",\"title\":null}],\"category\":null,\"business_category\":null,\"is_business\":null,\"is_professional\":null,\"business_email\":null,\"business_phone\":null,\"business_address\":null,\"pronouns\":[],\"highlight_reel_count\":null,\"has_clips\":true,\"is_recently_joined\":null,\"fbid\":\"17841401372920316\",\"extra\":{}}}\n{\"input\":{\"handle\":\"puma\"},\"data\":{\"id\":\"10145706\",\"username\":\"puma\",\"full_name\":\"PUMA\",\"biography\":null,\"followers\":12944878,\"following\":156,\"posts\":3410,\"is_verified\":true,\"is_private\":false,\"avatar_url\":\"https://scontent.cdninstagram.com/v/t51.2885-19/459303202_479954131680638_1811732038334385568_n.jpg?stp=dst-jpg_s150x150_tt6&_nc_cat=1&ccb=7-5&_nc_sid=f7ccc5&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLnd3dy4xMDgwLkMzIn0%3D&_nc_ohc=6y4B96ggjd4Q7kNvwE7FzBY&_nc_oc=Adq0W6VKziE3BN79hJsEg3xkAwpn4KvDzSuV-isioX5bPi3N-7qNRiuw088KQwTKbd4&_nc_zt=24&_nc_ht=scontent.cdninstagram.com&_nc_ss=7ba8c&oh=00_AQRowtgV1L3xm9gUSmI1MvL5OHL8vN-3rcnpG9Q4zJx_jw&oe=6AE847DA\",\"external_url\":\"http://clicklinkin.bio/puma\",\"links\":[{\"url\":\"http://clicklinkin.bio/puma\",\"title\":null}],\"category\":null,\"business_category\":null,\"is_business\":null,\"is_professional\":null,\"business_email\":null,\"business_phone\":null,\"business_address\":null,\"pronouns\":[],\"highlight_reel_count\":null,\"has_clips\":true,\"is_recently_joined\":null,\"fbid\":\"17841401011180158\",\"extra\":{}}}"},"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true}},"example":[{"input":{"handle":"nike"},"data":{"id":"13460080","username":"nike","full_name":"Nike","biography":"Just Do It.","followers":290883678,"following":267,"posts":1677,"is_verified":true,"is_private":false,"avatar_url":"https://scontent-gru1-2.cdninstagram.com/v/t51.82787-19/551608484_18567162979020081_1135468084872726555_n.jpg?stp=dst-jpg_s320x320_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby4zOTkuYzIifQ&_nc_ht=scontent-gru1-2.cdninstagram.com&_nc_cat=1&_nc_oc=Q6cZ2gHC4Nik0gg8y1nEyf204PLsfYXZ5BFiWfiTlZtYZV3DOr68ePjQhWr9fM3Iexw91C0&_nc_ohc=4E2UsSUAjnYQ7kNvwH_U2Ru&_nc_gid=nLnFTyxL1eDG5p2C-lmn_A&edm=AOQ1c0wBAAAA&ccb=7-5&oh=00_AQQJNXwVsaGkSRKbeEAu-6UfcqopykkUrslfLr6NbTTjBw&oe=6AE8C5FA&_nc_sid=8b3546","external_url":"http://empli.fi/nike","links":[{"url":"http://empli.fi/nike","title":null}],"category":null,"business_category":null,"is_business":true,"is_professional":true,"business_email":null,"business_phone":null,"business_address":"One Bowerman Dr, Beaverton, Oregon, 97005","pronouns":[],"highlight_reel_count":5,"has_clips":true,"is_recently_joined":false,"fbid":"17841400602400210","extra":{}}},{"input":{"handle":"adidas"},"data":{"id":"20269764","username":"adidas","full_name":"adidas","biography":"Through Sport We Have The Power To Change Lives #YouGotThis","followers":29837145,"following":1059,"posts":null,"is_verified":true,"is_private":false,"avatar_url":"https://scontent.cdninstagram.com/v/t51.82787-19/839334195_18666329605045765_5263068549495526888_n.jpg?stp=dst-jpg_s150x150_tt6&_nc_cat=1&ccb=7-5&_nc_sid=f7ccc5&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLnd3dy4xMDgwLkMzIn0%3D&_nc_ohc=pyx9E6Wz7ocQ7kNvwF-4B5f&_nc_oc=Adr4uRyiUJhvMGl2Nho6Z5Wv4svIf6gfdNTFcI55LhV2zcpCm2cFtABQ8fIks3L_BCw&_nc_zt=24&_nc_ht=scontent.cdninstagram.com&_nc_gid=UxQ9-xXqxsROdC4mDYrADw&_nc_ss=7ba8c&oh=00_AQQDIvbZ5E2XrBp6oe_pFRgfjSnSPGMY37cBeoSRJT-2vQ&oe=6AE8BCC5","external_url":"https://linktr.ee/adidas","links":[{"url":"https://linktr.ee/adidas","title":null}],"category":null,"business_category":null,"is_business":null,"is_professional":null,"business_email":null,"business_phone":null,"business_address":null,"pronouns":[],"highlight_reel_count":null,"has_clips":true,"is_recently_joined":null,"fbid":"17841401372920316","extra":{}}},{"input":{"handle":"puma"},"data":{"id":"10145706","username":"puma","full_name":"PUMA","biography":null,"followers":12944878,"following":156,"posts":3410,"is_verified":true,"is_private":false,"avatar_url":"https://scontent.cdninstagram.com/v/t51.2885-19/459303202_479954131680638_1811732038334385568_n.jpg?stp=dst-jpg_s150x150_tt6&_nc_cat=1&ccb=7-5&_nc_sid=f7ccc5&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLnd3dy4xMDgwLkMzIn0%3D&_nc_ohc=6y4B96ggjd4Q7kNvwE7FzBY&_nc_oc=Adq0W6VKziE3BN79hJsEg3xkAwpn4KvDzSuV-isioX5bPi3N-7qNRiuw088KQwTKbd4&_nc_zt=24&_nc_ht=scontent.cdninstagram.com&_nc_ss=7ba8c&oh=00_AQRowtgV1L3xm9gUSmI1MvL5OHL8vN-3rcnpG9Q4zJx_jw&oe=6AE847DA","external_url":"http://clicklinkin.bio/puma","links":[{"url":"http://clicklinkin.bio/puma","title":null}],"category":null,"business_category":null,"is_business":null,"is_professional":null,"business_email":null,"business_phone":null,"business_address":null,"pronouns":[],"highlight_reel_count":null,"has_clips":true,"is_recently_joined":null,"fbid":"17841401011180158","extra":{}}}]}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"404":{"description":"No such snapshot, or results expired.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"409":{"description":"Snapshot is not ready for download.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"},"example":{"error":{"code":"snapshot_not_ready","message":"Snapshot is not ready for download.","request_id":"req_5c10900e919bc7a3ff79b7501d582b4c"}}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}},"delete":{"tags":["Batch"],"operationId":"batch.cancel","summary":"Cancel a job / delete its results","description":"On an active job: cancel — the dispatcher stops, in-flight rows finish (and bill), completed rows stay downloadable, status becomes `canceled`. On a terminal job: delete the stored results now (early retention); the job row remains for the usage ledger.","security":[{"bearerAuth":[]}],"parameters":[{"name":"snapshot_id","in":"path","required":true,"schema":{"type":"string"},"description":"The id returned by `POST /v1/batch/trigger`."}],"responses":{"200":{"description":"Updated job state.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","required":["snapshot_id","operation","status","rows_total","rows_ready","rows_failed"],"properties":{"snapshot_id":{"type":"string","example":"s_9f3c1ab27de40155"},"operation":{"type":"string","example":"instagram.web_profile_info"},"status":{"type":"string","enum":["starting","running","ready","failed","canceled"]},"rows_total":{"type":"integer"},"rows_ready":{"type":"integer"},"rows_failed":{"type":"integer"},"cost":{"type":"string","description":"Accrued so far — successful rows only.","example":"$0.0010"},"estimated_cost":{"type":"string","description":"Pre-authorized at trigger, never charged up front."},"format":{"type":"string","enum":["ndjson","json","csv"]},"include_errors":{"type":"boolean"},"created_at":{"type":"string","format":"date-time"},"finished_at":{"type":"string","format":"date-time","nullable":true},"expires_at":{"type":"string","format":"date-time"}}},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"snapshot_id":"s_9b697730fede50c5","operation":"live.instagram.profile","status":"canceled","rows_total":5,"rows_ready":0,"rows_failed":0,"cost":"$0.0000","estimated_cost":"$0.0025","format":"ndjson","include_errors":false,"created_at":"2026-08-03T18:46:20.121Z","finished_at":"2026-08-03T18:46:24.861Z","expires_at":"2026-08-03T18:47:08.671Z"},"meta":{"cost":"$0.0000","balance":"$6.5720","request_id":"req_3b65ef75a619a1fcecfcb3768518aa68"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"404":{"description":"No such snapshot.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}},"/v1/batch/snapshots":{"get":{"tags":["Batch"],"operationId":"batch.snapshots","summary":"List batch jobs","description":"This account's jobs, newest first. Free.","security":[{"bearerAuth":[]}],"parameters":[{"name":"operation","in":"query","schema":{"type":"string"},"description":"Filter by catalog operation id."},{"name":"status","in":"query","schema":{"type":"string","enum":["starting","running","ready","failed","canceled"]}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"examples":{"default":{"value":20,"x-disabled":true}}},{"name":"cursor","in":"query","schema":{"type":"string"},"description":"Opaque `next_cursor` from the previous page."}],"responses":{"200":{"description":"Jobs page.","content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","required":["snapshots"],"properties":{"snapshots":{"type":"array","items":{"type":"object","required":["snapshot_id","operation","status","rows_total","rows_ready","rows_failed"],"properties":{"snapshot_id":{"type":"string","example":"s_9f3c1ab27de40155"},"operation":{"type":"string","example":"instagram.web_profile_info"},"status":{"type":"string","enum":["starting","running","ready","failed","canceled"]},"rows_total":{"type":"integer"},"rows_ready":{"type":"integer"},"rows_failed":{"type":"integer"},"cost":{"type":"string","description":"Accrued so far — successful rows only.","example":"$0.0010"},"estimated_cost":{"type":"string","description":"Pre-authorized at trigger, never charged up front."},"format":{"type":"string","enum":["ndjson","json","csv"]},"include_errors":{"type":"boolean"},"created_at":{"type":"string","format":"date-time"},"finished_at":{"type":"string","format":"date-time","nullable":true},"expires_at":{"type":"string","format":"date-time"}}}},"next_cursor":{"type":"string","nullable":true}}},"meta":{"$ref":"#/components/schemas/ApiMeta"}}},"example":{"data":{"snapshots":[{"snapshot_id":"s_9b697730fede50c5","operation":"live.instagram.profile","status":"canceled","rows_total":5,"rows_ready":0,"rows_failed":0,"cost":"$0.0000","estimated_cost":"$0.0025","format":"ndjson","include_errors":false,"created_at":"2026-08-03T18:46:20.121Z","finished_at":"2026-08-03T18:46:24.861Z","expires_at":"2026-08-03T18:47:08.671Z"},{"snapshot_id":"s_e26fd0bb3183ab1b","operation":"live.instagram.profile","status":"ready","rows_total":50,"rows_ready":50,"rows_failed":0,"cost":"$0.0250","estimated_cost":"$0.0250","format":"ndjson","include_errors":false,"created_at":"2026-08-03T18:42:57.717Z","finished_at":"2026-08-03T18:43:49.993Z","expires_at":"2026-08-17T18:42:57.717Z"}],"next_cursor":"1785782577717"},"meta":{"cost":"$0.0000","balance":"$6.5720","request_id":"req_467f3bea489f9c952e7df2323a6f531f"}}}}},"400":{"$ref":"#/components/responses/InvalidRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/InsufficientBalance"},"429":{"$ref":"#/components/responses/RateLimitExceeded"},"502":{"$ref":"#/components/responses/UpstreamError"},"503":{"$ref":"#/components/responses/BillingUnavailable"},"504":{"$ref":"#/components/responses/UpstreamTimeout"}}}}}}