Skip to main content

​
Lookup 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. The endpoint returns every API-visible email we have for each resolved creator. Emails can be unvalidated, so check status before treating an address as deliverable. 
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": "creator" },
      { "creator_id": "123e4567-e89b-12d3-a456-426614174000" }
    ]
  }'

​
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. The response includes a billing preview: 
{
  "data": {
    "billing": {
      "billable_results": 1,
      "credits_charged": 5
    }
  }
}

​
Response fields

Each email includes:
FieldMeaning
emailEmail address as stored
statusunvalidated, valid, risky, or creator_verified
confidenceNullable score from import or enrichment
is_primaryWhether this is the selected primary email
validated_atLast validation time, if known
first_seen_atFirst time Influship observed the email
last_seen_atMost recent observation time