---
title: "Enrich by email"
method: POST
path: "/public/v1/creators/enrich/email/"
tags: ["Enrich by email"]
---

# Enrich by email

`POST /public/v1/creators/enrich/email/`

## Request

- Base URL: `https://api-dashboard.influencers.club`
- URL: `https://api-dashboard.influencers.club/public/v1/creators/enrich/email/`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/influencers/apis/core-api-concepts/docs/public/v1/creators/enrich/email/post.ts> (a function with typed inputs; its response is checked against the schema)

Perform basic enrichment of creator profiles using an email address.

**What you get**

- Returns the creator's single strongest platform — the one with the highest follower count — with essential profile data: basic social media presence, contact details, and platform account identifiers.
- Ideal for quick profile lookups and initial creator identification across Instagram, YouTube, TikTok, Twitter, Twitch, and OnlyFans.

**Credits**

- 0.05 credits per successful request. If no data is returned, no credits are deducted.

<div class="ic-ai-prompt-root" data-endpoint="email"></div>

## Request body

- EnrichBasicEmailRequest
  - `email` string, required: The creator's email address.

## Response `200`

- HandleEmailResponse
  - `result` HandleEmailPlatformResponse
    - `platform` string, nullable: The creator's social media platform.
    - `userId` string, nullable
    - `url` string, nullable: The creator's profile URL.
    - `username` string, nullable: The creator's username on the platform.
    - `fullname` string, nullable
    - `picture` string, nullable: URL to the creator's profile picture. This URL is temporary and expires after 24 hours. To keep the image, download it to your own storage before it expires.
    - `followers` integer, nullable
  - `credits_cost` number, double, nullable

## Other responses

- `400`: Bad request — invalid input or unsupported state.
- `401`: Unauthorized — missing or invalid API key.
- `403`: Forbidden — caller is not permitted to perform this action.
- `422`: Unprocessable entity — validation failed.
- `429`: Too Many Requests — rate or capacity limit exceeded. Inspect the `Retry-After` header and the `retry_after` body field for the wait time in seconds.

## Changes

- **2026-08-18** `87e654ac822e`: 3 info
  - added the media type `application/json` for the response with the status `400`
  - added the non-success response with the status `403`
  - added the non-success response with the status `429`

[Operation history](https://skmtc.dev/influencers/apis/core-api-concepts/changes/public/v1/creators/enrich/email/post.md)

---

[API](https://skmtc.dev/influencers/apis/core-api-concepts.md) - [All operations](https://skmtc.dev/influencers/apis/core-api-concepts/llms.txt) - [OpenAPI document](https://skmtc.dev/influencers/apis/core-api-concepts/revisions/11c76bf81bec?raw)