EveryData platform API
Facebook API
Use Facebook for Facebook public Pages, posts, comments, ads, groups, Marketplace listings, and Page reviews only through the 10 listed contracts, such as `search`, `profile`, `user_posts`, because one view does not inherit another view’s reach.
For matching public results, use Facebook action `search` with `keyword`; for the selected Facebook record, switch to `profile` and `url`, rather than carrying parameters across.
- Endpoint
- POST /api/v1/social
- Capabilities
- 10
- Per 1,000
- $1.389–$2.778
Available capabilities
Compare the Facebook actions by required input, returned data, and price. Use the action identifier exactly as shown in your request.
| Action | Required | Optional | Delivery | Limit | Per 1,000 | Response fields |
|---|---|---|---|---|---|---|
searchSearch Search public results on Facebook. Accepts these parameters: | keyword | content_type, since, until | Sync delivery | Catalog values: defaultLimit=10, maxLimit=200. A limit can control pages or per-parent expansion for some actions, so it is not always a final row count. | $1.39 per 1,000 requests | id · url · text · author_name · author_username · like_count · comment_count · share_count · posted_at · platform |
profileDetails Retrieve details from Facebook. Accepts these parameters: | url | — | Async delivery | — | $2.78 per 1,000 requests | id · name · url · bio · category · like_count · follower_count · is_verified · phone · email · website · rating · rating_scale · avatar_url · platform |
user_postsPosts by user Retrieve public posts from Facebook. Accepts these parameters: | url | — | Async delivery | Catalog values: defaultLimit=10, maxLimit=50. A limit can control pages or per-parent expansion for some actions, so it is not always a final row count. | $2.78 per 1,000 requests | id · url · text · author_name · author_username · like_count · comment_count · share_count · posted_at · platform |
postPost details Retrieve a public post from Facebook. Accepts these parameters: | url | — | Sync delivery | — | $1.39 per 1,000 requests | id · url · text · author_name · author_username · like_count · comment_count · share_count · posted_at · platform |
commentsComments Retrieve public comments from Facebook. Accepts these parameters: | url | — | Async delivery | Catalog values: defaultLimit=10, maxLimit=50. A limit can control pages or per-parent expansion for some actions, so it is not always a final row count. | $2.78 per 1,000 requests | id · text · author_name · author_username · like_count · reply_count · posted_at · reply_to_id · platform |
followersFollowers Retrieve public follower metrics from Facebook. Accepts these parameters: | username | channel | Sync delivery | — | $1.39 per 1,000 requests | id · username · url · follower_count · following_count · post_count · like_count · connection_count · precision · platform |
adsAds Use the | keyword | country, status | Sync delivery | Catalog values: defaultLimit=20, maxLimit=200. A limit can control pages or per-parent expansion for some actions, so it is not always a final row count. | $1.39 per 1,000 requests | id · url · text · title · cta_text · link_url · is_active · started_at · ended_at · platforms · variant_count · advertiser_id · advertiser_name · advertiser_url · advertiser_likes · image_url · platform |
group_postsGroup posts Retrieve group posts from Facebook. Accepts these parameters: | url | sort | Sync delivery | Catalog values: defaultLimit=20, maxLimit=200. A limit can control pages or per-parent expansion for some actions, so it is not always a final row count. | $1.39 per 1,000 requests | id · url · text · posted_at · like_count · comment_count · share_count · author_id · author_name · author_url · group_url · platform |
marketplaceMarketplace Use the | keyword | location | Sync delivery | Catalog values: defaultLimit=20, maxLimit=200. A limit can control pages or per-parent expansion for some actions, so it is not always a final row count. | $1.39 per 1,000 requests | id · url · name · price · currency · city · state · condition · image_url · posted_at · platform |
reviewsReviews Retrieve public reviews from Facebook. Accepts these parameters: | url | — | Sync delivery | Catalog values: defaultLimit=20, maxLimit=200. A limit can control pages or per-parent expansion for some actions, so it is not always a final row count. | $1.39 per 1,000 requests | id · url · text · is_recommended · rating · rating_scale · posted_at · like_count · comment_count · author_id · author_name · author_url · platform |
What does each Facebook action accept?
Each answer below pairs one callable action with its real inputs. Parameter meanings and allowed values are action-specific; a familiar name does not carry the same meaning across every platform.
Official sources are linked only to clarify the platform term beside them. They do not imply platform authorization or endorsement, and they do not add official-site features to the EveryInfra API contract.
What do the Facebook search parameters mean?
Search public results on Facebook. Accepts these parameters: since, until, keyword, and content_type. Returns these fields: author_username, text, share_count, and posted_at.
keywordRequired- Specifies the search query for distinct platform endpoints. For search, it searches public posts; for ads, it accepts ad keywords or direct Ad Library and Page URLs; for marketplace, it accepts item search terms or complete Marketplace search URLs. Each action queries a different dataset rather than returning the same results under different field names.
content_typeOptional- Sorts results for the search action using allowed values latest for newer posts or most_popular for popular posts. Despite its name, content_type acts as a sorting dimension and does not filter by media format, such as images or videos.Allowed values:
latestmost_popularFacebook: Boundaries of Public Posts and Public InformationFacebook help documentation defines the visibility of public shares, Page posts, and comments on public posts. This clarifies the objects addressed by search; it does not endorse `content_type` ranking values or show that publicly visible information is authorized for automated collection.Checked sinceOptional- Filters post publication dates for the search action from this start date, recommended in YYYY-MM-DD format. Combined with until, it forms the query date range; it does not filter ad run times or comment creation times.
untilOptional- Filters post publication dates for the search action up to this end date, recommended in YYYY-MM-DD format. Combined with since, it forms the query date range; it does not control ad expiration dates.
What do the Facebook profile parameters mean?
Retrieve details from Facebook. Accepts these parameters: url. Returns these fields: rating_scale, follower_count, category, and email.
urlRequired- Specifies the target URL corresponding to the requested action. Use public Page URLs for profile and user_posts, post URLs for post and comments, group page URLs or group identifiers for group_posts, and business page URLs for reviews (which appends /reviews). Arbitrary Facebook URLs cannot be interchanged across actions.Facebook Official: Public Visibility of Page Profiles, Posts, and CommentsOfficial Meta documentation discusses public details across Pages, profiles, posts, and comments; this definition of visibility does not guarantee that every URL can be read, that every field will be returned, or that this endpoint holds Meta access authorization.CheckedMeta Official Documentation: Automated Data Collection Requires Prior PermissionMeta explicitly states that automated collection of Facebook data without prior permission violates its terms, even for publicly visible data. Citing authoritative sources does not constitute proof of authorization for platform collection or reuse.Checked
What do the Facebook user_posts parameters mean?
Retrieve public posts from Facebook. Accepts these parameters: url. Returns these fields: share_count, posted_at, like_count, and author_name.
urlRequired- Specifies the target URL corresponding to the requested action. Use public Page URLs for profile and user_posts, post URLs for post and comments, group page URLs or group identifiers for group_posts, and business page URLs for reviews (which appends /reviews). Arbitrary Facebook URLs cannot be interchanged across actions.Facebook Official: Public Visibility of Page Profiles, Posts, and CommentsOfficial Meta documentation discusses public details across Pages, profiles, posts, and comments; this definition of visibility does not guarantee that every URL can be read, that every field will be returned, or that this endpoint holds Meta access authorization.CheckedMeta Official Documentation: Automated Data Collection Requires Prior PermissionMeta explicitly states that automated collection of Facebook data without prior permission violates its terms, even for publicly visible data. Citing authoritative sources does not constitute proof of authorization for platform collection or reuse.Checked
What do the Facebook post parameters mean?
Retrieve a public post from Facebook. Accepts these parameters: url. Returns these fields: text, author_name, comment_count, and posted_at.
urlRequired- Specifies the target URL corresponding to the requested action. Use public Page URLs for profile and user_posts, post URLs for post and comments, group page URLs or group identifiers for group_posts, and business page URLs for reviews (which appends /reviews). Arbitrary Facebook URLs cannot be interchanged across actions.Facebook Official: Public Visibility of Page Profiles, Posts, and CommentsOfficial Meta documentation discusses public details across Pages, profiles, posts, and comments; this definition of visibility does not guarantee that every URL can be read, that every field will be returned, or that this endpoint holds Meta access authorization.CheckedMeta Official Documentation: Automated Data Collection Requires Prior PermissionMeta explicitly states that automated collection of Facebook data without prior permission violates its terms, even for publicly visible data. Citing authoritative sources does not constitute proof of authorization for platform collection or reuse.Checked
What do the Facebook comments parameters mean?
Retrieve public comments from Facebook. Accepts these parameters: url. Returns these fields: text, reply_count, author_name, and like_count.
urlRequired- Specifies the target URL corresponding to the requested action. Use public Page URLs for profile and user_posts, post URLs for post and comments, group page URLs or group identifiers for group_posts, and business page URLs for reviews (which appends /reviews). Arbitrary Facebook URLs cannot be interchanged across actions.Facebook Official: Public Visibility of Page Profiles, Posts, and CommentsOfficial Meta documentation discusses public details across Pages, profiles, posts, and comments; this definition of visibility does not guarantee that every URL can be read, that every field will be returned, or that this endpoint holds Meta access authorization.CheckedMeta Official Documentation: Automated Data Collection Requires Prior PermissionMeta explicitly states that automated collection of Facebook data without prior permission violates its terms, even for publicly visible data. Citing authoritative sources does not constitute proof of authorization for platform collection or reuse.Checked
What do the Facebook followers parameters mean?
Retrieve public follower metrics from Facebook. Accepts these parameters: channel and username. Returns these fields: username, post_count, connection_count, and following_count.
usernameRequired- Specifies the Facebook account or Page identifier without an @ symbol for the followers action. This capability returns a total follower count object rather than an exported list of individual follower profiles or a user relationship graph.Facebook: Following a Page Is Distinct from Liking ItOfficial Facebook documentation explains that Follow is used to receive Page updates and notes differences for Pages transitioning from Like to Follow structures; this differentiates `follower_count` from `like_count`, but does not indicate that this platform can export follower lists.Checked
channelOptional- Acts as a compatibility input for the account identifier in the followers action. If username is supplied, it takes precedence, and public requests must still include the required username parameter. This parameter does not represent a chat channel ID.
What do the Facebook ads parameters mean?
Use the ads action on Facebook. Accepts these parameters: country, status, and keyword. Returns these fields: started_at, title, ended_at, and advertiser_id.
keywordRequired- Specifies the search query for distinct platform endpoints. For search, it searches public posts; for ads, it accepts ad keywords or direct Ad Library and Page URLs; for marketplace, it accepts item search terms or complete Marketplace search URLs. Each action queries a different dataset rather than returning the same results under different field names.Meta Official: Ads and Page Search Objects in the Ad LibraryHistorical Meta announcements introduce searching ads by keyword or Page and highlight transparency data differences between general active ads and political or issue ads, along with official API requirements; this does not imply that all ads include spend, impressions, or complete history, as this endpoint does not offer those stable fields.Checked
countryOptional- Specifies the country code for keyword queries in the ads action, such as US (defaults to US). Values are converted to uppercase when constructing request URLs. If keyword is provided as a complete URL, the parameters embedded in that URL take precedence and this country setting is not applied.
statusOptional- Filters ad page status with allowed values: all (default), active (currently running), or inactive (stopped). This represents ad delivery status rather than ad review status. When passing an Ad Library keyword URL, the embedded active_status condition operates on a separate input path and is not guaranteed to filter identically to this parameter.
What do the Facebook group_posts parameters mean?
Retrieve group posts from Facebook. Accepts these parameters: sort and url. Returns these fields: like_count, author_id, comment_count, and group_url.
urlRequired- Specifies the target URL corresponding to the requested action. Use public Page URLs for profile and user_posts, post URLs for post and comments, group page URLs or group identifiers for group_posts, and business page URLs for reviews (which appends /reviews). Arbitrary Facebook URLs cannot be interchanged across actions.Meta Official: Historical Private Content Remains Protected When Groups Change to PublicOfficial Meta documentation notes that when a private group switches to public, new content becomes publicly visible while content and member lists from its private phase remain restricted; therefore, a group currently public does not guarantee access to historical posts or complete member lists.CheckedMeta Official Documentation: Automated Data Collection Requires Prior PermissionMeta explicitly states that automated collection of Facebook data without prior permission violates its terms, even for publicly visible data. Citing authoritative sources does not constitute proof of authorization for platform collection or reuse.Checked
sortOptional- Specifies post ordering for group_posts using top for top posts or recent for posts with recent activity, defaulting to chronological order if omitted. The recent option is based on activity rather than post creation time alone. Unsupported string values fall back to chronological order instead of returning an error.
What do the Facebook marketplace parameters mean?
Use the marketplace action on Facebook. Accepts these parameters: location and keyword. Returns these fields: currency, name, image_url, and price.
keywordRequired- Specifies the search query for distinct platform endpoints. For search, it searches public posts; for ads, it accepts ad keywords or direct Ad Library and Page URLs; for marketplace, it accepts item search terms or complete Marketplace search URLs. Each action queries a different dataset rather than returning the same results under different field names.
locationOptional- Specifies the city path identifier for marketplace, such as nyc (defaults to nyc). It does not accept free-form street addresses. If keyword contains a complete Marketplace URL, that URL takes precedence and location is ignored.Meta Official: Marketplace Listings and Location Search BoundsHistorical Meta documentation defines Marketplace as a feature for local item listing and discovery, distinguishing item title, price, and location; this supports object semantics only and does not establish native UI filtering options or historical regional availability as current capabilities of this endpoint.Checked
What do the Facebook reviews parameters mean?
Retrieve public reviews from Facebook. Accepts these parameters: url. Returns these fields: text, author_id, author_name, and comment_count.
urlRequired- Specifies the target URL corresponding to the requested action. Use public Page URLs for profile and user_posts, post URLs for post and comments, group page URLs or group identifiers for group_posts, and business page URLs for reviews (which appends /reviews). Arbitrary Facebook URLs cannot be interchanged across actions.Facebook Official Documentation: Page Recommendations and ReviewsOfficial documentation explains that recommendations are displayed in the Reviews section of a Page and notes that removing violating reviews can alter the Page rating. A Page's overall rating is distinct from an individual recommendation entry, so `is_recommended` cannot be automatically converted into a star rating.CheckedMeta Official Documentation: Automated Data Collection Requires Prior PermissionMeta explicitly states that automated collection of Facebook data without prior permission violates its terms, even for publicly visible data. Citing authoritative sources does not constitute proof of authorization for platform collection or reuse.Checked
How to use the Facebook API
- 01Read the public catalog and choose a platform action.
- 02Send the platform, action, and required parameters to POST /api/v1/social.
- 03Handle a synchronous result or poll the returned job ID when the selected action is asynchronous.
- 04Store the structured response fields needed by your application.
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"facebook","action":"search","params":{"keyword":"<keyword>"}}'
Facebook API questions
What can I retrieve with the Facebook API?
Set platform to facebook. The current catalog lists search, details, posts by user, post details, comments, and more. These action names identify different Facebook objects or views; they are not interchangeable search modes.
Which input starts a Facebook `search` request?
Specifies the search query for distinct platform endpoints. For search, it searches public posts; for ads, it accepts ad keywords or direct Ad Library and Page URLs; for marketplace, it accepts item search terms or complete Marketplace search URLs. Each action queries a different dataset rather than returning the same results under different field names. Send it as keyword inside params.
Which fields can Facebook `search` return?
Its declared schema includes text, author_name, author_username, and like_count. A declared field can still be absent from an individual source record, and every other action has its own field list.
Does every Facebook action return immediately?
No assumption is needed: this page labels each action's delivery mode. The current catalog contains sync delivery and async delivery; poll a returned job ID only for an action labeled asynchronous.