Endpoint Playground

Try the Retrieve videos for a TikTok hashtag API

Lists videos for one hashtag name as the mobile app returns them (`aweme_list` with author, music and statistics), plus `cursor` and `has_more`. `sort=fresh` is the newest list and works from any measured egress; `sort=popular` is the hot list and only answers from a US egress.

Request: GET /tiktok/mobile/hashtag/posts
Cost: 8 credits/request
Auth: apiKey

Retrieve videos for a TikTok hashtag API documentation TikTok platform page Pricing

Prefilled cURL

curl 'https://api.crawlora.net/api/v1/tiktok/mobile/hashtag/posts?name=readingvlog&sort=fresh' \
  -H "x-api-key: $CRAWLORA_API_KEY"

Request parameters

Parameter	Type	Required	Prefilled value	Description
name	string	Yes	readingvlog	Hashtag name without the leading #
sort	string	No	fresh	Listing: fresh (newest) or popular (hot)
count	integer	No		Videos per page (max 50)
cursor	integer	No		Pagination cursor

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "aweme_list": [
      {
        "aweme_id": "7681236055831416084",
        "desc": "#readingvlog"
      }
    ],
    "cursor": 5,
    "has_more": true,
    "status_code": 0,
    "status_msg": ""
  }
}

More TikTok endpoints

List TikTok explore categories Retrieve TikTok video comments Retrieve TikTok Creative Center filter taxonomy Retrieve TikTok Creative Center trending hashtags Retrieve TikTok Creative Center top content Retrieve TikTok Creative Center trending videos Retrieve the TikTok explore feed for a category Retrieve TikTok hashtag details Retrieve TikTok hashtag posts Anchor catalogue used by the video composer Retrieve replies to a TikTok comment Retrieve comments for a TikTok video All 66 TikTok endpoints

The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.

Set up API key Endpoint docs

Endpoint

Choose one catalog endpoint for this request.

1 shown

Group

Method

Auth

Endpoint

GETapiKey8 credits/requesttiktokmobile.hashtagPostsResponseDocTikTok

GET /tiktok/mobile/hashtag/posts

Retrieve videos for a TikTok hashtag

Response behavior

- Without a session the popular list returns an empty page from egresses outside the US; with a session it is region-independent.

API key required. Paste a full key or rotate one from the API Keys page.

Set up API key

View docs

API key

API key required for live requests. Your key is only used to send requests from this Playground.

not configured

Active Playground key: not configured

Manage API keys in Console

Required query parameters

name

requiredstring

Hashtag name without the leading #

Add an API key to send a live request.

If an active API key is configured, Copy cURL includes it. Share links never include API keys.

View docs

Sample responseGET

Shown before your first request. Add an API key and send a request to see the live response, status, latency, and headers.

{
  "code": 200,
  "msg": "OK",
  "data": {
    "aweme_list": [
      {
        "aweme_id": "7681236055831416084",
        "desc": "#readingvlog"
      }
    ],
    "cursor": 5,
    "has_more": true,
    "status_code": 0,
    "status_msg": ""
  }
}

Endpoint Playground

Try the Retrieve videos for a TikTok hashtag API

Request: GET /tiktok/mobile/hashtag/posts
Cost: 8 credits/request
Auth: apiKey

Retrieve videos for a TikTok hashtag API documentation TikTok platform page Pricing

Prefilled cURL

curl 'https://api.crawlora.net/api/v1/tiktok/mobile/hashtag/posts?name=readingvlog&sort=fresh' \
  -H "x-api-key: $CRAWLORA_API_KEY"

Request parameters

Parameter	Type	Required	Prefilled value	Description
name	string	Yes	readingvlog	Hashtag name without the leading #
sort	string	No	fresh	Listing: fresh (newest) or popular (hot)
count	integer	No		Videos per page (max 50)
cursor	integer	No		Pagination cursor

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "aweme_list": [
      {
        "aweme_id": "7681236055831416084",
        "desc": "#readingvlog"
      }
    ],
    "cursor": 5,
    "has_more": true,
    "status_code": 0,
    "status_msg": ""
  }
}

More TikTok endpoints

The sample response, schema and code snippets below work without an account. Sending a live request needs an API key.

Set up API key Endpoint docs

Endpoint

Choose one catalog endpoint for this request.

1 shown

Group

Method

Auth

Endpoint

GETapiKey8 credits/requesttiktokmobile.hashtagPostsResponseDocTikTok

GET /tiktok/mobile/hashtag/posts

Retrieve videos for a TikTok hashtag

Response behavior

- Without a session the popular list returns an empty page from egresses outside the US; with a session it is region-independent.

API key required. Paste a full key or rotate one from the API Keys page.

Set up API key

View docs

API key

API key required for live requests. Your key is only used to send requests from this Playground.

not configured

Active Playground key: not configured

Manage API keys in Console

Required query parameters

name

requiredstring

Hashtag name without the leading #

Add an API key to send a live request.

If an active API key is configured, Copy cURL includes it. Share links never include API keys.

View docs

Sample responseGET

Shown before your first request. Add an API key and send a request to see the live response, status, latency, and headers.

{
  "code": 200,
  "msg": "OK",
  "data": {
    "aweme_list": [
      {
        "aweme_id": "7681236055831416084",
        "desc": "#readingvlog"
      }
    ],
    "cursor": 5,
    "has_more": true,
    "status_code": 0,
    "status_msg": ""
  }
}