# Search and organize X posts by keyword

Search and organize X posts by keyword. Follow concrete contracts, examples and reviewable steps using X (Twitter).

Canonical page: https://datanavoapi.com/en/guides/x-search-posts-by-keyword/

This is a local simulation. Program-generated samples are not live platform data and do not establish provider availability.

## Task goal

Search and organize X posts by keyword. Follow concrete contracts, examples and reviewable steps using X (Twitter).

This is a local simulation. Program-generated samples are not live platform data and do not establish provider availability.

## Inputs, goal and deliverable

Search and organize X posts by keyword. Follow concrete contracts, examples and reviewable steps using X (Twitter).

Inputs consist of explicit platforms, keywords or object identifiers. Preserve the samples, request IDs, classifications and unresolved questions in the deliverable. The task does not schedule itself or paginate indefinitely.

## Step-by-step plan

| Step | Capability | Input | Output |

| --- | --- | --- | --- |

| 1 | x.posts.search | query, sort | post / items |

| 2 | x.posts.get | id | post / item |

- [X post search](https://datanavoapi.com/en/apis/x/posts/search/)
- [X post detail](https://datanavoapi.com/en/apis/x/posts/get/)

## Reusable task prompt

Ask the client to present a plan before you confirm each execution. This prompt bounds the sample; it does not call an external service for you.

```text
Goal: Search and organize X posts by keyword
Use only DataNavoAPI local demo/simulated mode.
Planned capabilities: x.posts.search → x.posts.get
Describe inputs and output fields and propose a bounded request count first.
Execute explicitly, retaining request IDs. Stop on failures or unknown outcomes.
Return a table, missing fields and sampling limits; never present fictional samples as market facts.
```

## Plan, run and export

This bounded example has 2 steps. Successful customer simulation costs 4 TEST; anonymous demo costs zero. Provide each required identifier before generating a fixed plan; search results do not expand the request list automatically.

Use data.items[].id for the matching platform and object detail, account IDs for account content and comment IDs for replies. Check object types before reusing an ID. Fixture IDs do not establish a real relationship. The workbench exports per-step JSON and source-labelled CSV.

| Workbench field | Meaning | Example |

| --- | --- | --- |

| query | 研究关键词 | 户外咖啡 |

| step2_id | 步骤 2 · id | 2108198226532708497 |

```json
{
  "schemaVersion": 1,
  "templateId": "guide-x-search-posts-by-keyword",
  "runId": "00000000-0000-4000-8000-000000000001",
  "inputs": {
    "query": "户外咖啡",
    "step2_id": "2108198226532708497"
  },
  "maxTotalCredits": 4,
  "estimatedCredits": 4,
  "priceVersion": "test-credit-v1",
  "steps": [
    {
      "id": "step-1",
      "title": "搜索 X 公开帖子",
      "capability": "x.posts.search",
      "params": {
        "query": "户外咖啡",
        "sort": "latest"
      },
      "maxCredits": 2,
      "idempotencyKey": "wf:00000000-0000-4000-8000-000000000001:step-1"
    },
    {
      "id": "step-2",
      "title": "X 帖子详情",
      "capability": "x.posts.get",
      "params": {
        "id": "2108198226532708497"
      },
      "maxCredits": 2,
      "idempotencyKey": "wf:00000000-0000-4000-8000-000000000001:step-2"
    }
  ]
}
```

- [Open this task in the workbench](https://datanavoapi.com/tools/workflow-runner/?template=guide-x-search-posts-by-keyword)
- [Download Skill instructions](https://datanavoapi.com/downloads/skills/guide-x-search-posts-by-keyword.md)

## Review and stop conditions

- Each conclusion links back to a sample and request ID.
- Pagination stops at the agreed bound.
- Missing fields remain missing rather than being invented by the model.
- External writes, scheduled monitoring and automatic top-ups are not enabled by this workflow.

## Python bounded-task example

By default this prints the complete plan without network access. Add --execute-demo to run these fixed samples and export source-labelled JSON. Any failure stops execution; no automatic paging or request expansion occurs.

```python
import json
import sys
from urllib.request import ProxyHandler, Request, build_opener

steps = json.loads("[{\"capability\":\"x.posts.search\",\"method\":\"GET\",\"params\":{\"query\":\"户外咖啡\",\"sort\":\"latest\"}},{\"capability\":\"x.posts.get\",\"method\":\"GET\",\"params\":{\"id\":\"2108198226532708497\"}}]")
# Preview only by default. Run with --execute-demo to request this fixed demo sample.
print(json.dumps(steps, ensure_ascii=False, indent=2))
if sys.argv[1:] != ["--execute-demo"]:
    raise SystemExit("Preview only. No request was sent.")
opener = build_opener(ProxyHandler({}))
results = []
for step in steps:
    request = Request("https://datanavoapi.com/api/atlas-demo",
        data=json.dumps(step).encode(), method="POST",
        headers={"Content-Type": "application/json", "Origin": "https://datanavoapi.com"})
    with opener.open(request, timeout=10) as response:
        result = json.load(response)
    if result.get("meta", {}).get("mode") != "demo" or result.get("meta", {}).get("billing", {}).get("charged"):
        raise RuntimeError("Unexpected response; stop without retrying")
    results.append({"capability": step["capability"], "response": result})
# No fan-out, automatic paging or retries. Export retains each source contract.
with open("datanavo-task-results.json", "w", encoding="utf-8") as output:
    json.dump(results, output, ensure_ascii=False, indent=2)
print("Saved datanavo-task-results.json")
```

## Related pages

- [X post search](https://datanavoapi.com/en/apis/x/posts/search/)
- [X post detail](https://datanavoapi.com/en/apis/x/posts/get/)
- [X (Twitter) APIs](https://datanavoapi.com/en/apis/x/)
- [X (Twitter) MCP](https://datanavoapi.com/en/mcp/x/)
- [Post fields](https://datanavoapi.com/en/docs/objects/post/)
- [How do I keep API results within an AI context budget?](https://datanavoapi.com/en/answers/api-response-too-many-tokens/)
- [How do I choose data sources for a sentiment workflow?](https://datanavoapi.com/en/answers/bettafish-data-source/)
- [How can public social data support research?](https://datanavoapi.com/en/answers/chinese-social-media-alternative-data/)
- [How do I prepare social data for a Doubao workflow?](https://datanavoapi.com/en/answers/doubao-social-media-data/)

[中文](https://datanavoapi.com/guides/x-search-posts-by-keyword/)
