Skip to main content
POST
/
submitCreators
cURL
curl --request POST \
  --url https://dev.creatordb.app/v2/submitCreators \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --header 'apiId: LE6DPZQkR3TQShxofXoD2j8qCBu1-f0jti665m1t50dwDD12W' \
  --data '{
  "platform": "youtube",
  "platformUserIds": [
    "UCm-X6o81nRsXQTmqpyArkBQ"
  ]
}'
{
  "data": [],
  "quotaUsed": 0,
  "quotaUsedTotal": 6024,
  "remainingPlanCredit": 993976,
  "remainingPrepurchasedCredit": 0,
  "timestamp": 1755503515301,
  "error": "",
  "success": true
}

Headers

​
apiId
string
required
Example:

"LE6DPZQkR3TQShxofXoD2j8qCBu1-f0jti665m1t50dwDD12W"

Body

application/json

submit database non existed creators

The parameters required for submitting new creators to the CreatorDB database via an API call.

​
platform
enum<string>
required

The social media platform that the creator uses or is active on.

Available options:
youtube,
instagram,
tiktok
​
platformUserIds
string[]
required

The creator's user ID on a specific social media platform, such as YouTube, Instagram, or TikTok.

Response

OK

​
data
string[]
​
quotaUsed
number

API credits that were used to make this call.

​
quotaUsedTotal
number

Total API credits used since the last billing cycle.

​
remainingPlanCredit
number

The number of remaining free API credits that come with your subscription plan. These API credits are renewed every billing cycle.

​
remainingPrepurchasedCredit
number

The number of remaining extra purchased API credits. These API credits do not expire until used.

​
timestamp
number

Unix timestamp of the call request that the server received.

​
error
string

Errors that occurred during the API call.

​
success
boolean

It is TRUE when the call is successful.

Last modified on February 25, 2026