Lookup Creator Emails

Look up known email addresses for creators by creator ID or social username.

Billing behavior:

• Charged only for unique resolved creators with at least one returned email
• Empty and unresolved results are not billable
• Returns validation status so unvalidated emails are explicit

Pricing: 5 credits per creator with at least one returned email ($0.05)

POST /v1/creator-emails/lookup

cURL

cURL

curl --request POST \
  --url https://api.influship.com/v1/creator-emails/lookup \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "creators": [
    {
      "creator_id": "123e4567-e89b-12d3-a456-426614174000"
    }
  ]
}
'

import Influship from 'influship';

const client = new Influship({
  apiKey: process.env['INFLUSHIP_API_KEY'], // This is the default and can be omitted
});

const response = await client.creatorEmails.lookup({
  creators: [{ creator_id: '123e4567-e89b-12d3-a456-426614174000' }],
});

console.log(response.data);

import os
from influship import Influship

client = Influship(
    api_key=os.environ.get("INFLUSHIP_API_KEY"),  # This is the default and can be omitted
)
response = client.creator_emails.lookup(
    creators=[{
        "creator_id": "123e4567-e89b-12d3-a456-426614174000"
    }],
)
print(response.data)

200

{
  "data": {
    "results": [
      {
        "input": {
          "creator_id": "123e4567-e89b-12d3-a456-426614174000"
        },
        "creator_id": "123e4567-e89b-12d3-a456-426614174000",
        "resolved": true,
        "emails": [
          {
            "email": "[e-mail]",
            "status": "unvalidated",
            "confidence": 0.72,
            "is_primary": false,
            "validated_at": null,
            "first_seen_at": "2026-05-01T00:00:00Z",
            "last_seen_at": "2026-05-02T00:00:00Z"
          }
        ]
      }
    ],
    "billing": {
      "billable_results": 1,
      "credits_charged": 5
    }
  }
}

{
  "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

Creator email lookup request

Creator email lookup request

creators · object[] · required

Creator lookups to resolve. Response rows preserve this input order.

Required array length: 1 - 100 elements

Creator email lookup input by creator ID or social handle

Option 1

Option 2

Show child attributes

Response

200

application/json

Creator email lookup response

Creator email lookup response

data · object · required

Show child attributes