> ## Documentation Index
> Fetch the complete documentation index at: https://docs.creatordb.app/llms.txt
> Use this file to discover all available pages before exploring further.
# Get Contact
> Retrieve the contact information of the specified YouTube creator.
Optionally pass `fields` in the request body to return a creator's contact information. The single available field, `emails`, is billed at the full-bundle price. The contact endpoint currently exposes only this one billable field, so fractional calls do not offer any savings yet. Fractional calls must be enabled on your API key. Otherwise, a request that includes `fields` returns a `400` error (`FractionalCallsNotEnabled`). Per-field costs are not published yet. For how fractional calls work, see [Fractional Calls](/api-v3/fractional-calls).
## OpenAPI
````yaml /api-v3/api-v3.yaml post /youtube/contact
openapi: 3.1.0
info:
version: 1.0.0
title: CreatorDB Headless API V3
description: '# CreatorDB Headless API V3'
contact:
name: CreatorDB
url: https://www.creatordb.app
email: support@creatordb.app
license:
url: http://www.apache.org/licenses/LICENSE-2.0.html
name: Apache 2.0
servers:
- url: https://apiv3.creatordb.app
description: Production Environment (CreatorDB Headless API V3)
security:
- ApiKeyAuth: []
tags:
- name: Brand
description: Brand analysis endpoints including sponsor search and brand reports.
- name: Facebook
description: Facebook creator data endpoints with metrics and search capabilities.
- name: General Operations
description: >-
General-purpose endpoints such as API status, content retrieval, and
cross-platform operations.
- name: Instagram
description: >-
Instagram creator data endpoints with metrics and advanced search
capabilities.
- name: Niches
description: >-
Niche-related endpoints for content category analysis and related
searches.
- name: Threads
description: Threads creator data endpoints with basic metrics and historical data.
- name: TikTok
description: >-
TikTok creator data endpoints with metrics and advanced search
functionality.
- name: Topic
description: Topic-based analysis and reporting endpoints for content categorization.
- name: YouTube
description: >-
YouTube creator data endpoints including basic metrics, historical data,
and detailed analytics.
paths:
/youtube/contact:
post:
tags:
- YouTube
summary: Get Contact
description: >-
Retrieve the contact information of the specified YouTube creator.
Optionally pass `fields` in the request body to return a
creator's contact information. The single available field, `emails`, is
billed at the full-bundle price. The contact endpoint currently exposes
only this one billable field, so fractional calls do not offer any
savings yet. Fractional calls must be enabled on your API key.
Otherwise, a request that includes `fields` returns a `400` error
(`FractionalCallsNotEnabled`). Per-field costs are not published yet.
For how fractional calls work, see [Fractional
Calls](/api-v3/fractional-calls).
operationId: getYoutubeContact
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- channelId
properties:
channelId:
type: string
description: Unique channel ID.
pattern: ^UC[a-zA-Z0-9_-]{22}$
minLength: 1
maxLength: 50
examples:
- UCBR8-60-B28hp2BmDPdntcQ
fields:
type: array
description: >-
Subset of contact fields to return. Omit or pass an empty
array to return the full response at the full-bundle price.
Per-field costs are not published yet.
items:
type: string
responses:
'200':
description: YouTube creator contact information returned successfully.
content:
application/json:
schema:
type: object
properties:
data:
type: object
description: Contact information.
properties:
emails:
type: array
description: Associated email addresses. Empty if unavailable.
examples:
- - example@email.com
items:
type: string
format: email
required:
- emails
examples:
- emails:
- example@email.com
creditsUsed:
type: integer
description: Number of API credits consumed by this request.
examples:
- 1
creditsAvailable:
type: integer
description: Number of API credits remaining.
examples:
- -1
traceId:
type: string
description: Unique trace ID for each request.
examples:
- f8e4a3b2c1d0e9f8a7b6c5d4e3f2a1b0
timestamp:
type: integer
description: >-
Time the response was generated, represented as a Unix
timestamp in milliseconds.
examples:
- 1750732453635
errorCode:
type: string
description: >-
Error code returned if the request fails. Empty if the
request is successful.
examples:
- ''
errorDescription:
type: string
description: >-
Description of the error. Empty if the request is
successful.
examples:
- ''
success:
type: boolean
description: '`true` if the request is successful.'
examples:
- true
required:
- data
- traceId
- timestamp
- errorCode
- errorDescription
- success
- creditsUsed
- creditsAvailable
examples:
default:
value:
data:
emails:
- contact@mrbeastbusiness.com
creditsUsed: 1
creditsAvailable: -1
traceId: 1565d8d07cc82917f4cc22bd240d1adc
timestamp: 1767934354696
errorCode: ''
errorDescription: ''
success: true
'400':
description: Validation error.
content:
application/json:
schema:
type: object
title: ValidationErrorResponse
properties:
success:
const: false
error:
type: string
message:
type: string
timestamp:
type: integer
required:
- success
- error
- message
- timestamp
examples:
missing identifier:
summary: No identifier provided
value:
success: false
error: VALIDATION_ERROR
message: 'Missing required identifier: ''channelId'' or ''uniqueId''.'
timestamp: 1770099403116
invalid channelId:
summary: Invalid channelId format
value:
success: false
error: VALIDATION_ERROR
message: >-
Invalid 'channelId' format. YouTube channel IDs must start
with 'UC' followed by 22 characters.
timestamp: 1770099403116
'429':
description: Exceeded quota or rate limit.
content:
application/json:
schema:
type: object
title: QuotaErrorResponse
properties:
success:
const: false
error:
type: string
message:
type: string
remainingPlanCredit:
type: number
required:
- success
- error
- message
- remainingPlanCredit
examples:
rate limit:
summary: Rate limit exceeded
value:
success: false
error: RATE_LIMIT_EXCEEDED
message: Too many requests. Please try again later.
quota exceeded:
summary: Credit quota exceeded
value:
success: false
error: QUOTA_EXCEEDED
message: Not enough credits to complete this request.
security:
- ApiKeyAuth: []
servers:
- url: https://apiv3.creatordb.app
description: Production Environment (CreatorDB Headless API V3)
x-codeSamples:
- lang: bash
label: cURL
source: |
curl -X POST "https://apiv3.creatordb.app/youtube/contact" \
-H "Content-Type: application/json" \
-H "api-key: " \
-d '{ "channelId": "UCX6OQ3DkcsbYNE6H8uQQuVA" }'
components:
securitySchemes:
ApiKeyAuth:
type: apiKey
description: The valid CreatorDB API key for authentication.
name: api-key
in: header
````