TikTok tools

TikToktiktok_top_videos

TikTok top video rankings

Browse TikTok top videos by period, region and category for viral-content research, international content planning and niche video benchmarking; sorting and pagination are supported, with at most 100 videos per chart.

Start with your agent

Claude CodeCodexCursor

Download and install the dedicated Mouter Skill for “TikTok top video rankings”: https://mouter.ai/skills/tiktok_top_videos.zip

Pricing

How credits work

0.01 credits per call

Each additional page is billed as a separate call.

Usage example

Agent

Example input

Use tiktok_top_videos. Look up TikTok top video rankings using period_end_timestamp 1762560000 and summarize trending charts, ranks and related content. Confirm inputs and estimated cost before running.

Example output

Example only: TikTok top video rankings has not been run. Once a task succeeds, its result contains these fields:

  1. platformtext
  2. itemslist: id, variants, video_id, cover_url, url
  3. paginationobject: has_more, next_cursor, total
  4. 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": "tiktok_top_videos",
  "arguments": {
    "period_end_timestamp": 1762560000
  }
}

2. Returned continuation

{
  "pagination": {
    "next_cursor": "<NEXT_CURSOR>",
    "has_more": true
  }
}

3. Follow-up request

{
  "name": "tiktok_top_videos",
  "arguments": {
    "period_end_timestamp": 1762560000,
    "cursor": "<NEXT_CURSOR>"
  }
}
  • Getting started: provide period-end timestamp. Adjust country or region, continuation cursor, result count as needed.

FAQ

Which period_end_timestamp should I pass to TikTok top video rankings?

TikTok top video rankings: Getting started: provide period-end timestamp. Adjust country or region, continuation cursor, result count as needed. period_end_timestamp: range 1000000000–9999999999 Illustrative values on this page: period_end_timestamp=1762560000. Replace example identifiers and URLs with your target before running.

Which result details can I use from TikTok top video rankings?

Browse TikTok top videos by period, region and category for viral-content research, international content planning and niche video benchmarking; sorting and pagination are supported, with at most 100 videos per chart. The result includes items, pagination. Read result.items[]: id, variants, video_id, cover_url, url, title, published_at, author, statistics, lifetime_statistics. 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.

Which regions and filters can I choose for TikTok top video rankings?

TikTok top video rankings: country_code: format ^[A-Z]{2}$; default "US" · period_dimension: values 1 / 3 / 5; default 3 · content_label_ids: up to 15 entries · order_by_metric: values 1 / 2 / 3; default 1.

How do I retrieve more results from TikTok top video rankings?

TikTok top video rankings: 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 TikTok top video rankings 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.