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:

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 Note that

    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)

Was this page helpful?