List a creator's videos (GET /v1/creators/{platform}/{handle}/videos)

GET/v1/creators/{platform}/{handle}/videos

The creator's videos as we already hold them, newest first, each with its Scores. A read of stored data that makes no vendor call: to get fresh videos, call the creator lookup with include=videos first and page here afterwards. With intelligence=true the page is analysed exactly like POST /v1/videos/search with intelligence: true, on every Platform: a Run whose passes run as a workflow, one RunItem per analysed video at GET /v1/runs/{id}/items, at most 20 videos analysed. A video that cannot be analysed (media_unavailable, or video_too_long past 10 minutes) comes back with intelligence: null and intelligence_error, uncharged; a Run where none could be analysed fails free.

Open in Playground(no API Key needed)

Price

Free. Counts toward the per-key request limit. intelligence=true costs 20 credits for each of the first 20 videos analysed, whether analysed now or already; the page itself stays free.

Supports estimate=true: the reply is the price in Credits and whether it would be cached, with no Run created and nothing charged.

Parameters

Name	In	Type	Required	Default	Description
`platform`	path	`string`one of `tiktok`, `instagram`, `youtube`, `facebook`	Required	—	Platform the subject lives on.
`handle`	path	`string`	Required	—	A bare handle, an `@handle`, or a URL-encoded profile URL — whichever the user pasted.
`limit`	query	`integer`min 1; max 100	Optional	`25`	Items per page.
`cursor`	query	`string`	Optional	—	Opaque `next_cursor` from the previous page.
`intelligence`	query	`boolean`	Optional	—	Analyse the page's first 20 videos in a Run, like search with `intelligence: true`. Takes `wait`, `estimate` and an Idempotency-Key.
`wait`	query	`integer`min 0; max 120	Optional	`30`	Seconds to hold the response open before handing back a running Run to poll. Default 30, max 120. A POST may send it in the body instead; given in both places with different values it is a 400.
`estimate`	query	`boolean`	Optional	—	`true` returns `{ estimate_credits, cached }` computed from what is already stored, and creates no Run. Nothing is charged. Only `true` or `false`; anything else is a 400. A POST may send it in the body instead; given in both places with different values it is a 400.
`Idempotency-Key`	header	`string`	Optional	—	1-255 printable ASCII characters. Replaying this key with the same payload returns the original Run (202 while it is still running); a different payload, or a different operation, is a 409 `idempotency_conflict`.

Responses

200 OK

{ items, next_cursor }. With intelligence=true, the Run envelope { run, result } instead, result being the page with intelligence on each analysed video (or { estimate_credits, ... } with estimate=true).

any of 3 shapes

Option 1object
- itemsarray of objectrequired
  platformstringrequired
  idstringrequired
  urlstringrequirednullable
  descriptionstringrequired
  posted_atstringrequirednullable
  duration_secondsnumberrequirednullable
  thumbnail_urlstringrequirednullable
  hashtagsarray of stringrequired
  soundobjectrequirednullable
  idstringrequired
  titlestringrequirednullable
  creatorobjectrequirednullable
  idstringrequired
  handlestringrequirednullable
  namestringrequired
  follower_countnumberrequirednullable
  snapshotobjectrequirednullable
  atstringrequired
  viewsnumberrequired
  likesnumberrequired
  commentsnumberrequired
  sharesnumberrequired
  savesnumberrequired
  scoresobjectrequirednullableNull when the creator has no baseline yet.
  outliernumberrequirednullableViews over the creator's median views.
  outlier_p90numberrequirednullable
  percentilenumberrequirednullableWhere this video sits in the creator's own sample, 0-100.
  velocityobjectrequirednullable
  views_per_hournumberrequired
  windowstringrequired
  reasonstringrequirednullablealways aged_outaged_out when the video is over 30 days old and Scores are null.
  baselineobjectrequiredThe yardstick every Score on this creator is measured against.
  median_viewsnumberrequired
  p90_viewsnumberrequired
  engagement_ratenumberrequirednullable
  posts_per_weeknumberrequirednullable
  sampleintegerrequired
  confidencestringrequiredone of high, low
  sourcestringrequiredone of videos, follower_tier
  computed_atstringrequirednullable
  stalebooleanrequiredTrue past 7 days; the next lookup refreshes it.
  coveragestringalways partialPresent only where the platform's index is best-effort.
