Time range

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


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

country_codeStringTwo letter (lower case) ISO 3166 country code
region_codeStringAvailable regions (lower case):
na North America
eu Europe
oc Oceania
sea South East Asia
sa South America
as Asia
me Middle East
af Africa
page_idIntegerFacebook page ID.
page_nameStringFacebook page username, usually the one that comes after ‘@’
external_linkStringThe href shared inside facebook post
fb_storyStringA description generated by Facebook about an event eg. Tom shared 3 photos or John shared a link
Click Try It! to start a request and see the response here!