# Get Reel

Fetches a public Facebook Reel with normalized title, views, likes, reactions, and comments.

- Platform: [Facebook](https://docs.upscrape.com/docs/platforms/facebook)
- Capability ID: `facebook.reel.get`
- Cost: 1 credit per request
- Maximum runtime: 30 seconds
- Execute endpoint: `POST https://data.upscrape.com/execute`

## Request

Use the exact public capability ID in the shared execute envelope.

```bash
curl --request POST \
  --url https://data.upscrape.com/execute \
  --header "Authorization: Bearer $UPSCRAPE_API_KEY" \
  --header "Content-Type: application/json" \
  --header "Prefer: wait=30" \
  --data '{
  "input": {
    "url": "https://www.facebook.com/reel/911507208162880"
  },
  "capability": "facebook.reel.get"
}'
```

## Input


| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `url` | `string` | Yes | Public Facebook Reel URL Default: `https://www.facebook.com/reel/911507208162880`. |

### Example input

```json
{
  "url": "https://www.facebook.com/reel/911507208162880"
}
```

## Response

Successful output is returned in `results[0].data`.

Raw platform output is intentionally open-ended and may evolve with the upstream source.

### Illustrative sample output

This example shows one response. Values and optional fields vary with the data available.

```json
{
  "actors": [
    {
      "__isActor": "User",
      "__isEntity": "User",
      "__typename": "User",
      "id": "100080376596424",
      "name": "Meta",
      "url": "https://www.facebook.com/Meta/",
      "work_foreign_entity_info": null,
      "work_info": null
    }
  ],
  "collaborators": [],
  "comet_sections": {
    "action_link": null,
    "badge": {
      "__isICometStorySection": "CometFeedUserVerifiedBadgeStrategy",
      "__module_component_CometBadgeSection_story": {
        "__dr": "CometFeedUserVerifiedBadgeStrategy.react"
      },
      "__module_operation_CometBadgeSection_story": {
        "__dr": "CometFeedUserVerifiedBadgeStrategy_badge$normalization.graphql"
      },
      "__typename": "CometFeedUserVerifiedBadgeStrategy",
      "is_prod_eligible": true
    },
    "follow_button": null
  },
  "comment_count": 114,
  "encrypted_tracking": "[redacted:token]",
  "id": "[redacted:token]=",
  "like_count": 457,
  "normalized_title": "Meta on Reels",
  "post_id": "966515752704302",
  "reaction_count": 523,
  "thumbnail_url": "https://scontent-lhr11-1.xx.fbcdn.net/v/t15.5256-10/[redacted:token].jpg?stp=dst-jpg_s1000x1200_tt6&_nc_cat=101&ccb=1-7&_nc_sid=c26028&_nc_ohc=_0-DA3BP16EQ7kNvwGcUyqL&_nc_oc=[redacted:token]&_nc_zt=23&_nc_ht=scontent-lhr11-1.xx&_nc_gid=L884NMSx6NdSQDehv7abzg&_nc_ss=7820f&oh=[redacted:token]&oe=6A8CD24C",
  "title": "196K views · 523 reactions | Meta on Reels",
  "to": null,
  "url": "https://www.facebook.com/reel/911507208162880/",
  "video_id": "911507208162880",
  "video_view_count": 36981,
  "video_view_count_text": "36K",
  "view_count": 196822,
  "view_count_text": "196K"
}
```
### Illustrative output fields

Derived from the sample above for orientation only. These fields are not a fixed response schema.

| Path | Observed type | Example |
| --- | --- | --- |
| `actors` | `array` | 1 items |
| `actors` | `array` | 1 items |
| `collaborators` | `array` | 0 items |
| `comet_sections` | `object` | 3 fields |
| `comet_sections.action_link` | `null` | null |
| `comet_sections.badge` | `object` | 5 fields |
| `comet_sections.follow_button` | `null` | null |
| `comment_count` | `integer` | 114 |
| `encrypted_tracking` | `string` | [redacted:token] |
| `id` | `string` | [redacted:token]= |
| `like_count` | `integer` | 457 |
| `normalized_title` | `string` | Meta on Reels |
| `post_id` | `string` | 966515752704302 |
| `reaction_count` | `integer` | 523 |
| `thumbnail_url` | `string` | https://scontent-lhr11-1.xx.fbcdn.net/v/t15.5256-10/[redacted:token].jp… |
| `title` | `string` | 196K views · 523 reactions \| Meta on Reels |
| `to` | `null` | null |
| `url` | `string` | https://www.facebook.com/reel/911507208162880/ |
| `video_id` | `string` | 911507208162880 |
| `video_view_count` | `integer` | 36981 |
| `video_view_count_text` | `string` | 36K |
| `view_count` | `integer` | 196822 |
| `view_count_text` | `string` | 196K |

## Execution behavior

A `200` response completed inline. A `202` response was queued; poll `GET /jobs/{id}` until the job reaches `completed` or `failed`. Use an `Idempotency-Key` when retrying must not create a duplicate logical job.

## Related documentation

- [Authentication](https://docs.upscrape.com/docs/api/authentication)
- [Jobs and results](https://docs.upscrape.com/docs/api/jobs)
- [Errors and retries](https://docs.upscrape.com/docs/api/errors)
- [Idempotency](https://docs.upscrape.com/docs/api/idempotency)
