탐색으로 건너뛰기

Toutiao guides

To decide which steps of a setup guide to improve, read the Toutiao article with toutiao.app.get_article_info, read the article’s comments with toutiao.app.get_comments, and give your teammate a revision list in which every row carries the comment excerpt, the article link and the request ID. To credit the right publisher, check the author profile with toutiao.app.get_user_id and toutiao.app.get_user_info.

Verify which version the article covers

Take the post ID from a link such as https://www.toutiao.com/article/123/, and replace the example ID 123 with the actual ID. Send the JSON bodies below to POST https://api.beatapi.io/v1/social-data/call with BeatAPI Bearer authentication.

{"action":"toutiao.app.get_article_info","params":{"group_id":"123"}}

Check that the response matches the article, and save the title, the version, the URL and the request ID. If the article shows an older menu, add a version column to the comment sheet so you can compare experiences with the old and new versions.

Read comments on the same article

{"action":"toutiao.app.get_comments","params":{"group_id":"123","offset":"0"}}

After a successful read, look for comments about setup. For another batch, keep the same group_id and pass the string "20" as the next offset. When you have enough material, or the results are empty or repeated, record the batch you stopped at and the reason.

Turn comments into a revision list

Example commentWhat to check in the articleNext step for the documentation team
“This button is gone in the new version”The version and screenshot used in the guideVerify the new location and add a screenshot
“Which cable should I plug in first?”Whether the steps specify the orderAdd a diagram that shows the order

Keep the article URL, the exact excerpt, the version checked and the comment request ID on each row. A reply that only says “Same question” needs the parent comment’s context before you group the reply. The article request and each comment request are billed separately. Choose the right ID or check comment offsets· BeatAPI pricing

Several articles have the same title. How do I credit the right source?

When a teammate shares an installation article and you find several articles with the same title, check the article and the publisher separately:

  1. Read the original article with the article’s group_id, and record the title, the publication date and the byline.
  2. If you can confirm the matching Toutiao profile, send the profile’s full URL to toutiao.app.get_user_id from the same API client.
{"action":"toutiao.app.get_user_id","params":{"user_profile_url":"<full Toutiao profile URL>"}}
  1. Check the returned user_id, then check the profile with {"action":"toutiao.app.get_user_info","params":{"user_id":"<confirmed user ID>"}}.
  2. Give the editor two columns: the posting account, and the credited author or source. If the posting account and the credited source differ, keep both and verify the original source before merging your records.

The home appliance installation story on Toutiao is an example of an article that displays both a posting account and a credited source.

To hand the check to an AI assistant, ask: “Check the posting account, byline and date on each link. Pull out questions about installation steps, give me the source link for each one, and turn them into a revision list.” If the author profile is missing, build the revision list from the confirmed articles and comments and flag the account for follow-up.

Make a request file from the article URL

When a teammate supplies an article URL for your script, validate the URL before building the request. build_request.py accepts a full HTTPS article URL in the /article/<id>/ form. For a short share link, open the link first and confirm which article the link leads to. Run build_request.py in a new folder for each article so the request and response files stay paired.

Save the script below as build_request.py. Replace the example URL with your article URL before sending the request.

import json
import re
import sys
from urllib.parse import urlsplit
source_url = sys.argv[1].strip()
url = urlsplit(source_url)
match = re.fullmatch(r"/article/([0-9]+)/?", url.path)
if url.scheme != "https" or url.netloc.lower() not in {"toutiao.com", "www.toutiao.com"} or not match:
raise SystemExit("Use the verified full Toutiao article URL.")
with open("article-request.json", "x", encoding="utf-8") as output:
json.dump({"action":"toutiao.app.get_article_info","params":{"group_id":match[1]}}, output)
python3 build_request.py 'https://www.toutiao.com/article/123/' &&
curl --fail-with-body -sS https://api.beatapi.io/v1/social-data/call \
-H "Authorization: Bearer $BEATAPI_API_KEY" \
-H 'Content-Type: application/json' \
--data-binary @article-request.json -o article-response.json

Check that the response belongs to the original article

Save the input article URL beside article-request.json and article-response.json. Check the response status and the request ID, and compare the returned title and publisher with the original link before quoting the article or reading the article’s comments. If the response fails or the article’s identity is unclear, keep the item open for review. Compare article and video IDs