TikTok API endpoint

Retrieve TikTok hashtag details

Returns the metadata payload for a TikTok hashtag page.

GETapiKey8 credits/requesttiktok.challengeResponseDoc/tiktok/hashtag/{name}

Parameters

Name	In	Type	Required	Enum	Example	Description
x-api-key	header	string	Yes			API key required
name	path	string	Yes			Hashtag name (e.g., 'christmas')

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

Plan	Price	Included credits	Daily cap	Rate limit	Overage
Free	$0/mo	2,000	500 daily credits	5/min	No overage
Starter	$9/mo	20,000	5,000 daily credits	15/min	$0.75/1,000 overage credits when enabled
Growth	$29/mo	100,000	25,000 daily credits	45/min	$0.45/1,000 overage credits when enabled
Pro	$79/mo	400,000	No daily cap	120/min	$0.30/1,000 overage credits
Business	$199/mo	1,200,000	No daily cap	300/min	$0.20/1,000 overage credits
Enterprise	$499/mo	5,000,000	No daily cap	1,000/min	$0.12/1,000 overage credits

Catalog quality warnings

missing example for required path param: name

Failure responses

Status	Description	Schema
400	Invalid input	#/definitions/app.Response
429	Rate limit exceeded	#/definitions/app.Response
500	Internal server error	#/definitions/app.Response

Example response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "challengeInfo": {
      "challenge": {
        "coverLarger": "https://p16-sg.tiktokcdn.com/obj/tiktok-obj/6a1da427fdfd35e4a056bfb897709fed.jpeg?shp=81f88b70&shcp=-",
        "coverMedium": "https://p16-sg.tiktokcdn.com/obj/tiktok-obj/6a1da427fdfd35e4a056bfb897709fed.jpeg?shp=81f88b70&shcp=-",
        "coverThumb": "https://p16-sg.tiktokcdn.com/obj/tiktok-obj/6a1da427fdfd35e4a056bfb897709fed.jpeg?shp=81f88b70&shcp=-",
        "desc": "Merry #Christmas!",
        "id": "3242",
        "isCommerce": false
      },
      "challengeAnnouncement": {
        "body": "",
        "title": ""
      },
      "stats": {
        "videoCount": 0,
        "viewCount": 321900000000
      },
      "statsV2": {
        "videoCount": "33173666",
        "viewCount": "321857738740"
      }
    },
    "extra": {
      "fatal_item_ids": [],
      "logid": "2024121109145995D9E90EDC8E41018BB8",
      "now": 1733908499000
    },
    "log_pb": {
      "impr_id": "2024121109145995D9E90EDC8E41018BB8"
    },
    "shareMeta": {
      "desc": "321900.0m views - Watch awesome short videos created with trending hashtag #christmas",
      "title": "#christmas on TikTok"
    },
    "statusCode": 0,
    "status_code": 0
  }
}

Request schema

No body schema

Response schema

#/definitions/tiktok.challengeResponseDoc

Field	Type	Required	Example
code	integer	No	200
data	tiktok.ChallengeDetailResp	No
data.challengeInfo	unknown	No
data.extra	object	No
data.extra.fatal_item_ids	array	No
data.extra.logid	string	No
data.extra.now	integer	No
data.log_pb	object	No
data.log_pb.impr_id	string	No
data.shareMeta	object	No
data.shareMeta.desc	string	No
data.shareMeta.title	string	No
data.statusCode	integer	No
data.status_code	integer	No
data.status_msg	string	No
msg	string	No	OK

Example request

curl -X GET "https://api.crawlora.net/api/v1/tiktok/hashtag/%3Cname%3E" -H "x-api-key: <api-key>"

TypeScript fetch

const url = new URL("https://api.crawlora.net/api/v1/tiktok/hashtag/%3Cname%3E");
const headers = new Headers();
headers.set("x-api-key", "<api-key>");
const response = await fetch(url, {
  method: "GET",
  headers,
});
const payload = await response.json();

Open in Playground Back to group