Skip to main content
POST
/
youtube
/
search
Search for YouTube creators based on custom filter criteria
curl --request POST \
  --url https://api.example.com/youtube/search \
  --header 'Content-Type: application/json' \
  --header 'api-key: <api-key>' \
  --data '
{
  "filters": [
    {
      "filterName": "<string>",
      "op": {},
      "value": "<string>",
      "isFuzzySearch": true
    }
  ],
  "pageSize": 123,
  "offset": 123,
  "desc": 123,
  "sortBy": "<string>"
}
'
{
  "id": "<string>",
  "email": "<string>"
}
​
api-key
string
required
You need a valid api-key for authentication.
​
filters
object[]
required
An array of filter objects that includes: filterName, op, and value. For the full list of supported filterName and their corresponding data types, please refer to Configuring Custom Search Filters and Examples. You can combine multiple filters in a single request to narrow down your search results. The API supports up to 10 filters per request. Maximum array length: 10
​
pageSize
integer
required
Specifies the maximum number of results to return in a single response. The upper limit is 100.
Required range: 1 ≤ x ≤ 100
​
offset
integer
required
Indicates the number of records to skip before starting to return results. Used for pagination.
Required range: x ≥ 0
​
desc
integer
Determines the sort order. When set to true, results will be in descending order. When false, results will be in ascending order.
​
sortBy
string
The field to sort results by. For example, if the value is totalFollowers, the creators that meet the search criteria are organized by the number of followers they have.
​
id
string
required
Unique identifier for the newly created user
​
email
string
required
User’s email address
Last modified on March 16, 2026