Facebook: Post
facebook_postFacebook posts, videos and comments: post details, attachments, comments and replies.
Actions:
action=details: Get a Facebook post's text, author, timestamp, media, and reaction, comment and share counts. Start here for any post. If you need view counts, video download URLs or audio metadata (common for reels and videos), use action=details_extended instead. Pricing: 1 credit per call. Inputs: link (required).
action=details_extended: Get everything action=details returns plus view counts, HD/SD video URLs, music/audio metadata and author verification status. Use it for reels and video posts, or when the standard details lack view_count, video_hd_src or attached_track. Pricing: 1 credit per call. Inputs: link (required).
action=id: Extract the numeric post ID from a Facebook post URL. Use it to get the post_id that action=attachments needs. Pricing: 1 credit per call. Inputs: link (required).
action=attachments: List every media attachment (images and videos, with URLs and dimensions) on a Facebook post, including all items in multi-photo posts. Needs the numeric post_id from action=id. For the post's text and engagement, use action=details. Pricing: 5 credits per call (deeper scrape than standard post details). Inputs: post_id (required).
action=video: Get a Facebook video post's metadata: title, message text and hashtags, owner, reactions and view count. Needs the numeric video_id (the number in a facebook.com/.../videos/ URL, or from facebook_page (action=videos)). Pricing: 1 credit per call. Inputs: video_id (required).
action=comments: List top-level comments on a Facebook post or reel, with author, text, timestamp and reaction count. Returns up to 30 per call plus an end_cursor for the next page. Set include_reply_info=true to get the comment_feedback_id and expansion_token that action=comment_replies needs. Pricing: 1 credit per call. Inputs: link (required), limit (optional), end_cursor (optional), include_reply_info (optional).
action=comment_replies: List replies to one Facebook comment. Needs comment_feedback_id and expansion_token, which action=comments returns when called with include_reply_info=true. Pricing: 1 credit per call. Inputs: comment_feedback_id (required), expansion_token (required).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| link | No | Facebook post or reel URL (regular posts, video posts and reels). Required for: details, details_extended, id, comments. | |
| limit | No | Maximum number of comments to return. Default: 10. Maximum: 30. Optional for: comments. | |
| action | Yes | Which operation to run. See the tool description for what each action returns and which parameters it needs. | |
| post_id | No | Numeric Facebook post ID, from action=id. Required for: attachments. | |
| video_id | No | Numeric Facebook video ID, e.g. the number in a facebook.com/.../videos/<id> URL. Required for: video. | |
| end_cursor | No | Pagination cursor for next page of comments. Optional for: comments. | |
| expansion_token | No | Expansion token from the comments endpoint with include_reply_info=true. Required for: comment_replies. | |
| include_reply_info | No | When "true", includes comment_feedback_id and expansion_token for fetching replies. Optional for: comments. | |
| comment_feedback_id | No | Feedback ID from the comments endpoint with include_reply_info=true. Required for: comment_replies. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes | JSON response from the SocialAPIs REST endpoint, unchanged. Object or array depending on the endpoint; most include a `meta` block (statusCode, duration, creditsCharged, creditsRemaining). | |
| creditsCharged | No | Credits charged for this call, or null if the endpoint did not report it. | |
| creditsRemaining | No | Credits left on the API key after this call, or null if not reported. |