Search TikTok posts by keyword — $0.06 per request, pay via USDC on Base/Solana/Tempo.
What it does
This endpoint searches TikTok posts by keyword through StableSocial's unified social media data API. It is one of 36 endpoints covering TikTok, Instagram, Facebook, and Reddit. You POST a JSON body with your search keywords and optional parameters (sort type, date filter, max posts, page size, pagination cursor), and receive a 202 response containing a signed JWT token. You then poll a separate free endpoint (GET /api/jobs?token=...) with SIWX wallet authentication to retrieve results once the async job completes (typically 5–60 seconds). Each request costs $0.06 USD, payable in USDC via x402 or MPP (Tempo method, charge intent). No API keys or signups are required — payment serves as authentication.
The search supports sorting by relevance, like count, or date posted, and filtering by time range (past day, week, month, or half year). Results are paginated via cursor-based pagination; each page fetch is a separate paid POST. Tokens expire after 30 minutes. If the trigger POST itself fails (e.g., bad parameters), you are not charged — payment only settles on 2xx responses.
StableSocial is part of the broader StableSocial platform which provides a consistent interface across four social platforms. The OpenAPI spec is published at /openapi.json and the endpoint supports both x402 and MPP payment protocols.
Capabilities
Use cases
- —Search TikTok for posts matching specific keywords for trend analysis
- —Monitor brand mentions or competitor activity on TikTok
- —Collect TikTok post data for social listening dashboards
- —Research viral content by filtering TikTok posts by date and sorting by likes
- —Feed TikTok search results into an AI agent's research pipeline
Fit
Best for
- —AI agents needing on-demand TikTok search without API key management
- —Social media researchers who want pay-per-use pricing instead of subscriptions
- —Developers building cross-platform social monitoring tools
- —One-off or low-volume TikTok data collection tasks
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 required)
Quick start
# Step 1: Trigger search (requires payment header)
curl -X POST https://stablesocial.dev/api/tiktok/search \
-H 'Content-Type: application/json' \
-d '{"keywords": "AI agents", "max_posts": 20, "sort_type": "relevance"}'
# → 202 {"token": "eyJ..."}
# Step 2: Poll for results (free, requires SIWX wallet auth)
curl https://stablesocial.dev/api/jobs?token=eyJ...
# → 200 {"status": "finished", "data": {...}}Example
Request
{
"keywords": "AI agents",
"max_posts": 20,
"sort_type": "relevance",
"date_posted": "past_week",
"max_page_size": 20
}Response
{
"token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
}Endpoint
Quality
Full OpenAPI schema with clear request parameters, well-documented async two-step flow, and explicit pricing. The endpoint returned 405 on HEAD/GET probes, which is expected since it only accepts POST. No response schema is documented (only 200 'Successful response'), and no example response data structure is available, which limits completeness.
Warnings
- —Probe returned 405 on HEAD/GET — endpoint only accepts POST, which is expected behavior, not a failure
- —No response body schema documented in OpenAPI spec — the shape of returned TikTok search data is unknown
- —SIWX wallet authentication is required for polling results, which adds integration complexity
- —The /docs page returns 404 — no dedicated documentation site beyond the OpenAPI spec and landing page
Citations
- —Each endpoint costs $0.06 per request in USDC on Base, Solana, or Tempohttps://stablesocial.dev
- —Async two-step flow: POST to trigger (paid, returns JWT token), then GET /api/jobs to poll (free, SIWX auth required)https://stablesocial.dev
- —TikTok search supports sort_type (relevance, like_count, date_posted) and date_posted filters (all, past_day, past_week, past_month, past_half_year)https://stablesocial.dev/openapi.json
- —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