Search Reddit user profiles by keyword — $0.06 per request via MPP/x402
What it does
This endpoint searches Reddit user profiles 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 search keywords 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). Pagination is supported via cursor-based tokens returned in the response's page_info object; each additional page requires a new paid POST.
Pricing is a flat $0.06 USD per request, payable in USDC via x402 or MPP (Tempo method on pathUSD). No API keys or signups are required — payment serves as authentication for trigger calls, and SIWX wallet auth secures result polling so only the paying wallet can retrieve data. If the trigger POST itself fails (e.g., bad parameters), you are not charged; payment only settles on 2xx responses. Tokens expire after 30 minutes.
The endpoint accepts optional parameters for max_profiles (default 50), max_page_size (default 50), and a cursor for pagination. The broader StableSocial API provides similar search, profile, post, comment, follower, and following endpoints across all four supported platforms with identical pricing and the same async two-step flow.
Capabilities
Use cases
- —Finding Reddit users relevant to a topic or brand for influencer research
- —Building social listening agents that discover Reddit community members by keyword
- —Enriching CRM or lead-gen pipelines with Reddit profile discovery
- —Monitoring Reddit for emerging voices in a niche or industry
- —Competitive analysis by searching for profiles associated with competitor keywords
Fit
Best for
- —AI agents needing on-demand Reddit user discovery without API key management
- —Pay-as-you-go social media research with no subscription commitment
- —Programmatic workflows that need a unified interface across TikTok, Instagram, Facebook, and Reddit
Not for
- —High-volume bulk scraping where per-request costs would accumulate significantly
- —Use cases requiring real-time streaming of Reddit data (this is async polling-based)
- —Accessing private or non-public Reddit profile information
Quick start
# Step 1: Trigger search (requires MPP or x402 payment header)
curl -X POST https://stablesocial.dev/api/reddit/search-profiles \
-H 'Content-Type: application/json' \
-d '{"keywords": "machine learning", "max_profiles": 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: <siwx_token>'
# → 200 {"status": "finished", "data": {...}}Example
Request
{
"keywords": "machine learning",
"max_profiles": 10,
"max_page_size": 10
}Response
{
"token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
}Endpoint
Quality
Full OpenAPI schema with clear request parameters, detailed x-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 downtime. Response schema for the final data payload is not documented (only the 202 token response is described), and no example response data for finished jobs is provided.
Warnings
- —Probe returned 405 on HEAD and GET because this endpoint only accepts POST — this is expected behavior, not a failure
- —No response schema documented for the finished job data payload — actual Reddit profile fields are unknown
- —The /docs page returns 404; documentation is embedded in the OpenAPI x-guidance field only
- —SIWX wallet authentication is required for polling results, which adds integration complexity beyond simple HTTP calls
Citations
- —Every endpoint costs $0.06 per requesthttps://stablesocial.dev
- —Async two-step flow: POST to trigger (paid), then poll GET /api/jobs with SIWX wallet auth (free)https://stablesocial.dev/openapi.json
- —Tokens expire after 30 minutes; jobs typically finish in 5–60 secondshttps://stablesocial.dev/openapi.json
- —Payment settles only on 2xx responses; failed triggers are not chargedhttps://stablesocial.dev/openapi.json
- —Supports x402 and MPP (Tempo method) payment protocolshttps://stablesocial.dev/openapi.json
- —36 endpoints across TikTok, Instagram, Facebook, and Reddithttps://stablesocial.dev