> ## Documentation Index
> Fetch the complete documentation index at: https://docs.socq.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Influencer Email Finder

> Find the public business emails of a creator from an Instagram, TikTok, YouTube, X or Facebook profile.

# Influencer Email Finder

Give it one creator profile and it goes looking for the emails that creator makes public: in the bio, behind link-in-bio pages, on linked websites and on the creator's accounts on other networks. Every email comes with the pages it was found on, so your outreach team can see where an address came from before using it.

```json theme={"dark"}
{
  "url": "https://www.instagram.com/miguelangeles"
}
```

Provide one Instagram, TikTok, YouTube, X or Facebook profile URL in url; a YouTube channel can be given by @handle or channel ID. When at least one email is found the result is one row and the lookup costs 8 credits. When none is found the task still succeeds, returns no rows and costs 0.5 credits. A profile that does not exist fails with a refund.

## Standard Result Fields

Task results use the stable SocQ fields below. Source-specific field names and formats are normalized without inferring or enriching values that the source did not provide. To request a smaller field set, use `fields` for MCP queries, `_result_fields` for typed tools, or `--result-fields` in the CLI. Declared fields remain present when their value is `null`.

| Field | Type | Nullable | Description |
| - | - | - | - |
| `id` | `string` | Yes | Unique identifier for this result item. |
| `platform` | `string` | No | Platform the result belongs to, such as `instagram` or `linkedin`. |
| `resource` | `string` | No | SocQ resource represented by the result, such as `videos` or `comments`. |
| `type` | `string` | No | Category of the result item, such as `video`, `post`, or `comment`. |
| `url` | `string` | Yes | Public URL of the result item when available. |
| `published_at` | `string` | Yes | Time the source item was published, in ISO 8601 format when available. |
| `collected_at` | `string` | No | Time SocQ collected or processed this result, in ISO 8601 format. |
| `username` | `string` | Yes | Handle of the profile that was looked up, without the leading @. For a YouTube channel given by ID, the channel ID. |
| `name` | `string` | Yes | Display name of the profile when available. |
| `emails` | `array<object>` | Yes | Public contact emails found for the account, each with the pages it was found on. |
| `emails.email` | `string` | Yes | Email address. |
| `emails.source_urls` | `array<string>` | Yes | Public pages where the email was found. |

The following example shows the response format for a completed task. Actual data depends on your query.

## Completed Task Response

```json theme={"dark"}
{
  "code": 200,
  "data": {
    "task_id": "example-creator-find-emails",
    "status": "succeeded",
    "public_id": "creator/find-emails",
    "result_count": 1,
    "credits_amount": 8,
    "results": {
      "limit": 50,
      "next_cursor": null,
      "has_more": false,
      "schema_id": "contact",
      "schema_version": "1.0",
      "items": [
        {
          "id": "instagram:miguelangeles",
          "platform": "creator",
          "resource": "find-emails",
          "type": "contact",
          "url": "https://www.instagram.com/miguelangeles",
          "published_at": null,
          "collected_at": "2026-11-17T23:54:19.492498Z",
          "username": "miguelangeles",
          "name": null,
          "emails": [
            {
              "email": "booking@amsbooking.fr",
              "source_urls": [
                "https://www.instagram.com/miguelangeles"
              ]
            },
            {
              "email": "mgmt@irlangel.com",
              "source_urls": [
                "https://www.instagram.com/miguelangeles",
                "https://www.youtube.com/@miguelangeles"
              ]
            },
            {
              "email": "miguel@irlangel.com",
              "source_urls": [
                "https://x.com/irlmiguel",
                "https://linktr.ee/miguelangeles"
              ]
            }
          ]
        }
      ]
    }
  }
}
```


## OpenAPI

````yaml api-manual/agent-api/agent-api.json POST /v1/creator/find-emails
openapi: 3.1.0
info:
  title: SocQ Agent API
  version: v1-87892a6484c2
  description: Asynchronous social data API generated from the SocQ Capability Registry.
servers:
  - url: https://api.socq.ai
security: []
paths:
  /v1/creator/find-emails:
    post:
      tags:
        - creator
      summary: Influencer Email Finder API
      description: Find the public contact emails of a creator from a social profile.
      operationId: socq_creator_find_emails
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $schema: https://json-schema.org/draft/2020-12/schema
              type: object
              additionalProperties: false
              properties:
                callback_url:
                  type: string
                  format: uri
                url:
                  type: string
                  minLength: 1
                  description: >-
                    Public profile URL, such as
                    https://www.instagram.com/<username> or
                    https://www.tiktok.com/@<username>.
              required:
                - url
              description: >-
                Provide one Instagram, TikTok, YouTube, X or Facebook profile
                URL in url. The profile, its bio links and its linked websites
                are checked for public contact emails; the result is one row
                listing each email with the pages it was found on.
      responses:
        '200':
          description: Task accepted
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AgentSubmitResponse'
        '422':
          description: Input validation failed
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AgentValidationErrorResponse'
      security:
        - bearerAuth: []
        - apiKeyAuth: []
components:
  schemas:
    AgentSubmitResponse:
      type: object
      properties:
        code:
          type: integer
          const: 200
        data:
          type: object
          properties:
            task_id:
              type: string
            status:
              type: string
            created_time:
              type:
                - string
                - 'null'
          required:
            - task_id
            - status
    AgentValidationErrorResponse:
      type: object
      properties:
        code:
          type: integer
          const: 422
        error:
          type: object
          properties:
            message:
              type: string
            type:
              type: string
            details:
              type: object
          required:
            - message
            - type
      required:
        - code
        - error
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
    apiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.