---
title: "Facebook Comments API"
method: GET
path: "/v1/facebook/comments"
tags: ["Facebook"]
---

# Facebook Comments API

`GET /v1/facebook/comments`

## Request

- Base URL: `https://api.captapi.com`
- URL: `https://api.captapi.com/v1/facebook/comments`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

Facebook post comments with reactionCount, reactions.like when mixed, author.id (pfbid), and replyCount.

Pass a post/Reel URL or feedbackId (from /v1/facebook/details) and get top-level comments as clean JSON. reactionCount is the mix total. reactions{} is included only when Facebook exposes a real multi-type mix — likes are reactions.like, not a likeCount twin (that field used to hold the total and is gone). Unused types are omitted, not zeroed. author is an object with stable id (pfbid or numeric), name, shortName, gender, url, and avatarUrl when exposed. replyCount and hasMore are included for threading/loops. A Reel URL returns the comment preview Facebook shows logged-out for that video (usually a few top comments). When Facebook returns no comments this time the call is a retryable 503 UPSTREAM_UNAVAILABLE at 0 credits; input that is not a Facebook URL is 400. Rows with signed CDN media (avatars) carry mediaUrlsExpireAt. Flat 2 credits. Prefer feedbackId when you already fetched details.

Docs: https://captapi.com/apis/facebook-comments

## Query parameters

- `url` string
- `feedbackId` string
- `limit` integer
- `cache` boolean

## Response `200`

Success. The data object for this endpoint.

- object
  - `success` unknown, required
  - `data` object, required
    - `platform` string: Platform identifier for this response (matches the endpoint's platform).
    - `url` string: Canonical URL of the item.
    - `totalReturned` integer: Number of items returned in this response.
    - `comments` object[]
      - `id` string: Id of this comments item.
      - `url` string: Canonical URL of the item.
      - `text` string: Text content.
      - `author` object: Nested author (id, name, shortName, gender, url, avatarUrl). author.url is the canonical profile URL.
        - `id` string: Id of this comments item.
        - `name` string
        - `shortName` string
        - `gender` string
        - `avatarUrl` string
      - `authorAvatarUrl` string: Profile picture URL of the person who wrote the comment.
      - `reactionCount` integer: Total of every reaction type Facebook exposed. Not likes.
      - `publishedAt` string: Publish date (ISO 8601) when the platform exposes an absolute timestamp.
      - `replyCount` integer: How many replies this comment has. Use Comment Replies with this comment's id to fetch them.
      - `mediaUrlsExpireAt` string: ISO-8601 UTC earliest expiry across signed media URLs in this response (expire= / x-expires / TikTok hex path timestamp). Null when no stamp is parseable — never a guess.
      - `reactions` unknown
    - `hasMore` boolean: Whether more results are available beyond this page. When true, pass nextCursor to fetch the next page.
    - `nextCursor` unknown
    - `feedbackId` string: Facebook feedback id for the post (useful for comments threading).

## Other responses

- `400`: Bad request: wrong platform URL, unknown endpoint, or an invalid parameter value. Not billed.
- `401`: Missing, invalid or revoked API key. Not billed.
- `402`: Not enough credits for this request. Not billed.
- `404`: The resource does not exist or is not public. Not billed.
- `422`: A required parameter is missing or has the wrong type. Not billed.
- `429`: Rate limit reached. Wait for Retry-After seconds. Not billed.
- `502`: The platform could not be reached or returned nothing usable. Retryable, not billed. 503 and 504 use the same envelope.

## Changes

- **2026-10-19** `c9b9ac5ff1bd`: 1 breaking, 11 warning, 1 info
  - the `data/comments/items/reactions` response's property type changed from `object` to no type for status `200`
  - removed the optional property `data/comments/items/likeCount` from the response with the `200` status
  - removed the optional property `data/comments/items/reactions/anger` from the response with the `200` status
  - removed the optional property `data/comments/items/reactions/care` from the response with the `200` status
  - …9 more

[Operation history](https://skmtc.dev/captapi/apis/captapi-api/changes/v1/facebook/comments/get.md)

---

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