toptik-app API
toptik-app API as documented publicly: 33 operations. Contract generated from the documentation by API Evangelist (2026-10-31); not the provider's own document.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/toptik-app:toptik-app-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.1.0
info:
title: toptik-app API
version: '2026-10-31'
description: 'GENERATED FROM DOCUMENTATION by API Evangelist on 2026-10-31: 33 operation(s) read from 4 public documentation page(s) (each operation
names its page in x-source). This is not the provider''s published contract; toptik-app has published no machine-readable contract that the
pipeline could find. Engine: anthropic.'
x-evidence-tiers:
code-example: 2
documentation: 31
pages-with-code: 4
pages-read: 4
x-generated-from: documentation
x-provenance: generated
x-authored-by: API Evangelist
x-generated: '2026-10-31'
x-generator: generate-contract-from-docs.py
x-engine: anthropic
x-sources:
- https://toptik.app/docs
- https://toptik.app/monitoring
- https://toptik.app/transcripts
- https://toptik.app/live
paths:
/v1/feed/explore:
get:
operationId: get_v1_feed_explore
tags:
- Feed
summary: 'TikTok''s Explore feed: what is trending now, not personalised.'
x-source: https://toptik.app/docs
parameters:
- name: count
in: query
required: false
schema:
type: integer
responses:
'200':
description: Success (status as documented)
x-evidence:
kind: documentation
/v1/hashtags/{id}:
get:
operationId: get_v1_hashtags_id
tags:
- Hashtags
summary: One hashtag by challenge id.
x-source: https://toptik.app/docs
parameters:
- name: id
in: path
required: true
schema:
type: string
responses:
'200':
description: Success (status as documented)
x-evidence:
kind: documentation
/v1/hashtags/{id}/videos:
get:
operationId: get_v1_hashtags_id_videos
tags:
- Hashtags
summary: Videos under a hashtag.
x-source: https://toptik.app/docs
parameters:
- name: id
in: path
required: true
schema:
type: string
- name: count
in: query
required: false
schema:
type: integer
description: 1–30, default 20
- name: cursor
in: query
required: false
schema:
type: integer
description: default 0
responses:
'200':
description: Success (status as documented)
x-evidence:
kind: documentation
/v1/live/alive:
get:
operationId: get_v1_live_alive
tags:
- Live
summary: 'Batch liveness: which of these rooms are still streaming.'
x-source: https://toptik.app/docs
parameters:
- name: room_ids
in: query
required: true
schema:
type: string
responses:
'200':
description: Success (status as documented)
x-evidence:
kind: documentation
/v1/live/rooms/{id}/gifts:
get:
operationId: get_v1_live_rooms_id_gifts
tags:
- Live
summary: The gift catalogue for a room.
x-source: https://toptik.app/docs
parameters:
- name: id
in: path
required: true
schema:
type: string
responses:
'200':
description: Success (status as documented)
x-evidence:
kind: documentation
/v1/live/streams:
get:
operationId: get_v1_live_streams
tags:
- Live
summary: Live rooms for a keyword, each with playable stream URLs, title and viewer count.
x-source: https://toptik.app/docs
parameters:
- name: q
in: query
required: true
schema:
type: string
description: ≤ 80 chars
- name: count
in: query
required: false
schema:
type: integer
description: 1–30, default 20
responses:
'200':
description: Success (status as documented)
x-evidence:
kind: documentation
/v1/live/users/{id}:
get:
operationId: get_v1_live_users_id
tags:
- Live
summary: Is this creator live right now, and in which room.
x-source: https://toptik.app/docs
parameters:
- name: id
in: path
required: true
schema:
type: string
- name: sec_uid
in: query
required: false
schema:
type: string
responses:
'200':
description: Success (status as documented)
x-evidence:
kind: documentation
/v1/music/resolve:
get:
operationId: get_v1_music_resolve
tags:
- Music
summary: A sound's title to its music id, with close candidates.
x-source: https://toptik.app/docs
parameters:
- name: title
in: query
required: true
schema:
type: string
description: ≤ 80 chars
responses:
'200':
description: Success (status as documented)
x-evidence:
kind: documentation
/v1/music/{id}/videos:
get:
operationId: get_v1_music_id_videos
tags:
- Music
summary: 'Videos TikTok associates with a sound: a feed seeded by the sound, not a strict filter.'
x-source: https://toptik.app/docs
parameters:
- name: id
in: path
required: true
schema:
type: string
- name: count
in: query
required: false
schema:
type: integer
description: 1–30
- name: cursor
in: query
required: false
schema:
type: integer
description: default 0
responses:
'200':
description: Success (status as documented)
x-evidence:
kind: documentation
/v1/places/{id}:
get:
operationId: get_v1_places_id
tags:
- Places
summary: 'A place''s landing page: its videos, reviews and nearby places.'
x-source: https://toptik.app/docs
parameters:
- name: id
in: path
required: true
schema:
type: string
- name: group_id
in: query
required: false
schema:
type: string
responses:
'200':
description: Success (status as documented)
x-evidence:
kind: documentation
/v1/places/{id}/reviews:
get:
operationId: get_v1_places_id_reviews
tags:
- Places
summary: A place's reviews.
x-source: https://toptik.app/docs
parameters:
- name: id
in: path
required: true
schema:
type: string
- name: count
in: query
required: false
schema:
type: integer
description: 1–30, default 20
- name: cursor
in: query
required: false
schema:
type: integer
description: default 0
responses:
'200':
description: Success (status as documented)
x-evidence:
kind: documentation
/v1/playlists/{id}:
get:
operationId: get_v1_playlists_id
tags:
- Playlists
summary: 'One playlist''s card: name, cover, item count, play stats.'
x-source: https://toptik.app/docs
parameters:
- name: id
in: path
required: true
schema:
type: string
- name: uid
in: query
required: true
schema:
type: string
- name: sec_uid
in: query
required: false
schema:
type: string
responses:
'200':
description: Success (status as documented)
x-evidence:
kind: documentation
/v1/search/hashtags:
get:
operationId: get_v1_search_hashtags
tags:
- Search
summary: Hashtag tab.
x-source: https://toptik.app/docs
parameters:
- name: q
in: query
required: true
schema:
type: string
- name: count
in: query
required: false
schema:
type: integer
- name: cursor
in: query
required: false
schema:
type: integer
responses:
'200':
description: Success (status as documented)
x-evidence:
kind: documentation
/v1/search/live:
get:
operationId: get_v1_search_live
tags:
- Search
summary: Search live rooms by keyword.
x-source: https://toptik.app/docs
parameters:
- name: q
in: query
required: true
schema:
type: string
- name: count
in: query
required: false
schema:
type: integer
- name: offset
in: query
required: false
schema:
type: integer
responses:
'200':
description: Success (status as documented)
x-evidence:
kind: documentation
/v1/search/music:
get:
operationId: get_v1_search_music
tags:
- Search
summary: Music tab.
x-source: https://toptik.app/docs
parameters:
- name: q
in: query
required: true
schema:
type: string
- name: count
in: query
required: false
schema:
type: integer
- name: cursor
in: query
required: false
schema:
type: integer
responses:
'200':
description: Success (status as documented)
x-evidence:
kind: documentation
/v1/search/photos:
get:
operationId: get_v1_search_photos
tags:
- Search
summary: Search photo-mode posts.
x-source: https://toptik.app/docs
parameters:
- name: q
in: query
required: true
schema:
type: string
- name: count
in: query
required: false
schema:
type: integer
- name: seen
in: query
required: false
schema:
type: string
- name: since
in: query
required: false
schema:
type: integer
responses:
'200':
description: Success (status as documented)
x-evidence:
kind: documentation
/v1/search/suggest:
get:
operationId: get_v1_search_suggest
tags:
- Search
summary: Search suggestions for a partial query.
x-source: https://toptik.app/docs
parameters:
- name: q
in: query
required: true
schema:
type: string
- name: count
in: query
required: false
schema:
type: integer
responses:
'200':
description: Success (status as documented)
x-evidence:
kind: documentation
/v1/search/top:
get:
operationId: get_v1_search_top
tags:
- Search
summary: 'Top tab: mixed videos and user cards.'
x-source: https://toptik.app/docs
parameters:
- name: q
in: query
required: true
schema:
type: string
- name: count
in: query
required: false
schema:
type: integer
- name: cursor
in: query
required: false
schema:
type: integer
- name: sort_type
in: query
required: false
schema:
type: integer
- name: publish_time
in: query
required: false
schema:
type: integer
- name: seen
in: query
required: false
schema:
type: string
- name: since
in: query
required: false
schema:
type: integer
responses:
'200':
description: Success (status as documented)
x-evidence:
kind: documentation
/v1/search/users:
get:
operationId: get_v1_search_users
tags:
- Search
summary: Search creators by keyword.
x-source: https://toptik.app/docs
parameters:
- name: q
in: query
required: true
schema:
type: string
- name: count
in: query
required: false
schema:
type: integer
- name: cursor
in: query
required: false
schema:
type: integer
- name: offset
in: query
required: false
schema:
type: integer
responses:
'200':
description: Success (status as documented)
x-evidence:
kind: documentation
/v1/search/videos:
get:
operationId: get_v1_search_videos
tags:
- Search
summary: Videos tab.
x-source: https://toptik.app/docs
parameters:
- name: q
in: query
required: true
schema:
type: string
- name: count
in: query
required: false
schema:
type: integer
- name: cursor
in: query
required: false
schema:
type: integer
- name: sort_type
in: query
required: false
schema:
type: integer
- name: publish_time
in: query
required: false
schema:
type: integer
- name: seen
in: query
required: false
schema:
type: string
- name: since
in: query
required: false
schema:
type: integer
responses:
'200':
description: Success (status as documented)
x-evidence:
kind: documentation
/v1/users/{id}:
get:
operationId: get_v1_users_id
tags:
- Users
summary: A creator's profile, with a flat `profile` block for the fields you actually want.
x-source: https://toptik.app/docs
parameters:
- name: id
in: path
required: true
schema:
type: string
responses:
'200':
description: Success (status as documented)
x-evidence:
kind: documentation
/v1/users/{id}/favorites:
get:
operationId: get_v1_users_id_favorites
tags:
- Users
summary: A user's liked videos, when public.
x-source: https://toptik.app/docs
parameters:
- name: id
in: path
required: true
schema:
type: string
- name: count
in: query
required: false
schema:
type: integer
- name: cursor
in: query
required: false
schema:
type: integer
responses:
'200':
description: Success (status as documented)
x-evidence:
kind: documentation
/v1/users/{id}/followers:
get:
operationId: get_v1_users_id_followers
tags:
- Users
summary: A user's followers.
x-source: https://toptik.app/docs
parameters:
- name: id
in: path
required: true
schema:
type: string
- name: count
in: query
required: false
schema:
type: integer
- name: cursor
in: query
required: false
schema:
type: integer
- name: offset
in: query
required: false
schema:
type: integer
- name: pair_id
in: query
required: false
schema:
type: string
responses:
'200':
description: Success (status as documented)
x-evidence:
kind: documentation
/v1/users/{id}/following:
get:
operationId: get_v1_users_id_following
tags:
- Users
summary: Who a user follows.
x-source: https://toptik.app/docs
parameters:
- name: id
in: path
required: true
schema:
type: string
- name: count
in: query
required: false
schema:
type: integer
- name: cursor
in: query
required: false
schema:
type: integer
- name: offset
in: query
required: false
schema:
type: integer
- name: pair_id
in: query
required: false
schema:
type: string
responses:
'200':
description: Success (status as documented)
x-evidence:
kind: documentation
/v1/users/{id}/playlists:
get:
operationId: get_v1_users_id_playlists
tags:
- Users
summary: A creator's playlists (TikTok calls them mixes / video series).
x-source: https://toptik.app/docs
parameters:
- name: id
in: path
required: true
schema:
type: string
- name: cursor
in: query
required: false
schema:
type: integer
- name: pair_id
in: query
required: false
schema:
type: string
responses:
'200':
description: Success (status as documented)
x-evidence:
kind: documentation
/v1/users/{id}/videos:
get:
operationId: get_v1_users_id_videos
tags:
- Users
summary: A user's posts.
x-source: https://toptik.app/docs
parameters:
- name: id
in: path
required: true
schema:
type: string
- name: count
in: query
required: false
schema:
type: integer
description: 1–35, default 20
- name: cursor
in: query
required: false
schema:
type: integer
description: default 0
responses:
'200':
description: Success (status as documented)
x-evidence:
kind: documentation
/v1/videos:
get:
operationId: get_v1_videos
tags:
- Videos
summary: Several videos in one call.
x-source: https://toptik.app/docs
parameters:
- name: ids
in: query
required: true
schema:
type: string
description: ≤ 800 chars
responses:
'200':
description: Success (status as documented)
x-evidence:
kind: documentation
/v1/videos/{id}/comments:
get:
operationId: get_v1_videos_id_comments
tags:
- Videos
summary: A video's comments.
x-source: https://toptik.app/docs
parameters:
- name: id
in: path
required: true
schema:
type: string
- name: count
in: query
required: false
schema:
type: integer
description: 1–50, default 20
- name: cursor
in: query
required: false
schema:
type: integer
description: default 0
- name: seen
in: query
required: false
schema:
type: string
description: ≤ 20000 chars
- name: session
in: query
required: false
schema:
type: string
description: ≤ 64 chars
responses:
'200':
description: Success (status as documented)
x-evidence:
kind: documentation
/v1/videos/{id}/comments/{commentId}/replies:
get:
operationId: get_v1_videos_id_comments_commentId_replies
tags:
- Videos
summary: Replies under one comment.
x-source: https://toptik.app/docs
parameters:
- name: id
in: path
required: true
schema:
type: string
- name: commentId
in: path
required: true
schema:
type: string
- name: count
in: query
required: false
schema:
type: integer
description: 1–50, default 20
- name: cursor
in: query
required: false
schema:
type: integer
description: default 0
responses:
'200':
description: Success (status as documented)
x-evidence:
kind: documentation
/v1/videos/{id}/description/translate:
get:
operationId: get_v1_videos_id_description_translate
tags:
- Videos
summary: A video's description, translated.
x-source: https://toptik.app/docs
parameters:
- name: id
in: path
required: true
schema:
type: string
- name: lang
in: query
required: false
schema:
type: string
description: default en
responses:
'200':
description: Success (status as documented)
x-evidence:
kind: documentation
/v1/videos/{id}/download:
get:
operationId: get_v1_videos_id_download
tags:
- Videos
summary: 'Every downloadable asset for one post: no-watermark video, watermarked video, audio, covers, captions.'
x-source: https://toptik.app/docs
parameters:
- name: id
in: path
required: true
schema:
type: string
responses:
'200':
description: Success (status as documented)
x-evidence:
kind: documentation
/v1/videos/{id}/music/related:
get:
operationId: get_v1_videos_id_music_related
tags:
- Videos
summary: Music recommended for a video.
x-source: https://toptik.app/docs
parameters:
- name: id
in: path
required: true
schema:
type: string
responses:
'200':
description: Success (status as documented)
x-evidence:
kind: documentation
/v1/videos/{id}/subtitles:
get:
operationId: get_v1_videos_id_subtitles
tags:
- Videos
summary: A video's captions translated into another language, as WebVTT.
x-source: https://toptik.app/docs
parameters:
- name: id
in: path
required: true
schema:
type: string
- name: subtitle_id
in: query
required: false
schema:
type: string
- name: lang
in: query
required: false
schema:
type: string
description: default en
responses:
'200':
description: Success (status as documented)
x-evidence:
kind: documentation
components:
securitySchemes:
apiKey:
type: apiKey
in: header
name: X-RapidAPI-Key
security:
- apiKey: []
tags:
- name: Feed
- name: Hashtags
- name: Live
- name: Music
- name: Places
- name: Playlists
- name: Search
- name: Users
- name: Videos