​
Overview

The Facebook API Suite offers multiple types of APIs, each designed for specific data collection needs from Facebook. Below is an overview of how these APIs connect and interact, based on the available features:

Posts API

This API allows users to collect multiple posts based on a single input URL (such as a Facebook page, group, or profile URL).
  •   Discovery functionality:
  •   Requires the direct URL of the Facebook page, group, or profile.

  •   Interesting Columns:
  •   post_url, content, hashtags, likes

Comments API

This API allows users to collect multiple comments from a post using its URL.
  •   Discovery functionality:
  •   N/A

  •   Interesting Columns:
  •   commenter_url, comment_text, num_likes, num_replies
There is no discovery capability across Facebook datasets since the data is locked behind login requirements.
The suite of APIs is designed to offer flexibility for targeted data collection, where users can input specific URLs to gather detailed post and comment data, either in bulk or with precise filtering options.

​
Posts API

Posts API allows users to collect detailed post data from Facebook profiles, groups, and pages. The API provides comprehensive data points about posts, including post details, page/profile details, and attachments and media.

​
Collect by Profile URL

This API enables users to collect detailed data from Facebook posts by providing a profile URL. Input Parameters
​
URL
string
required
The Facebook profile URL.
​
num_of_posts
number
The number of recent posts to collect. If omitted, there is no limit.
​
posts_to_not_include
array
Array of post IDs to exclude from the results.
​
start_date
string
Start date for filtering posts in MM-DD-YYYY format (should be earlier than end_date).
​
end_date
string
End date for filtering posts in MM-DD-YYYY format (should be later than start_date).
Output Structure Includes comprehensive data points:
  • Post Details: post_id, content, hashtags, date_posted, num_comments, num_likes, and more.
    For all data points, click here.
  • Page/Profile Details: page_name, page_category, page_followers, profile_handle.
    We provide a limited set of data points about the profile.
  • Attachments and Media: attachments and post_image (link only, not the file itself), video_view_count.

​
Collect by Group URL

This API enables users to collect detailed posts from Facebook groups by providing a group URL. Input Parameters
​
URL
string
required
The Facebook group URL.
​
num_of_posts
number
The number of posts to collect. If omitted, there is no limit.
​
posts_to_not_include
array
Array of post IDs to exclude from the results.
​
start_date
string
Start date for filtering posts in MM-DD-YYYY format (should be earlier than end_date).
​
end_date
string
End date for filtering posts in MM-DD-YYYY format (should be later than start_date).
Output Structure Includes comprehensive data points:
  • Post Details: post_id, user_url, user_username, content, date_posted, hashtags, num_comments, num_shares, num_likes_type, and more.
    For all data points, click here.
  • Group Details: group_name, group_id, group_url, group_intro, group_category, and more.
  • User Details: user_is_verified, profile_handle and more.
  • Attachments and External Links: Attachments (link only, not the file itself), original_post_url, other_posts_url, post_external_link and more.

​
Collect by Post URL

This API enables users to collect detailed data from specific Facebook posts using post URLs. Input Parameters
​
URL
string
required
The Facebook profile URL.
Output Structure Includes comprehensive data points:
  • Post Details: post_id, content, hashtags, date_posted, num_comments, num_likes, and more.
    For all data points, click here.
  • Page/Profile Details: page_name, page_category, page_followers, profile_handle.
    We provide a limited set of data points about the profile.
  • Attachments and Media: attachments and post_image (link only, not the file itself), video_view_count.

​
Comments API

Comments API allows users to collect detailed comment data from Facebook posts. The API provides comprehensive data points about comments, including comment details, user details, post metadata, and attachments and media.

​
Collect by Post URL

This API enables users to collect detailed comment data from Facebook posts by providing a post URL. Input Parameters
​
URL
string
required
The Facebook post URL.
​
num_of_comments
number
The number of comments to collect. If omitted, there is no limit.
​
comments_to_not_include
array
Array of comment IDs to exclude.
​
start_date
string
Start date for filtering comments in MM-DD-YYYY format (should be earlier than end_date).
​
end_date
string
End date for filtering comments in MM-DD-YYYY format (should be later than start_date).
Output Structure Includes comprehensive data points:
  • Comment Details: comment_id, comment_text, num_likes, replies, num_replies, and more.
    For all data points, click here.
  • User Details: user_name, user_id, user_url
    We provide a limited set of data points about the profile.
  • Post Metadata: post_id, post_url.
  • Attachments and Media: attached_files (link only, not the file itself) , video_length.

​
Reels API

Reels API allows users to collect detailed data about Facebook reels from public profiles. The API provides comprehensive data points about reels, including post details, page/profile details, and attachments and media.

​
Collect by Profile URL

This API allows users to collect detailed data about Facebook reels from public profiles by providing the profile URL. Input Parameters
​
URL
string
required
The Facebook profile URL.
​
num_of_posts
number
Number of reels to collect (default: up to 1600).
​
posts_to_not_include
array
Array of reel IDs to exclude.
​
start_date
string
Start of the date range for filtering reels.
​
end_date
string
End of the date range for filtering reels.
Output Structure Includes comprehensive data points:
  • Reel Details: post_id, content, hashtags, date_posted, num_comments, num_likes, audio (soundtrack details), video_view_count and more.
    For all data points, click here.
  • Page/Profile Details: page_name, page_category, page_followers, profile_handle.
    We provide a limited set of data points about the profile.
  • Attachments and Media: external_link (link only, not the file itself)