TikTok Hashtag Search API

Parameters

Query parameters

Examples

Make the request

curl "https://www.monocrawl.com/v1/tiktok/search-hashtag?hashtag=coffee" \
  -H "x-api-key: mn_your_key_here"

const key = process.env.MONOCRAWL_API_KEY;
if (!key) throw new Error('Set MONOCRAWL_API_KEY on your server.');
const res = await fetch(
  "https://www.monocrawl.com/v1/tiktok/search-hashtag?hashtag=coffee",
  { headers: { "x-api-key": key } },
);
const body = await res.json();

if (!body.success) {
  // one error shape for every endpoint — see /docs/errors
  throw new Error(`${body.error.type}: ${body.error.message}`);
}

console.log(body.data, "credits left:", body.credits_remaining);

import os
import requests

res = requests.get(
    "https://www.monocrawl.com/v1/tiktok/search-hashtag?hashtag=coffee",
    headers={"x-api-key": os.environ["MONOCRAWL_API_KEY"]},
    timeout=60,
)
body = res.json()

if not body["success"]:
    # one error shape for every endpoint — see /docs/errors
    raise RuntimeError(f"{body['error']['type']}: {body['error']['message']}")

print(body["data"], "credits left:", body["credits_remaining"])

Response

Response fields and example

This example is illustrative, not a captured live response. Variable-cost operations may settle a charge different from the list price below. A successful response puts the platform payload in data and reports the exact credits used, remaining balance, request id and cache status beside it.

{
  "success": true,
  "platform": "tiktok",
  "endpoint": "/v1/tiktok/search-hashtag",
  "data": {
    "items": [
      {
        "id": "7350000000000000002",
        "url": "https://www.tiktok.com/@example_creator/video/7350000000000000002",
        "caption": "A desk setup",
        "created_at": "2026-09-01T12:00:00.000Z",
        "duration_s": 15,
        "stats": {
          "plays": 1200,
          "likes": 100,
          "comments": 12,
          "shares": null,
          "saves": 8
        }
      }
    ],
    "cursor": null,
    "has_more": null
  },
  "credits_used": 1,
  "credits_remaining": 99,
  "request_id": "req_…",
  "cached": false
}

The example is illustrative and shows a documented subset of data. The fields below are optional across supported sources; nullable fields can also be absent. Preserve unknown values and accept additional fields.

Schema basis: reviewed response shaper. See schema coverage and validation limits.

Download the data JSON Schema. Validate response.data, not the whole envelope. A valid shape does not establish that every field or source record was returned.

include_music=true preserves the existing native source. Adding search_mode=precise selects source counters and regions with exact music strings, but verification can be unavailable and video durations are whole seconds. Keep the options with their cursor.

Failures use the typed error envelope. A confirmed uncharged or refunded failure reports zero; a pending reconciliation can report an unknown charge. Read credits_used and error.details.billing_status, and keep request_id for recovery. Response contract · Error reference

Related

Useful next calls

• All TikTok operations →
• Browse the complete endpoint directory →
• OpenAPI JSON →