# Facebook API guide



## Start with Facebook



Read a public page, choose a post from its feed and inspect the available discussion. Pages, groups, reels and marketplace listings are separate data surfaces.



These requests use your API key and can spend credits. Check the current price on the endpoint page; each new page is a separate request. Later examples use illustrative identifiers: replace them with values from your earlier response.



### 1. Resolve the page



Keep the returned page URL and source identifiers. Page followers and likes describe different counters. [Parameters and current cost →](https://www.monocrawl.com/docs/endpoints/facebook/profile)



**facebook/profile**

```
curl "https://www.monocrawl.com/v1/facebook/profile?url=https%3A%2F%2Fwww.facebook.com%2Fnasa" \
  -H "x-api-key: mn_your_key_here"
```



### 2. Read the page feed



Choose a returned post URL. A page of posts is a bounded sample, and feed order may include pinned content. [Parameters and current cost →](https://www.monocrawl.com/docs/endpoints/facebook/posts)



**facebook/posts**

```
curl "https://www.monocrawl.com/v1/facebook/posts?url=https%3A%2F%2Fwww.facebook.com%2Fnasa" \
  -H "x-api-key: mn_your_key_here"
```



### 3. Read a post discussion



Replace the example URL with a post from the feed. Preserve reply continuation fields on each comment. [Parameters and current cost →](https://www.monocrawl.com/docs/endpoints/facebook/post-comments)



**facebook/post-comments**

```
curl "https://www.monocrawl.com/v1/facebook/post-comments?url=https%3A%2F%2Fwww.facebook.com%2Freel%2F2839681326387786%2F" \
  -H "x-api-key: mn_your_key_here"
```



## Choose filters with the source behavior in mind



| Control | Behavior and limits |
| --- | --- |
| URL identity | Use the correct public page, post or group URL. A page name does not resolve to a group and a numeric counter is not a list of people. [Endpoint reference →](https://www.monocrawl.com/docs/endpoints/facebook/profile) |
| Reply continuation | Pass feedback_id and expansion_token from the same parent comment together. Neither can be reconstructed from the display text. [Endpoint reference →](https://www.monocrawl.com/docs/endpoints/facebook/comment-replies) |
| Sort and time | Group sort_by supports CHRONOLOGICAL or TOP_POSTS. City event time buckets belong to city-events; do not attach them to other feeds. [Endpoint reference →](https://www.monocrawl.com/docs/endpoints/facebook/group-posts) |
| Coverage | A visible comment count does not guarantee every comment or reply can be collected. Preserve the returned cursor and warnings. [Endpoint reference →](https://www.monocrawl.com/docs/endpoints/facebook/post-comments) |



Source availability, ordering and field coverage can change. Inspect warnings and partial-result metadata alongside the rows. See [runnable workflows](https://www.monocrawl.com/docs/workflows), [metric semantics](https://www.monocrawl.com/docs/metric-semantics), [computed fields](https://www.monocrawl.com/docs/computed-fields) and the [pagination matrix](https://www.monocrawl.com/docs/pagination).



## Match the operation to your task



| Your task | Endpoint | When to use it |
| --- | --- | --- |
| A specific post | [`post`](https://www.monocrawl.com/docs/endpoints/facebook/post) | Retrieve its full available text and counters. |
| Replies under a comment | [`comment-replies`](https://www.monocrawl.com/docs/endpoints/facebook/comment-replies) | Requires both feedback_id and expansion_token from that comment row. |
| A public group feed | [`group-posts`](https://www.monocrawl.com/docs/endpoints/facebook/group-posts) | Use a group URL and its supported sort. A page feed does not retrieve group posts. |
| Events around a city | [`city-events`](https://www.monocrawl.com/docs/endpoints/facebook/city-events) | Use a city events URL and the declared time bucket. |



Explore all documented operations by purpose below. Each endpoint reference contains its accepted parameters and current price.



### Other operations



- [`city-events`](https://www.monocrawl.com/docs/endpoints/facebook/city-events)

- [`event`](https://www.monocrawl.com/docs/endpoints/facebook/event)

- [`events`](https://www.monocrawl.com/docs/endpoints/facebook/events)

- [`group`](https://www.monocrawl.com/docs/endpoints/facebook/group)

- [`marketplace-item`](https://www.monocrawl.com/docs/endpoints/facebook/marketplace-item)

- [`marketplace-locations`](https://www.monocrawl.com/docs/endpoints/facebook/marketplace-locations)

- [`photos`](https://www.monocrawl.com/docs/endpoints/facebook/photos)



### Comments and replies



- [`comment-replies`](https://www.monocrawl.com/docs/endpoints/facebook/comment-replies)

- [`post-comments`](https://www.monocrawl.com/docs/endpoints/facebook/post-comments)



### Search and discovery



- [`events-search`](https://www.monocrawl.com/docs/endpoints/facebook/events-search)

- [`marketplace-search`](https://www.monocrawl.com/docs/endpoints/facebook/marketplace-search)

- [`search-pages`](https://www.monocrawl.com/docs/endpoints/facebook/search-pages)

- [`search-people`](https://www.monocrawl.com/docs/endpoints/facebook/search-people)

- [`search-posts`](https://www.monocrawl.com/docs/endpoints/facebook/search-posts)

- [`search-videos`](https://www.monocrawl.com/docs/endpoints/facebook/search-videos)



### Posts and media



- [`group-posts`](https://www.monocrawl.com/docs/endpoints/facebook/group-posts)

- [`post`](https://www.monocrawl.com/docs/endpoints/facebook/post)

- [`posts`](https://www.monocrawl.com/docs/endpoints/facebook/posts)

- [`reels`](https://www.monocrawl.com/docs/endpoints/facebook/reels)

- [`reels/full`](https://www.monocrawl.com/docs/endpoints/facebook/reels/full)



### Transcripts



- [`post-transcript`](https://www.monocrawl.com/docs/endpoints/facebook/post-transcript)



### Accounts and audiences



- [`profile`](https://www.monocrawl.com/docs/endpoints/facebook/profile)

- [`profile/full`](https://www.monocrawl.com/docs/endpoints/facebook/profile/full)



## Endpoint reference

## facebook/city-events

`GET /v1/facebook/city-events`

The public events on a city's Facebook events page, one page at a time and optionally limited to today, this week or next week: name, when, where, kind, cover, price range and interest counts.

*Facebook city events*

| Parameter | Required | Description |
| --- | --- | --- |
| `url` | yes | A city's Facebook events page URL — e.g. `https://www.facebook.com/events/explore/saint-petersburg-florida/111326725552547` |
| `time` | no | today, this_week or next_week; omitted = all time Accepted values: today, this_week, next_week. Case, spaces, hyphens and underscores are interchangeable. — e.g. `this_week` |
| `cursor` | no | Opaque cursor from the previous page |
| `dry_run` | no | Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable. — e.g. `1` |

### Useful optional inputs

- `cursor`: Continue the same source traversal with the complete returned cursor. Saved-result retrieval and a new source page can have different prices; quote the next call.
- `dry_run`: Read a free estimate before fetching sources or scheduling paid work. Zero credits; cache status and availability are snapshots rather than guarantees.

**Cost:** 4 credits at list price per successful uncached response; variable-cost operations may quote or settle a different charge. Confirmed uncharged or refunded failures report zero. Pending reconciliation can report credits_used:null; retain request_id and the original idempotency key.

```bash
curl "https://www.monocrawl.com/v1/facebook/city-events?url=https%3A%2F%2Fwww.facebook.com%2Fevents%2Fexplore%2Fsaint-petersburg-florida%2F111326725552547" \
  -H "x-api-key: mn_your_key_here"
```

### Response data

Illustrative abbreviated data; documented core fields are optional and may be null. Additional source fields are allowed.

```json
{
  "cursor": null,
  "dropped": 0,
  "has_more": false,
  "items": [
    {
      "cover_url": "https://example.com/example",
      "going_count": 0,
      "id": "example",
      "interested_count": 0,
      "is_happening_now": false,
      "is_online": false,
      "is_past": false,
      "kind": "example",
      "location": {
        "id": "example",
        "name": "example",
        "type": "example"
      },
      "name": "example",
      "place": "example",
      "platform": "example",
      "price_range": "example",
      "social_text": "example",
      "starts_at": "2026-09-01T12:00:00Z",
      "url": "https://example.com/example",
      "when_text": "example"
    }
  ],
  "url": "https://example.com/example"
}
```

[Field reference](https://www.monocrawl.com/docs/endpoints/facebook/city-events#response) · [JSON Schema for response.data](https://www.monocrawl.com/schemas/facebook/city-events.json)


## facebook/comment-replies

`GET /v1/facebook/comment-replies`

The reply thread under one Facebook comment — chain feedback_id + expansion_token from facebook/post-comments. Facebook hides some reply threads; an empty list is the platform's real answer, not an error.

*Comment replies*

| Parameter | Required | Description |
| --- | --- | --- |
| `feedback_id` | yes | feedback_id from a facebook/post-comments row. |
| `expansion_token` | yes | expansion_token from the same facebook/post-comments row. |
| `cursor` | no | Opaque cursor from the previous page. |
| `dry_run` | no | Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable. — e.g. `1` |
| `judgments` | no | Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Accepted values: on, off. Case, spaces, hyphens and underscores are interchangeable. — e.g. `on` |
| `label` | no | Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Accepted values: default, none. Case, spaces, hyphens and underscores are interchangeable. — e.g. `none` |
| `label_evidence` | no | Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable. — e.g. `1` |
| `exclude` | no | Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Accepted values: engagement_bait. Case, spaces, hyphens and underscores are interchangeable. — e.g. `engagement_bait` |
| `fit` | no | Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Accepted values: goal. Case, spaces, hyphens and underscores are interchangeable. — e.g. `goal` |
| `goal` | no | Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. — e.g. `Find concrete product complaints` |
| `tokens` | no | Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. — e.g. `4000` |

### Useful optional inputs

- `fit`: Use fit=goal with a task description to replace confidently irrelevant records with recall stubs and reduce agent context. No fit surcharge; full evidence is retained for 24 hours when stored, and the response size target is soft.
- `cursor`: Continue the same source traversal with the complete returned cursor. Saved-result retrieval and a new source page can have different prices; quote the next call.
- `dry_run`: Read a free estimate before fetching sources or scheduling paid work. Zero credits; cache status and availability are snapshots rather than guarantees.

**Cost:** 2 credits at list price per successful uncached response; variable-cost operations may quote or settle a different charge. Confirmed uncharged or refunded failures report zero. Pending reconciliation can report credits_used:null; retain request_id and the original idempotency key.

```bash
# Replace REPLACE_WITH_FEEDBACK_ID, REPLACE_WITH_EXPANSION_TOKEN with the required input described in the parameter table.
curl "https://www.monocrawl.com/v1/facebook/comment-replies?feedback_id=REPLACE_WITH_FEEDBACK_ID&expansion_token=REPLACE_WITH_EXPANSION_TOKEN" \
  -H "x-api-key: mn_your_key_here"
```

### Response data

Illustrative abbreviated data; documented core fields are optional and may be null. Additional source fields are allowed.

```json
{
  "cursor": null,
  "dropped": 0,
  "has_more": false,
  "items": [
    {
      "author": {
        "id": "example",
        "name": "example"
      },
      "created_at": "2026-09-01T12:00:00Z",
      "expansion_token": "example",
      "feedback_id": "example",
      "id": "example",
      "reactions": 0,
      "reply_count": 0,
      "text": "example"
    }
  ]
}
```

[Field reference](https://www.monocrawl.com/docs/endpoints/facebook/comment-replies#response) · [JSON Schema for response.data](https://www.monocrawl.com/schemas/facebook/comment-replies.json)


## facebook/event

`GET /v1/facebook/event`

One event in full: description, timing, location and coordinates, attendance count, hosts, creator, ticket link and cover.

*Facebook event*

| Parameter | Required | Description |
| --- | --- | --- |
| `id` | yes | Event id (or pass url) — e.g. `1234567890123456` |
| `url` | no | Event URL, instead of id — e.g. `https://www.facebook.com/events/1234567890123456` |
| `dry_run` | no | Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable. — e.g. `1` |

### Useful optional inputs

- `dry_run`: Read a free estimate before fetching sources or scheduling paid work. Zero credits; cache status and availability are snapshots rather than guarantees.

**Cost:** 2 credits at list price per successful uncached response; variable-cost operations may quote or settle a different charge. Confirmed uncharged or refunded failures report zero. Pending reconciliation can report credits_used:null; retain request_id and the original idempotency key.

```bash
curl "https://www.monocrawl.com/v1/facebook/event?id=1234567890123456" \
  -H "x-api-key: mn_your_key_here"
```

### Response data

Illustrative abbreviated data; documented core fields are optional and may be null. Additional source fields are allowed.

```json
{
  "attendance_count": 0,
  "cover_url": "https://example.com/example",
  "creator": {
    "id": "example",
    "name": "example",
    "type": "example"
  },
  "description": "example",
  "hosts": [
    {
      "id": "example",
      "name": "example",
      "type": "example",
      "url": "https://example.com/example",
      "verified": false
    }
  ],
  "id": "example",
  "is_canceled": false,
  "is_online": false,
  "is_past": false,
  "kind": "example",
  "location": {
    "address": "example",
    "city": "example",
    "latitude": 0,
    "longitude": 0,
    "name": "example"
  },
  "name": "example",
  "platform": "example",
  "privacy": "example",
  "starts_at": "2026-09-01T12:00:00Z",
  "url": "https://example.com/example",
  "when_text": "example"
}
```

[Field reference](https://www.monocrawl.com/docs/endpoints/facebook/event#response) · [JSON Schema for response.data](https://www.monocrawl.com/schemas/facebook/event.json)


## facebook/events

`GET /v1/facebook/events`

The events a page has published, one page at a time: name, when, where, kind and whether it is online, past or cancelled.

*Facebook page events*

| Parameter | Required | Description |
| --- | --- | --- |
| `url` | yes | Page URL — e.g. `https://www.facebook.com/nasa` |
| `cursor` | no | Opaque cursor from the previous page |
| `dry_run` | no | Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable. — e.g. `1` |

### Useful optional inputs

- `cursor`: Continue the same source traversal with the complete returned cursor. Saved-result retrieval and a new source page can have different prices; quote the next call.
- `dry_run`: Read a free estimate before fetching sources or scheduling paid work. Zero credits; cache status and availability are snapshots rather than guarantees.

**Cost:** 2 credits at list price per successful uncached response; variable-cost operations may quote or settle a different charge. Confirmed uncharged or refunded failures report zero. Pending reconciliation can report credits_used:null; retain request_id and the original idempotency key.

```bash
curl "https://www.monocrawl.com/v1/facebook/events?url=https%3A%2F%2Fwww.facebook.com%2Fnasa" \
  -H "x-api-key: mn_your_key_here"
```

### Response data

Illustrative abbreviated data; documented core fields are optional and may be null. Additional source fields are allowed.

```json
{
  "_meta": {
    "billing": {
      "charged": 0,
      "list_price": 0,
      "reason": "example"
    }
  },
  "cursor": null,
  "dropped": 0,
  "items": []
}
```

[Field reference](https://www.monocrawl.com/docs/endpoints/facebook/events#response) · [JSON Schema for response.data](https://www.monocrawl.com/schemas/facebook/events.json)


## facebook/events-search

`GET /v1/facebook/events-search`

Public events matching a query, one page at a time. A search result carries the event id, name and link; this source lists no timing, place or flags, so those fields are null here. Read one event in full (timing, location, hosts, attendance) with facebook/event.

*Facebook event search*

| Parameter | Required | Description |
| --- | --- | --- |
| `query` | yes | Search query — e.g. `astronomy night` |
| `cursor` | no | Opaque cursor from the previous page |
| `dry_run` | no | Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable. — e.g. `1` |
| `judgments` | no | Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Accepted values: on, off. Case, spaces, hyphens and underscores are interchangeable. — e.g. `on` |
| `label` | no | Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Accepted values: default, none. Case, spaces, hyphens and underscores are interchangeable. — e.g. `none` |
| `label_evidence` | no | Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable. — e.g. `1` |
| `exclude` | no | Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Accepted values: engagement_bait. Case, spaces, hyphens and underscores are interchangeable. — e.g. `engagement_bait` |
| `fit` | no | Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Accepted values: goal. Case, spaces, hyphens and underscores are interchangeable. — e.g. `goal` |
| `goal` | no | Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. — e.g. `Find concrete product complaints` |
| `tokens` | no | Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. — e.g. `4000` |

### Useful optional inputs

- `fit`: Use fit=goal with a task description to replace confidently irrelevant records with recall stubs and reduce agent context. No fit surcharge; full evidence is retained for 24 hours when stored, and the response size target is soft.
- `cursor`: Continue the same source traversal with the complete returned cursor. Saved-result retrieval and a new source page can have different prices; quote the next call.
- `dry_run`: Read a free estimate before fetching sources or scheduling paid work. Zero credits; cache status and availability are snapshots rather than guarantees.

**Cost:** 2 credits at list price per successful uncached response; variable-cost operations may quote or settle a different charge. Confirmed uncharged or refunded failures report zero. Pending reconciliation can report credits_used:null; retain request_id and the original idempotency key.

```bash
curl "https://www.monocrawl.com/v1/facebook/events-search?query=astronomy%20night" \
  -H "x-api-key: mn_your_key_here"
```

### Response data

Illustrative abbreviated data; documented core fields are optional and may be null. Additional source fields are allowed.

```json
{
  "count": 0,
  "cursor": null,
  "dropped": 0,
  "has_more": false,
  "items": [
    {
      "id": "example",
      "name": "example",
      "platform": "example",
      "url": "https://example.com/example"
    }
  ],
  "query": "example"
}
```

[Field reference](https://www.monocrawl.com/docs/endpoints/facebook/events-search#response) · [JSON Schema for response.data](https://www.monocrawl.com/schemas/facebook/events-search.json)


## facebook/group

`GET /v1/facebook/group`

A public Facebook group: name, member count and description.

*Group details*

| Parameter | Required | Description |
| --- | --- | --- |
| `url` | yes | Facebook group URL. — e.g. `https://www.facebook.com/groups/366190054572553/` |
| `dry_run` | no | Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable. — e.g. `1` |

### Useful optional inputs

- `dry_run`: Read a free estimate before fetching sources or scheduling paid work. Zero credits; cache status and availability are snapshots rather than guarantees.

**Cost:** 2 credits at list price per successful uncached response; variable-cost operations may quote or settle a different charge. Confirmed uncharged or refunded failures report zero. Pending reconciliation can report credits_used:null; retain request_id and the original idempotency key.

```bash
curl "https://www.monocrawl.com/v1/facebook/group?url=https%3A%2F%2Fwww.facebook.com%2Fgroups%2F366190054572553%2F" \
  -H "x-api-key: mn_your_key_here"
```

### Response data

Illustrative abbreviated data; documented core fields are optional and may be null. Additional source fields are allowed.

```json
{
  "activity": {
    "new_members_text": "example",
    "posts_last_day": 0,
    "posts_last_month": 0
  },
  "administrator_count": 0,
  "administrators": [
    {
      "avatar_url": "https://example.com/example",
      "id": "example",
      "name": "example",
      "url": "https://example.com/example"
    }
  ],
  "categories": [],
  "created_at": "2026-09-01T12:00:00Z",
  "description": "example",
  "history_summary": "example",
  "id": "example",
  "members": 0,
  "moderator_count": 0,
  "moderators": [
    {
      "avatar_url": "https://example.com/example",
      "id": "example",
      "name": "example",
      "url": "https://example.com/example"
    }
  ],
  "name": "example",
  "platform": "example",
  "privacy": "example",
  "privacy_description": "example",
  "rules": [],
  "url": "https://example.com/example",
  "visibility": "example"
}
```

[Field reference](https://www.monocrawl.com/docs/endpoints/facebook/group#response) · [JSON Schema for response.data](https://www.monocrawl.com/schemas/facebook/group.json)


## facebook/group-posts

`GET /v1/facebook/group-posts`

Recent posts in a public Facebook group with reaction and comment counts. Paged by cursor.

*Group posts*

| Parameter | Required | Description |
| --- | --- | --- |
| `url` | yes | Facebook group URL. — e.g. `https://www.facebook.com/groups/366190054572553/` |
| `cursor` | no | Opaque cursor from the previous page. |
| `sort_by` | no | CHRONOLOGICAL or TOP_POSTS. Accepted values: CHRONOLOGICAL, TOP_POSTS. Case, spaces, hyphens and underscores are interchangeable. |
| `dry_run` | no | Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable. — e.g. `1` |
| `judgments` | no | Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Accepted values: on, off. Case, spaces, hyphens and underscores are interchangeable. — e.g. `on` |
| `label` | no | Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Accepted values: default, none. Case, spaces, hyphens and underscores are interchangeable. — e.g. `none` |
| `label_evidence` | no | Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable. — e.g. `1` |
| `exclude` | no | Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Accepted values: engagement_bait. Case, spaces, hyphens and underscores are interchangeable. — e.g. `engagement_bait` |
| `fit` | no | Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Accepted values: goal. Case, spaces, hyphens and underscores are interchangeable. — e.g. `goal` |
| `goal` | no | Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. — e.g. `Find concrete product complaints` |
| `tokens` | no | Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. — e.g. `4000` |

### Useful optional inputs

- `fit`: Use fit=goal with a task description to replace confidently irrelevant records with recall stubs and reduce agent context. No fit surcharge; full evidence is retained for 24 hours when stored, and the response size target is soft.
- `cursor`: Continue the same source traversal with the complete returned cursor. Saved-result retrieval and a new source page can have different prices; quote the next call.
- `dry_run`: Read a free estimate before fetching sources or scheduling paid work. Zero credits; cache status and availability are snapshots rather than guarantees.

**Cost:** 2 credits at list price per successful uncached response; variable-cost operations may quote or settle a different charge. Confirmed uncharged or refunded failures report zero. Pending reconciliation can report credits_used:null; retain request_id and the original idempotency key.

```bash
curl "https://www.monocrawl.com/v1/facebook/group-posts?url=https%3A%2F%2Fwww.facebook.com%2Fgroups%2F366190054572553%2F" \
  -H "x-api-key: mn_your_key_here"
```

### Response data

Illustrative abbreviated data; documented core fields are optional and may be null. Additional source fields are allowed.

```json
{
  "cursor": null,
  "dropped": 0,
  "items": [
    {
      "author": {
        "id": "example",
        "name": "example"
      },
      "created_at": "2026-09-01T12:00:00Z",
      "id": "example",
      "image": "https://example.com/example",
      "images": [],
      "media_urls": [
        "example"
      ],
      "platform": "example",
      "stats": {
        "comments": 0,
        "reactions": 0
      },
      "text": "example",
      "thumbnail_url": "https://example.com/example",
      "url": "https://example.com/example",
      "video": {},
      "video_urls": []
    }
  ]
}
```

[Field reference](https://www.monocrawl.com/docs/endpoints/facebook/group-posts#response) · [JSON Schema for response.data](https://www.monocrawl.com/schemas/facebook/group-posts.json)


## facebook/marketplace-item

`GET /v1/facebook/marketplace-item`

One Marketplace listing in full: description, photos, attributes, availability and price as displayed. Fields the seller did not publish stay null.

*Marketplace item*

| Parameter | Required | Description |
| --- | --- | --- |
| `id` | yes | Listing id from facebook/marketplace-search (or pass url). — e.g. `28157874247229481` |
| `url` | no | Full marketplace item URL — alternative to id. |
| `dry_run` | no | Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable. — e.g. `1` |

### Useful optional inputs

- `dry_run`: Read a free estimate before fetching sources or scheduling paid work. Zero credits; cache status and availability are snapshots rather than guarantees.

**Cost:** 2 credits at list price per successful uncached response; variable-cost operations may quote or settle a different charge. Confirmed uncharged or refunded failures report zero. Pending reconciliation can report credits_used:null; retain request_id and the original idempotency key.

```bash
curl "https://www.monocrawl.com/v1/facebook/marketplace-item?id=28157874247229481" \
  -H "x-api-key: mn_your_key_here"
```

### Response data

Illustrative abbreviated data; documented core fields are optional and may be null. Additional source fields are allowed.

```json
{
  "attributes": [],
  "category_id": "example",
  "delivery_types": [],
  "description": "example",
  "id": "example",
  "photos": [
    "example"
  ],
  "platform": "example",
  "price": {
    "formatted": "example"
  },
  "title": "example",
  "url": "https://example.com/example"
}
```

[Field reference](https://www.monocrawl.com/docs/endpoints/facebook/marketplace-item#response) · [JSON Schema for response.data](https://www.monocrawl.com/schemas/facebook/marketplace-item.json)


## facebook/marketplace-locations

`GET /v1/facebook/marketplace-locations`

Resolve a place name to Marketplace-usable coordinates. Returns candidate locations with lat/lng — pick the right one before searching.

*Marketplace locations*

| Parameter | Required | Description |
| --- | --- | --- |
| `query` | yes | City or place name to resolve. — e.g. `Austin` |
| `dry_run` | no | Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable. — e.g. `1` |

### Useful optional inputs

- `dry_run`: Read a free estimate before fetching sources or scheduling paid work. Zero credits; cache status and availability are snapshots rather than guarantees.

**Cost:** 2 credits at list price per successful uncached response; variable-cost operations may quote or settle a different charge. Confirmed uncharged or refunded failures report zero. Pending reconciliation can report credits_used:null; retain request_id and the original idempotency key.

```bash
curl "https://www.monocrawl.com/v1/facebook/marketplace-locations?query=Austin" \
  -H "x-api-key: mn_your_key_here"
```

### Response data

Illustrative abbreviated data; documented core fields are optional and may be null. Additional source fields are allowed.

```json
{
  "items": [
    {
      "lat": 0,
      "lng": 0,
      "name": "example"
    }
  ]
}
```

[Field reference](https://www.monocrawl.com/docs/endpoints/facebook/marketplace-locations#response) · [JSON Schema for response.data](https://www.monocrawl.com/schemas/facebook/marketplace-locations.json)


## facebook/marketplace-search

`GET /v1/facebook/marketplace-search`

Search Facebook Marketplace listings around a point: title, price, image and listing URL. Paged by cursor.

*Marketplace search*

| Parameter | Required | Description |
| --- | --- | --- |
| `query` | yes | What to search for. — e.g. `bike` |
| `lat` | yes | Latitude from facebook/marketplace-locations. — e.g. `30.2672` |
| `lng` | yes | Longitude from facebook/marketplace-locations. — e.g. `-97.7431` |
| `radius_km` | no | Search radius in km. |
| `min_price` | no | Minimum price. |
| `max_price` | no | Maximum price. |
| `sort_by` | no | e.g. creation_time_descend. Accepted values: suggested, distance_ascend, creation_time_descend, price_ascend, price_descend. Case, spaces, hyphens and underscores are interchangeable. |
| `condition` | no | e.g. used_good. Accepted values: new, used_like_new, used_good, used_fair. Case, spaces, hyphens and underscores are interchangeable. |
| `date_listed` | no | Listed within N days. Accepted values: all, 1, 7, 30, last_24_hours, last_7_days, last_30_days. Case, spaces, hyphens and underscores are interchangeable. |
| `availability` | no | e.g. available. Accepted values: available, sold, all. Case, spaces, hyphens and underscores are interchangeable. |
| `delivery_method` | no | e.g. local_pickup. Accepted values: all, local_pickup, shipping. Case, spaces, hyphens and underscores are interchangeable. |
| `cursor` | no | Opaque cursor from the previous page. |
| `dry_run` | no | Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable. — e.g. `1` |
| `judgments` | no | Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Accepted values: on, off. Case, spaces, hyphens and underscores are interchangeable. — e.g. `on` |
| `label` | no | Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Accepted values: default, none. Case, spaces, hyphens and underscores are interchangeable. — e.g. `none` |
| `label_evidence` | no | Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable. — e.g. `1` |
| `exclude` | no | Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Accepted values: engagement_bait. Case, spaces, hyphens and underscores are interchangeable. — e.g. `engagement_bait` |
| `fit` | no | Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Accepted values: goal. Case, spaces, hyphens and underscores are interchangeable. — e.g. `goal` |
| `goal` | no | Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. — e.g. `Find concrete product complaints` |
| `tokens` | no | Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. — e.g. `4000` |

### Useful optional inputs

- `fit`: Use fit=goal with a task description to replace confidently irrelevant records with recall stubs and reduce agent context. No fit surcharge; full evidence is retained for 24 hours when stored, and the response size target is soft.
- `cursor`: Continue the same source traversal with the complete returned cursor. Saved-result retrieval and a new source page can have different prices; quote the next call.
- `dry_run`: Read a free estimate before fetching sources or scheduling paid work. Zero credits; cache status and availability are snapshots rather than guarantees.

**Cost:** 2 credits at list price per successful uncached response; variable-cost operations may quote or settle a different charge. Confirmed uncharged or refunded failures report zero. Pending reconciliation can report credits_used:null; retain request_id and the original idempotency key.

```bash
curl "https://www.monocrawl.com/v1/facebook/marketplace-search?query=bike&lat=30.2672&lng=-97.7431" \
  -H "x-api-key: mn_your_key_here"
```

### Response data

Illustrative abbreviated data; documented core fields are optional and may be null. Additional source fields are allowed.

```json
{
  "cursor": null,
  "dropped": 0,
  "items": [
    {
      "category_id": "example",
      "delivery_types": [
        "example"
      ],
      "id": "example",
      "image": "https://example.com/example",
      "is_live": false,
      "is_pending": false,
      "is_sold": false,
      "location": "example",
      "platform": "example",
      "price": {
        "amount": 0,
        "formatted": "example"
      },
      "title": "example",
      "url": "https://example.com/example"
    }
  ]
}
```

[Field reference](https://www.monocrawl.com/docs/endpoints/facebook/marketplace-search#response) · [JSON Schema for response.data](https://www.monocrawl.com/schemas/facebook/marketplace-search.json)


## facebook/photos

`GET /v1/facebook/photos`

A profile's photos with captions and reaction counts. Paged by cursor.

*Profile photos*

| Parameter | Required | Description |
| --- | --- | --- |
| `url` | yes | Facebook profile or page URL, or its username; not a display name. HTTP links are upgraded to HTTPS. Example: https://www.facebook.com/nasa. — e.g. `https://www.facebook.com/NASA` |
| `cursor` | no | Opaque cursor from the previous page. |
| `dry_run` | no | Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable. — e.g. `1` |

### Useful optional inputs

- `cursor`: Continue the same source traversal with the complete returned cursor. Saved-result retrieval and a new source page can have different prices; quote the next call.
- `dry_run`: Read a free estimate before fetching sources or scheduling paid work. Zero credits; cache status and availability are snapshots rather than guarantees.

**Cost:** 2 credits at list price per successful uncached response; variable-cost operations may quote or settle a different charge. Confirmed uncharged or refunded failures report zero. Pending reconciliation can report credits_used:null; retain request_id and the original idempotency key.

```bash
curl "https://www.monocrawl.com/v1/facebook/photos?url=https%3A%2F%2Fwww.facebook.com%2FNASA" \
  -H "x-api-key: mn_your_key_here"
```

### Response data

Illustrative abbreviated data; documented core fields are optional and may be null. Additional source fields are allowed.

```json
{
  "cursor": null,
  "dropped": 0,
  "items": [
    {
      "id": "example",
      "platform": "example",
      "url": "https://example.com/example"
    }
  ]
}
```

[Field reference](https://www.monocrawl.com/docs/endpoints/facebook/photos#response) · [JSON Schema for response.data](https://www.monocrawl.com/schemas/facebook/photos.json)


## facebook/post

`GET /v1/facebook/post`

One Facebook post: text, reaction breakdown, comment and share counts.

*Post details*

| Parameter | Required | Description |
| --- | --- | --- |
| `url` | yes | Full Facebook post URL. — e.g. `https://www.facebook.com/reel/2839681326387786/` |
| `dry_run` | no | Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable. — e.g. `1` |
| `judgments` | no | Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Accepted values: on, off. Case, spaces, hyphens and underscores are interchangeable. — e.g. `on` |
| `label` | no | Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Accepted values: default, none. Case, spaces, hyphens and underscores are interchangeable. — e.g. `none` |
| `label_evidence` | no | Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable. — e.g. `1` |
| `exclude` | no | Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Accepted values: engagement_bait. Case, spaces, hyphens and underscores are interchangeable. — e.g. `engagement_bait` |
| `fit` | no | Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Accepted values: goal. Case, spaces, hyphens and underscores are interchangeable. — e.g. `goal` |
| `goal` | no | Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. — e.g. `Find concrete product complaints` |
| `tokens` | no | Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. — e.g. `4000` |

### Useful optional inputs

- `fit`: Use fit=goal with a task description to replace confidently irrelevant records with recall stubs and reduce agent context. No fit surcharge; full evidence is retained for 24 hours when stored, and the response size target is soft.
- `dry_run`: Read a free estimate before fetching sources or scheduling paid work. Zero credits; cache status and availability are snapshots rather than guarantees.

**Cost:** 2 credits at list price per successful uncached response; variable-cost operations may quote or settle a different charge. Confirmed uncharged or refunded failures report zero. Pending reconciliation can report credits_used:null; retain request_id and the original idempotency key.

```bash
curl "https://www.monocrawl.com/v1/facebook/post?url=https%3A%2F%2Fwww.facebook.com%2Freel%2F2839681326387786%2F" \
  -H "x-api-key: mn_your_key_here"
```

### Response data

Illustrative abbreviated data; documented core fields are optional and may be null. Additional source fields are allowed.

```json
{
  "id": "1234567890124",
  "text": "Illustrative post",
  "stats": {
    "likes": 3,
    "comments": 2
  }
}
```

[Field reference](https://www.monocrawl.com/docs/endpoints/facebook/post#response) · [JSON Schema for response.data](https://www.monocrawl.com/schemas/facebook/post.json)


## facebook/post-comments

`GET /v1/facebook/post-comments`

Comments on a Facebook post with reaction and reply counts. Paged by cursor.

*Post comments*

| Parameter | Required | Description |
| --- | --- | --- |
| `url` | yes | Full Facebook post URL. — e.g. `https://www.facebook.com/reel/2839681326387786/` |
| `cursor` | no | Opaque cursor from the previous page. |
| `dry_run` | no | Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable. — e.g. `1` |
| `judgments` | no | Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Accepted values: on, off. Case, spaces, hyphens and underscores are interchangeable. — e.g. `on` |
| `label` | no | Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Accepted values: default, none. Case, spaces, hyphens and underscores are interchangeable. — e.g. `none` |
| `label_evidence` | no | Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable. — e.g. `1` |
| `exclude` | no | Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Accepted values: engagement_bait. Case, spaces, hyphens and underscores are interchangeable. — e.g. `engagement_bait` |
| `fit` | no | Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Accepted values: goal. Case, spaces, hyphens and underscores are interchangeable. — e.g. `goal` |
| `goal` | no | Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. — e.g. `Find concrete product complaints` |
| `tokens` | no | Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. — e.g. `4000` |

### Useful optional inputs

- `fit`: Use fit=goal with a task description to replace confidently irrelevant records with recall stubs and reduce agent context. No fit surcharge; full evidence is retained for 24 hours when stored, and the response size target is soft.
- `cursor`: Continue the same source traversal with the complete returned cursor. Saved-result retrieval and a new source page can have different prices; quote the next call.
- `dry_run`: Read a free estimate before fetching sources or scheduling paid work. Zero credits; cache status and availability are snapshots rather than guarantees.

**Cost:** 2 credits at list price per successful uncached response; variable-cost operations may quote or settle a different charge. Confirmed uncharged or refunded failures report zero. Pending reconciliation can report credits_used:null; retain request_id and the original idempotency key.

```bash
curl "https://www.monocrawl.com/v1/facebook/post-comments?url=https%3A%2F%2Fwww.facebook.com%2Freel%2F2839681326387786%2F" \
  -H "x-api-key: mn_your_key_here"
```

### Response data

Illustrative abbreviated data; documented core fields are optional and may be null. Additional source fields are allowed.

```json
{
  "items": [
    {
      "id": "1234567890125",
      "text": "Illustrative comment",
      "reply_count": 1,
      "feedback_id": "example-feedback",
      "expansion_token": "example-token"
    }
  ],
  "cursor": null,
  "has_more": null
}
```

[Field reference](https://www.monocrawl.com/docs/endpoints/facebook/post-comments#response) · [JSON Schema for response.data](https://www.monocrawl.com/schemas/facebook/post-comments.json)


## facebook/post-transcript

`GET /v1/facebook/post-transcript`

The spoken words of a Facebook video or reel as text. transcript is null when the video has no speech or captions — that is the honest answer, not an error.

*Video transcript*

| Parameter | Required | Description |
| --- | --- | --- |
| `url` | yes | Facebook video post or reel URL, video under ~2 minutes. — e.g. `https://www.facebook.com/reel/1114235920664408` |
| `dry_run` | no | Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable. — e.g. `1` |

### Useful optional inputs

- `dry_run`: Read a free estimate before fetching sources or scheduling paid work. Zero credits; cache status and availability are snapshots rather than guarantees.

**Cost:** 5 credits at list price per successful uncached response; variable-cost operations may quote or settle a different charge. Confirmed uncharged or refunded failures report zero. Pending reconciliation can report credits_used:null; retain request_id and the original idempotency key.

```bash
curl "https://www.monocrawl.com/v1/facebook/post-transcript?url=https%3A%2F%2Fwww.facebook.com%2Freel%2F1114235920664408" \
  -H "x-api-key: mn_your_key_here"
```

### Response data

Illustrative abbreviated data; documented core fields are optional and may be null. Additional source fields are allowed.

```json
{
  "has_transcript": false,
  "id": "example",
  "platform": "example",
  "transcript": "example",
  "url": "https://example.com/example"
}
```

[Field reference](https://www.monocrawl.com/docs/endpoints/facebook/post-transcript#response) · [JSON Schema for response.data](https://www.monocrawl.com/schemas/facebook/post-transcript.json)


## facebook/posts

`GET /v1/facebook/posts`

Recent posts on a Facebook page with reaction and comment counts. Paged by cursor.

*Page posts*

| Parameter | Required | Description |
| --- | --- | --- |
| `url` | yes | Facebook page URL. — e.g. `https://www.facebook.com/nasa` |
| `cursor` | no | Opaque cursor from the previous page. |
| `dry_run` | no | Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable. — e.g. `1` |
| `judgments` | no | Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Accepted values: on, off. Case, spaces, hyphens and underscores are interchangeable. — e.g. `on` |
| `label` | no | Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Accepted values: default, none. Case, spaces, hyphens and underscores are interchangeable. — e.g. `none` |
| `label_evidence` | no | Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable. — e.g. `1` |
| `exclude` | no | Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Accepted values: engagement_bait. Case, spaces, hyphens and underscores are interchangeable. — e.g. `engagement_bait` |
| `fit` | no | Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Accepted values: goal. Case, spaces, hyphens and underscores are interchangeable. — e.g. `goal` |
| `goal` | no | Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. — e.g. `Find concrete product complaints` |
| `tokens` | no | Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. — e.g. `4000` |

### Useful optional inputs

- `fit`: Use fit=goal with a task description to replace confidently irrelevant records with recall stubs and reduce agent context. No fit surcharge; full evidence is retained for 24 hours when stored, and the response size target is soft.
- `cursor`: Continue the same source traversal with the complete returned cursor. Saved-result retrieval and a new source page can have different prices; quote the next call.
- `dry_run`: Read a free estimate before fetching sources or scheduling paid work. Zero credits; cache status and availability are snapshots rather than guarantees.

**Cost:** 2 credits at list price per successful uncached response; variable-cost operations may quote or settle a different charge. Confirmed uncharged or refunded failures report zero. Pending reconciliation can report credits_used:null; retain request_id and the original idempotency key.

```bash
curl "https://www.monocrawl.com/v1/facebook/posts?url=https%3A%2F%2Fwww.facebook.com%2Fnasa" \
  -H "x-api-key: mn_your_key_here"
```

### Response data

Illustrative abbreviated data; documented core fields are optional and may be null. Additional source fields are allowed.

```json
{
  "items": [
    {
      "id": "1234567890124",
      "text": "Illustrative feed post",
      "stats": {
        "reactions": 3,
        "comments": 2
      },
      "images": []
    }
  ],
  "cursor": null,
  "has_more": null
}
```

[Field reference](https://www.monocrawl.com/docs/endpoints/facebook/posts#response) · [JSON Schema for response.data](https://www.monocrawl.com/schemas/facebook/posts.json)


## facebook/profile

`GET /v1/facebook/profile`

A Facebook page's public profile: category, contact details, follower and like counts.

*Page profile*

| Parameter | Required | Description |
| --- | --- | --- |
| `url` | yes | Facebook profile or page URL, or its username; not a display name. HTTP links are upgraded to HTTPS. Example: https://www.facebook.com/nasa. — e.g. `https://www.facebook.com/nasa` |
| `dry_run` | no | Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable. — e.g. `1` |
| `judgments` | no | Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Accepted values: on, off. Case, spaces, hyphens and underscores are interchangeable. — e.g. `on` |
| `label` | no | Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Accepted values: default, none. Case, spaces, hyphens and underscores are interchangeable. — e.g. `none` |
| `label_evidence` | no | Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable. — e.g. `1` |
| `exclude` | no | Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Accepted values: engagement_bait. Case, spaces, hyphens and underscores are interchangeable. — e.g. `engagement_bait` |
| `fit` | no | Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Accepted values: goal. Case, spaces, hyphens and underscores are interchangeable. — e.g. `goal` |
| `goal` | no | Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. — e.g. `Find concrete product complaints` |
| `tokens` | no | Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. — e.g. `4000` |

### Useful optional inputs

- `fit`: Use fit=goal with a task description to replace confidently irrelevant records with recall stubs and reduce agent context. No fit surcharge; full evidence is retained for 24 hours when stored, and the response size target is soft.
- `dry_run`: Read a free estimate before fetching sources or scheduling paid work. Zero credits; cache status and availability are snapshots rather than guarantees.

**Cost:** 2 credits at list price per successful uncached response; variable-cost operations may quote or settle a different charge. Confirmed uncharged or refunded failures report zero. Pending reconciliation can report credits_used:null; retain request_id and the original idempotency key.

```bash
curl "https://www.monocrawl.com/v1/facebook/profile?url=https%3A%2F%2Fwww.facebook.com%2Fnasa" \
  -H "x-api-key: mn_your_key_here"
```

### Response data

Illustrative abbreviated data; documented core fields are optional and may be null. Additional source fields are allowed.

```json
{
  "id": "1234567890123",
  "name": "Example Page",
  "followers": 1200,
  "likes_count": 1000
}
```

[Field reference](https://www.monocrawl.com/docs/endpoints/facebook/profile#response) · [JSON Schema for response.data](https://www.monocrawl.com/schemas/facebook/profile.json)


## facebook/profile/full

`GET /v1/facebook/profile/full`

A real public profile plus one page of posts/videos, preserving original normalized component fields and source order. HTTP 200 may be partial: inspect complete, partial and legs. Failed profile: no posts requested, zero charge. Failed posts: profile retained and only that successful component charged. Cached components use the public cache-hit price. Computed fields summarize the returned page, including available engagement averages and observed posting frequency. Missing metrics remain unknown.

*Facebook profile with posts (one page)*

| Parameter | Required | Description |
| --- | --- | --- |
| `url` | yes | Public profile identifier. LinkedIn accepts /company/name or /in/name URLs. — e.g. `https://www.facebook.com/mrbeast` |
| `posts` | no | Desired page size, 1-100. Existing components choose their own page size; the entire single source page is preserved, even if longer or shorter, so no records are skipped between cursors. No automatic extra pages. — e.g. `25` |
| `cursor` | no | Opaque posts_cursor from the previous response; use posts_pagination.next_params to retain all required context. Unsupported component continuation is refused before calls. |
| `include` | no | CSV: posts and/or computed (default both), or profile alone. Profile is always returned. Computed is arithmetic over this page only, not an AI summary. — e.g. `posts,computed` |
| `dry_run` | no | Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable. — e.g. `1` |
| `judgments` | no | Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Accepted values: on, off. Case, spaces, hyphens and underscores are interchangeable. — e.g. `on` |
| `label` | no | Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Accepted values: default, none. Case, spaces, hyphens and underscores are interchangeable. — e.g. `none` |
| `label_evidence` | no | Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable. — e.g. `1` |
| `exclude` | no | Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Accepted values: engagement_bait. Case, spaces, hyphens and underscores are interchangeable. — e.g. `engagement_bait` |
| `fit` | no | Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Accepted values: goal. Case, spaces, hyphens and underscores are interchangeable. — e.g. `goal` |
| `goal` | no | Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. — e.g. `Find concrete product complaints` |
| `tokens` | no | Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. — e.g. `4000` |

### Useful optional inputs

- `fit`: Use fit=goal with a task description to replace confidently irrelevant records with recall stubs and reduce agent context. No fit surcharge; full evidence is retained for 24 hours when stored, and the response size target is soft.
- `cursor`: Continue the same source traversal with the complete returned cursor. Saved-result retrieval and a new source page can have different prices; quote the next call.
- `dry_run`: Read a free estimate before fetching sources or scheduling paid work. Zero credits; cache status and availability are snapshots rather than guarantees.

**Cost:** 47 credits at list price per successful uncached response; variable-cost operations may quote or settle a different charge. Confirmed uncharged or refunded failures report zero. Pending reconciliation can report credits_used:null; retain request_id and the original idempotency key.

```bash
curl "https://www.monocrawl.com/v1/facebook/profile/full?url=https%3A%2F%2Fwww.facebook.com%2Fmrbeast" \
  -H "x-api-key: mn_your_key_here"
```

### Response data

Illustrative abbreviated data; documented core fields are optional and may be null. Additional source fields are allowed.

```json
{
  "_meta": {
    "billing": {
      "charged": 0,
      "components": [
        {}
      ],
      "formula": "example",
      "list_price": 0,
      "maximum_component_credits": 0
    }
  },
  "_warnings": [
    "example"
  ],
  "complete": false,
  "identity_kind": "example",
  "legs": [
    {
      "attempts": 0,
      "component": "example",
      "credits": 0,
      "endpoint": "example",
      "error": "example",
      "ok": false,
      "served_by": "example",
      "status": 0
    }
  ],
  "partial": false,
  "platform": "example",
  "posts_pagination": {
    "page_size_control": "example",
    "requested": 0
  },
  "profile": {
    "_warnings": [
      "example"
    ],
    "avatar_url": "https://example.com/example",
    "bio": "example",
    "business_page_active": false,
    "category": "example",
    "cover_url": "https://example.com/example",
    "created_at": "2026-09-01T12:00:00Z",
    "created_text": "example",
    "followers": 0,
    "id": "example",
    "name": "example",
    "platform": "example",
    "talking_about": 0,
    "url": "https://example.com/example",
    "website": "example"
  },
  "scope": "example"
}
```

[Field reference](https://www.monocrawl.com/docs/endpoints/facebook/profile/full#response) · [JSON Schema for response.data](https://www.monocrawl.com/schemas/facebook/profile/full.json)


## facebook/reels

`GET /v1/facebook/reels`

A profile's reels: description, view count, duration, music and video URL per reel. Paged by cursor.

*Profile reels*

| Parameter | Required | Description |
| --- | --- | --- |
| `url` | yes | Facebook profile URL (personal profiles expose a reels tab; pages often do not). — e.g. `https://www.facebook.com/pacemorby` |
| `cursor` | no | Opaque cursor from the previous page. |
| `dry_run` | no | Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable. — e.g. `1` |
| `judgments` | no | Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Accepted values: on, off. Case, spaces, hyphens and underscores are interchangeable. — e.g. `on` |
| `label` | no | Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Accepted values: default, none. Case, spaces, hyphens and underscores are interchangeable. — e.g. `none` |
| `label_evidence` | no | Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable. — e.g. `1` |
| `exclude` | no | Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Accepted values: engagement_bait. Case, spaces, hyphens and underscores are interchangeable. — e.g. `engagement_bait` |
| `fit` | no | Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Accepted values: goal. Case, spaces, hyphens and underscores are interchangeable. — e.g. `goal` |
| `goal` | no | Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. — e.g. `Find concrete product complaints` |
| `tokens` | no | Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. — e.g. `4000` |

### Useful optional inputs

- `fit`: Use fit=goal with a task description to replace confidently irrelevant records with recall stubs and reduce agent context. No fit surcharge; full evidence is retained for 24 hours when stored, and the response size target is soft.
- `cursor`: Continue the same source traversal with the complete returned cursor. Saved-result retrieval and a new source page can have different prices; quote the next call.
- `dry_run`: Read a free estimate before fetching sources or scheduling paid work. Zero credits; cache status and availability are snapshots rather than guarantees.

**Cost:** 2 credits at list price per successful uncached response; variable-cost operations may quote or settle a different charge. Confirmed uncharged or refunded failures report zero. Pending reconciliation can report credits_used:null; retain request_id and the original idempotency key.

```bash
curl "https://www.monocrawl.com/v1/facebook/reels?url=https%3A%2F%2Fwww.facebook.com%2Fpacemorby" \
  -H "x-api-key: mn_your_key_here"
```

### Response data

Illustrative abbreviated data; documented core fields are optional and may be null. Additional source fields are allowed.

```json
{
  "count": 0,
  "cursor": null,
  "dropped": 0,
  "has_more": false,
  "items": [
    {
      "author": {
        "id": "example",
        "name": "example"
      },
      "description": "example",
      "duration_ms": 0,
      "feedback_id": "example",
      "id": "example",
      "platform": "example",
      "thumbnail": "example",
      "url": "https://example.com/example",
      "video_url": "https://example.com/example",
      "views": 0
    }
  ]
}
```

[Field reference](https://www.monocrawl.com/docs/endpoints/facebook/reels#response) · [JSON Schema for response.data](https://www.monocrawl.com/schemas/facebook/reels.json)


## facebook/reels/full

`GET /v1/facebook/reels/full`

Bounded automatic pagination through registered sources. Retains entire pages, removes duplicate IDs, returns stop_reason, complete and next_params. Up to five pages per request; not guaranteed full account history. Charges successful fresh component calls at max(5, underlying price), with normal lower cache-hit pricing.

*Collect facebook reels*

| Parameter | Required | Description |
| --- | --- | --- |
| `url` | yes | Public profile identifier. — e.g. `https://www.facebook.com/mrbeast` |
| `cursor` | no | Opaque continuation from the previous response. Preserve query or identity. |
| `max_pages` | no | Maximum source pages: 1-5, default 1. Catalog price reserves the five-page maximum; actual successful component charges are settled after execution. — e.g. `1` |
| `dry_run` | no | Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable. — e.g. `1` |
| `judgments` | no | Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Accepted values: on, off. Case, spaces, hyphens and underscores are interchangeable. — e.g. `on` |
| `label` | no | Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Accepted values: default, none. Case, spaces, hyphens and underscores are interchangeable. — e.g. `none` |
| `label_evidence` | no | Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable. — e.g. `1` |
| `exclude` | no | Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Accepted values: engagement_bait. Case, spaces, hyphens and underscores are interchangeable. — e.g. `engagement_bait` |
| `fit` | no | Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Accepted values: goal. Case, spaces, hyphens and underscores are interchangeable. — e.g. `goal` |
| `goal` | no | Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. — e.g. `Find concrete product complaints` |
| `tokens` | no | Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. — e.g. `4000` |

### Useful optional inputs

- `fit`: Use fit=goal with a task description to replace confidently irrelevant records with recall stubs and reduce agent context. No fit surcharge; full evidence is retained for 24 hours when stored, and the response size target is soft.
- `cursor`: Continue the same source traversal with the complete returned cursor. Saved-result retrieval and a new source page can have different prices; quote the next call.
- `dry_run`: Read a free estimate before fetching sources or scheduling paid work. Zero credits; cache status and availability are snapshots rather than guarantees.

**Cost:** 25 credits at list price per successful uncached response; variable-cost operations may quote or settle a different charge. Confirmed uncharged or refunded failures report zero. Pending reconciliation can report credits_used:null; retain request_id and the original idempotency key.

```bash
curl "https://www.monocrawl.com/v1/facebook/reels/full?url=https%3A%2F%2Fwww.facebook.com%2Fmrbeast" \
  -H "x-api-key: mn_your_key_here"
```

### Response data

Illustrative abbreviated data; documented core fields are optional and may be null. Additional source fields are allowed.

```json
{
  "_meta": {
    "billing": {
      "charged": 0,
      "list_price": 0,
      "maximum_component_credits": 0
    }
  },
  "_warnings": [
    "example"
  ],
  "complete": false,
  "count": 0,
  "cursor": null,
  "items": [
    {
      "author": {
        "id": "example",
        "name": "example"
      },
      "description": "example",
      "duration_ms": 0,
      "feedback_id": "example",
      "id": "example",
      "platform": "example",
      "thumbnail": "example",
      "url": "https://example.com/example",
      "video_url": "https://example.com/example",
      "views": 0
    }
  ],
  "legs": [
    {
      "attempts": 0,
      "credits": 0,
      "endpoint": "example",
      "ok": false,
      "served_by": "example",
      "status": 0
    }
  ],
  "next_params": {
    "cursor": null,
    "max_pages": 0,
    "url": "https://example.com/example"
  },
  "pages_fetched": 0,
  "partial": false,
  "platform": "example",
  "source_metadata": {
    "count": 0,
    "cursor": null,
    "has_more": false
  },
  "stop_reason": "example"
}
```

[Field reference](https://www.monocrawl.com/docs/endpoints/facebook/reels/full#response) · [JSON Schema for response.data](https://www.monocrawl.com/schemas/facebook/reels/full.json)


## facebook/search-pages

`GET /v1/facebook/search-pages`

One native search page with a continuation cursor. Source-defined page size. No time filtering. Video dates and counts reported only as text remain text; no guessed exact values.

*Search Facebook pages*

| Parameter | Required | Description |
| --- | --- | --- |
| `query` | yes | Search phrase; ranked platform search, not a strict local substring match. — e.g. `NASA` |
| `cursor` | no | Opaque continuation from the previous response. Preserve query or identity. |
| `dry_run` | no | Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable. — e.g. `1` |
| `judgments` | no | Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Accepted values: on, off. Case, spaces, hyphens and underscores are interchangeable. — e.g. `on` |
| `label` | no | Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Accepted values: default, none. Case, spaces, hyphens and underscores are interchangeable. — e.g. `none` |
| `label_evidence` | no | Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable. — e.g. `1` |
| `exclude` | no | Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Accepted values: engagement_bait. Case, spaces, hyphens and underscores are interchangeable. — e.g. `engagement_bait` |
| `fit` | no | Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Accepted values: goal. Case, spaces, hyphens and underscores are interchangeable. — e.g. `goal` |
| `goal` | no | Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. — e.g. `Find concrete product complaints` |
| `tokens` | no | Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. — e.g. `4000` |

### Useful optional inputs

- `fit`: Use fit=goal with a task description to replace confidently irrelevant records with recall stubs and reduce agent context. No fit surcharge; full evidence is retained for 24 hours when stored, and the response size target is soft.
- `cursor`: Continue the same source traversal with the complete returned cursor. Saved-result retrieval and a new source page can have different prices; quote the next call.
- `dry_run`: Read a free estimate before fetching sources or scheduling paid work. Zero credits; cache status and availability are snapshots rather than guarantees.

**Cost:** 12 credits at list price per successful uncached response; variable-cost operations may quote or settle a different charge. Confirmed uncharged or refunded failures report zero. Pending reconciliation can report credits_used:null; retain request_id and the original idempotency key.

```bash
curl "https://www.monocrawl.com/v1/facebook/search-pages?query=NASA" \
  -H "x-api-key: mn_your_key_here"
```

### Response data

Illustrative abbreviated data; documented core fields are optional and may be null. Additional source fields are allowed.

```json
{
  "_warnings": [
    "example"
  ],
  "count": 0,
  "cursor": null,
  "dropped": 0,
  "has_more": false,
  "items": [
    {
      "avatar_url": "https://example.com/example",
      "id": "example",
      "name": "example",
      "platform": "example",
      "type": "example",
      "url": "https://example.com/example",
      "verified": false
    }
  ],
  "query": "example"
}
```

[Field reference](https://www.monocrawl.com/docs/endpoints/facebook/search-pages#response) · [JSON Schema for response.data](https://www.monocrawl.com/schemas/facebook/search-pages.json)


## facebook/search-people

`GET /v1/facebook/search-people`

One native search page with a continuation cursor. Source-defined page size. No time filtering. Video dates and counts reported only as text remain text; no guessed exact values.

*Search Facebook people*

| Parameter | Required | Description |
| --- | --- | --- |
| `query` | yes | Search phrase; ranked platform search, not a strict local substring match. — e.g. `NASA` |
| `cursor` | no | Opaque continuation from the previous response. Preserve query or identity. |
| `dry_run` | no | Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable. — e.g. `1` |
| `judgments` | no | Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Accepted values: on, off. Case, spaces, hyphens and underscores are interchangeable. — e.g. `on` |
| `label` | no | Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Accepted values: default, none. Case, spaces, hyphens and underscores are interchangeable. — e.g. `none` |
| `label_evidence` | no | Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable. — e.g. `1` |
| `exclude` | no | Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Accepted values: engagement_bait. Case, spaces, hyphens and underscores are interchangeable. — e.g. `engagement_bait` |
| `fit` | no | Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Accepted values: goal. Case, spaces, hyphens and underscores are interchangeable. — e.g. `goal` |
| `goal` | no | Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. — e.g. `Find concrete product complaints` |
| `tokens` | no | Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. — e.g. `4000` |

### Useful optional inputs

- `fit`: Use fit=goal with a task description to replace confidently irrelevant records with recall stubs and reduce agent context. No fit surcharge; full evidence is retained for 24 hours when stored, and the response size target is soft.
- `cursor`: Continue the same source traversal with the complete returned cursor. Saved-result retrieval and a new source page can have different prices; quote the next call.
- `dry_run`: Read a free estimate before fetching sources or scheduling paid work. Zero credits; cache status and availability are snapshots rather than guarantees.

**Cost:** 12 credits at list price per successful uncached response; variable-cost operations may quote or settle a different charge. Confirmed uncharged or refunded failures report zero. Pending reconciliation can report credits_used:null; retain request_id and the original idempotency key.

```bash
curl "https://www.monocrawl.com/v1/facebook/search-people?query=NASA" \
  -H "x-api-key: mn_your_key_here"
```

### Response data

Illustrative abbreviated data; documented core fields are optional and may be null. Additional source fields are allowed.

```json
{
  "_warnings": [
    "example"
  ],
  "count": 0,
  "cursor": null,
  "dropped": 0,
  "has_more": false,
  "items": [
    {
      "avatar_url": "https://example.com/example",
      "id": "example",
      "name": "example",
      "platform": "example",
      "type": "example",
      "url": "https://example.com/example",
      "verified": false
    }
  ],
  "query": "example"
}
```

[Field reference](https://www.monocrawl.com/docs/endpoints/facebook/search-people#response) · [JSON Schema for response.data](https://www.monocrawl.com/schemas/facebook/search-people.json)


## facebook/search-posts

`GET /v1/facebook/search-posts`

One native search page with a continuation cursor. Source-defined page size. No time filtering. Video dates and counts reported only as text remain text; no guessed exact values.

*Search Facebook posts*

| Parameter | Required | Description |
| --- | --- | --- |
| `query` | yes | Search phrase; ranked platform search, not a strict local substring match. — e.g. `NASA` |
| `cursor` | no | Opaque continuation from the previous response. Preserve query or identity. |
| `dry_run` | no | Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable. — e.g. `1` |
| `judgments` | no | Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Accepted values: on, off. Case, spaces, hyphens and underscores are interchangeable. — e.g. `on` |
| `label` | no | Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Accepted values: default, none. Case, spaces, hyphens and underscores are interchangeable. — e.g. `none` |
| `label_evidence` | no | Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable. — e.g. `1` |
| `exclude` | no | Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Accepted values: engagement_bait. Case, spaces, hyphens and underscores are interchangeable. — e.g. `engagement_bait` |
| `fit` | no | Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Accepted values: goal. Case, spaces, hyphens and underscores are interchangeable. — e.g. `goal` |
| `goal` | no | Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. — e.g. `Find concrete product complaints` |
| `tokens` | no | Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. — e.g. `4000` |

### Useful optional inputs

- `fit`: Use fit=goal with a task description to replace confidently irrelevant records with recall stubs and reduce agent context. No fit surcharge; full evidence is retained for 24 hours when stored, and the response size target is soft.
- `cursor`: Continue the same source traversal with the complete returned cursor. Saved-result retrieval and a new source page can have different prices; quote the next call.
- `dry_run`: Read a free estimate before fetching sources or scheduling paid work. Zero credits; cache status and availability are snapshots rather than guarantees.

**Cost:** 12 credits at list price per successful uncached response; variable-cost operations may quote or settle a different charge. Confirmed uncharged or refunded failures report zero. Pending reconciliation can report credits_used:null; retain request_id and the original idempotency key.

```bash
curl "https://www.monocrawl.com/v1/facebook/search-posts?query=NASA" \
  -H "x-api-key: mn_your_key_here"
```

### Response data

Illustrative abbreviated data; documented core fields are optional and may be null. Additional source fields are allowed.

```json
{
  "_warnings": [
    "example"
  ],
  "count": 0,
  "cursor": null,
  "dropped": 0,
  "has_more": false,
  "items": [
    {
      "album": [],
      "author": {
        "id": "example",
        "name": "example",
        "url": "https://example.com/example"
      },
      "created_at": "2026-09-01T12:00:00Z",
      "id": "example",
      "images": [],
      "media_urls": [],
      "platform": "example",
      "reactions_count": 0,
      "stats": {
        "comments": 0,
        "likes": 0,
        "reactions": {},
        "shares": 0
      },
      "text": "example",
      "url": "https://example.com/example",
      "video_urls": []
    }
  ],
  "query": "example"
}
```

[Field reference](https://www.monocrawl.com/docs/endpoints/facebook/search-posts#response) · [JSON Schema for response.data](https://www.monocrawl.com/schemas/facebook/search-posts.json)


## facebook/search-videos

`GET /v1/facebook/search-videos`

One native search page with a continuation cursor. Source-defined page size. No time filtering. Video dates and counts reported only as text remain text; no guessed exact values.

*Search Facebook videos*

| Parameter | Required | Description |
| --- | --- | --- |
| `query` | yes | Search phrase; ranked platform search, not a strict local substring match. — e.g. `NASA` |
| `cursor` | no | Opaque continuation from the previous response. Preserve query or identity. |
| `dry_run` | no | Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable. — e.g. `1` |
| `judgments` | no | Add bounded AI labels to eligible returned records (default on). off preserves the original data shape. Unclassified records remain present; labels depend on evidence, time, capacity and the existing request budget. No label surcharge. Accepted values: on, off. Case, spaces, hyphens and underscores are interchangeable. — e.g. `on` |
| `label` | no | Set none to disable labels; default enables the endpoint’s label set. Equivalent to judgments=off. Accepted values: default, none. Case, spaces, hyphens and underscores are interchangeable. — e.g. `none` |
| `label_evidence` | no | Include exact supporting sentences and zero-based sentence indexes when a label has validated evidence. No extra charge or change to decisions. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable. — e.g. `1` |
| `exclude` | no | Optionally remove confidently labelled engagement bait. Uncertain and unclassified records stay; removed IDs and an owner-bound recall reference are returned. Accepted values: engagement_bait. Case, spaces, hyphens and underscores are interchangeable. — e.g. `engagement_bait` |
| `fit` | no | Use goal to replace confidently irrelevant records with recall stubs. Keeps first, last, relevant and uncertain records; preserves order. Full evidence is stored for 24 hours when available. Accepted values: goal. Case, spaces, hyphens and underscores are interchangeable. — e.g. `goal` |
| `goal` | no | Required with fit=goal: describe the task in at most 600 characters. Supplied text is task context, never permission to act on posts. — e.g. `Find concrete product complaints` |
| `tokens` | no | Optional soft response target for fit=goal, 256–32000. Safety and evidence retention take priority, so the returned result may exceed it. — e.g. `4000` |

### Useful optional inputs

- `fit`: Use fit=goal with a task description to replace confidently irrelevant records with recall stubs and reduce agent context. No fit surcharge; full evidence is retained for 24 hours when stored, and the response size target is soft.
- `cursor`: Continue the same source traversal with the complete returned cursor. Saved-result retrieval and a new source page can have different prices; quote the next call.
- `dry_run`: Read a free estimate before fetching sources or scheduling paid work. Zero credits; cache status and availability are snapshots rather than guarantees.

**Cost:** 12 credits at list price per successful uncached response; variable-cost operations may quote or settle a different charge. Confirmed uncharged or refunded failures report zero. Pending reconciliation can report credits_used:null; retain request_id and the original idempotency key.

```bash
curl "https://www.monocrawl.com/v1/facebook/search-videos?query=NASA" \
  -H "x-api-key: mn_your_key_here"
```

### Response data

Illustrative abbreviated data; documented core fields are optional and may be null. Additional source fields are allowed.

```json
{
  "_warnings": [
    "example"
  ],
  "count": 0,
  "cursor": null,
  "dropped": 0,
  "has_more": false,
  "items": [
    {
      "author": {
        "id": "example",
        "name": "example",
        "url": "https://example.com/example"
      },
      "id": "example",
      "platform": "example",
      "stats": {},
      "text": "example",
      "thumbnail_url": "https://example.com/example",
      "time_and_views_text": "example",
      "title": "example",
      "type": "example",
      "url": "https://example.com/example"
    }
  ],
  "query": "example"
}
```

[Field reference](https://www.monocrawl.com/docs/endpoints/facebook/search-videos#response) · [JSON Schema for response.data](https://www.monocrawl.com/schemas/facebook/search-videos.json)