Facebook Search Posts
Search public Facebook posts by keyword, with optional date filters and cursor pagination. keyword is required; startDate and endDate are optional inclusive bounds in yyyy-MM-dd format. Leave cursor empty or omit it for the initial search, and provide an available pagination cursor to request the next set of results. Returns a JSON response containing status code, search data, message, and recordTime. The search data's individual post fields and pagination structure are not specified, so a total count or next cursor is not guaranteed. This tool retrieves public content only and does not publish or change posts.
Pricing
| Condition | Charge |
|---|---|
| Each call | 34.92 credits/call |
Parameters
Optional parameters use the platform defaults when omitted.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
cursor | string | No | 用于获取下一组结果的分页游标。 | "" |
endDate | string | No | 搜索范围的结束日期(包含),格式为 yyyy-MM-dd。 | — |
keyword | string | Yes | 用于在公开帖子中搜索的关键词。支持基础文本匹配。 | — |
startDate | string | No | 搜索范围的开始日期(包含),格式为 yyyy-MM-dd。 | — |
Invocation example
Copy the request and explore its response example.
/agent-api/v1/tool/executeX-Api-Keycurl --request POST \
--url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_facebook_search_posts' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"cursor": "{\"page_number\": 1, \"flow_cursors_serialized\": {\"INTERNAL_DEBUG_MODULE\": \"{}\", \"SEARCH_CONTROLS_INTERCEPT\": \"{}\", \"INTEGRITY\": \"{}\", \"SHORTCUT_DEEP_DIVE\": \"{}\", \"SPELLER\": \"{}\", \"HASHTAG_HEADER\": \"{}\", \"HASHTAG_CACHED_CONTENT\": \"{}\", \"POSTS_TAB_UNICORN_CACHE\": \"{}\", \"POSTS_TAB\": \"{\\\"has_more_results\\\": true, \\\"browse_cursor_serialized\\\": \\\"Abp2Ij0fy6ltZ2QY6dYjRPvGXbJBviq6LF-1EtS2CaeUva-TN-g5U1omzQdZ_BZ36Fsivy8HgqVFHbM396WmbMsdokUJZSPmG3gCs0WiDXH8y2IyapFA8CUagiNi-rAyqbV93TOm8x4NGpH0dDR2f0z4Kou9jOHaIdgkoBOpdOHZFVCGVIE2ozohkh1NpCZWzwKLJjUM57ONr4tyTCGHBTclcbAa9-2vko0DDl8bxeBuQ_ptL9TloxMXaw-OYLJI_iRJPA5h9w3-1_I64G8ujuMyRTDwRR3Y7-GPB7sQTbm5RUa4Ttkf2OcL84nA3xORdrZ8BDhY_Njqe8mjW4njUcmrPvYCh5YExo6B51FbDbnEAZNOXu5Q-xmBFHrc3P1YDXDN2k-5Ku40L-84Pe5ITIwfCL7jm9JTV2jTjboHu-MekvwruVjtxIdQ05WsykjWd9NLGFEuXysFKD4oZX5dr6IU_WRP8q6ISAz-Da9c8JRCXOvI90ndMdRaaaP5-Vfs0QP-2ryNDYV2nXnP5btz9tJx0tMhNE_1g7FocCBHR-oCJ0kIuIXYu5x9vueNOAOJStJzmkqCGWsMjsssV2vLhteTVaYtDzOp3qSLyd11ILUTntZz68ywIbrt3licEpDGYsg\\\", \\\"processed_unicorn_ids\\\": [], \\\"is_end_of_serp\\\": false}\", \"LOLA_BACKFILL\": \"{}\", \"PARALLEL_FETCH_NOOP\": \"{}\"}, \"result_ids_shown\": [], \"unit_id_logging_fields\": {\"num_total_modules\": 12, \"num_total_results\": 12, \"num_total_vertical_results\": 12}, \"entity_ids_shown_by_type\": {}, \"processed_unicorn_ids\": [], \"completed_flows\": [\"INTERNAL_DEBUG_MODULE\", \"SEARCH_CONTROLS_INTERCEPT\", \"INTEGRITY\", \"SHORTCUT_DEEP_DIVE\", \"SPELLER\", \"HASHTAG_HEADER\", \"HASHTAG_CACHED_CONTENT\", \"POSTS_TAB_UNICORN_CACHE\"], \"custom_cursors_serialized\": {}}",
"endDate": "2026-11-04",
"keyword": "Triton Poker",
"startDate": "2026-10-29"
}
}'{
"code": 0,
"data": {
"cursor": null,
"results": [
{
"album_preview": null,
"associated_group": null,
"associated_group_id": null,
"message": "Santosh Suvarna was the only Indian to make the Final Table at Triton Poker’s Super High Roller series. \n\nREAD MORE: https://bit.ly/3DltsuI\n\n#TritonPoker #PokerLive #GutshotMagazine Triton Poker",
"type": "post",
"url": "https://www.facebook.com/GutshotMagazine/posts/pfbid0C5ur2diC74twSiv4549tkVPujkhsePXHHivasfut26vWsdQwnXvydBa4BXHVUYYnl"
}
]
},
"message": null,
"recordTime": "2026-11-05T15:39:04.045416634",
"requestParams": {
"body": null,
"query": {
"cursor": "{\"completed_flows\":[\"INTERNAL_DEBUG_MODULE\"],\"custom_cursors_serialized\":{},\"entity_ids_shown_by_type\":{},\"flow_cursors_serialized\":{\"HASHTAG_CACHED_CONTENT\":\"{}\",\"HASHTAG_HEADER\":\"{}\",\"INTEGRITY\":\"{}\",\"INTERNAL_DEBUG_MODULE\":\"{}\",\"LOLA_BACKFILL\":\"{}\",\"PARALLEL_FETCH_NOOP\":\"{}\"},\"page_number\":1,\"processed_unicorn_ids\":[]}",
"endDate": "2026-11-04",
"keyword": "Triton Poker",
"startDate": "2026-10-29"
}
}
}This example shows part of the response. Copied content is valid JSON.





