Skip to main content

​
Ingest Creators On Demand

Most creators you search for are already in Influship. When one is not, use POST /v1/creators/ingest to request it. We validate the handle live to confirm it exists, seed a profile, and start building it in the background. You then poll for the result. Only Instagram is supported today.
The source_query field is optional. It is a free-text note for your own attribution — for example the search that surfaced this creator — and does not affect processing.

​
Responses

A new ingest returns 202 Accepted:
If we already have the creator, you get 200 OK with status: "already_exists" and the same shape. This path is not charged.

​
Polling for the Profile

The profile builds asynchronously. Poll the returned status_url (which is GET /v1/creators/{id}) to retrieve it:
  • Basic header details (name, bio) are usually available within about a minute.
  • Full analysis and synthesized fields fill in within about a day.
  • While the profile is still building, GET /v1/creators/{id} may return 404 or sparse fields. Keep polling with a sensible backoff — every few minutes is plenty.

​
Billing

Ingest costs 5 credits ($0.05), charged only when a new creator is seeded (the 202 path). You are not charged when:
  • the creator already exists (200 already_exists),
  • the handle does not exist (404),
  • the handle format is invalid (422),
  • or you exceed the daily quota (429).

​
Limits

Each account has a daily ingest quota (default 50 per UTC day). Exceeding it returns 429 with error.code: "quota_exceeded" and a Retry-After header pointing to the next UTC midnight:
If you need a higher quota, reach out at elliot@influship.com.

​
Error Reference