> ## 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.

# GET /api/v1/page-scrapers - List Facebook Page Scrapers

> List page scraper jobs and overall scraper status. Filter by search text or completion.

> List Facebook page scraper jobs for your account, or fetch aggregate status. Scraping still needs a connected Facebook browser.

## Status overview

```bash theme={null}
curl -H "Authorization: Bearer YOUR_TOKEN" -H "Accept: application/json" \
  "https://reachowl.com/api/v1/page-scrapers/status"
```

Example response:

```json theme={null}
{
  "is_running": true,
  "active_count": 2,
  "paused_count": 1,
  "completed_count": 5,
  "total_count": 8,
  "last_batch_at": "2026-10-20T12:00:00.000000Z"
}
```

## List scrapers

| Parameter | Type | Description |
| - | - | - |
| `search` | string | Filter by location name or keyword |
| `is_complete` | boolean | Filter completed vs incomplete jobs |
| `page` | integer | Page number |
| `limit` | integer | Page size (1-500, default 50) |

```bash theme={null}
curl -H "Authorization: Bearer YOUR_TOKEN" -H "Accept: application/json" \
  "https://reachowl.com/api/v1/page-scrapers?page=1&limit=50"
```

## Get one scraper

```bash theme={null}
curl -H "Authorization: Bearer YOUR_TOKEN" -H "Accept: application/json" \
  "https://reachowl.com/api/v1/page-scrapers/12"
```

## Bulk controls

```bash theme={null}
curl -X POST "https://reachowl.com/api/v1/page-scrapers/start-all" \
  -H "Authorization: Bearer YOUR_TOKEN"

curl -X POST "https://reachowl.com/api/v1/page-scrapers/stop-all" \
  -H "Authorization: Bearer YOUR_TOKEN"

curl -X POST "https://reachowl.com/api/v1/page-scrapers/rerun-all" \
  -H "Authorization: Bearer YOUR_TOKEN"
```

* `start-all` - set incomplete jobs to `active`
* `stop-all` - set incomplete jobs to `paused`
* `rerun-all` - reset all jobs (including completed) and queue them again


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