Skip to main content
GET
Get a Brand's Daily Sponsorship Activity Over Time

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._-]+$
pastDayRange
string
required

Number of days of history to return, counting back from today (UTC), today included. A whole number from 1 to 400, without leading zeros. Other values return a 400 error, for example pastDayRange must be between 1 and 400 days. You're billed on the days actually returned, which can be fewer.

Pattern: ^(0|[1-9]\d*)$

Response

Brand historical sponsorship data returned successfully.

Sponsor History API response. Contains sponsor history in data, along with credit usage, trace info, and error details.

data
object
required

The brand's sponsorship history, with the brand ID, the range of days returned, and one daily series per platform.

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

Purchased credits remaining after this request.

Example:

75

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 the request is 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