---
title: "Retrieve Facebook Post by ID"
method: GET
path: "/desearch/facebook/post/{id}"
tags: ["Facebook Search"]
---

# Retrieve Facebook Post by ID

`GET /desearch/facebook/post/{id}`

## Request

- Base URL: `https://api.desearch.ai`
- URL: `https://api.desearch.ai/desearch/facebook/post/{id}`
- Auth: API key in header `Authorization`

Retrieve normalized metadata for a public Facebook post/media item by ID.

Billing metadata: successful billable responses include the `X-Desearch-Cost-Usd`, `X-Desearch-Usage-Count`, `X-Desearch-Service`, and `X-Desearch-Currency` headers. JSON object responses also include optional `cost_usd`, `usage_count`, `service`, and `currency` fields. For example, `usage_count=10` at `$0.015 / 1,000` resolves to `cost_usd=0.00015`. JSON arrays, text, and streaming responses keep their body shape and expose billing metadata only through headers.

## Path parameters

- `id` string, required: Facebook public post/media ID

## Response `200`

A normalized Facebook post object.

- union
  - FacebookPost
    - `id` string, nullable
    - `url` string, nullable
    - `text` string, nullable
    - `createTime` string, nullable
    - `author` FacebookProfile
      - `id` string, nullable
      - `username` string, nullable
      - `name` string, nullable
      - `url` string, nullable
      - `avatar` string, nullable
      - `verified` boolean, nullable
      - `bio` string, nullable
      - `category` string, nullable
      - `followers` integer, nullable
      - `likes` integer, nullable
    - `stats` FacebookPostStats
      - `reactionCount` integer, nullable
      - `commentCount` integer, nullable
      - `shareCount` integer, nullable
      - `viewCount` integer, nullable
    - `media` FacebookMedia[]
      - `type` string, nullable
      - `url` string, nullable
      - `thumbnail` string, nullable
      - `width` integer, nullable
      - `height` integer, nullable
    - `hashtags` string[]
  - object

## Other responses

- `301`: Moved Permanently
- `304`: Not Modified
- `401`: Unauthorized
- `422`: Validation Error
- `429`: Too Many Requests
- `500`: Internal Server Error

---

[API](https://skmtc.dev/desearch/apis/desearch-api.md) · [All operations](https://skmtc.dev/desearch/apis/desearch-api/llms.txt) · [OpenAPI document](https://skmtc.dev/desearch/apis/desearch-api/revisions/c2d7648859bd?raw)
