TikTok API endpoint

Retrieve TikTok popular-trend country and industry metadata

Returns the country and industry metadata used by the TikTok Creative Center popular-trend endpoints.

GETapiKey8 credits/requestpopulartrend.countryIndustryMetaResponseDoc/tiktok/popular-trend/country-industry-meta

Parameters

NameInTypeRequiredEnumExampleDescription
x-api-keyheaderstringYesAPI key required

Authentication

Send your scraping API key in the x-api-key header. Use the console API Keys page to rotate or select the active key.

Billing

Endpoint usage is metered in credits. The plan prices, included credits, limits, and overage rates below match the active backend billing configuration.

Credit cost
8 credits/request
Charged response
Successful 2xx responses
PlanPriceIncluded creditsDaily capRate limitOverage
Free$0/mo2,000500 daily credits5/minNo overage
Starter$9/mo20,0005,000 daily credits15/min$0.75/1,000 overage credits when enabled
Growth$29/mo100,00025,000 daily credits45/min$0.45/1,000 overage credits when enabled
Pro$79/mo400,000No daily cap120/min$0.30/1,000 overage credits
Business$199/mo1,200,000No daily cap300/min$0.20/1,000 overage credits
Enterprise$499/mo5,000,000No daily cap1,000/min$0.12/1,000 overage credits

Failure responses

StatusDescriptionSchema
429Rate limit exceeded#/definitions/app.Response
500Internal server error#/definitions/app.Response

Example response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "country": [
      {
        "id": "AR",
        "value": "Argentina"
      }
    ],
    "industry": [
      {
        "id": "22000000000",
        "value": "Apparel & Accessories"
      }
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/populartrend.countryIndustryMetaResponseDoc

FieldTypeRequiredEnumBoundsExampleDescription
codeintegerNo200
datapopularTrend.CountryIndustryMetaNo
data.countryarrayNo
data.country[].idstringNo
data.country[].valuestringNo
data.industryarrayNo
data.industry[].idstringNo
data.industry[].valuestringNo
msgstringNoOK

Example request

curl -X GET "https://api.crawlora.net/api/v1/tiktok/popular-trend/country-industry-meta" -H "x-api-key: <api-key>"

TypeScript fetch

const url = new URL("https://api.crawlora.net/api/v1/tiktok/popular-trend/country-industry-meta");
const headers = new Headers();
headers.set("x-api-key", "<api-key>");
const response = await fetch(url, {
  method: "GET",
  headers,
});
const payload = await response.json();