Skip to main content
GET
/
sponsor
/
summary
Get Brand Summary
curl --request GET \
  --url https://apiv3.creatordb.app/sponsor/summary \
  --header 'api-key: <api-key>'
{
  "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,
  "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"

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.

​
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 May 19, 2026