Skip to main content
GET
/
sponsor
/
creators
List Creators Sponsored by a Brand (One Platform)
curl --request GET \
  --url https://apiv3.creatordb.app/sponsor/creators \
  --header 'api-key: <api-key>'
{
  "data": {
    "creators": [
      {
        "creatorId": "UCm-X6o81nRsXQTmqpyArkBQ",
        "platform": "youtube",
        "displayName": "Flamingo",
        "avatar": "https://yt3.ggpht.com/example",
        "sponsoredContent": [
          "https://www.youtube.com/watch?v=abc123"
        ],
        "country": "USA",
        "followers": 12000000,
        "avgRecentSponsoredEngagementRate": 0.0452,
        "topics": [
          "RPG"
        ],
        "niches": [
          "gaming_Gaming"
        ],
        "sponsoredCount": 3,
        "lastSponsoredDate": 1754797869000
      }
    ],
    "totalResults": 30,
    "offset": 0,
    "pageSize": 50
  },
  "traceId": "f8e4a3b2c1d0e9f8a7b6c5d4e3f2a1b0",
  "timestamp": 1750732453635,
  "creditsAvailable": 975,
  "creditsUsed": 25,
  "errorCode": "",
  "errorDescription": "",
  "success": true
}

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.

Authorizations

​
api-key
string
header
required

The valid CreatorDB API key for authentication.

Query Parameters

​
brandId
string
required

Unique brand identifier, typically the brand's primary domain. Allowed characters: letters (a-z, A-Z), digits (0-9), periods (.), underscores (_), and hyphens (-).

Minimum string length: 1
Pattern: ^[a-zA-Z0-9._-]+$
Example:

"acer.com"

​
platform
enum<string>
required

Social media platform to query. Accepted values: youtube, instagram.

Available options:
youtube,
instagram
Example:

"youtube"

​
pageSize
string
default:50

Number of creators per page. Default: 50. Maximum: 100

Example:

"50"

​
offset
string
default:0

Number of records to skip before returning results. Default: 0

Example:

"0"

​
sortBy
enum<string>
default:lastSponsoredDate

Field to sort brands by. Accepted values: lastSponsoredDate, followers, avgRecentSponsoredEngagementRate, sponsoredCount

Available options:
lastSponsoredDate,
followers,
avgRecentSponsoredEngagementRate,
sponsoredCount
Example:

"lastSponsoredDate"

​
desc
string
default:true

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

Example:

"true"

Response

200 - application/json

Sponsored creators returned successfully.

Sponsor Creators API response

​
data
object
required

Creator list with pagination metadata (total count, current offset, and page size).

​
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

Remaining credits available for this API key after the current request.

Example:

975

​
creditsUsed
number
required

Number of API credits consumed by this request.

Example:

25

​
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.

Last modified on April 28, 2026