Get Sponsored Creator Demographics

GET

sponsor

audience

curl --request GET \
  --url https://apiv3.creatordb.app/sponsor/audience \
  --header 'api-key: <api-key>'

const options = {method: 'GET', headers: {'api-key': '<api-key>'}};

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

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://apiv3.creatordb.app/sponsor/audience",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "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/sponsor/audience")

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

request = Net::HTTP::Get.new(url)
request["api-key"] = '<api-key>'

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

package main

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

func main() {

	url := "https://apiv3.creatordb.app/sponsor/audience"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("api-key", "<api-key>")

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

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

	fmt.Println(string(body))

}

{
  "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,
  "planCreditsAvailable": 900,
  "purchasedCreditsAvailable": 75,
  "errorCode": "",
  "errorDescription": "",
  "success": true,
  "keyCreditsAvailable": 4975
}

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

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

Remaining credits available for this API key after the current request. Equals planCreditsAvailable plus purchasedCreditsAvailable.

Example:

975

creditsUsed

number

required

Number of API credits consumed by this request.

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

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

Last modified on September 10, 2026

⌘I

Get Sponsored Creator Demographics

curl --request GET \
  --url https://apiv3.creatordb.app/sponsor/audience \
  --header 'api-key: <api-key>'

const options = {method: 'GET', headers: {'api-key': '<api-key>'}};

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

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://apiv3.creatordb.app/sponsor/audience",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "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/sponsor/audience")

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

request = Net::HTTP::Get.new(url)
request["api-key"] = '<api-key>'

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

package main

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

func main() {

	url := "https://apiv3.creatordb.app/sponsor/audience"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("api-key", "<api-key>")

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

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

	fmt.Println(string(body))

}

{
  "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,
  "planCreditsAvailable": 900,
  "purchasedCreditsAvailable": 75,
  "errorCode": "",
  "errorDescription": "",
  "success": true,
  "keyCreditsAvailable": 4975
}

Getting Started

User Guides

API Endpoints

Filter Value References

Troubleshooting and FAQs

Authorizations

Query Parameters

Response