---
document_id: agent.collection.task.facebook_search_posts_v1
schema_version: 2
parent_document_id: agent.querying
section: querying
---

<!-- Generated by scripts.build_agent_guide; do not edit. -->

# Search posts / 搜索帖子

Search Facebook posts with an optional absolute date range and opaque-token pagination.

按关键词搜索 Facebook 帖子，可选绝对日期范围，并使用不透明令牌翻页。

Task / 任务: `facebook_search_posts_v1`
Platform / 平台: Facebook / Facebook
Billing / 计费: 60 Credits per successful task / 每个成功任务 60 Credits
Access / 调用方式: this source is available through the Search API only; call `POST /v1/search` with `source`, then read `GET /v1/search/{job_id}`. It is not listed by `list_collection_tasks` and `describe_collection_task` does not answer for it.
调用方式：该来源仅通过 Search API 提供；用 `source` 调用 `POST /v1/search`，再用 `GET /v1/search/{job_id}` 读取结果。它不出现在 `list_collection_tasks` 中，`describe_collection_task` 也不返回它。

## Limitations / 限制

- One fixed marketplace data route is called per task; no automatic version fallback or cross-platform fan-out is performed.
- Returned data is bounded and projected into task-specific public fields; missing fields are not inferred.
- Each successful request is charged once by the configured Asklear task price.
- Production exposure requires the configured marketplace data connection and bounded live acceptance evidence.

## Inputs / 输入

- `query` — Query / 查询词; kind=text; required=True; default=''; bounds=min_length=1, max_length=100
- `page_token` — Page token / 页面令牌; kind=page_token; required=False; default=''; bounds=max_length=4096
- `filters.time_range` — Time range / 时间范围; kind=text; required=False; default=''; bounds=max_length=64; allowed=custom:YYYY-MM-DD:YYYY-MM-DD

## Minimal call / 最小调用

`search`

```json
{
  "source": "facebook",
  "query": "搜索 Facebook 上关于扫地机器人的帖子"
}
```


## Result and pagination / 结果与分页

- 分页方式：不透明令牌翻页。`page_token` 传入，下一页用 `pagination.next_page_token` 传回。

Search results are returned under `data.items`, with page state under `data.pagination`. /
Search 结果位于 `data.items`，分页状态位于 `data.pagination`。

Only the fields listed below are part of this source's stable Search result contract. /
只有下方列出的字段属于此来源的稳定 Search 结果契约。

## Result fields / 结果字段

- `meta.request_id` — type=string; Asklear request identifier for tracing. / 用于追踪的 Asklear 请求 ID。
- `meta.latency_ms` — type=integer; Search execution latency in milliseconds. / 搜索执行耗时（毫秒）。
- `meta.credits_charged` — type=integer; Asklear Credits settled for this search after completion. / 搜索完成后 Asklear 实际结算的 Credits。
- `data.items` — type=array<object>; Search result items returned by this page. / 本页返回的搜索结果条目。
- `data.pagination` — type=object; Search pagination state and the next-page token. / 搜索分页状态及下一页令牌。

This source is published by the Search API. Use `POST /v1/search` and `GET /v1/search/{job_id}`; it has no generic Collection entry point. /
该来源由 Search API 发布，请使用 `POST /v1/search` 与 `GET /v1/search/{job_id}`；它没有通用采集入口。