Skip to main content
GET
Get Page or Profile Posts
Fetch the timeline of a Page or profile. Both endpoints return the same post feed envelope and paginate with the same Relay cursor. Facebook decides the page size and currently serves about 3 posts per page to a logged-out client, regardless of how many are asked for. To collect a date range, follow end_cursor while has_next_page is true and stop when created_at passes your cut-off — the feed is returned newest-first. Credits: 5 (each)

Authorization

string
required
Your ScrapeBadger API key.

Path Parameters

string
required
Vanity slug (e.g. nasa) or the numeric entity id.

Query Parameters

string
Pagination cursor — the end_cursor from a previous response.

Response

Post[]
Each Post includes id, post_id, url, permalink_url, message, story_type, creation_time_utc, created_at, author (Actor — id, name, url, profile_picture, is_verified, typename), attachments[] (Media — type (Photo · Video), id, uri, width, height, url, playable_url), reaction_count, reaction_count_text, top_reactions[] ({ name, count }), comment_count and share_count.
integer
Number of posts in this page.
string
Pass as after for the next page.
boolean
Whether more posts are reachable.

Example

Response
Personal profiles that Facebook shows only to signed-in visitors return 503 with a message saying so, not an empty posts[]. An empty posts[] with has_next_page: false means the end of the feed.