Search TikTok posts by music/sound — $0.06 per request, pay with USDC via MPP or x402.
What it does
This endpoint searches TikTok for posts that use a specific music track or sound. You provide a `music_title` and `music_id`, and the service fetches matching TikTok videos on demand. It costs $0.06 USD per request, payable in USDC on Base, Solana, or Tempo (pathUSD) — no API keys or subscriptions required.
The endpoint uses an async two-step flow. Step 1: POST to `/api/tiktok/search-music` with a payment header and a JSON body containing the music title and ID. On success you receive a 202 response with a signed JWT token. Step 2: Poll `GET /api/jobs?token=...` (free, but requires SIWX wallet authentication proving you are the paying wallet) until the job status is "finished" and data is returned. Jobs typically complete in 5–60 seconds; tokens expire after 30 minutes. Pagination is supported via a `cursor` field in the response's `page_info`, with each subsequent page requiring a new paid POST.
This is one of 36 endpoints in the StableSocial API, which provides unified pay-per-request access to TikTok, Instagram, Facebook, and Reddit data. All endpoints share the same pricing ($0.06/request) and the same async job pattern. Payment settles only on 2xx responses — if the trigger fails (bad params, entity not found), you are not charged.
Capabilities
Use cases
- —Finding TikTok videos that use a specific trending sound or song
- —Monitoring how a branded audio clip spreads across TikTok
- —Analyzing the popularity and reach of a music track on TikTok
- —Discovering user-generated content associated with a particular sound
- —Competitive analysis of music-driven TikTok campaigns
Fit
Best for
- —AI agents that need on-demand TikTok music/sound data without managing API keys
- —Social media researchers tracking audio trends on TikTok
- —Marketing teams analyzing sound-driven content virality
Not for
- —Bulk historical data dumps (each page costs $0.06 and jobs are async)
- —Real-time streaming of TikTok content (this is a poll-based async API)
- —Use cases requiring official TikTok API compliance or OAuth user tokens
Quick start
# Step 1: Trigger the search (requires MPP/x402 payment header)
curl -X POST https://stablesocial.dev/api/tiktok/search-music \
-H 'Content-Type: application/json' \
-d '{"music_title": "original sound", "music_id": "6812345678901234567"}'
# → 202 {"token": "eyJ..."}
# Step 2: Poll for results (free, SIWX wallet auth required)
curl https://stablesocial.dev/api/jobs?token=eyJ...Example
Request
{
"music_id": "6812345678901234567",
"music_title": "original sound",
"max_page_size": 50
}Response
{
"token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
}Endpoint
Quality
Full OpenAPI schema with clear request parameters, well-documented async flow, and explicit pricing. The endpoint returned 405 on HEAD/GET probes, which is expected since it only accepts POST. No example response data schema is provided for the finished job payload, and the /docs page returns 404, so the actual shape of returned TikTok music search results is unknown.
Warnings
- —Probe returned 405 on HEAD and GET — endpoint only accepts POST with payment header, so liveness could not be directly confirmed via probe
- —No response schema defined for the finished job data — the structure of returned TikTok music search results is undocumented in the OpenAPI spec
- —The /docs page returns 404; all documentation is embedded in the OpenAPI x-guidance field and the landing page
Citations
- —Each request costs $0.06 USD, payable in USDC on Base, Solana, or Tempohttps://stablesocial.dev
- —The endpoint requires music_title and music_id as required parametershttps://stablesocial.dev/openapi.json
- —Async two-step flow: POST to trigger (paid, returns 202 with JWT token), then poll GET /api/jobs (free, SIWX wallet auth)https://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