JustSERPDocs
Facebook

Facebook Page events

The events tab of a Facebook Page (upcoming or past) read with no login: 8 events in the document and 8 more for each scroll, up to `max_events`.

GET
/v1/facebook/events

The events tab of a Facebook Page (upcoming or past) read with no login: 8 events in the document and 8 more for each scroll, up to max_events. Facebook's own event search and city pages show a logged-out visitor nothing, so a Page is the way in. A Page whose tab has no events ("No events to show") answers 200 with events_results: [] and total_count: 0.

Authorization

headerX-API-Key<token>

Your API key.

Query Parameters

cancel_token?string

A name you make up for this request (a UUID is fine), so you can later GET /v1/cancel with it. Only you know it, so only you can cancel. Use a new one for every request, retries included: a cancelled token stays cancelled for a few minutes.

Length1 <= length <= 128
page?string

The Page's name in its address, e.g. brushystreet.

profile_url?string

facebook.com/, with or without /events.

url?string
tab?string
Default"upcoming"
Value in"upcoming""past"
max_events?integer
Range1 <= value <= 100
Default24
country?string

Two letters, any case (us, GB).

Match^[A-Za-z]{2}$

Response Body

The answer.

application/json
  1. response

The first three keys of every parsed 200 (the answer is the document itself, no success/data envelope): what the search was (search_metadata), what it asked (search_parameters), the parser's own search_information ({} when it has none). The engine's blocks follow, at the same level. An engine whose answer is a list puts it under results.

search_metadata*
search_parameters*

The request's own fields as sent, engine first, without cancel_token.

search_information*

The parser's own, e.g. yelp_search's; otherwise {}.

page?
tab?string
total_count?integer|null
has_more?boolean
events_results*array<>
Example Request
curl -X GET 'https://api.justserp.com/v1/facebook/events?page=brushystreet&tab=upcoming'
Example Response
{  "search_metadata": {    "id": "string",    "status": "Success",    "created_at": "string",    "request_url": "string",    "html_url": "string"  },  "search_parameters": {},  "search_information": {},  "page": {},  "tab": "string",  "total_count": 0,  "has_more": true,  "events_results": [    {}  ]}