- next_cursorstringrequirednullablePass back as cursor. Null on the last page.
Option 2object
- runobjectrequiredEvery charged operation creates a Run. The envelope is identical whether the result came back inline or was polled.
  idstringrequired
  kindstringrequiredWhat was run, e.g. video_lookup.
  statusstringrequiredone of running, completed, partial, failedpartial keeps the completed items and charges for them, up to what the Balance covers; failed charges nothing.
  created_atstringrequiredRFC 3339.
  completed_atstringrequirednullableNull while the Run is still running.
  charge_creditsintegerrequiredWhat this Run actually cost, in Credits. A stored answer costs the same as a fresh one.
  list_price_creditsintegerrequiredThe full price of the work asked for, in Credits. Equal to charge_credits unless the Run charged for only part of it.
  cachedbooleanrequiredTrue when a stored result answered without paying the vendor.
  progressobjectWhat a running Research has done so far, refreshed as it works: stage (keywords, searching, filtering, analysing, writing_digest) and the counts known by then — keywords, found, kept, dropped_off_topic, and analysed of shortlisted. A count is absent until its stage produced it. Absent once the Run settles, and on every other kind.
  stagestringrequiredone of keywords, searching, filtering, analysing, writing_digest
  keywordsintegervalue at least 0
  searchesintegervalue at least 0
  foundintegervalue at least 0
  judgedintegervalue at least 0
  keptintegervalue at least 0
  dropped_off_topicintegervalue at least 0
  dropped_unsureintegervalue at least 0
  shortlistedintegervalue at least 0
  analysedintegervalue at least 0
  updated_atstringrequired
