Search TikTok posts by hashtag — $0.06 per request, pay with USDC via MPP/x402.
What it does
This endpoint searches TikTok for posts matching a given hashtag. It is part of StableSocial, a pay-per-request social media data API covering TikTok, Instagram, Facebook, and Reddit (36 endpoints total). Every call costs a flat $0.06 USD, settled in USDC on Base, Solana, or Tempo via the MPP or x402 payment protocols. No API keys or subscriptions are required — payment itself serves as authentication.
The flow is asynchronous: you POST to `/api/tiktok/search-hashtag` with a JSON body containing the hashtag (without the `#` symbol), along with optional `max_page_size` (default 50) and `cursor` parameters for pagination. On success, the endpoint returns HTTP 202 with a signed JWT token. You then poll `GET /api/jobs?token=...` (free, but requires SIWX wallet auth proving you are the paying wallet) until the job status is `finished`, at which point the response includes the matching post data. Jobs typically complete in 5–60 seconds; tokens expire after 30 minutes.
This is a standalone search endpoint with no dependency on other StableSocial calls — you do not need to fetch a profile first. Pagination works by extracting the `cursor` from `page_info` in the response and submitting a new paid POST for each subsequent page. If the trigger POST itself fails (e.g., bad parameters), you are not charged.
Capabilities
Use cases
- —Discovering trending TikTok content around a specific hashtag for market research
- —Monitoring brand mentions or campaign hashtags on TikTok
- —Collecting TikTok post data for sentiment analysis on a topic
- —Building social listening dashboards that track hashtag activity
- —Competitive analysis by comparing engagement across hashtags
Fit
Best for
- —AI agents that need on-demand TikTok hashtag data without managing API keys
- —Social media researchers who want pay-as-you-go access without subscriptions
- —Developers building social listening tools across multiple platforms
Not for
- —High-frequency real-time streaming of TikTok data (async polling adds latency)
- —Use cases requiring official TikTok API compliance or verified data provenance
- —Users without a crypto wallet (USDC payment and SIWX auth are required)
Quick start
# Step 1: Trigger search (requires MPP/x402 payment header)
curl -X POST https://stablesocial.dev/api/tiktok/search-hashtag \
-H 'Content-Type: application/json' \
-d '{"hashtag": "cooking", "max_page_size": 20}'
# → 202 {"token": "eyJ..."}
# Step 2: Poll for results (free, SIWX wallet auth required)
curl https://stablesocial.dev/api/jobs?token=eyJ...
# → 200 {"status": "finished", "data": {...}}Example
Request
{
"hashtag": "cooking",
"max_page_size": 20
}Response
{
"token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
}Endpoint
Quality
Full OpenAPI schema with clear request parameters, documented pricing ($0.06/request), and detailed async workflow guidance. The endpoint returned 405 on HEAD/GET probes, which is expected since it only accepts POST. No response schema or example response data is provided, and the /docs page returns 404, so the actual shape of returned TikTok data is unknown.
Warnings
- —Endpoint returned 405 on HEAD and GET probes — this is expected since it only accepts POST with a payment header, but live 402 challenge was not directly captured for this specific endpoint.
- —No response schema defined in OpenAPI — the shape of returned hashtag search data is undocumented.
- —The /docs page returns 404; all documentation comes from the OpenAPI x-guidance field and the landing page.
- —Requires a crypto wallet with USDC for payment and SIWX for polling — no fiat payment option documented.
Citations
- —Every endpoint costs $0.06 per request in USDC on Base, Solana, or Tempohttps://stablesocial.dev
- —The search-hashtag endpoint accepts POST with a required 'hashtag' field and optional max_page_size and cursor parametershttps://stablesocial.dev/openapi.json
- —Async two-step flow: POST to trigger (returns 202 with JWT token), then poll GET /api/jobs with SIWX wallet authhttps://stablesocial.dev
- —Tokens expire after 30 minutes; jobs typically finish in 5–60 secondshttps://stablesocial.dev
- —Payment only settles on 2xx responses — failed triggers are not chargedhttps://stablesocial.dev
- —36 endpoints across TikTok, Instagram, Facebook, and Reddithttps://stablesocial.dev