Search Facebook people profiles by keyword — $0.06/request, pay via USDC on Base, Solana, or Tempo
What it does
This endpoint searches Facebook for people profiles matching a keyword query. It is part of StableSocial, a pay-per-request social media data API covering TikTok, Instagram, Facebook, and Reddit through 36 unified endpoints. Every call costs a flat $0.06 in USDC, settled on Base, Solana, or Tempo (pathUSD). No API keys or subscriptions 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/facebook/search-people`. On success you receive a 202 response containing 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" and your data is returned. Jobs typically complete in 5–60 seconds; tokens expire after 30 minutes. If the trigger POST itself fails (bad params, entity not found), you are not charged.
Pagination is cursor-based: each finished response includes a `page_info` object with `has_next_page` and `cursor`. To fetch the next page, make a new paid POST with the cursor value. The `max_page_size` parameter controls results per page (default 50). The endpoint supports both x402 and MPP (Tempo method, charge intent) payment protocols.
Capabilities
Use cases
- —Finding Facebook user profiles matching a name or keyword for lead generation
- —Enriching CRM records by searching Facebook for matching people profiles
- —Competitive research by discovering public Facebook profiles in a niche
- —Agent-driven social media reconnaissance across platforms
- —Building people-search tools that aggregate results from multiple social networks
Fit
Best for
- —AI agents needing programmatic Facebook people search without API key management
- —Developers who want pay-per-call pricing instead of monthly subscriptions
- —Applications that need cross-platform social search (TikTok, Instagram, Facebook, Reddit) through one provider
Not for
- —High-volume bulk scraping where per-request costs would accumulate significantly
- —Use cases requiring real-time streaming data from Facebook
- —Applications that need official Facebook Graph API features like posting or managing pages
Quick start
# Step 1: Trigger search (requires payment header)
curl -X POST https://stablesocial.dev/api/facebook/search-people \
-H 'Content-Type: application/json' \
-d '{"keywords": "john doe", "max_page_size": 10}'
# → 202 {"token": "eyJ..."}
# Step 2: Poll for results (requires SIWX wallet auth)
curl 'https://stablesocial.dev/api/jobs?token=eyJ...'Example
Request
{
"keywords": "john doe",
"max_page_size": 10
}Response
{
"token": "eyJhbGciOiJIUzI1NiIs..."
}Endpoint
Quality
Full OpenAPI schema with clear request parameters, detailed guidance documentation, and confirmed pricing. The endpoint returned 405 on HEAD/GET probes, which is expected since it only accepts POST. No example response data schema is documented (only the job token and generic job polling responses), so the actual shape of returned people-search results is unknown.
Warnings
- —Endpoint returned 405 on HEAD and GET probes; it only accepts POST with a payment header, so liveness could not be directly confirmed via probe
- —No response schema documented — the structure of returned Facebook people search results is unspecified in the OpenAPI spec
- —The /docs page returns 404; documentation is embedded in the OpenAPI x-guidance field only
- —Data is scraped from Facebook on demand; availability depends on Facebook's public access policies which may change
Citations
- —Every endpoint costs $0.06 per request in USDC on Base, Solana, or Tempohttps://stablesocial.dev
- —The API uses an async two-step flow: POST to trigger (paid), 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
- —The search-people endpoint accepts keywords (required), max_page_size, and cursor parametershttps://stablesocial.dev/openapi.json
- —Payment only settles on 2xx responses; failed triggers are not chargedhttps://stablesocial.dev
- —36 endpoints across TikTok, Instagram, Facebook, and Reddithttps://stablesocial.dev