- resultobjectrequired
  itemsarray of objectrequired
  platformstringrequired
  idstringrequired
  urlstringrequirednullable
  descriptionstringrequired
  posted_atstringrequirednullable
  duration_secondsnumberrequirednullable
  thumbnail_urlstringrequirednullable
  hashtagsarray of stringrequired
  soundobjectrequirednullable
  idstringrequired
  titlestringrequirednullable
  creatorobjectrequirednullable
  idstringrequired
  handlestringrequirednullable
  namestringrequired
  follower_countnumberrequirednullable
  snapshotobjectrequirednullable
  atstringrequired
  viewsnumberrequired
  likesnumberrequired
  commentsnumberrequired
  sharesnumberrequired
  savesnumberrequired
  scoresobjectrequirednullableNull when the creator has no baseline yet.
  outliernumberrequirednullableViews over the creator's median views.
  outlier_p90numberrequirednullable
  percentilenumberrequirednullableWhere this video sits in the creator's own sample, 0-100.
  velocityobjectrequirednullable
  views_per_hournumberrequired
  windowstringrequired
  reasonstringrequirednullablealways aged_outaged_out when the video is over 30 days old and Scores are null.
  baselineobjectrequiredThe yardstick every Score on this creator is measured against.
  median_viewsnumberrequired
  p90_viewsnumberrequired
  engagement_ratenumberrequirednullable
  posts_per_weeknumberrequirednullable
  sampleintegerrequired
  confidencestringrequiredone of high, low
  sourcestringrequiredone of videos, follower_tier
  computed_atstringrequirednullable
  stalebooleanrequiredTrue past 7 days; the next lookup refreshes it.
  coveragestringalways partialPresent only where the platform's index is best-effort.
  intelligenceobjectnullableThe analysis. Null when this video could not be analysed (uncharged); absent past the cap.
  versionintegerrequired
  modelstringrequired
  computed_atstringrequired
  sourcestringrequired
  contentobjectrequired
  summarystringrequired
  nichestringrequired
  languagesarray of stringrequired
  content_stylesarray of stringrequired
  keywordsarray of objectrequired
  keywordstringrequired
  categorystringrequired
  sentimentnumberrequired
  transcriptstringrequirednullable
  hookobjectrequired
  opening_linestringrequirednullable
  typestringrequired
  visual_hookstringrequirednullable
  rationalestringrequirednullable
  persuasionobjectrequired
  call_to_actionobjectrequired
  typestringrequired
  textstringrequirednullable
  sponsoredbooleanrequired
  sponsorship_signalsarray of stringrequired
  brands_and_productsarray of objectrequired
  namestringrequired
  kindstringrequired
  prominencestringrequired
  trend_referencesarray of objectrequired
  namestringrequired
  kindstringrequired
  toneobjectrequired
  sentiment_labelstringrequired
  sentiment_scorenumberrequired
  primary_emotionstringrequired
  emotion_intensitynumberrequirednullable
  emotion_rationalestringrequirednullable
  speaking_stylestringrequired
  speaking_style_notesstringrequirednullable
  visualobjectrequired
  formatstringrequired
  settingstringrequired
  face_visibilitystringrequired
  on_screen_textarray of stringrequired
  has_on_screen_captionsbooleanrequired
  camera_notesstringrequirednullable
  lighting_notesstringrequirednullable
  elementsany
  safetyobjectrequired
  brand_safety_tierstringrequired
  reasonsarray of stringrequired
  notesstringrequirednullable
  intelligence_errorobjectWhy intelligence is null.
  typestringrequired
  titlestringrequired
  statusintegerrequired
  codestringrequiredone of missing_authorization, invalid_key, key_revoked, invalid_token, organization_not_selected, organization_access_revoked, connection_revoked, forbidden, invalid_request, unsupported_platform, unsupported_kind, kind_deprecated, not_found, video_too_long, idempotency_conflict, run_not_ready, advertiser_ambiguous, insufficient_balance, rate_limit_exceeded, concurrency_limit_exceeded, tracker_limit_exceeded, webhook_limit_exceeded, webhook_rotation_in_progress, collection_limit_exceeded, collection_name_taken, collection_kind_mismatch, media_unavailable, vendor_error, source_unavailable, service_unavailable, internal_errorStable machine-readable code.
  detailstring
  next_cursorstringrequirednullable
  intelligenceobjectrequiredPer-video outcomes page at GET /v1/runs/{id}/items.
  requestedintegerrequired
  completedintegerrequired
  failedintegerrequired
  capintegerrequired
Option 3objectReturned instead of a Run when estimate=true. Nothing is charged. Operations with more to say about a quote add members; the two above are always present.
- estimate_creditsintegerrequiredWhat the call would be charged, in Credits.
- cachedbooleanrequiredWhether a stored result can already answer. It does not change the price.

200 · `{ items, next_cursor }`. With `intelligence=true`, the Run envelope `{ run, result }` instead, `result` being the page with `intelligence` on each analysed video (or `{ estimate_credits, ... }` with `estimate=true`).

