Posts by topic
Get the current page of TikTok or Pipixia topic posts, preserving multiple images and mixed media without automatic pagination. Other platforms are not currently available.
Start with your agent
Download and install the dedicated Mouter Skill for “Posts by topic”: https://mouter.ai/skills/topic_posts.zip
Pricing
0.01 credits per call
Each additional page is billed as a separate call.
Usage example
Agent
Example input
Use topic_posts. Look up Posts by topic using platform tiktok, topic ID 123456789 and summarize posts linked to a topic or music track. Confirm inputs and estimated cost before running.
Example output
Example only: Posts by topic has not been run. Once a task succeeds, its result contains these fields:
- platformtext
- music_idtext
- topic_idtext
- itemslist: audio_tracks, music, topics, id, url
- returned_countnumber
- paginationobject: has_more, next_cursor, total
- retrieved_atnumber
Values depend on your input. The matching JSON example structure is in the API tab.
Continue this example
For the first batch, omit cursor. When pagination.has_more indicates more results and pagination.next_cursor is present, pass the returned pagination.next_cursor as cursor in the next call. Keep the original identifiers, filters and ordering unchanged. Each request retrieves one batch. Illustrative requests and response fragment; no calls are executed.
1. Initial request
{
"name": "topic_posts",
"arguments": {
"platform": "tiktok",
"topic_id": "123456789"
}
}2. Returned continuation
{
"pagination": {
"next_cursor": "<NEXT_CURSOR>",
"has_more": true
}
}3. Follow-up request
{
"name": "topic_posts",
"arguments": {
"platform": "tiktok",
"topic_id": "123456789",
"cursor": "<NEXT_CURSOR>"
}
}- Getting started: provide platform, topic ID. Adjust continuation cursor, result count as needed.
FAQ
Which platform / topic_id should I pass to Posts by topic?
Posts by topic: Getting started: provide platform, topic ID. Adjust continuation cursor, result count as needed. platform: values tiktok / pipixia · topic_id: 1–128 characters; format ^[0-9]+$ Illustrative values on this page: platform="tiktok", topic_id="123456789". Replace example identifiers and URLs with your target before running.
Which result details can I use from Posts by topic?
Get the current page of TikTok or Pipixia topic posts, preserving multiple images and mixed media without automatic pagination. Other platforms are not currently available. The result includes music_id, topic_id, items, returned_count, pagination. Read result.items[]: id, url, title, text, content_html, author, published_at, published_at_text, cover_url, media. result.retrieved_at records retrieval time; content publication times are separate source fields. Optional fields depend on what the source returns; retain null or missing values when combining results.
How do I retrieve more results from Posts by topic?
Posts by topic: For the first batch, omit cursor. When pagination.has_more indicates more results and pagination.next_cursor is present, pass the returned pagination.next_cursor as cursor in the next call. Keep the original identifiers, filters and ordering unchanged. Each request retrieves one batch.
How is Posts by topic billed for each request?
Published reference rates: Standard rate: 0.01 credits · Per call. Each additional page is billed as a separate call. Final charges use your account’s rates and actual usage.