/fbPosts

post

https://api.newswhip.com/v1/fbPosts

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

📘
Time range
The maximum range between the from and to dates in your query should not exceed 7 days.

Filters

The following filtering options can be used in the filters body parameter.

Field	Type	Description
`language`	String
`country_code`	String	Two letter (lower case) ISO 3166 country code
`region_code`	String	Available regions (lower case): `na` North America `eu` Europe `oc` Oceania `sea` South East Asia `sa` South America `as` Asia `me` Middle East `af` Africa
`authors`	String
`page_id`	Integer	Facebook page ID.
`page_name`	String	Facebook page username, usually the one that comes after ‘@’
`external_link`	String	The href shared inside facebook post
`fb_story`	String	A description generated by Facebook about an event eg. Tom shared 3 photos or John shared a link

Query Params

key

string

required

Defaults to DevHub

Your API key.

Body Params

filters

array of strings

required

Defaults to country_code:us

See the Notes section at the bottom of this page. The Lucene query strings section shares important considerations, including the limits to the number of filters that are allowed.

filters*

from

int64

Defaults to null

Unix timestamp in milliseconds. Filters articles published after {from}. Defaults to 1 week ago.

int64

Defaults to null

Unix timestamp in milliseconds. Filters articles published before {to}. Defaults to now.

language

string

Two letter ISO 639-1 language code. Defaults to any language.

default_fields

array of strings

Defaults to page_name,external_link

Up to 3 available fields to be used when filtering only by keywords (like "Barack Obama"). Defaults to page_name and external_link. You can choose from: headline, external_link, page_id, page_name, country_code, authors, language, region_code, and summary.

default_fields

size

int32

Defaults to 5

Max number of articles to be returned (includes relatedStories.) Defaults to 200. The maximum you can specify is 5,000.

content_type

string

all, all_video, embedded_video, native_video, live_video, link, photo, status, branded_content. Defaults to return all content types.

sort_by

string

Defaults to default

Sorts by the following in descending order: default, nw_max_score, fb_overperforming, fb_total_engagement, created_at, fb_likes, fb_shares, fb_comments, fb_loves, fb_wows, fb_hahas, fb_sads, fb_angrys. The default sort_by is nw_max score when the selected time-range is <= 25h, otherwise it will be fb_overperforming.

Time range

Filters

200200

400400