{
  "items": [
    {
      "platform": "tiktok",
      "id": "7300000000000000000",
      "url": "https://www.tiktok.com/@someone/video/7300000000000000000",
      "description": "3 minutes at 4°C every morning for 30 days. Here is what actually changed. #coldplunge #recovery",
      "posted_at": "2026-09-05T06:32:11.000Z",
      "duration_seconds": 41,
      "thumbnail_url": "https://p16-sign.tiktokcdn.com/obj/tos-cover-7300000000000000000.jpeg",
      "hashtags": [
        "coldplunge",
        "recovery",
        "morningroutine"
      ],
      "sound": {
        "id": "7180000000000000000",
        "title": "original sound - someone"
      },
      "creator": {
        "id": "cre_9d4b2a7f1c",
        "handle": "someone",
        "name": "Someone",
        "follower_count": 184300
      },
      "snapshot": {
        "at": "2026-09-08T09:14:04.219Z",
        "views": 1284000,
        "likes": 143200,
        "comments": 2810,
        "shares": 9040,
        "saves": 21600
      },
      "scores": {
        "outlier": 4.21,
        "outlier_p90": 1.6,
        "percentile": 95,
        "velocity": {
          "views_per_hour": 6698.6,
          "window": "snapshot"
        },
        "reason": null,
        "baseline": {
          "median_views": 305000,
          "p90_views": 802000,
          "engagement_rate": 0.1342,
          "posts_per_week": 4.1,
          "sample": 20,
          "confidence": "high",
          "source": "videos",
          "computed_at": "2026-09-08T09:14:03.902Z",
          "stale": false
        }
      }
    },
    {
      "platform": "tiktok",
      "id": "7300000000000000042",
      "url": "https://www.tiktok.com/@anotherone/video/7300000000000000042",
      "description": "I tried cold plunging before every workout for a week. #coldplunge",
      "posted_at": "2026-09-06T13:04:52.000Z",
      "duration_seconds": 28,
      "thumbnail_url": "https://p16-sign.tiktokcdn.com/obj/tos-cover-7300000000000000042.jpeg",
      "hashtags": [
        "coldplunge",
        "gym"
      ],
      "sound": {
        "id": "7180000000000000099",
        "title": "Winter Air"
      },
      "creator": {
        "id": "cre_1a77c0b3de",
        "handle": "anotherone",
        "name": "Another One",
        "follower_count": 21400
      },
      "snapshot": {
        "at": "2026-09-08T09:14:04.219Z",
        "views": 96200,
        "likes": 8140,
        "comments": 212,
        "shares": 401,
        "saves": 1180
      },
      "scores": null
    }
  ],
  "next_cursor": "eyJpZCI6ImNsdjRxOHkifQ"
}

202 Accepted

Still running: { run }. Poll GET /v1/runs/{id}.

object

Still running. Poll GET /v1/runs/{id}.

runobjectrequiredEvery charged operation creates a Run. The envelope is identical whether the result came back inline or was polled.
- idstringrequired
- kindstringrequiredWhat was run, e.g. video_lookup.
- statusstringrequiredone of running, completed, partial, failedpartial keeps the completed items and charges for them, up to what the Balance covers; failed charges nothing.
- created_atstringrequiredRFC 3339.
- completed_atstringrequirednullableNull while the Run is still running.
- charge_creditsintegerrequiredWhat this Run actually cost, in Credits. A stored answer costs the same as a fresh one.
- list_price_creditsintegerrequiredThe full price of the work asked for, in Credits. Equal to charge_credits unless the Run charged for only part of it.
- cachedbooleanrequiredTrue when a stored result answered without paying the vendor.
- progressobjectWhat a running Research has done so far, refreshed as it works: stage (keywords, searching, filtering, analysing, writing_digest) and the counts known by then — keywords, found, kept, dropped_off_topic, and analysed of shortlisted. A count is absent until its stage produced it. Absent once the Run settles, and on every other kind.
  stagestringrequiredone of keywords, searching, filtering, analysing, writing_digest
  keywordsintegervalue at least 0
  searchesintegervalue at least 0
  foundintegervalue at least 0
  judgedintegervalue at least 0
  keptintegervalue at least 0
  dropped_off_topicintegervalue at least 0
  dropped_unsureintegervalue at least 0
  shortlistedintegervalue at least 0
  analysedintegervalue at least 0
  updated_atstringrequired

202 · Example

{
  "run": {
    "id": "run_8f2c1ad04b",
    "kind": "creator_videos",
    "status": "running",
    "created_at": "2026-09-08T09:14:02.418Z",
    "completed_at": null,
    "charge_credits": 0,
    "list_price_credits": 0,
    "cached": false
  }
}

400 Bad Request

invalid_request (a malformed id, wait, estimate or Idempotency-Key) or unsupported_platform, refused before any Run opens. Nothing is charged.

object

RFC 9457 problem document, served as application/problem+json. Branch on code, never on the prose.

