MPPtempoquality 0.72

Search Facebook groups by keyword — $0.06 per request, no API keys needed.

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

What it does

This endpoint searches Facebook group profiles by keyword via 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 job-status endpoint (GET /api/jobs?token=...) with SIWX wallet authentication until the result is ready, typically within 5–60 seconds. Tokens expire after 30 minutes.

The API uses an async two-step flow: Step 1 is a paid POST that triggers data collection and returns a job token. Step 2 is a free GET that polls for results, authenticated by the same wallet that paid. Pagination is supported via a cursor field in the response's page_info object; each additional page requires a new paid POST. Payment settles via USDC on Base, Solana, or Tempo (pathUSD) at a fixed price of $0.06 per request. No API keys, signups, or subscriptions are required — the payment header serves as authentication.

If the trigger POST itself fails (e.g., bad parameters), you are not charged. The response schema for group search results is not documented in the OpenAPI spec beyond a generic 200 success, so the exact shape of returned group data must be discovered at runtime.

Capabilities

facebook-group-searchkeyword-searchasync-job-pollingcursor-paginationpay-per-requestcrypto-paymentsiwx-wallet-authno-api-key

Use cases

  • —Finding Facebook groups related to a topic or niche for market research
  • —Discovering community groups around a brand or product name
  • —Building an agent that monitors emerging Facebook communities by keyword
  • —Aggregating group metadata for competitive analysis across social platforms
  • —Enriching CRM or audience data with relevant Facebook group associations

Fit

Best for

  • —AI agents that need on-demand Facebook group discovery without managing credentials
  • —Researchers exploring community structures on Facebook
  • —Developers building multi-platform social search tools

Not for

  • —High-volume bulk scraping requiring sub-cent pricing
  • —Use cases needing real-time streaming of Facebook group activity
  • —Applications that require detailed group member lists or private group content

Quick start

# Step 1: Trigger search (paid, $0.06)
curl -X POST https://stablesocial.dev/api/facebook/search-groups \
  -H 'Content-Type: application/json' \
  -H 'X-Payment: <payment-header>' \
  -d '{"keywords": "artificial intelligence"}'
# → 202 {"token": "eyJ..."}

# Step 2: Poll for results (free, SIWX auth required)
curl https://stablesocial.dev/api/jobs?token=eyJ... \
  -H 'SIGN-IN-WITH-X: <siwx-token>'

Example

Request

{
  "keywords": "artificial intelligence",
  "max_page_size": 50
}

Response

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

Endpoint

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

Quality

0.72/ 1.00

Full OpenAPI schema with clear request parameters, documented pricing ($0.06/request), and detailed guidance on the async two-step flow. However, the probe did not capture a live 402 challenge (endpoint is POST-only, probe tried HEAD/GET which returned 405), and the response schema for group search results is unspecified beyond a generic 200. No example response data for the actual group results is available.

Warnings

  • —Probe returned 405 because HEAD/GET were used; the endpoint only accepts POST — this does not indicate the endpoint is down.
  • —Response schema for successful group search results is not documented; the OpenAPI spec only shows a generic '200: Successful response'.
  • —No /docs, /pricing, or /README pages were found (all returned 404); documentation is embedded in the OpenAPI x-guidance field only.

Citations

Provenance

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

Agent access

JSONhttps://clawmart.sh/api/listings/Nru8Lw
Search Facebook groups by keyword — $0.06 per request, no API keys needed. — Clawmart · Clawmart