Skip to main content
GET
/
sponsor
/
performance
Get Performance Metrics for Creators Sponsored by a Brand (One Platform)
curl --request GET \
  --url https://apiv3.creatordb.app/sponsor/performance \
  --header 'api-key: <api-key>'
{
  "data": {
    "sponsoredCreators": [
      {
        "creatorId": "UCm-X6o81nRsXQTmqpyArkBQ",
        "displayName": "Flamingo",
        "platform": "youtube",
        "creatorTotalStats": {
          "avgEngagementRate": 0.0452,
          "avgViews": 1600000,
          "avgLikes": 63700,
          "avgComments": 5200,
          "contentCount": 180,
          "latestContentDate": 1741939200000
        },
        "creatorAllSponsoredStats": {
          "avgEngagementRate": 0.0412,
          "avgViews": 1950000,
          "avgLikes": 66500,
          "avgComments": 5350,
          "sponsoredCount": 42,
          "latestSponsoredContentDate": 1738569600000
        },
        "creatorSpecificSponsoredStats": {
          "avgEngagementRate": 0.0379,
          "avgViews": 2200000,
          "avgLikes": 69800,
          "avgComments": 5500,
          "sponsoredCount": 3,
          "latestSponsoredContentDate": 1733529600000
        },
        "estimatedCost": 4500,
        "estimatedCreatorCPM": 9.12,
        "content": [
          {
            "contentId": "eHnzGYHEdO0",
            "title": "ROBLOX OP ADMIN IN STEAL A BRAINROT",
            "publishTime": 1754797869000,
            "views7d": 8200,
            "views30d": 15000,
            "views90d": 28500,
            "viewsLifetime": 150000,
            "likes": 10000,
            "comments": 100,
            "engagementRate": 0.1202,
            "length": 873,
            "hashtags": [
              "#VLOG"
            ],
            "estimatedContentCPM": 300
          }
        ]
      }
    ],
    "totalResults": 156,
    "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. Only one platform is allowed per request.

Available options:
youtube,
instagram
Example:

"youtube"

​
pageSize
string
default:50

Number of unique creators per page. All sponsored content for each creator is included. Default: 50. Maximum: 100

Example:

"50"

​
offset
string
default:0

Number of creators to skip before returning results. Pagination is creator-level. Default: 0

Example:

"0"

​
sortBy
enum<string>
default:publishTime

Field for sorting creators. Accepted values: publishTime, views, likes, engagementRate. Numeric sort fields (views, likes, engagementRate) use per-creator averages across this brand's sponsored content. Default: publishTime.

Available options:
publishTime,
views,
likes,
engagementRate
Example:

"publishTime"

​
desc
string
default:true

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

Example:

"true"

Response

200 - application/json

Performance of sponsored creators returned successfully.

Sponsor Performance API response. Contains creator performance data in data, along with credit usage, trace info, and error details.

​
data
object
required

Sponsored creators with performance data for the queried brand and platform, along 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 successful.

Example:

""

​
success
boolean
required

true if the request is successful.

Example:

true

Last modified on April 28, 2026