typestringrequired
titlestringrequired
statusintegerrequired
codestringrequiredone of missing_authorization, invalid_key, key_revoked, invalid_token, organization_not_selected, organization_access_revoked, connection_revoked, forbidden, invalid_request, unsupported_platform, unsupported_kind, kind_deprecated, not_found, video_too_long, idempotency_conflict, run_not_ready, advertiser_ambiguous, insufficient_balance, rate_limit_exceeded, concurrency_limit_exceeded, tracker_limit_exceeded, webhook_limit_exceeded, webhook_rotation_in_progress, collection_limit_exceeded, collection_name_taken, collection_kind_mismatch, media_unavailable, vendor_error, source_unavailable, service_unavailable, internal_errorStable machine-readable code.
detailstring

400 · Example

{
  "type": "https://www.shortsintel.com/docs/reference/errors/invalid_request",
  "title": "Invalid request",
  "status": 400,
  "code": "invalid_request",
  "detail": "`estimate` must be `true` or `false`."
}

401 Unauthorized

missing_authorization, invalid_key, key_revoked or invalid_token.

object

RFC 9457 problem document, served as application/problem+json. Branch on code, never on the prose.

typestringrequired
titlestringrequired
statusintegerrequired
codestringrequiredone of missing_authorization, invalid_key, key_revoked, invalid_token, organization_not_selected, organization_access_revoked, connection_revoked, forbidden, invalid_request, unsupported_platform, unsupported_kind, kind_deprecated, not_found, video_too_long, idempotency_conflict, run_not_ready, advertiser_ambiguous, insufficient_balance, rate_limit_exceeded, concurrency_limit_exceeded, tracker_limit_exceeded, webhook_limit_exceeded, webhook_rotation_in_progress, collection_limit_exceeded, collection_name_taken, collection_kind_mismatch, media_unavailable, vendor_error, source_unavailable, service_unavailable, internal_errorStable machine-readable code.
detailstring

401 · Example

{
  "type": "https://www.shortsintel.com/docs/reference/errors/invalid_key",
  "title": "Invalid key",
  "status": 401,
  "code": "invalid_key",
  "detail": "That API key does not exist. Keys look like `sk_live_...` and are created in the console."
}

402 Payment Required

insufficient_balance — the Balance cannot cover the quoted price (the worst case for Research and enriched search). No Run is created and nothing is charged. A multi-item Run whose Balance runs short later charges its completed items up to the Balance and ends partial.

object

RFC 9457 problem document, served as application/problem+json. Branch on code, never on the prose.

typestringrequired
titlestringrequired
statusintegerrequired
codestringrequiredone of missing_authorization, invalid_key, key_revoked, invalid_token, organization_not_selected, organization_access_revoked, connection_revoked, forbidden, invalid_request, unsupported_platform, unsupported_kind, kind_deprecated, not_found, video_too_long, idempotency_conflict, run_not_ready, advertiser_ambiguous, insufficient_balance, rate_limit_exceeded, concurrency_limit_exceeded, tracker_limit_exceeded, webhook_limit_exceeded, webhook_rotation_in_progress, collection_limit_exceeded, collection_name_taken, collection_kind_mismatch, media_unavailable, vendor_error, source_unavailable, service_unavailable, internal_errorStable machine-readable code.
detailstring

402 · Example

{
  "type": "https://www.shortsintel.com/docs/reference/errors/insufficient_balance",
  "title": "Insufficient balance",
  "status": 402,
  "code": "insufficient_balance",
  "detail": "Your balance does not cover this operation. Top up in the console.",
  "balance_credits": 0,
  "required_credits": 20
}

404 Not Found

not_found — including anything belonging to another Customer.

object

RFC 9457 problem document, served as application/problem+json. Branch on code, never on the prose.

