jsonscraper
← Developer toolsMODEL CONTEXT PROTOCOL

TikTok API.
Now in your assistant.

Connect public TikTok data to ChatGPT, Claude, Codex or another MCP client. Use your existing API key, plan and ready-to-use tools.

Connect MCP ↓Ready-to-use workflows ↓GitHub ↗
54 JSON toolsYour API keyStreamable HTTP · stdioMIT · 0.1.3
QUICK START

Choose where to work

Each product has its own connection. No additional license key is needed.

Contact support
MCP endpoint
https://jsonscraper.com/mcp/tiktok/server

Choose a connection method

Open ChatGPT in a browser on your computer or phone. Have your existing TikTok API key ready.

Upload a ready-made ZIP package

  1. Download the TikTok API archive below.
  2. Plugins → Add → Upload plugin archive: choose the downloaded ZIP and add the plugin.
  3. Install the plugin and connect with OAuth: enter your API key on the jsonscraper page.
Download ZIP ↓Open Plugins ↗

If ChatGPT asks you to add the MCP server separately, use the manual settings below.

Connect manually
  1. 1

    Open the connection form

    Plugins → Add → Add custom MCP server

    Open ChatGPT ↗
  2. 2

    Complete the form

    jsonscraper TikTok API
    Icon · optional

    PNG · 256 × 256 · under 10 KB

    Download icon ↓

    Download the PNG and upload it using the plus in the icon field. Copy the remaining values below.

    Name
    jsonscraper TikTok API
    Description · optional
    Public TikTok profiles, media, comments and search through the jsonscraper API.
    Server URL
    https://jsonscraper.com/mcp/tiktok/server
    Connection
    Server URL
    Authentication
    OAuth
    Advanced OAuth settings

    Paste the server URL first: OAuth settings are discovered automatically. Keep detected settings when they match the values below.

    Client registration
    Dynamic registration · DCR
    Client ID / Client Secret
    Leave empty
    Scope
    tiktok:read
    Authorization URL
    https://jsonscraper.com/mcp/tiktok/oauth/authorize
    Token URL
    https://jsonscraper.com/mcp/tiktok/oauth/token
    Registration URL
    https://jsonscraper.com/mcp/tiktok/oauth/register
    Authorization server · Issuer
    https://jsonscraper.com/mcp/tiktok/oauth
    Resource
    https://jsonscraper.com/mcp/tiktok/server

    Enter your API key on the jsonscraper authorization page after creating the connection.

  3. 3

    Save and authorize

    Acknowledge ChatGPT’s warning and select Create as a plugin. Open the new card and select Install. On the jsonscraper page, enter your TikTok API key and approve access.

    In chat, type @, select your connection and send a request.

Choose a ready-to-use workflow →

Try a first request
Message for ChatGPT
Read the public TikTok profile @therock and summarize the profile and available statistics. Use one API request.

Each tool call counts toward your normal API quota.

Connect in the desktop app

Settings → MCP servers → Add server → Streamable HTTP

Use the name and URL above. Select Save, then Restart and Authenticate. Enter your API key on the jsonscraper page.

If MCP servers is unavailable, follow the browser instructions above.

Desktop app guide ↗
Connect from your phone

Open ChatGPT in Safari, Chrome or another browser on your phone and follow the steps above. Add the server through the browser rather than the ChatGPT mobile app.

Missing a button or having trouble connecting?

Open Plugins in your browser. If the MCP creation option is absent, check account permissions or ask your workspace administrator.

If authorization fails, check that your key belongs to the TikTok API and is active. Reconnect after changing the key.

Get help in chat →

ChatGPT setup guide ↗

AFTER CONNECTING

Choose a task. Copy a prompt.

Enter a profile or topic, adjust the filters and send the prepared prompt to ChatGPT or Claude with your jsonscraper connector enabled.

Audit a profileFind top posts, content themes and practical improvements.

Up to 20 posts

Up to 4 API calls · public data

Ready-to-use prompt
Analyze the public TikTok profile therock using its 20 latest posts. Show 5 strong posts with available views, likes and comments. Explain which caption topics perform well and suggest 3 experiments.

Use jsonscraper TikTok API with at most 4 API calls. Include links, date and sample size; do not invent missing metrics.
Tools used
  • tiktok_get_user_info
  • tiktok_get_user_feed
  • tiktok_get_comments_by_id
Compare competitorsCompare public performance, topics and content differences.

Up to 3 profiles, 15 posts each

Up to 12 API calls · public data

Ready-to-use prompt
Compare up to 3 public TikTok profiles: therock, tiktok. Use 15 recent posts per profile. Return a table of followers and median views, likes and comments, followed by 3 content-topic differences and 3 experiments.

Use jsonscraper TikTok API with at most 12 API calls. Include links, date and sample size; do not invent missing metrics.
Tools used
  • tiktok_get_user_info
  • tiktok_get_user_feed
  • tiktok_get_comments_by_id
