MPPtempoquality 0.78

Search TikTok user profiles by keyword — $0.06 per request, pay via USDC on Base/Solana/Tempo.

Price
$0.06 / call
Protocol
mpp
Verified
no
Endpoint
https://stablesocial.dev/api/tiktok/search-profiles

What it does

This endpoint searches TikTok for user profiles matching a keyword query. 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 via x402 or MPP (Tempo). No API keys or signups are required — payment itself serves as authentication.

The endpoint uses an async two-step flow. You POST a JSON body with your search keywords (and optional pagination parameters) to `/api/tiktok/search-profiles`. On success you receive a 202 response containing a signed JWT token. You then poll `GET /api/jobs?token=...` (authenticated via SIWX wallet signature) until the job status transitions to "finished" and your profile results are returned. Tokens expire after 30 minutes; jobs typically complete in 5–60 seconds. Pagination is supported via a `cursor` field in the response's `page_info` object — each subsequent page requires a new paid POST.

Key request parameters: `keywords` (required, the search query string), `max_page_size` (results per page, default 50), and `cursor` (for pagination). The endpoint accepts `application/json` and is documented in a full OpenAPI 3.1.0 spec at `/openapi.json`. Payment is not charged if the trigger POST itself fails (e.g., bad parameters).

Capabilities

tiktok-profile-searchkeyword-searchsocial-media-dataasync-job-pollingcursor-paginationpay-per-requestno-api-keysiwx-wallet-authusdc-paymentx402mpp-tempo

Use cases

  • —Finding TikTok influencers or creators matching specific keywords for marketing campaigns
  • —Competitive analysis by discovering TikTok accounts in a particular niche
  • —Building social listening tools that identify relevant TikTok profiles by topic
  • —Agent-driven research workflows that need on-demand TikTok profile discovery

Fit

Best for

  • —AI agents needing programmatic TikTok profile search without API key management
  • —One-off or low-volume social media research where subscriptions are overkill
  • —Developers who want a unified social API across TikTok, Instagram, Facebook, and Reddit
  • —Crypto-native workflows settling micropayments in USDC

Not for

  • —High-frequency bulk scraping (each page costs $0.06 and requires async polling)
  • —Use cases requiring real-time streaming of TikTok data
  • —Accessing private or non-public TikTok profile information

Quick start

# Step 1: Trigger search (requires payment header)
curl -X POST https://stablesocial.dev/api/tiktok/search-profiles \
  -H 'Content-Type: application/json' \
  -d '{"keywords": "cooking", "max_page_size": 10}'
# → 202 {"token": "eyJ..."}

# Step 2: Poll for results (requires SIWX wallet auth)
curl 'https://stablesocial.dev/api/jobs?token=eyJ...' \
  -H 'SIGN-IN-WITH-X: <wallet-signature>'
# → 200 {"status": "finished", "data": {...}}

Example

Request

{
  "keywords": "cooking",
  "max_page_size": 10
}

Response

{
  "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
}

Endpoint

URLhttps://stablesocial.dev/api/tiktok/search-profiles
Transporthttp
Protocolmpp
CurrencypathUSD

Quality

0.78/ 1.00

Full OpenAPI 3.1.0 schema with clear request parameters, detailed guidance documentation, and explicit pricing. The endpoint is a POST-only route so the HEAD/GET probe returning 405 is expected and does not indicate a problem. Docked slightly because no response schema is provided (only "Successful response") and no example response data structure is documented.

Warnings

  • —Probe returned 405 because HEAD/GET were used on a POST-only endpoint; this does not indicate the endpoint is down.
  • —No response schema is documented — the shape of returned profile data is unknown.
  • —No dedicated docs page exists (/docs returns 404); all documentation is in the OpenAPI x-guidance field and the landing page.

Citations

Provenance

Indexed frommpp_dev
Enriched2026-04-19 16:45:56Z · anthropic/claude-opus-4.6 · v2
First seen2026-04-18
Last seen2026-04-22

Agent access

JSONhttps://clawmart.sh/api/listings/SdaYUq