Ingest a Creator On Demand

curl --request POST \
  --url https://api.influship.com/v1/creators/ingest \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "platform": "instagram",
  "username": "fitness_coach_jane"
}
'

const options = {
  method: 'POST',
  headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({platform: 'instagram', username: 'fitness_coach_jane'})
};

fetch('https://api.influship.com/v1/creators/ingest', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.influship.com/v1/creators/ingest"

payload = {
    "platform": "instagram",
    "username": "fitness_coach_jane"
}
headers = {
    "X-API-Key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "data": {
    "status": "ingesting",
    "creator": {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "username": "fitness_coach_jane",
      "platform": "instagram"
    },
    "status_url": "/v1/creators/123e4567-e89b-12d3-a456-426614174000"
  }
}

{
  "data": {
    "status": "ingesting",
    "creator": {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "username": "fitness_coach_jane",
      "platform": "instagram"
    },
    "status_url": "/v1/creators/123e4567-e89b-12d3-a456-426614174000"
  }
}

{
  "error": {
    "code": "validation_error",
    "message": "Request validation failed",
    "param": "query",
    "request_id": "550e8400-e29b-41d4-a716-446655440000",
    "details": {}
  }
}

{
  "error": {
    "code": "validation_error",
    "message": "Request validation failed",
    "param": "query",
    "request_id": "550e8400-e29b-41d4-a716-446655440000",
    "details": {}
  }
}

{
  "error": {
    "code": "validation_error",
    "message": "Request validation failed",
    "param": "query",
    "request_id": "550e8400-e29b-41d4-a716-446655440000",
    "details": {}
  }
}

{
  "error": {
    "code": "validation_error",
    "message": "Request validation failed",
    "param": "query",
    "request_id": "550e8400-e29b-41d4-a716-446655440000",
    "details": {}
  }
}

{
  "error": {
    "code": "validation_error",
    "message": "Request validation failed",
    "param": "query",
    "request_id": "550e8400-e29b-41d4-a716-446655440000",
    "details": {}
  }
}

{
  "error": {
    "code": "validation_error",
    "message": "Request validation failed",
    "param": "query",
    "request_id": "550e8400-e29b-41d4-a716-446655440000",
    "details": {}
  }
}

{
  "error": {
    "code": "validation_error",
    "message": "Request validation failed",
    "param": "query",
    "request_id": "550e8400-e29b-41d4-a716-446655440000",
    "details": {}
  }
}

Creators

Ingest a Creator On Demand

Request ingestion of a creator we do not yet have. The handle is validated live before anything is created, then a profile is seeded and enrichment begins asynchronously.

How it works:

The handle is normalized and validated live to confirm it exists
If we already have the creator, you get 200 with status: already_exists and are not charged
Otherwise a profile is seeded and you get 202 with status: ingesting

Polling for results: Use the returned status_url (GET /v1/creators/{id}) to poll for the built profile. Basic header details are usually available within about a minute; full analysis and synthesized fields fill in within about a day. While the profile is still building, that endpoint may return 404 or sparse fields.

Limits:

Only instagram is supported today
Each account has a daily ingest quota; exceeding it returns 429 with quota_exceeded and a Retry-After header
Handles that do not exist return 404 and are not charged

Pricing: 5 credits per creator ingested ($0.05). Charged only when a new creator is seeded — existing, not-found, and invalid handles are free.

POST

creators

ingest

Ingest a Creator On Demand

curl --request POST \
  --url https://api.influship.com/v1/creators/ingest \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "platform": "instagram",
  "username": "fitness_coach_jane"
}
'

const options = {
  method: 'POST',
  headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({platform: 'instagram', username: 'fitness_coach_jane'})
};

fetch('https://api.influship.com/v1/creators/ingest', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.influship.com/v1/creators/ingest"

payload = {
    "platform": "instagram",
    "username": "fitness_coach_jane"
}
headers = {
    "X-API-Key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "data": {
    "status": "ingesting",
    "creator": {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "username": "fitness_coach_jane",
      "platform": "instagram"
    },
    "status_url": "/v1/creators/123e4567-e89b-12d3-a456-426614174000"
  }
}

{
  "data": {
    "status": "ingesting",
    "creator": {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "username": "fitness_coach_jane",
      "platform": "instagram"
    },
    "status_url": "/v1/creators/123e4567-e89b-12d3-a456-426614174000"
  }
}

{
  "error": {
    "code": "validation_error",
    "message": "Request validation failed",
    "param": "query",
    "request_id": "550e8400-e29b-41d4-a716-446655440000",
    "details": {}
  }
}

{
  "error": {
    "code": "validation_error",
    "message": "Request validation failed",
    "param": "query",
    "request_id": "550e8400-e29b-41d4-a716-446655440000",
    "details": {}
  }
}

{
  "error": {
    "code": "validation_error",
    "message": "Request validation failed",
    "param": "query",
    "request_id": "550e8400-e29b-41d4-a716-446655440000",
    "details": {}
  }
}

{
  "error": {
    "code": "validation_error",
    "message": "Request validation failed",
    "param": "query",
    "request_id": "550e8400-e29b-41d4-a716-446655440000",
    "details": {}
  }
}

{
  "error": {
    "code": "validation_error",
    "message": "Request validation failed",
    "param": "query",
    "request_id": "550e8400-e29b-41d4-a716-446655440000",
    "details": {}
  }
}

{
  "error": {
    "code": "validation_error",
    "message": "Request validation failed",
    "param": "query",
    "request_id": "550e8400-e29b-41d4-a716-446655440000",
    "details": {}
  }
}

{
  "error": {
    "code": "validation_error",
    "message": "Request validation failed",
    "param": "query",
    "request_id": "550e8400-e29b-41d4-a716-446655440000",
    "details": {}
  }
}

Authorizations

X-API-Key

string

header

required

Body

application/json

On-demand creator ingest request

platform

enum<string>

required

Platform of the handle to ingest. Only instagram is supported today.

Available options:

instagram

Example:

"instagram"

username

string

required

Handle to ingest. A leading @ is stripped and the handle is lowercased before validation.

Required string length: 1 - 50

Example:

"fitness_coach_jane"

source_query

string

Optional free-text note describing why this creator is being ingested (e.g. the search that surfaced them). Stored for your own attribution; does not affect processing.

Maximum string length: 500

Example:

"vegan fitness coaches in Austin"

Response

Successful response

data

object

required

On-demand creator ingest result

Show child attributes

Autocomplete Search Get Creator by ID

Overview

Endpoints

Ingest a Creator On Demand

Authorizations

Body

Response