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

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

{
  "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