Skip to main content
GET
/
sponsor
/
audience
Get Audience Demographics for Creators Sponsored by a Brand (Per Platform)
curl --request GET \
  --url https://apiv3.creatordb.app/sponsor/audience \
  --header 'api-key: <api-key>'
{
  "data": {
    "youtube": {
      "audienceLocations": [
        {
          "country": "THA",
          "share": 0.1446
        }
      ],
      "audienceGender": {
        "maleRatio": 0.6705,
        "femaleRatio": 0.3295
      },
      "audienceAvgAge": 28,
      "audienceAgeBreakdown": [
        "18-24"
      ]
    },
    "instagram": {
      "audienceLocations": [
        {
          "country": "THA",
          "share": 0.1446
        }
      ],
      "audienceGender": {
        "maleRatio": 0.6705,
        "femaleRatio": 0.3295
      },
      "audienceAvgAge": 28,
      "audienceAgeBreakdown": [
        {
          "ageRange": "18-24",
          "share": 0.245
        }
      ]
    }
  },
  "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>

Filter audience demographics by social media platform. If empty, returns data for both platforms (either may be absent if unavailable).

Available options:
youtube,
instagram
Example:

"youtube"

Response

200 - application/json

Audience data of sponsored creators returned successfully.

Sponsor Audience API response. Contains audience demographics in data, along with credit usage, trace info, and error details."

​
data
object
required
​
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 succeeds.

Example:

""

​
errorDescription
string
required

Description of the error if any. Empty if successful.

Example:

""

​
success
boolean
required

true if the request is successful.

Example:

true

Last modified on April 28, 2026