Skip to main content
POST
cURL

Authorizations

api-key
string
header
required

The valid CreatorDB API key for authentication.

Body

application/json
uniqueId
string
required

Instagram account ID. Accepts instagram or @instagram format (@ is stripped automatically).

Required string length: 1 - 31
Pattern: ^@?[a-zA-Z0-9._]{1,30}$
Example:

"instagram"

fields
object

Map sponsorList to the number of sponsoring brands to return. Omit or pass an empty object to return all brands at the full-bundle price. For per-brand costs, see Field and Item Costs.

Response

Instagram sponsorship data returned successfully.

Instagram sponsorship API response with sponsor-grouped content and performance metrics.

data
object
required

Retrieve recently sponsored Instagram posts and reels data for a specified creator.

creditsUsed
number
required

Number of API credits consumed by this request.

Example:

1

creditsAvailable
number
required

Number of API credits remaining. Equals planCreditsAvailable plus purchasedCreditsAvailable.

Example:

-1

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

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

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

Last modified on September 10, 2026