Licenses and request quota
This check uses the keys already connected. It does not consume social-data API requests.
Licenses and request quota
Check my connected licenses: status, expiration date and remaining API requests.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.
55 JSON toolsYour API keyStreamable HTTP · stdioMIT · 0.3.1
QUICK START
Contact supportChoose where to work
Add an IG or TikTok API license, or both. Each product keeps its own plan and request limits.
Connect ChatGPT
Use your existing API key
- 1
- 2
Complete the form
Icon · optionalPNG · 256 × 256 · under 10 KB
Download icon ↓NamejsonscraperDescription · optionalPublic TikTok profiles, media, comments and search through the jsonscraper API.Server URLhttps://mcp.jsonscraper.com- Connection
- Server URL
- Authentication
- OAuth
- 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.
Additional information
Connection options
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
instagram:read tiktok:readAuthorization URL
https://mcp.jsonscraper.com/oauth/authorizeToken URL
https://mcp.jsonscraper.com/oauth/tokenRegistration URL
https://mcp.jsonscraper.com/oauth/registerAuthorization server · Issuer
https://mcp.jsonscraper.com/oauthResource
https://mcp.jsonscraper.comEnter your API key on the jsonscraper authorization page after creating the connection.
Install a ready-made ZIP plugin
If your ChatGPT interface supports plugin uploads, download the archive below and select it in the import menu without unpacking. After installation, authorize with OAuth using your API key.
Try it out
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.
Help and documentation
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 →Add a connector in Claude
Use the same MCP URL and TikTok API key. No local server installation is needed.
- 1
- 2
Enter the name and server URL
NamejsonscraperServer URLhttps://mcp.jsonscraper.com - 3
Connect your API key
Select Add and, if prompted, Connect. Enter your existing TikTok API key on the jsonscraper page and approve access. In chat, open + → Connectors and enable jsonscraper for the conversation.
Additional information
Connection options
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
instagram:read tiktok:readAuthorization URL
https://mcp.jsonscraper.com/oauth/authorizeToken URL
https://mcp.jsonscraper.com/oauth/tokenRegistration URL
https://mcp.jsonscraper.com/oauth/registerAuthorization server · Issuer
https://mcp.jsonscraper.com/oauthResource
https://mcp.jsonscraper.comEnter your API key on the jsonscraper authorization page after creating the connection.
Install a ready-made ZIP plugin
If your Claude interface supports plugin uploads, download the archive below and select it in the import menu without unpacking. After installation, authorize with OAuth using your API key.
Authentication · Claude
Select Continue. Set Authentication to Sign in now and OAuth client to Register automatically. Leave Request headers empty.
Team workspace setup
For Team and Enterprise, an owner or authorized member adds the connector under Organization settings → Connectors → Add → Custom → Web. Each member then opens Customize → Connectors, selects Connect and authorizes with their own API key.
Try it out
Choose a ready-to-use workflow
Try a first request
Message for Claude
Read the public TikTok profile @therock and summarize the profile and available statistics. Use one API request.Help and documentation
Can’t find the connector option?
Check connector access for your account and workspace permissions. Use Claude on the web for setup.
Get help in chat →Connect with your API license
Set the key in the environment used to launch Codex. The key itself is not written into your repository configuration.
Codex CLI
export JSONSCRAPER_LICENSE_KEY='your-license-key'
codex mcp add jsonscraper-tiktok \
--url https://mcp.jsonscraper.com \
--bearer-token-env-var JSONSCRAPER_LICENSE_KEYOr add to config.toml
~/.codex/config.toml
[mcp_servers.jsonscraper_tiktok]
url = "https://mcp.jsonscraper.com"
bearer_token_env_var = "JSONSCRAPER_LICENSE_KEY"For OAuth, add the server without bearer-token-env-var, then run codex mcp login jsonscraper-tiktok.
Standard remote MCP
Use Streamable HTTP and send your API license in the Authorization: Bearer header. Initialize the client, call tools/list, then tools/call.
List tools
curl 'https://mcp.jsonscraper.com' \
-H "Authorization: Bearer $JSONSCRAPER_LICENSE_KEY" \
-H 'Content-Type: application/json' \
-H 'Accept: application/json, text/event-stream' \
--data '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'Local stdio and self-hosting instructions are available in the repository. GitHub ↗
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_infotiktok_get_user_feedtiktok_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_infotiktok_get_user_feedtiktok_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_usertiktok_get_user_infotiktok_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
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_urltiktok_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_infotiktok_get_user_feedtiktok_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_infotiktok_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 /getNoWatermarkUrlParameters: video_url, region, cache_timeout
tiktok_get_no_watermark_url_by_idGet non watermarked video url by video ID
GET /getNoWatermarkUrlByIDParameters: video_id, region, cache_timeout
tiktok_get_video_by_idGet video info by ID
GET /getVideoByIDParameters: video_id, region, cache_timeout
tiktok_get_video_by_urlGet video info by URL
GET /getVideoByUrlParameters: video_url, region, cache_timeout
tiktok_get_unshortened_urlConvert short TikTok video URL to full TikTok video URL
GET /getUnshortenedUrlParameters: video_url, cache_timeout
tiktok_get_comments_by_urlGet comments list by video URL
GET /getCommentsByUrlParameters: video_url, region, cursor, count, cache_timeout
tiktok_get_comments_by_idGet comments list by video ID
GET /getCommentsByIDParameters: video_id, region, cursor, count, cache_timeout
tiktok_get_comments_repliesGet comments replies
GET /getCommentsRepliesParameters: video_id, comment_id, cursor, count, cache_timeout
tiktok_search_userSearch for user by keyword
GET /searchUserParameters: keyword, cursor, count, region, follower_count, profile_type, other_pref, cache_timeout
tiktok_search_videoSearch for video by keyword
GET /searchVideoParameters: keyword, cursor, count, cache_timeout, date_posted, sort_by, region
tiktok_search_musicSearch for music by keyword
GET /searchMusicParameters: keyword, cursor, count, cache_timeout, filter_by, sort_type, region
tiktok_search_liveSearch for live by keyword
GET /searchLiveParameters: keyword, offset, count, cache_timeout, region
tiktok_search_hashtagSearch for hashtag by keyword
GET /searchHashtagParameters: keyword, cursor, count, region, cache_timeout
tiktok_search_locationSearch for location by keyword
GET /searchLocationParameters: keyword, cursor, count, region, cache_timeout
tiktok_search_topTop search by text query
GET /searchTopParameters: keyword, cursor, count, region, sort_type, publish_time, cache_timeout
tiktok_search_insightsSearch insights by text query
GET /searchInsightsParameters: keyword, cursor, count, region, cache_timeout
tiktok_search_comment_suggested_usersSearch comment suggested users
GET /searchCommentSuggestedUsersParameters: keyword, count, region, cache_timeout
tiktok_get_user_infoGet user info by profile URL or nickname
GET /getUserInfoParameters: query, region, cache_timeout
tiktok_get_user_info_by_idGet user info by profile ID
GET /getUserInfoByIDParameters: user_id, region, cache_timeout
tiktok_get_basic_user_infoGet user info by username
GET /getBasicUserInfoParameters: query, region, cache_timeout
tiktok_get_user_feedGet user feed by profile URL or nickname
GET /getUserFeedParameters: query, max_cursor, count, region, with_pinned_posts, sort_type, cache_timeout
tiktok_get_user_feed_by_idGet user feed by profile ID
GET /getUserFeedByIDParameters: user_id, max_cursor, count, region, with_pinned_posts, sort_type, cache_timeout
tiktok_get_user_idGet user ID by profile URL or nickname
GET /getUserIDParameters: query, region, cache_timeout
tiktok_get_username_by_idGet username by TikTok user ID
GET /getUsernameByIDParameters: user_id, region, cache_timeout
tiktok_get_twitter_usernameGet Twitter username by profile URL, nickname or TikTok user ID
GET /getTwitterUsernameParameters: query, region, cache_timeout
tiktok_get_instagram_usernameGet IG username by profile URL, nickname or TikTok user ID
GET /getIGUsernameParameters: query, region, cache_timeout
tiktok_get_youtube_channelGet YouTube channel info by profile URL, nickname or TikTok user ID
GET /getYoutubeChannelParameters: query, region, cache_timeout
tiktok_get_followersGet user followers by profile URL or nickname
GET /getFollowersParameters: query, count, min_time, cache_timeout
tiktok_get_followers_by_idGet user followers by profile ID
GET /getFollowersByIDParameters: user_id, count, min_time, cache_timeout
tiktok_get_followingGet user following by profile URL or nickname
GET /getFollowingParameters: query, count, min_time, cache_timeout
tiktok_get_following_by_idGet user following by profile ID
GET /getFollowingByIDParameters: user_id, count, min_time, cache_timeout
tiktok_get_live_event_info_by_idGet live event info by ID
GET /getLiveEventInfoByIDParameters: event_id, cache_timeout
tiktok_get_hashtag_infoGet hashtag info by URL or tag name
GET /getHashtagInfoParameters: query, region, cache_timeout
tiktok_get_hashtag_feedGet hashtag feed by URL or tag name
GET /getHashtagFeedParameters: query, cursor, count, region, cache_timeout
tiktok_get_hashtag_feed_by_idGet hashtag feed by ID
GET /getHashtagFeedByIDParameters: id, cursor, count, region, cache_timeout
tiktok_get_location_info_by_idGet location info by ID
GET /getLocationInfoByIDParameters: location_id, cache_timeout
tiktok_get_location_feed_by_idGet videos by location ID
GET /getLocationFeedByIDParameters: location_id, count, cursor, region, cache_timeout
tiktok_get_music_infoGet music info by URL or ID
GET /getMusicInfoParameters: query, region, cache_timeout
tiktok_get_music_feedGet music feed by URL or ID
GET /getMusicFeedParameters: query, cursor, count, cache_timeout, region
tiktok_get_music_chartsGet music charts
GET /getMusicChartsParameters: chart_type, cache_timeout, region
tiktok_get_trending_categories_listGet trending categories list
GET /getTrendingCategoriesListParameters: region, offset, count, cache_timeout
tiktok_get_trending_feedGet trending feed
GET /getTrendingFeedParameters: region, pull_type, cache_timeout
tiktok_get_stickers_by_idGet effect information by IDs
GET /getStickersByIDParameters: sticker_ids, cache_timeout
tiktok_get_sticker_by_idGet effect information by ID
GET /getStickerByIDParameters: sticker_id, cache_timeout
tiktok_get_sticker_feed_by_idGet videos by effect ID
GET /getStickerFeedByIDParameters: sticker_id, count, cursor, region, cache_timeout
tiktok_get_user_storiesGet user stories
GET /getUserStoriesParameters: user_id, count, min_cursor, region, cache_timeout
tiktok_get_story_info_by_idGet story info by ID
GET /getStoryInfoByIDParameters: story_id, region, cache_timeout
tiktok_get_user_playlistsGet user playlists
GET /getUserPlaylistsParameters: user_id, cursor, cache_timeout
tiktok_get_user_playlist_by_idGet user playlist by ID
GET /getUserPlaylistByIDParameters: user_id, playlist_id, cache_timeout
tiktok_get_video_by_playlist_idGet video by playlist ID
GET /getVideoByPlaylistIDParameters: user_id, playlist_id, max_cursor, cache_timeout
tiktok_get_available_ranking_listGet available ranking list
GET /getAvailableRankingListParameters: room_id, user_id, cache_timeout
tiktok_get_ranking_infoGet ranking info
GET /getRankingInfoParameters: rank_type, room_id, user_id, cache_timeout
tiktok_get_live_infoGet live info
GET /getLiveInfoParameters: room_id, user_id, cache_timeout
tiktok_get_live_feedGet live feed
GET /getLiveFeedParameters: draw_room_id, max_time, region, cache_timeout
jsonscraper_get_license_infoLicenses and request quota
Account license informationParameters: product
No tools found. Try another keyword.
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