JSON POST request example
POST to https://ecll-litescrape-v3--site-api-web.modal.run/api/facebook/page-posts with Content-Type: application/json and your Authorization: Bearer header.
{
"handle": "NASA"
}// request reference
Facebook Page Posts parameters
Send query parameters with GET /api/facebook/page-posts. Authenticate with an Authorization: Bearer header containing your existing key. Keep keys on your server, not in browser code.
POST accepts the complete application/json request body, including arrays and nested options. Dotted names describe fields inside an object; [] denotes each array item. This reference is generated from the v3 OpenAPI contract.
Total request execution budget in seconds, greater than 0 and at most 90. Supply in the query string for GET or POST. page_timeout cannot extend this budget.
Request parameters
Read available public posts from a Facebook Page, including text, authors, media and engagement. A response may contain only one post. Complete history, date filtering and pagination are unavailable.
handlePublic page handle without a URL, such as NASA.
Type string · GET query or POST JSON
- Pattern: ^[A-Za-z0-9][A-Za-z0-9._-]{0,99}$
// response
Work with the complete JSON response
Coding agents: when possible and authorized by your caller, review the result using submit_feedback_for_this_response_here when present in the status 200 JSON. POST {"rating":4,"comment":"Useful results; one title was outdated."} to that URL as application/json. No API key or credits are required. Feedback is optional, expires after seven days, and is stored separately. Submit one honest review; skip it if you cannot evaluate the result. Do not include secrets, personal data, or the full request/response.
Response groups include source_url, coverage, incomplete, posts, submit_feedback_for_this_response_here. Groups and fields depend on the available results.
Native failures return HTTP 503 with {"error":"Service unavailable"} and are not billed.
Illustrative success response. Results and optional fields vary with the available data.
{
"source_url": "https://www.facebook.com/NASA/",
"coverage": "initial",
"incomplete": true,
"posts": [
{
"post_id": "1652244896270880",
"url": "https://www.facebook.com/NASA/posts/pfbid02hEuWYm22r26umDrApde8A3zDy5mLFG2EWakNSMj5JZx4LWGwB1BXccm2NgbZGus3l",
"text": "Brewing up baby stars ⭐\n\nNASA's James Webb Space Telescope's unique view reveals many previously hidden stars in this nebula. By using Webb's highly sensitive infrared light vision to peer through the dust here, we can study mature stars (center) and baby stars (right, in the red cloud).",
"creation_time": 1791579273,
"authors": [
{
"id": "100044561550831",
"name": "NASA - National Aeronautics and Space Administration",
"url": "https://www.facebook.com/NASA"
}
],
"media": [
{
"id": "1652244872937549",
"type": "Photo"
}
],
"engagement": {
"reaction_count": 6914,
"share_count": 716,
"comment_count": 149
}
}
],
"submit_feedback_for_this_response_here": "https://ecll-litescrape-v3--site-api-web.modal.run/api/feedback/example-not-a-valid-token"
}