Find relevant creatorsBuild a short list with evidence of topic relevance.

Up to 5 candidates

Up to 12 API calls · public data

Ready-to-use prompt
Find up to 5 public TikTok creators about skincare with 10000–100000 followers. Give a profile link, follower count, available post examples and a brief relevance explanation based on the bio and captions.

Use jsonscraper TikTok API with at most 12 API calls. Include links, date and sample size; do not invent missing metrics.
Tools used
  • tiktok_search_user
  • tiktok_get_user_info
  • tiktok_get_user_feed
Find videos with filtersFilter by keywords, views, likes and date; choose the sort order.

Up to 80 search results

Up to 4 API calls · public data

Sort results
Ready-to-use prompt
Find public TikTok videos about skincare from the last 30 days with at least 10000 views and 500 likes. Check up to 80 search results. Sort by views and show up to 10 matching videos with URL, creator, date and available metrics. Search region: US.

Use jsonscraper TikTok API with at most 4 API calls. Include links, date and sample size; do not invent missing metrics. Apply filters to the retrieved sample. Exclude records missing a required metric. If few match, ask which filter to relax.
Tools used
  • tiktok_search_video
Understand commentsFind recurring questions, objections and response ideas.

Up to 100 comments

Up to 4 API calls · public data

Ready-to-use prompt
Analyze up to 100 public comments on [paste a public URL]. Identify recurring questions, objections and discussion themes. Give up to 5 short examples and 3 reply ideas. Do not post anything.

Use jsonscraper TikTok API with at most 4 API calls. Include links, date and sample size; do not invent missing metrics.
Tools used
  • tiktok_get_video_by_url
  • tiktok_get_comments_by_id
Find content ideasTurn caption themes and public performance into content tests.

20 posts, 5 ideas

Up to 4 API calls · public data

Ready-to-use prompt
Review up to 20 recent posts from TikTok profile therock. Use caption themes and available performance to suggest 5 content ideas. Give a topic, text hook, testable hypothesis and example link for each.

Use jsonscraper TikTok API with at most 4 API calls. Include links, date and sample size; do not invent missing metrics.
Tools used
  • tiktok_get_user_info
  • tiktok_get_user_feed
  • tiktok_get_comments_by_id
Create a comparison snapshotSave a current metrics table to compare with a later snapshot.

Snapshot of up to 20 posts

Up to 4 API calls · public data

Ready-to-use prompt
Prepare CSV text with the current public metrics for TikTok profile therock and up to 20 recent posts. Columns: UTC capture date, profile, post ID and URL, publication date, views, likes and comments. If I supplied a prior table, compare matching IDs; otherwise return only the current snapshot.

Use jsonscraper TikTok API with at most 4 API calls. Include links, date and sample size; do not invent missing metrics.
Tools used
  • tiktok_get_user_info
  • tiktok_get_user_feed
Get a precise result

Start with a small sample. Specify the topic, date range, metrics and output format. Numeric filters apply to retrieved data; missing metrics are reported separately. To compare over time, save a metrics snapshot and provide it in a later conversation.

CAPABILITIES

Clear tools for real tasks

Profiles, media, comments, search and other JSON API methods. Every tool includes its description and parameters.

tiktok_get_no_watermark_urlGet non watermarked video url
GET /getNoWatermarkUrl

Parameters: video_url, region, cache_timeout

tiktok_get_no_watermark_url_by_idGet non watermarked video url by video ID
GET /getNoWatermarkUrlByID

Parameters: video_id, region, cache_timeout

tiktok_get_video_by_idGet video info by ID
GET /getVideoByID

Parameters: video_id, region, cache_timeout

tiktok_get_video_by_urlGet video info by URL
GET /getVideoByUrl

Parameters: video_url, region, cache_timeout

tiktok_get_unshortened_urlConvert short TikTok video URL to full TikTok video URL
GET /getUnshortenedUrl

Parameters: video_url, cache_timeout

tiktok_get_comments_by_urlGet comments list by video URL
GET /getCommentsByUrl

Parameters: video_url, region, cursor, count, cache_timeout

tiktok_get_comments_by_idGet comments list by video ID
GET /getCommentsByID

Parameters: video_id, region, cursor, count, cache_timeout

tiktok_get_comments_repliesGet comments replies
GET /getCommentsReplies

Parameters: video_id, comment_id, cursor, count, cache_timeout

Same key. Same plan.

Each tool call performs one API request. Normal plan limits and caching terms apply. MCP does not bypass quotas or automatically paginate.

Access and current pricing →

You control the requests

Tell your assistant which data and how many pages you need. Use the API or SDK for direct binary downloads; MCP returns JSON.

SDKs and complete examples →

Need the other product?

IG MCP →Get help connecting