scraper
Back to API docs

Overview

  • Overview

APIs

  • POSTPost
  • POSTSearch

Facebook Search

5 credits

Search Facebook for posts.

POST/api/v1/tools/facebook/search

Parameters

querystringrequired

Search query string.

maxResultsnumber

Maximum number of results to return. Must be a positive integer. Defaults to 100. Upper bound is determined by your plan.

Response Schema

dataobject

Facebook search result

postsobject[]

Matching posts.

countnumber

Number of posts returned

metaobject

Request metadata

toolstring

Tool name (facebook-search)

creditsUsednumber

Credits consumed (5)

requestIdstring

Unique request ID

Request

curl -X POST https://scraper.run/api/v1/tools/facebook/search \
-H "Authorization: Bearer sc_live_..." \
-H "Content-Type: application/json" \
-d '{
"query": "machine learning frameworks"
}'

Response Example

{
"data": {
"posts": [
{
"id": "pfbid02kLmNoPq",
"author": "ML Community",
"text": "Comparing PyTorch, TensorFlow, and JAX for production ML workloads in 2026. Here are our benchmarks.",
"createdAt": "2026-04-06T12:00:00.000Z",
"url": "https://www.facebook.com/mlcommunity/posts/pfbid02kLmNoPq",
"reactions": 567
}
],
"count": 1
},
"meta": {
"tool": "facebook-search",
"creditsUsed": 5,
"requestId": "req_abc123"
}
}