Analyze clip by URL

Query parameters

This endpoint has no query parameters.

Request body

Send JSON with Content-Type: application/json.

• urlstringrequired

  Public clip URL

  Example: https://www.instagram.com/reel/ABC123/

• asyncbooleanoptional

  Default true. Set false to wait for completion.

  Example: true

{
  "url": "https://www.instagram.com/reel/ABC123/",
  "async": true
}

Response

202 Waits until the clip is scraped and assigned an id, then returns. When `async` is true (default), Gemini analysis may still be running (`status: processing`). When `async` is false, waits for full analysis (`status: completed`).

• job_idstring | nullrequired

  Job id when async; null when sync completed

• statusstringrequired

  `processing` or `completed`

• collection_idstringoptional

  One-off collection id for the clip

• clip_idstringrequired

  Clip id (available after scrape; use with clip analytics)

{
  "job_id": "82fde0d4-1111-2222-3333-444455556666",
  "status": "processing",
  "collection_id": "c1a2b3c4-1111-2222-3333-444455556666",
  "clip_id": "3858d56f-8c7e-4602-8f23-ab329c9cc0e0"
}