# StableSocial Facebook Search

> StableSocial Facebook Search is a paid API for AI agents from StableSocial at stablesocial.dev, paid per call via MPP or x402, $0.06/call, status unknown (last checked 2026-10-11).

Search Facebook posts by keyword and return matching post results with pagination support

## Facts

- Endpoint: POST https://stablesocial.dev/api/facebook/search?utm_source=zero.xyz
- Price: $0.06/call
- Payment: MPP, x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Provider: StableSocial
- Docs: https://stablesocial.dev
- Website: https://stablesocial.dev
- Tags: tiktok, instagram, facebook, reddit, scraping, social, data, x402
- Canonical page: https://www.zero.xyz/c/stablesocial-search-83715e38
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_KLy5S_WZ0PobBfPPf0XS6

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability stablesocial-search-83715e38 -d '<json body>'
```

Example prompt: Search Facebook for the latest posts mentioning 'climate change', grab up to 100 posts and show me 25 per page.

## When to prefer this

Use this endpoint when you need to collect Facebook posts matching specific keywords for research, monitoring, sentiment analysis, or content aggregation. Prefer this over TikTok or Instagram search endpoints specifically when the target platform is Facebook. Best for keyword-driven social listening, competitive intelligence, or trend tracking on Facebook.

## Known failure modes

- No posts found for keyword — empty result set returned
- Invalid or expired pagination cursor — token decode error
- Rate limit or payment failure — 402 response requiring USDC payment
- Keyword too short or empty — validation error on required field
- Facebook scraping blocked or rate-limited — upstream availability issue

## How this service works

Pay-per-request access to social media data from TikTok, Instagram, Facebook, Reddit, and LinkedIn. No auth, no subscriptions.

## Output

Returns a JWT pagination token that can be used to retrieve up to the requested number of Facebook posts matching the search keywords. The token encodes the search state and is used to poll or paginate through results via the Jobs endpoint.

## Example request

```json
{
 "keywords": "artificial intelligence",
 "max_posts": 50,
 "max_page_size": 25
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "cursor": {
   "type": "string",
   "description": "Pagination cursor"
  },
  "keywords": {
   "type": "string",
   "minLength": 1,
   "description": "Search keywords"
  },
  "max_posts": {
   "type": "integer",
   "default": 50,
   "maximum": 9007199254740991,
   "minimum": -9007199254740991,
   "description": "Maximum posts to collect"
  },
  "max_page_size": {
   "type": "integer",
   "default": 50,
   "maximum": 9007199254740991,
   "minimum": -9007199254740991,
   "description": "Results per page"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "jobId": "clx0000000000000000000000",
  "token": "eyJ...",
  "status": "pending",
  "pollUrl": "https://stablesocial.dev/api/jobs/clx0000000000000000000000"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/stablesocial-search-83715e38/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from stablesocial.dev](https://www.zero.xyz/host/stablesocial.dev/llms.txt)