Skip to main content
POST
/
sponsor
/
submit
Submit a Brand for Indexing into the CreatorDB Database
curl --request POST \
  --url https://apiv3.creatordb.app/sponsor/submit \
  --header 'Content-Type: application/json' \
  --header 'api-key: <api-key>' \
  --data '
{
  "brandName": "Notion",
  "brandUrl": "https://www.notion.so",
  "competitors": [
    "Odoo",
    "Everything App"
  ],
  "notes": "Frequently sponsors productivity and tech YouTube channels"
}
'
{
  "data": {
    "submissionId": "69dc931e8015d8a4a41ad288",
    "status": "accepted",
    "existingBrandId": "notion.so"
  },
  "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.

Body

application/json

Request body for submitting a brand to the CreatorDB database.

brandName
string
required

Display name of the brand (1-100 characters).

Required string length: 1 - 100
Example:

"Notion"

brandUrl
string<uri>
required

The brand's official website URL. Must include the http/https protocol.

Example:

"https://www.notion.so"

competitors
string[]

Up to 10 competitor brand names or domains.

Maximum array length: 10
Example:
["Odoo", "Everything App"]
notes
string

Optional context to help reviewers process the submission, such as known social handles or reasons the brand should be indexed.

Maximum string length: 500
Example:

"Frequently sponsors productivity and tech YouTube channels"

Response

200 - application/json

Submitted brand for processing into CreatorDB database successfully

Response body for a sponsor submission. Submission details are returned in data.

data
object
required

Response body for a sponsor submission.

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 8, 2026