YouTube

Search Content

Search YouTube videos, Shorts, and streams across every creator in the CreatorDB database, using content-level and creator-level filters. Returns individual content items, each with a short summary of its creator. Without timeRange or a publishTime filter, the search covers the last 30 days.

Each call costs 1–97 credits, set by the time window, a description filter, a 100K+ followers floor, and the content type. A search with no matches is still charged. For filters, pricing, and examples, see Using Content Search.

POST

youtube

content-search

Search Content

curl --request POST \
  --url https://apiv3.creatordb.app/youtube/content-search \
  --header 'Content-Type: application/json' \
  --header 'api-key: <api-key>' \
  --data '
{
  "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
}
'

curl --request POST \
  --url https://apiv3.creatordb.app/youtube/content-search \
  --header 'Content-Type: application/json' \
  --header 'api-key: <api-key>' \
  --data '
{
  "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
}
'

const options = {
  method: 'POST',
  headers: {'api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    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
  })
};

fetch('https://apiv3.creatordb.app/youtube/content-search', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://apiv3.creatordb.app/youtube/content-search"

payload = {
    "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
}
headers = {
    "api-key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://apiv3.creatordb.app/youtube/content-search",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    '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
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

require 'uri'
require 'net/http'

url = URI("https://apiv3.creatordb.app/youtube/content-search")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"filters\": [\n    {\n      \"filterName\": \"isSponsored\",\n      \"op\": \"=\",\n      \"value\": true\n    },\n    {\n      \"filterName\": \"views\",\n      \"op\": \">\",\n      \"value\": 1000000\n    },\n    {\n      \"filterName\": \"publishTime\",\n      \"op\": \"<\",\n      \"value\": 30\n    },\n    {\n      \"filterName\": \"postType\",\n      \"op\": \"=\",\n      \"value\": \"video\"\n    }\n  ],\n  \"sortBy\": \"views\",\n  \"desc\": true,\n  \"pageSize\": 20,\n  \"offset\": 0\n}"

response = http.request(request)
puts response.read_body

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://apiv3.creatordb.app/youtube/content-search"

	payload := strings.NewReader("{\n  \"filters\": [\n    {\n      \"filterName\": \"isSponsored\",\n      \"op\": \"=\",\n      \"value\": true\n    },\n    {\n      \"filterName\": \"views\",\n      \"op\": \">\",\n      \"value\": 1000000\n    },\n    {\n      \"filterName\": \"publishTime\",\n      \"op\": \"<\",\n      \"value\": 30\n    },\n    {\n      \"filterName\": \"postType\",\n      \"op\": \"=\",\n      \"value\": \"video\"\n    }\n  ],\n  \"sortBy\": \"views\",\n  \"desc\": true,\n  \"pageSize\": 20,\n  \"offset\": 0\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("api-key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://apiv3.creatordb.app/youtube/content-search")
  .header("api-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"filters\": [\n    {\n      \"filterName\": \"isSponsored\",\n      \"op\": \"=\",\n      \"value\": true\n    },\n    {\n      \"filterName\": \"views\",\n      \"op\": \">\",\n      \"value\": 1000000\n    },\n    {\n      \"filterName\": \"publishTime\",\n      \"op\": \"<\",\n      \"value\": 30\n    },\n    {\n      \"filterName\": \"postType\",\n      \"op\": \"=\",\n      \"value\": \"video\"\n    }\n  ],\n  \"sortBy\": \"views\",\n  \"desc\": true,\n  \"pageSize\": 20,\n  \"offset\": 0\n}")
  .asString();

{
  "data": {
    "contentList": [
      {
        "contentId": "FbCF_H4ZD64",
        "contentType": "video",
        "title": "I hosted an ADMIN ABUSE on GROW A GARDEN",
        "description": "Thanks @JandelTheGuy play grow a garden here...",
        "thumbnail": "https://i.ytimg.com/vi/FbCF_H4ZD64/hqdefault.jpg",
        "url": "https://www.youtube.com/watch?v=FbCF_H4ZD64",
        "publishTime": 1755273600000,
        "lengthSec": 873,
        "isSponsored": true,
        "partneredBrands": [
          "acer.com"
        ],
        "views": 5009695,
        "likes": 153000,
        "comments": 15182,
        "engagementRate": 0.0336,
        "hashtags": [
          "#VLOG"
        ],
        "language": "eng",
        "category": "Gaming",
        "creator": {
          "channelId": "UCm-X6o81nRsXQTmqpyArkBQ",
          "displayName": "Flamingo",
          "avatarUrl": "https://yt3.googleusercontent.com/7cF22TRiceqQr2Cro_X4uhRVnwCdOa2HXiwdBGPnUEqJDuCyr2CykDfDw2rCWjbjaHEdTMUC=s900-c-k-c0x00ffffff-no-rj",
          "totalSubscribers": 13900000
        }
      }
    ],
    "totalResults": 1250,
    "hasNextPage": true,
    "nextOffset": 20,
    "timeRange": {
      "from": 1790812800000,
      "to": 1792713600000,
      "isDefault": false
    }
  },
  "traceId": "f8e4a3b2c1d0e9f8a7b6c5d4e3f2a1b0",
  "timestamp": 1750732453635,
  "creditsAvailable": 975,
  "creditsUsed": 25,
  "planCreditsAvailable": 900,
  "purchasedCreditsAvailable": 75,
  "errorCode": "",
  "errorDescription": "",
  "success": true,
  "keyCreditsAvailable": 4975
}

Authorizations

api-key

string

header

required

The valid CreatorDB API key for authentication.

Body

application/json

YouTube content search request parameters. Search for YouTube content (videos, shorts, streams) across all creators in the CreatorDB database using content-level and creator-level filters.

filters

object[]

required

Filter objects that include filterName, op, and value. For all accepted filterName values, see Using Content Search. Use channelId to search one creator's content.

Required array length: 1 - 10 elements

Show child attributes

pageSize

integer

required

Number of results per page. Maximum: 100.

Required range: 1 <= x <= 100

offset

integer

required

Number of records to skip before returning results.

Required range: x >= 0

desc

boolean

Sort order for results. true for descending, false for ascending order. Default is true.

sortBy

enum<string>

default:publishTime

The field to sort results by. Default is publishTime.

Available options:

views,

likes,

comments,

engagement,

publishTime,

lengthSec,

performanceViews,

performanceEngagement,

followers

timeRange

object

The publish-date range to search, as absolute times. Only content published inside the range is returned. Without timeRange or any publishTime filter, the search covers the last 30 days.

Show child attributes

Response

Content search results.

YouTube content search response.

data

object

required

Content search results with pagination details.

Show child attributes

traceId

string

required

Unique trace ID for each request.

Example:

"f8e4a3b2c1d0e9f8a7b6c5d4e3f2a1b0"

timestamp

integer

required

Time the response was generated, represented as a Unix timestamp in milliseconds.

Example:

1750732453635

creditsAvailable

number

required

Number of API credits remaining. Equals planCreditsAvailable plus purchasedCreditsAvailable.

Example:

975

creditsUsed

number

required

Number of API credits consumed by this request, from the content search price grid. For details, see Using Content Search.

Example:

25

planCreditsAvailable

number

required

Remaining plan credits after this request, in credits.

Example:

900

purchasedCreditsAvailable

number

required

Remaining purchased-bucket credits after this request, in display units.

Example:

75

errorCode

string

required

Error code returned if the request fails. Empty if the request is successful.

Example:

""

errorDescription

string

required

Description of the error. Empty if the request is successful.

Example:

""

success

boolean

required

true if the request is successful.

Example:

true

keyCreditsAvailable

number

Remaining credits this API key can spend after this request, before reaching its spend limit. Present only when the key has a spend limit.

Example:

4975

⌘I

Search Content

curl --request POST \
  --url https://apiv3.creatordb.app/youtube/content-search \
  --header 'Content-Type: application/json' \
  --header 'api-key: <api-key>' \
  --data '
{
  "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
}
'

curl --request POST \
  --url https://apiv3.creatordb.app/youtube/content-search \
  --header 'Content-Type: application/json' \
  --header 'api-key: <api-key>' \
  --data '
{
  "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
}
'

const options = {
  method: 'POST',
  headers: {'api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    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
  })
};

fetch('https://apiv3.creatordb.app/youtube/content-search', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://apiv3.creatordb.app/youtube/content-search"

payload = {
    "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
}
headers = {
    "api-key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://apiv3.creatordb.app/youtube/content-search",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    '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
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

require 'uri'
require 'net/http'

url = URI("https://apiv3.creatordb.app/youtube/content-search")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"filters\": [\n    {\n      \"filterName\": \"isSponsored\",\n      \"op\": \"=\",\n      \"value\": true\n    },\n    {\n      \"filterName\": \"views\",\n      \"op\": \">\",\n      \"value\": 1000000\n    },\n    {\n      \"filterName\": \"publishTime\",\n      \"op\": \"<\",\n      \"value\": 30\n    },\n    {\n      \"filterName\": \"postType\",\n      \"op\": \"=\",\n      \"value\": \"video\"\n    }\n  ],\n  \"sortBy\": \"views\",\n  \"desc\": true,\n  \"pageSize\": 20,\n  \"offset\": 0\n}"

response = http.request(request)
puts response.read_body

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://apiv3.creatordb.app/youtube/content-search"

	payload := strings.NewReader("{\n  \"filters\": [\n    {\n      \"filterName\": \"isSponsored\",\n      \"op\": \"=\",\n      \"value\": true\n    },\n    {\n      \"filterName\": \"views\",\n      \"op\": \">\",\n      \"value\": 1000000\n    },\n    {\n      \"filterName\": \"publishTime\",\n      \"op\": \"<\",\n      \"value\": 30\n    },\n    {\n      \"filterName\": \"postType\",\n      \"op\": \"=\",\n      \"value\": \"video\"\n    }\n  ],\n  \"sortBy\": \"views\",\n  \"desc\": true,\n  \"pageSize\": 20,\n  \"offset\": 0\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("api-key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://apiv3.creatordb.app/youtube/content-search")
  .header("api-key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"filters\": [\n    {\n      \"filterName\": \"isSponsored\",\n      \"op\": \"=\",\n      \"value\": true\n    },\n    {\n      \"filterName\": \"views\",\n      \"op\": \">\",\n      \"value\": 1000000\n    },\n    {\n      \"filterName\": \"publishTime\",\n      \"op\": \"<\",\n      \"value\": 30\n    },\n    {\n      \"filterName\": \"postType\",\n      \"op\": \"=\",\n      \"value\": \"video\"\n    }\n  ],\n  \"sortBy\": \"views\",\n  \"desc\": true,\n  \"pageSize\": 20,\n  \"offset\": 0\n}")
  .asString();

{
  "data": {
    "contentList": [
      {
        "contentId": "FbCF_H4ZD64",
        "contentType": "video",
        "title": "I hosted an ADMIN ABUSE on GROW A GARDEN",
        "description": "Thanks @JandelTheGuy play grow a garden here...",
        "thumbnail": "https://i.ytimg.com/vi/FbCF_H4ZD64/hqdefault.jpg",
        "url": "https://www.youtube.com/watch?v=FbCF_H4ZD64",
        "publishTime": 1755273600000,
        "lengthSec": 873,
        "isSponsored": true,
        "partneredBrands": [
          "acer.com"
        ],
        "views": 5009695,
        "likes": 153000,
        "comments": 15182,
        "engagementRate": 0.0336,
        "hashtags": [
          "#VLOG"
        ],
        "language": "eng",
        "category": "Gaming",
        "creator": {
          "channelId": "UCm-X6o81nRsXQTmqpyArkBQ",
          "displayName": "Flamingo",
          "avatarUrl": "https://yt3.googleusercontent.com/7cF22TRiceqQr2Cro_X4uhRVnwCdOa2HXiwdBGPnUEqJDuCyr2CykDfDw2rCWjbjaHEdTMUC=s900-c-k-c0x00ffffff-no-rj",
          "totalSubscribers": 13900000
        }
      }
    ],
    "totalResults": 1250,
    "hasNextPage": true,
    "nextOffset": 20,
    "timeRange": {
      "from": 1790812800000,
      "to": 1792713600000,
      "isDefault": false
    }
  },
  "traceId": "f8e4a3b2c1d0e9f8a7b6c5d4e3f2a1b0",
  "timestamp": 1750732453635,
  "creditsAvailable": 975,
  "creditsUsed": 25,
  "planCreditsAvailable": 900,
  "purchasedCreditsAvailable": 75,
  "errorCode": "",
  "errorDescription": "",
  "success": true,
  "keyCreditsAvailable": 4975
}

Getting Started

User Guides

API Endpoints

Filter Value References

Troubleshooting and FAQs

Search Content

Authorizations

Body

Response