Create creator

Query parameters

This endpoint has no query parameters.

Request body

Send JSON with Content-Type: application/json.

• profileUrlstringrequired

  Public profile URL

  Example: https://www.instagram.com/natgeo/

• namestringoptional

  Optional display name override

• maxCountintegeroptional

  Max videos to analyze (capped by plan/API quota)

  Example: 50

• refreshbooleanoptional

  Enable continuous refresh analysis

  Example: true

{
  "profileUrl": "https://www.instagram.com/natgeo/",
  "maxCount": 20,
  "refresh": false
}

Response

202 Accepted. Poll `job_id` or wait for `creator.ready`.

• creator_idstringrequired

  Creator id to use in later calls

• job_idstring | nullrequired

  Async job id for polling GET /jobs/:id

• statusstringrequired

  Job status such as `processing` or `queued`

• already_attachedbooleanoptional

  True when the profile was already attached (create only)

• credits_chargednumberoptional

  Credits charged for this create (create only)

{
  "creator_id": "354bb8ac-1111-2222-3333-444455556666",
  "job_id": "82fde0d4-1111-2222-3333-444455556666",
  "status": "processing",
  "already_attached": false,
  "credits_charged": 0
}