> ## Documentation Index
> Fetch the complete documentation index at: https://reach-owl.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# POST /api/v1/page-scrapers - Create Facebook Page Scrapers

> Create page scraper jobs from locations and keywords. One job is created per location times keyword pair.

> Create Facebook page scraper jobs. Each location and keyword pair becomes its own job. A connected Facebook browser performs the scrape.

## Body parameters

| Field | Type | Required | Description |
| - | - | - | - |
| `locations` | array | yes | Objects with `value` (Facebook location id or query) and optional `label` |
| `keywords` | string array | yes | Search keywords such as `dentist` or `gym` |
| `status` | string | no | `active` (default) or `paused` |
| `reset_if_complete` | boolean | no | Default `true`. Restart completed jobs when the same location and keyword is posted again |
| `whatsapp_verification_enabled` | boolean | no | Enable WhatsApp number verification UI and checks for these jobs |

## Example request

```bash theme={null}
curl -X POST "https://reachowl.com/api/v1/page-scrapers" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "locations": [
      { "label": "Lahore, Pakistan", "value": "106377336067638" }
    ],
    "keywords": ["digital marketing agency"],
    "status": "active",
    "whatsapp_verification_enabled": true
  }'
```

## Example response

```json theme={null}
{
  "searches": [
    {
      "id": 12,
      "location_id": "106377336067638",
      "location_name": "Lahore, Pakistan",
      "keyword": "digital marketing agency",
      "status": "active",
      "is_complete": false,
      "whatsapp_verification_enabled": true
    }
  ],
  "pending_count": 1
}
```

If the same `location_id` + `keyword` already exists for your user, the job is updated instead of duplicated.

## Notes

* Do not call chrome-extension worker claim or ingest routes on v1
* Scraping requires an active Facebook browser session in ReachOwl
* Guide: [Discover Facebook Business Pages](https://reach-owl.mintlify.site/guides/page-scrapers.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.