typestringrequired
titlestringrequired
statusintegerrequired
codestringrequiredone of missing_authorization, invalid_key, key_revoked, invalid_token, organization_not_selected, organization_access_revoked, connection_revoked, forbidden, invalid_request, unsupported_platform, unsupported_kind, kind_deprecated, not_found, video_too_long, idempotency_conflict, run_not_ready, advertiser_ambiguous, insufficient_balance, rate_limit_exceeded, concurrency_limit_exceeded, tracker_limit_exceeded, webhook_limit_exceeded, webhook_rotation_in_progress, collection_limit_exceeded, collection_name_taken, collection_kind_mismatch, media_unavailable, vendor_error, source_unavailable, service_unavailable, internal_errorStable machine-readable code.
detailstring

404 · Example

{
  "type": "https://www.shortsintel.com/docs/reference/errors/not_found",
  "title": "Not found",
  "status": 404,
  "code": "not_found",
  "detail": "No such resource for this Customer."
}

409 Conflict

idempotency_conflict — the same Idempotency-Key with a different payload.

object

RFC 9457 problem document, served as application/problem+json. Branch on code, never on the prose.

typestringrequired
titlestringrequired
statusintegerrequired
codestringrequiredone of missing_authorization, invalid_key, key_revoked, invalid_token, organization_not_selected, organization_access_revoked, connection_revoked, forbidden, invalid_request, unsupported_platform, unsupported_kind, kind_deprecated, not_found, video_too_long, idempotency_conflict, run_not_ready, advertiser_ambiguous, insufficient_balance, rate_limit_exceeded, concurrency_limit_exceeded, tracker_limit_exceeded, webhook_limit_exceeded, webhook_rotation_in_progress, collection_limit_exceeded, collection_name_taken, collection_kind_mismatch, media_unavailable, vendor_error, source_unavailable, service_unavailable, internal_errorStable machine-readable code.
detailstring

409 · Example

{
  "type": "https://www.shortsintel.com/docs/reference/errors/idempotency_conflict",
  "title": "Idempotency conflict",
  "status": 409,
  "code": "idempotency_conflict",
  "detail": "This Idempotency-Key was used with a different payload.",
  "run_id": "run_8f2c1ad04b"
}

429 Too Many Requests

rate_limit_exceeded or concurrency_limit_exceeded, with Retry-After.

object

RFC 9457 problem document, served as application/problem+json. Branch on code, never on the prose.

typestringrequired
titlestringrequired
statusintegerrequired
codestringrequiredone of missing_authorization, invalid_key, key_revoked, invalid_token, organization_not_selected, organization_access_revoked, connection_revoked, forbidden, invalid_request, unsupported_platform, unsupported_kind, kind_deprecated, not_found, video_too_long, idempotency_conflict, run_not_ready, advertiser_ambiguous, insufficient_balance, rate_limit_exceeded, concurrency_limit_exceeded, tracker_limit_exceeded, webhook_limit_exceeded, webhook_rotation_in_progress, collection_limit_exceeded, collection_name_taken, collection_kind_mismatch, media_unavailable, vendor_error, source_unavailable, service_unavailable, internal_errorStable machine-readable code.
detailstring

429 · Example

{
  "type": "https://www.shortsintel.com/docs/reference/errors/rate_limit_exceeded",
  "title": "Rate limit exceeded",
  "status": 429,
  "code": "rate_limit_exceeded",
  "detail": "60 requests per minute per key. Retry after the number of seconds in `Retry-After`.",
  "limit": 60
}

502 Bad Gateway

A Run that opened and then failed is answered as application/problem+json with its problem's status — vendor_error here, not_found as 404 — and the Run envelope alongside, so the Run id is kept. A failed Run is never charged.

object

RFC 9457 problem document, served as application/problem+json. Branch on code, never on the prose.

typestringrequired
titlestringrequired
statusintegerrequired
codestringrequiredone of missing_authorization, invalid_key, key_revoked, invalid_token, organization_not_selected, organization_access_revoked, connection_revoked, forbidden, invalid_request, unsupported_platform, unsupported_kind, kind_deprecated, not_found, video_too_long, idempotency_conflict, run_not_ready, advertiser_ambiguous, insufficient_balance, rate_limit_exceeded, concurrency_limit_exceeded, tracker_limit_exceeded, webhook_limit_exceeded, webhook_rotation_in_progress, collection_limit_exceeded, collection_name_taken, collection_kind_mismatch, media_unavailable, vendor_error, source_unavailable, service_unavailable, internal_errorStable machine-readable code.
detailstring

