MPPtempoquality 0.72

Search Facebook page profiles by keyword — $0.06/request, pay via USDC on Base, Solana, or Tempo

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

What it does

This endpoint searches Facebook for page 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 a unified interface. 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 follows an async two-step flow. You POST a JSON body with your search keywords (and optional pagination parameters) along with a payment header. On success you receive a 202 response containing a signed JWT token. You then poll `GET /api/jobs?token=...` (free, but requires SIWX wallet authentication proving you are the paying wallet) until the job status transitions from "pending" to "finished", at which point the response includes the search results. Jobs typically complete in 5–60 seconds; tokens expire after 30 minutes. Pagination is cursor-based: each subsequent page requires a new paid POST.

The request schema accepts `keywords` (required string), `max_page_size` (integer, default 50), and `cursor` (string for pagination). The endpoint is a POST-only route — HEAD and GET return 405, which is expected behavior. StableSocial handles upstream platform changes so callers interact with a stable interface. If the trigger POST itself fails (e.g., bad parameters), you are not charged.

Capabilities

facebook-page-searchkeyword-searchsocial-media-dataasync-job-pollingcursor-paginationpay-per-requestcrypto-paymentsiwx-wallet-authno-api-key

Use cases

  • —Finding Facebook pages related to a brand, topic, or competitor keyword
  • —Building social media monitoring dashboards that track page presence across Facebook
  • —Enriching CRM or lead-gen pipelines with Facebook page data for businesses
  • —Agent-driven research workflows that need to discover relevant Facebook pages programmatically
  • —Aggregating social media presence data across platforms for competitive analysis

Fit

Best for

  • —AI agents that need on-demand Facebook page discovery without managing API keys
  • —Pay-as-you-go social media research with no subscription commitment
  • —Developers who want a unified social API across TikTok, Instagram, Facebook, and Reddit

Not for

  • —High-volume bulk scraping (each page of results costs $0.06)
  • —Use cases requiring real-time streaming or webhook-based updates
  • —Accessing private or non-public Facebook page data

Quick start

# Step 1: Trigger search (requires payment header)
curl -X POST https://stablesocial.dev/api/facebook/search-pages \
  -H 'Content-Type: application/json' \
  -d '{"keywords": "coffee shops", "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": "coffee shops",
  "max_page_size": 10
}

Response

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

Endpoint

URLhttps://stablesocial.dev/api/facebook/search-pages
Transporthttp
Protocolmpp
CurrencypathUSD

Quality

0.72/ 1.00

Full OpenAPI schema with clear request parameters, well-documented async flow, and confirmed pricing. The endpoint returned 405 on HEAD/GET which is expected for a POST-only route. Response schema for the actual finished job data is not documented (only the 202 token response and generic polling flow), and no example response payload for search results is available.

Warnings

  • —Endpoint returned 405 on HEAD and GET probes — this is expected since it is POST-only, but the MPP challenge was not captured via POST
  • —No response schema for the actual search results data (only the 202 token envelope is documented)
  • —The /docs page returns 404 — documentation is embedded in the OpenAPI x-guidance field only
  • —Data is scraped from Facebook on demand; availability and completeness depend on upstream platform access

Citations

Provenance

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

Agent access

JSONhttps://clawmart.sh/api/listings/8GWX87
Search Facebook page profiles by keyword — $0.06/request, pay via USDC on Base, Solana, or Tempo — Clawmart · Clawmart