DataNavoAPI / GUIDES / DOUYIN

Query Douyin videos and accounts with Python

Query Douyin videos and accounts with Python. Follow concrete contracts, examples and reviewable steps using Douyin.

LOCAL SIMULATIONAll displayed records are fictional fixtures. Live APIs, payments and external email are disabled.中文版 ↗
01

Task goal

Query Douyin videos and accounts with Python. Follow concrete contracts, examples and reviewable steps using Douyin.

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

02

Inputs, goal and deliverable

Query Douyin videos and accounts with Python. Follow concrete contracts, examples and reviewable steps using Douyin.

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.

03

Step-by-step plan

StepCapabilityInputOutput
1douyin.videos.searchquery, sortpost / items
2douyin.videos.getidpost / item
3douyin.users.getidaccount / item
04

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: Query Douyin videos and accounts with Python
Use only DataNavoAPI local demo/simulated mode.
Planned capabilities: douyin.videos.search → douyin.videos.get → douyin.users.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.
05

Plan, run and export

This bounded example has 3 steps. Successful customer simulation costs 5 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 fieldMeaningExample
query研究关键词户外咖啡
step2_id步骤 2 · id7694940173372575014
step3_id步骤 3 · idMS4wLjABAAAAZ0aPDJzFhBrs0q3wVsp2a9WWrBuAUMsVyygoaO0bCw8
json
{
  "schemaVersion": 1,
  "templateId": "guide-douyin-api-python",
  "runId": "00000000-0000-4000-8000-000000000001",
  "inputs": {
    "query": "户外咖啡",
    "step2_id": "7694940173372575014",
    "step3_id": "MS4wLjABAAAAZ0aPDJzFhBrs0q3wVsp2a9WWrBuAUMsVyygoaO0bCw8"
  },
  "maxTotalCredits": 5,
  "estimatedCredits": 5,
  "priceVersion": "test-credit-v1",
  "steps": [
    {
      "id": "step-1",
      "title": "搜索抖音视频",
      "capability": "douyin.videos.search",
      "params": {
        "query": "户外咖啡",
        "sort": "relevance"
      },
      "maxCredits": 2,
      "idempotencyKey": "wf:00000000-0000-4000-8000-000000000001:step-1"
    },
    {
      "id": "step-2",
      "title": "抖音视频详情",
      "capability": "douyin.videos.get",
      "params": {
        "id": "7694940173372575014"
      },
      "maxCredits": 2,
      "idempotencyKey": "wf:00000000-0000-4000-8000-000000000001:step-2"
    },
    {
      "id": "step-3",
      "title": "获取抖音账号资料",
      "capability": "douyin.users.get",
      "params": {
        "id": "MS4wLjABAAAAZ0aPDJzFhBrs0q3wVsp2a9WWrBuAUMsVyygoaO0bCw8"
      },
      "maxCredits": 1,
      "idempotencyKey": "wf:00000000-0000-4000-8000-000000000001:step-3"
    }
  ]
}
06

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.
07

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\":\"douyin.videos.search\",\"method\":\"GET\",\"params\":{\"query\":\"户外咖啡\",\"sort\":\"relevance\"}},{\"capability\":\"douyin.videos.get\",\"method\":\"GET\",\"params\":{\"id\":\"7694940173372575014\"}},{\"capability\":\"douyin.users.get\",\"method\":\"GET\",\"params\":{\"id\":\"MS4wLjABAAAAZ0aPDJzFhBrs0q3wVsp2a9WWrBuAUMsVyygoaO0bCw8\"}}]")
# 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")
TRY THE CONTRACT

Clear inputs. Inspectable output.

Each click runs a local fixture. Advanced JSON inputs are checked against the selected method. Editing does not execute a request.

Copying does not execute. CLI quote is read-only and needs a local customer TEST key. Configure MCP in demo mode first. GET and POST batches both return only fictional local fixtures.

Download contract example (no execution) ↗

For TEST budgets, Key scopes or failure scenarios, open the account console. Customer sandbox ↗