UnifAPI Docs

Get a Facebook post or Reel by URL

Returns one public Facebook post or Reel by its URL: author, text, media, music and reaction, comment and share counts. Set `include_comments` or `include_transcript` for a comment sample or a video transcript. Returns `not_found` when the post does not exist or is not public.

Pricing — $ · min $0.003

Minimum 3 credits ($0.003) per call. Records returned above the minimum bill 1 credit ($0.001) each.

GET
/facebook/posts

Authorization

bearerAuth
AuthorizationBearer <token>

UnifAPI API key. Provider credentials are managed by UnifAPI.

In: header

Query Parameters

url*string

Public permalink to the Facebook post or reel.

Length1 <= length <= 4096
include_comments?string

When true, includes a sample of top-level comments when available.

Value in

  • "true"
  • "false"
include_transcript?string

When true, includes a plain-text transcript when available for the video.

Value in

  • "true"
  • "false"

Header Parameters

Unifapi-Version?"2026-07-01"

Pin the API version an integration was built against (date-based, e.g. 2026-07-01). Omit to use the current version. Public URL paths stay stable and unversioned; breaking changes ship under a new dated version and are announced with Deprecation and Sunset response headers. The served version is echoed in every response's Unifapi-Version header. Policy: https://unifapi.com/versioning.md

Default"2026-07-01"

Value in

  • "2026-07-01"

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/facebook/posts?url=string"
{  "request_id": "string",  "data": {    "platform": "string",    "post_id": "string",    "url": "string",    "description": "string",    "published_at": 0,    "is_paid_partnership": true,    "feedback_id": "string",    "link_attachment": {      "url": "string",      "title": "string",      "image_url": "string"    },    "author": {      "name": "string",      "profile_url": "string",      "avatar_url": "string",      "platform_user_id": "string",      "is_verified": true    },    "like_count": 0,    "comment_count": 0,    "share_count": 0,    "view_count": 0,    "reactions": {      "property1": 0,      "property2": 0    },    "media": {      "thumbnail_url": "string",      "image_url": "string",      "image_urls": [        "string"      ],      "video_url": "string",      "video_hd_url": "string",      "duration": 0,      "width": 0,      "height": 0,      "captions_url": "string"    },    "music": {      "track_title": "string",      "album_art_url": "string",      "music_id": "string",      "type": "string"    },    "comments": [      {        "comment_id": "string",        "text": "string",        "created_at": 0,        "reply_count": 0,        "reaction_count": 0,        "author_name": "string",        "author_platform_user_id": "string",        "author_avatar_url": "string",        "reactions": {          "property1": 0,          "property2": 0        }      }    ],    "transcript": "string"  },  "billing": {    "credits_charged": 0,    "records_charged": 0,    "balance_remaining": 0,    "truncated_due_to_balance": true  }}