Facebook Search Posts

34.92 credits/call
ae_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.

Social
34.92 credits/call

Pricing

34.92 credits/call
ConditionCharge
Each call34.92 credits/call

Parameters

Optional parameters use the platform defaults when omitted.

ParameterTypeRequiredDescriptionDefault
cursorstringNo用于获取下一组结果的分页游标。""
endDatestringNo搜索范围的结束日期(包含),格式为 yyyy-MM-dd。—
keywordstringYes用于在公开帖子中搜索的关键词。支持基础文本匹配。—
startDatestringNo搜索范围的开始日期(包含),格式为 yyyy-MM-dd。—

Invocation example

Copy the request and explore its response example.

POST/agent-api/v1/tool/executeX-Api-Key
Request coderequest.sh
curl --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"
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "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.