502 · Example

{
  "type": "https://www.shortsintel.com/docs/reference/errors/vendor_error",
  "title": "Vendor error",
  "status": 502,
  "code": "vendor_error",
  "detail": "The upstream data provider could not be reached.",
  "run": {
    "id": "run_8f2c1ad04b",
    "kind": "creator_videos",
    "status": "failed",
    "created_at": "2026-09-08T09:14:02.418Z",
    "completed_at": "2026-09-08T09:14:04.930Z",
    "charge_credits": 0,
    "list_price_credits": 0,
    "cached": false
  }
}

503 Service Unavailable

source_unavailable: every source this Run reads failed or is switched off. The Run fails uncharged, with its envelope alongside; endpoints names the source. Retry later rather than treating it as empty.

object

RFC 9457 problem document, served as application/problem+json. Branch on code, never on the prose.

typestringrequired
titlestringrequired
statusintegerrequired
codestringrequiredone of missing_authorization, invalid_key, key_revoked, invalid_token, organization_not_selected, organization_access_revoked, connection_revoked, forbidden, invalid_request, unsupported_platform, unsupported_kind, kind_deprecated, not_found, video_too_long, idempotency_conflict, run_not_ready, advertiser_ambiguous, insufficient_balance, rate_limit_exceeded, concurrency_limit_exceeded, tracker_limit_exceeded, webhook_limit_exceeded, webhook_rotation_in_progress, collection_limit_exceeded, collection_name_taken, collection_kind_mismatch, media_unavailable, vendor_error, source_unavailable, service_unavailable, internal_errorStable machine-readable code.
detailstring

503 · Example

{
  "type": "https://www.shortsintel.com/docs/reference/errors/source_unavailable",
  "title": "Source unavailable",
  "status": 503,
  "code": "source_unavailable",
  "detail": "The tiktok/video source is unavailable right now.",
  "endpoints": [
    "tiktok/video"
  ],
  "run": {
    "id": "run_8f2c1ad04b",
    "kind": "creator_videos",
    "status": "failed",
    "created_at": "2026-09-08T09:14:02.418Z",
    "completed_at": "2026-09-08T09:14:04.930Z",
    "charge_credits": 0,
    "list_price_credits": 0,
    "cached": false
  }
}

Request samples

curl "https://www.shortsintel.com/v1/creators/tiktok/someone/videos?limit=25&wait=30" \
  -H "Authorization: Bearer sk_live_YOUR_KEY"

const response = await fetch(
  "https://www.shortsintel.com/v1/creators/tiktok/someone/videos?limit=25&wait=30",
  {
    method: "GET",
    headers: {
      "Authorization": "Bearer sk_live_YOUR_KEY",
    },
  },
);

if (!response.ok) {
  throw new Error(`ShortsIntel ${response.status}`);
}

const data = await response.json();

import requests

response = requests.get(
    "https://www.shortsintel.com/v1/creators/tiktok/someone/videos?limit=25&wait=30",
    headers={
        "Authorization": "Bearer sk_live_YOUR_KEY",
    },
)
response.raise_for_status()

data = response.json()

This call creates a Run. With wait it holds the response open until the Run finishes or the wait runs out, then answers with the finished result or 202 and the running Run. Poll GET /v1/runs/{id} until it settles; re-reading a Run is free.

Runs: How a call becomes a Run, waiting inline, polling and free re-reads.
Pagination: Following next_cursor through a list.
Addressing videos and creators: Naming a video, creator, hashtag or sound.

Price

Parameters

Responses

200 OK

202 Accepted

400 Bad Request

401 Unauthorized

402 Payment Required

404 Not Found

409 Conflict

429 Too Many Requests

502 Bad Gateway

503 Service Unavailable

Request samples

Related guides