Get Brand Summary

GET

sponsor

summary

Get Brand Summary

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

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

fetch('https://apiv3.creatordb.app/sponsor/summary', 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/summary",
  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/summary")

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/summary"

	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": {
    "summary": {
      "totalSponsoredCreators": 49,
      "totalSponsoredContent": 278,
      "youtube": {
        "creators": {
          "sponsoredCreators": 34,
          "sponsoredContent": 156,
          "sponsoredContent30d": 35,
          "creatorLocationBreakdown": [
            {
              "key": "<string>",
              "count": 12,
              "share": 0.4
            }
          ],
          "creatorLanguageBreakdown": [
            {
              "key": "eng",
              "count": 12,
              "share": 0.4
            }
          ]
        },
        "performance": {
          "estimatedTotalSpend7d": 28000,
          "estimatedTotalSpend30d": 100000,
          "estimatedTotalSpend90d": 220000,
          "estimatedCPM30d": 8.51,
          "estimatedCPE30d": 0.31,
          "views": {
            "total": 452000000,
            "avg": 75374,
            "median": 62000,
            "min": 1200,
            "max": 890000,
            "views30d": 11758366
          },
          "likes": {
            "total": 452000000,
            "avg": 75374,
            "median": 62000,
            "min": 1200,
            "max": 890000
          },
          "comments": {
            "total": 452000000,
            "avg": 75374,
            "median": 62000,
            "min": 1200,
            "max": 890000
          },
          "engagement": {
            "avgEngagementRate": 0.0352
          },
          "growth30d": {
            "viewsGrowth": 0.3261,
            "likesGrowth": 0.2119,
            "commentsGrowth": 0.2976,
            "engagementGrowth": -0.0831
          }
        }
      },
      "instagram": {
        "creators": {
          "sponsoredCreators": 34,
          "sponsoredContent": 156,
          "sponsoredContent30d": 35,
          "creatorLocationBreakdown": [
            {
              "key": "<string>",
              "count": 12,
              "share": 0.4
            }
          ],
          "creatorLanguageBreakdown": [
            {
              "key": "<string>",
              "count": 12,
              "share": 0.4
            }
          ]
        },
        "performance": {
          "estimatedTotalSpend7d": null,
          "estimatedTotalSpend30d": null,
          "estimatedTotalSpend90d": null,
          "estimatedCPM30d": null,
          "estimatedCPE30d": null,
          "views": {
            "total": 452000000,
            "avg": 75374,
            "median": 62000,
            "min": 1200,
            "max": 890000
          },
          "likes": {
            "total": 452000000,
            "avg": 75374,
            "median": 62000,
            "min": 1200,
            "max": 890000
          },
          "comments": {
            "total": 452000000,
            "avg": 75374,
            "median": 62000,
            "min": 1200,
            "max": 890000
          },
          "engagement": {
            "avgEngagementRate": 123
          },
          "growth30d": {
            "viewsGrowth": 0.3261,
            "likesGrowth": 0.2119,
            "commentsGrowth": 0.2976,
            "engagementGrowth": -0.0831
          }
        }
      }
    }
  },
  "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"

Response

200 - application/json

Brand summary data returned successfully.

Response body for a sponsor summary. Summary details are returned in data.

data

object

required

Top-level response object containing the brand summary.

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

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

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

fetch('https://apiv3.creatordb.app/sponsor/summary', 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/summary",
  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/summary")

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/summary"

	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": {
    "summary": {
      "totalSponsoredCreators": 49,
      "totalSponsoredContent": 278,
      "youtube": {
        "creators": {
          "sponsoredCreators": 34,
          "sponsoredContent": 156,
          "sponsoredContent30d": 35,
          "creatorLocationBreakdown": [
            {
              "key": "<string>",
              "count": 12,
              "share": 0.4
            }
          ],
          "creatorLanguageBreakdown": [
            {
              "key": "eng",
              "count": 12,
              "share": 0.4
            }
          ]
        },
        "performance": {
          "estimatedTotalSpend7d": 28000,
          "estimatedTotalSpend30d": 100000,
          "estimatedTotalSpend90d": 220000,
          "estimatedCPM30d": 8.51,
          "estimatedCPE30d": 0.31,
          "views": {
            "total": 452000000,
            "avg": 75374,
            "median": 62000,
            "min": 1200,
            "max": 890000,
            "views30d": 11758366
          },
          "likes": {
            "total": 452000000,
            "avg": 75374,
            "median": 62000,
            "min": 1200,
            "max": 890000
          },
          "comments": {
            "total": 452000000,
            "avg": 75374,
            "median": 62000,
            "min": 1200,
            "max": 890000
          },
          "engagement": {
            "avgEngagementRate": 0.0352
          },
          "growth30d": {
            "viewsGrowth": 0.3261,
            "likesGrowth": 0.2119,
            "commentsGrowth": 0.2976,
            "engagementGrowth": -0.0831
          }
        }
      },
      "instagram": {
        "creators": {
          "sponsoredCreators": 34,
          "sponsoredContent": 156,
          "sponsoredContent30d": 35,
          "creatorLocationBreakdown": [
            {
              "key": "<string>",
              "count": 12,
              "share": 0.4
            }
          ],
          "creatorLanguageBreakdown": [
            {
              "key": "<string>",
              "count": 12,
              "share": 0.4
            }
          ]
        },
        "performance": {
          "estimatedTotalSpend7d": null,
          "estimatedTotalSpend30d": null,
          "estimatedTotalSpend90d": null,
          "estimatedCPM30d": null,
          "estimatedCPE30d": null,
          "views": {
            "total": 452000000,
            "avg": 75374,
            "median": 62000,
            "min": 1200,
            "max": 890000
          },
          "likes": {
            "total": 452000000,
            "avg": 75374,
            "median": 62000,
            "min": 1200,
            "max": 890000
          },
          "comments": {
            "total": 452000000,
            "avg": 75374,
            "median": 62000,
            "min": 1200,
            "max": 890000
          },
          "engagement": {
            "avgEngagementRate": 123
          },
          "growth30d": {
            "viewsGrowth": 0.3261,
            "likesGrowth": 0.2119,
            "commentsGrowth": 0.2976,
            "engagementGrowth": -0.0831
          }
        }
      }
    }
  },
  "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