> ## 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.
# Search Content
> Search for YouTube content (videos, shorts, streams) across all creators in the CreatorDB database using content-level and creator-level filters. Enables discovery of specific content by performance metrics, hashtags, sponsorship status, and more. By default, the `contentList` is sorted by `publishTime` descending (newest first). Custom sorting can be applied using the `sortBy` parameter.
## OpenAPI
````yaml /api-v3/api-v3.yaml post /youtube/content-search
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/content-search:
post:
tags:
- YouTube
summary: Search Content
description: >-
Search for YouTube content (videos, shorts, streams) across all creators
in the CreatorDB database using content-level and creator-level filters.
Enables discovery of specific content by performance metrics, hashtags,
sponsorship status, and more. By default, the `contentList` is sorted by
`publishTime` descending (newest first). Custom sorting can be applied
using the `sortBy` parameter.
operationId: searchYoutubeContent
requestBody:
content:
application/json:
schema:
type: object
properties:
filters:
type: array
items:
type: object
properties:
filterName:
type: string
description: The field to apply the filter on.
op:
type: string
enum:
- in
- '>'
- '='
- <
description: >-
The comparison operator. Available values include
`in`, `>`, `=`, `<`.
- String fields accept:
`=`, `in`.
- Number fields support: `>`, `=`,
`<`.
- Boolean fields support: `=`
value:
description: >-
Type depends on the `filterName`.
- String
fields accept `string` or `string[]`.
- Number
fields accept `number`.
- Boolean fields accept
`boolean`.
- Operator `in` accepts `string[]`,
operator `=` accepts string for `string` fields.
anyOf:
- type: string
- type: number
- type: array
maxItems: 100
items:
type: string
- type: boolean
isFuzzySearch:
type: boolean
description: >-
When `true`, performs a fuzzy match for `string` type
`filterName`.
default: false
required:
- filterName
- op
- value
minItems: 1
maxItems: 10
description: >-
Filter objects that include `filterName`, `op`, and `value`.
For all accepted `filterName` values and their data types,
see [Configuring Custom Search Filters and
Examples](https://docs.creatordb.app/api-v3/configuring_advanced_search_filters#available-filtername-&-sortby).
desc:
type: boolean
description: >-
Sort order for results. `true` for descending, `false` for
ascending order.
sortBy:
type: string
description: >-
Field to sort content by. For example, `views` sorts by view
count.
pageSize:
type: integer
description: 'Number of results per page. Maximum: 100.'
minimum: 1
maximum: 100
offset:
type: integer
description: Number of records to skip before returning results.
minimum: 0
required:
- filters
- pageSize
- offset
description: >-
Request body for searching YouTube content across all creators
using content-level and creator-level filters.
example:
filters:
- filterName: isSponsored
op: '='
value: true
- filterName: views
op: '>'
value: 1000000
- filterName: publishTime
op: <
value: 30
- filterName: postType
op: '='
value: video
sortBy: views
desc: true
pageSize: 20
offset: 0
responses:
'200':
description: YouTube content search data returned successfully.
content:
application/json:
schema:
type: object
properties:
data:
type: object
properties:
contentList:
type: array
items:
type: object
properties:
contentId:
type: string
description: >-
The unique content ID. URL:
`https://www.youtube.com/watch?v={contentId}`
example: FbCF_H4ZD64
contentType:
type: string
description: 'Content type: `video`, `shorts`, or `stream`.'
example: video
title:
type: string
description: The video title.
example: I hosted an ADMIN ABUSE on GROW A GARDEN
description:
type: string
description: The video description.
example: Thanks @JandelTheGuy play grow a garden here...
thumbnail:
type: string
description: Thumbnail URL of the video.
example: https://i.ytimg.com/vi/FbCF_H4ZD64/hqdefault.jpg
url:
type: string
description: Direct URL of the content.
example: https://www.youtube.com/watch?v=FbCF_H4ZD64
publishTime:
type: integer
minimum: 0
description: >-
Publish time, represented as a Unix timestamp in
milliseconds.
example: 1755273600000
lengthSec:
type: integer
minimum: 0
description: Duration of the video in seconds.
example: 873
isSponsored:
type: boolean
description: '`true` if sponsored.'
example: true
partneredBrands:
type: array
items:
type: string
description: >-
Brand IDs (returned as domains) associated with
the sponsored content. Empty if the content is
not sponsored.
example:
- acer.com
views:
type: integer
minimum: 0
description: Number of views.
example: 5009695
likes:
type: integer
minimum: 0
description: Number of likes.
example: 153000
comments:
type: integer
minimum: 0
description: Number of comments.
example: 15182
engagementRate:
type: number
description: >-
Engagement rate, rounded to 4th decimal place.
*Engagement Rate = (Likes + Comments
+ Views) / Subscribers*
example: 0.0336
hashtags:
type: array
items:
type: string
description: Keywords in the video title or description.
example:
- '#VLOG'
language:
type: string
description: >-
Language used in the content, represented in
**ISO 639-3** format. For language code list,
see
[here](https://docs.creatordb.app/api-v3/language-code).
example: eng
category:
type: string
description: Predefined YouTube content category.
example: Gaming
creator:
type: object
properties:
channelId:
type: string
description: Channel ID.
example: UCm-X6o81nRsXQTmqpyArkBQ
displayName:
type: string
description: Channel display name.
example: Flamingo
avatarUrl:
type: string
description: Channel profile picture URL.
example: >-
https://yt3.googleusercontent.com/7cF22TRiceqQr2Cro_X4uhRVnwCdOa2HXiwdBGPnUEqJDuCyr2CykDfDw2rCWjbjaHEdTMUC=s900-c-k-c0x00ffffff-no-rj
totalSubscribers:
type: integer
minimum: 0
description: Total subscriber count.
example: 13900000
required:
- channelId
- displayName
- avatarUrl
- totalSubscribers
description: Creator information for the content.
required:
- contentId
- contentType
- title
- description
- thumbnail
- url
- publishTime
- lengthSec
- isSponsored
- partneredBrands
- views
- likes
- comments
- engagementRate
- hashtags
- language
- category
- creator
description: A content item with creator and performance details.
description: Content items matching the search filters.
totalResults:
type: integer
minimum: 0
description: >-
Total number of content items matching the search
filters.
example: 1250
hasNextPage:
type: boolean
description: '`true` if there is a next page of results.'
example: true
nextOffset:
type: integer
minimum: 0
description: >-
The offset value for retrieving the next page of
results.
example: 20
required:
- contentList
- totalResults
- hasNextPage
- nextOffset
description: Content search results with pagination details.
traceId:
type: string
description: Unique trace ID for each request.
example: f8e4a3b2c1d0e9f8a7b6c5d4e3f2a1b0
timestamp:
type: integer
description: >-
Time the response was generated, represented as a Unix
timestamp in milliseconds.
example: 1750732453635
creditsAvailable:
type: number
description: Number of API credits remaining.
creditsUsed:
type: number
description: Number of API credits consumed by this request.
example: 25
errorCode:
type: string
description: >-
Error code returned if the request fails. Empty if the
request succeeds.
example: ''
errorDescription:
type: string
description: Description of the error if any. Empty if successful.
example: ''
success:
type: boolean
description: '`true` if the request is successful.'
example: true
required:
- data
- traceId
- timestamp
- creditsAvailable
- creditsUsed
- errorCode
- errorDescription
- success
description: >-
Response body for content search results. The content list and
pagination details are returned in `data`.
components:
securitySchemes:
ApiKeyAuth:
type: apiKey
description: The valid CreatorDB API key for authentication.
name: api-key
in: header
````