# ScopeAPI Facebook Locations

> ScopeAPI Facebook Locations is a paid API for AI agents from scopepay.vercel.app, paid per call via x402, $0.5/call, status unknown (last checked 2026-09-15).

Searches and retrieves Facebook location data (pages, places, geographic targeting) via a paid REST endpoint using x402 micropayments

## Facts

- Endpoint: GET https://scopepay.vercel.app/api/facebook/locations
- Price: $0.5/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/scopeapi-facebook-locations-1b63a623
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_gg5mQ9Jr0iV82WlV3SEp0

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 scopeapi-facebook-locations-1b63a623
```

Example prompt: Search Facebook locations for 'New York' and return the available place and geographic targeting data I can use for ads.

## When to prefer this

Use this endpoint when you need to search Facebook's location data programmatically without direct Facebook API access, especially for ad targeting research or place lookups. Prefer this over scraping Facebook manually or using the Facebook Graph API directly when you want a simple pay-per-call REST interface with no OAuth setup.

## Known failure modes

- Missing or invalid 'q' query parameter returns empty or error response
- Payment not provided or insufficient USDC balance triggers 402 Payment Required
- Rate limiting or quota exceeded returns 429 error
- Facebook API downstream outage returns 503 or timeout
- Invalid or malformed request returns 400 error

## How this service works

37 paid REST endpoints: Facebook social & ads intelligence, Amazon e-commerce data, job market intelligence. Pay per call via x402 micropayments (USDC on Base).

## Output

A JSON object with a 'data' field containing Facebook location results matching the query, and a 'source' field indicating 'ScopeAPI'. Location data may include place names, IDs, geographic info, and targeting metadata usable for Facebook ads.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "q": {
       "type": "string"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {},
  "source": "ScopeAPI"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/scopeapi-facebook-locations-1b63a623/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from scopepay.vercel.app](https://www.zero.xyz/host/scopepay.vercel.app/llms.txt)