# Compare X trend samples across regions

Compare X trend samples across regions. Follow concrete contracts, examples and reviewable steps using X (Twitter).

Canonical page: https://datanavoapi.com/en/guides/x-trends-by-country/

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

## Task goal

Compare X trend samples across regions. 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

Compare X trend samples across regions. 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.trends.list | board | trend / items |

| 2 | x.trends.list | board | trend / items |

- [X trends](https://datanavoapi.com/en/apis/x/trends/list/)
- [X trends](https://datanavoapi.com/en/apis/x/trends/list/)

## 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: Compare X trend samples across regions
Use only DataNavoAPI local demo/simulated mode.
Planned capabilities: x.trends.list → x.trends.list
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 |

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

| step1_board | 步骤 1 · board | trends |

| step1_region | 步骤 1 · region | US |

| step2_board | 步骤 2 · board | trends |

| step2_region | 步骤 2 · region | JP |

```json
{
  "schemaVersion": 1,
  "templateId": "guide-x-trends-by-country",
  "runId": "00000000-0000-4000-8000-000000000001",
  "inputs": {
    "step1_board": "trends",
    "step1_region": "US",
    "step2_board": "trends",
    "step2_region": "JP"
  },
  "maxTotalCredits": 4,
  "estimatedCredits": 4,
  "priceVersion": "test-credit-v1",
  "steps": [
    {
      "id": "step-1",
      "title": "X 趋势榜",
      "capability": "x.trends.list",
      "params": {
        "board": "trends",
        "region": "US"
      },
      "maxCredits": 2,
      "idempotencyKey": "wf:00000000-0000-4000-8000-000000000001:step-1"
    },
    {
      "id": "step-2",
      "title": "X 趋势榜",
      "capability": "x.trends.list",
      "params": {
        "board": "trends",
        "region": "JP"
      },
      "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-trends-by-country)
- [Download Skill instructions](https://datanavoapi.com/downloads/skills/guide-x-trends-by-country.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.trends.list\",\"method\":\"GET\",\"params\":{\"board\":\"trends\",\"region\":\"US\"}},{\"capability\":\"x.trends.list\",\"method\":\"GET\",\"params\":{\"board\":\"trends\",\"region\":\"JP\"}}]")
# 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 trends](https://datanavoapi.com/en/apis/x/trends/list/)
- [X (Twitter) APIs](https://datanavoapi.com/en/apis/x/)
- [X (Twitter) MCP](https://datanavoapi.com/en/mcp/x/)
- [Trend fields](https://datanavoapi.com/en/docs/objects/trend/)
- [How do I query X trends for a country?](https://datanavoapi.com/en/answers/how-to-get-x-trends-for-a-country/)
- [Cross-platform trend research workflow](https://datanavoapi.com/en/skills/trends/)

[中文](https://datanavoapi.com/guides/x-trends-by-country/)
