Get Creator Emails

Use POST /v1/creator-emails/lookup to fetch known email addresses for creators. You can look up creators by Influship creator ID or by social username.

Before you start	Details
Auth	API key or OAuth
Resource	Instagram creator ID or handle
Cost	5 credits per unique resolved creator with returned emails
Limits	1–100 lookups per request; empty email arrays are not billed

Each resolved creator includes their available email addresses and validation status. Check each address’s status and timestamps before adding it to your outreach workflow.

curl -s "https://api.influship.com/v1/creator-emails/lookup" \
  -H "X-API-Key: $INFLUSHIP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "creators": [
      { "platform": "instagram", "username": "alexrivera.fit" },
      { "platform": "instagram", "username": "missing_example" }
    ]
  }'

Billing

Creator email lookup costs 5 credits per unique resolved creator with at least one returned email. Empty results and unresolved creators are not charged.

Inspect the response

This fictional example has one resolved creator with an unvalidated email, plus one unresolved input. Results preserve input order:

{
  "data": {
    "results": [
      {
        "input": {"platform": "instagram", "username": "alexrivera.fit"},
        "creator_id": "123e4567-e89b-12d3-a456-426614174000",
        "resolved": true,
        "emails": [{
          "email": "alex@example.com", "status": "unvalidated", "confidence": null,
          "is_primary": true, "validated_at": null,
          "first_seen_at": "2026-10-01T12:00:00Z", "last_seen_at": "2026-10-05T12:00:00Z"
        }]
      },
      {
        "input": {"platform": "instagram", "username": "missing_example"},
        "creator_id": null, "resolved": false, "emails": []
      }
    ],
    "billing": {"billable_results": 1, "credits_charged": 5}
  }
}

One resolved creator with emails costs 5 credits ($0.05); the unresolved row costs nothing. A resolved creator with an empty emails array also costs nothing. Neither an empty array nor a successful resolution promises a deliverable address.

Response fields

Each email includes:

Field	Meaning
`email`	Email address as stored
`status`	`unvalidated`, `valid`, `risky`, or `creator_verified`
`confidence`	Nullable score from import or enrichment
`is_primary`	Whether this is the selected primary email
`validated_at`	Last validation time, if known
`first_seen_at`	First time Influship observed the email
`last_seen_at`	Most recent observation time

Choose how to use an address

Status	Application handling
`unvalidated`	Display as unvalidated; do not infer deliverability from a confidence score
`risky`	Keep out of automatic send queues pending your review
`valid`	Inspect `validated_at`; a historical validation is not a delivery guarantee
`creator_verified`	Preserve the verification label and timestamps; do not infer current deliverability

resolved: false means the creator was not resolved. resolved: true with emails: [] means no email address was returned for that creator. For missing Instagram handles, see ingestion; for temporary failures, use Error Handling.

Start building

Find and evaluate creators

Research and save

Apps and workflows

Live platform data

Connect your tools

Operate your integration

Billing

Inspect the response

Response fields

Choose how to use an address

​Billing

​Inspect the response

​Response fields

​Choose how to use an address

Billing

Inspect the response

Response fields

Choose how to use an address