{"server":{"name":"ScrapeCreators API","version":"1.0.0","transport":"http"},"capabilities":{"tools":{"v1_tiktok_profile":{"name":"v1_tiktok_profile","description":"Fetches public profile data for a TikTok user by their handle — useful for looking up a creator's identity, bio, and account stats. Returns a `user` object (display name, avatar URLs, bio/signature, verification status, bio link) and a `stats` object (followerCount, followingCount, heartCount/total likes, videoCount). This only returns profile metadata, not the user's actual videos or followers list.","inputSchema":{"type":"object","properties":{"handle":{"type":"string","description":"TikTok handle (e.g. stoolpresidente)"}},"required":["handle"]}},"v1_tiktok_profile_region":{"name":"v1_tiktok_profile_region","description":"Returns the TikTok region code for a public profile, like `US` for United States or `MX` for Mexico.","inputSchema":{"type":"object","properties":{"handle":{"type":"string","description":"TikTok handle (e.g. stoolpresidente)"}},"required":["handle"]}},"v1_tiktok_user_audience":{"name":"v1_tiktok_user_audience","description":"Retrieves audience demographic data for a TikTok user, showing where their followers are located by country. Returns `audienceLocations`, an array of objects each containing `country`, `countryCode`, `count`, and `percentage`. Costs 26 credits per request.","inputSchema":{"type":"object","properties":{"handle":{"type":"string","description":"TikTok handle (e.g. shakira)"}},"required":["handle"]}},"v3_tiktok_profile_videos":{"name":"v3_tiktok_profile_videos","description":"Fetches videos posted by a TikTok user, sortable by latest or most popular — use this to get a creator's video feed or TikToks. Returns `aweme_list`, an array of video objects each containing `aweme_id`, `desc` (caption), `statistics` (play_count, digg_count/likes, comment_count, share_count, collect_count/saves), and `video` (download URLs, duration, cover image). Paginate with `max_cursor` from the previous response.","inputSchema":{"type":"object","properties":{"handle":{"type":"string","description":"TikTok handle (e.g. stoolpresidente)"},"user_id":{"type":"string","description":"TikTok user id. Use this for faster responses. (e.g. 6659752019493208069)"},"sort_by":{"type":"string","description":"What to sort by (e.g. latest)","enum":["latest","popular"]},"max_cursor":{"type":"string","description":"Cursor to get more videos. Get 'max_cursor' from previous response. (e.g. 1734562353000)"},"region":{"type":"string","description":"Region (Country) you want the proxy in. Defaults to US. (e.g. US)"},"trim":{"type":"boolean","description":"Set to true for a trimmed down version of the response"}},"required":["handle"]}},"v2_tiktok_video":{"name":"v2_tiktok_video","description":"Fetches detailed data for a single TikTok video by URL, including its metadata, engagement stats, and optionally its transcript/captions. Returns `aweme_detail` with `desc` (caption), `statistics` (play_count, digg_count/likes, comment_count, share_count, collect_count), `video` (download URLs including no-watermark), `author` info, and `music` info; also returns `transcript` in WEBVTT format if `get_transcript=true`.","inputSchema":{"type":"object","properties":{"url":{"type":"string","description":"TikTok video URL (e.g. https://www.tiktok.com/@randomspamvideos25/video/7251387037834595630)"},"get_transcript":{"type":"boolean","description":"Get transcript of the video"},"region":{"type":"string","description":"Region of the proxy. Sometimes you'll need to specify the region if you're not getting a response. Commonly for videos from the Phillipines, in which case you'd use 'PH'. Use 2 letter country codes like US, GB, FR, etc (e.g. US)"},"trim":{"type":"boolean","description":"Set to true to get a trimmed response"},"download_media":{"type":"boolean","description":"Set to true to download the video/images and get back permanent Supabase URLs. Costs 10 credits if media is found, 1 credit otherwise."}},"required":["url"]}},"v1_tiktok_video_transcript":{"name":"v1_tiktok_video_transcript","description":"Extracts the transcript, captions, or subtitles from a TikTok video by URL. Returns `id`, `url`, and `transcript` as a WEBVTT-formatted string with timestamped text segments. Video must be under 2 minutes; costs an additional 10 credits when `use_ai_as_fallback=true`.","inputSchema":{"type":"object","properties":{"url":{"type":"string","description":"TikTok video URL (e.g. https://www.tiktok.com/@stoolpresidente/video/7499229683859426602)"},"language":{"type":"string","description":"Language of the transcript. 2 letter language code, ie 'en', 'es', 'fr', 'de', 'it', 'ja', 'ko', 'zh' (e.g. en)"},"use_ai_as_fallback":{"type":"string","description":"Set to 'true' to use AI as a fallback to get the transcript if the transcript is not found. Costs 10 credits to use this feature. And only if the video is under 2 minutes."}},"required":["url"]}},"v1_tiktok_user_live":{"name":"v1_tiktok_user_live","description":"Checks if a TikTok user is currently live streaming and retrieves their live room details. Returns `liveRoomUserInfo` (nickname, avatar, followerCount, roomId) and `liveRoom` (title, startTime, status, `liveRoomStats` with enterCount and userCount, plus `streamData` with playback URLs in multiple qualities).","inputSchema":{"type":"object","properties":{"handle":{"type":"string","description":"TikTok handle (e.g. thejustalex)"}},"required":["handle"]}},"v1_tiktok_video_comments":{"name":"v1_tiktok_video_comments","description":"Fetches comments on a TikTok video by URL — useful for reading audience reactions, replies, and engagement. Returns `comments`, an array where each comment includes `text`, `digg_count` (likes), `reply_comment_total`, `create_time`, and a `user` object with the commenter's nickname and unique_id; also returns `total` comment count. Paginate with `cursor` from the previous response.","inputSchema":{"type":"object","properties":{"url":{"type":"string","description":"TikTok video URL"},"cursor":{"type":"number","description":"Cursor to get more comments. Get 'cursor' from previous response. (e.g. 20)"},"trim":{"type":"boolean","description":"Set to true to get a trimmed response"}},"required":["url"]}},"v1_tiktok_video_comment_replies":{"name":"v1_tiktok_video_comment_replies","description":"Fetches replies to a specific TikTok comment by its ID. Returns `comments`, an array of comment objects each with `text`, `user` info, and `create_time`. Paginate with `cursor` from the previous response.","inputSchema":{"type":"object","properties":{"comment_id":{"type":"string","description":"TikTok comment ID. This is the cid from the comments endpoint. (e.g. 7623828115408274207)"},"url":{"type":"string","description":"TikTok video URL. This is the url from the comments endpoint. (e.g. https://www.tiktok.com/@stoolpresidente/video/7623818255903329566)"},"cursor":{"type":"number","description":"Cursor to get more replies. Get 'cursor' from previous response. (e.g. 3)"}},"required":["comment_id","url"]}},"v1_tiktok_user_following":{"name":"v1_tiktok_user_following","description":"Retrieves the following list — accounts that a TikTok user follows — by their handle. Returns `followings`, an array of user objects each with `nickname`, `unique_id`, `uid`, `follower_count`, `following_count`, `signature`, and avatar URLs; also returns `total` count. Paginate with `min_time` from the previous response.","inputSchema":{"type":"object","properties":{"handle":{"type":"string","description":"TikTok handle (e.g. stoolpresidente)"},"min_time":{"type":"number","description":"Used to paginate. Get 'min_time' from previous response. (e.g. 1605663376)"},"trim":{"type":"boolean","description":"Set to true to get a trimmed response"}},"required":["handle"]}},"v1_tiktok_user_followers":{"name":"v1_tiktok_user_followers","description":"Retrieves the follower list of a TikTok account by handle or user_id — useful for seeing who follows a creator or getting subscriber data. Returns `followers`, an array of user objects each with `nickname`, `unique_id`, `uid`, `follower_count`, `following_count`, and avatar URLs; also returns `total` follower count. Paginate with `min_time` from the previous response.","inputSchema":{"type":"object","properties":{"handle":{"type":"string","description":"TikTok handle (e.g. stoolpresidente)"},"user_id":{"type":"string","description":"User id. Use this for faster response times. (e.g. 6659752019493208069)"},"min_time":{"type":"number","description":"Used to paginate. Get 'min_time' from previous response. (e.g. 1605663376)"},"trim":{"type":"boolean","description":"Set to true to get a trimmed response"}},"required":[]}},"v1_tiktok_search_users":{"name":"v1_tiktok_search_users","description":"Searches for TikTok users by keyword or name — useful for finding creators or accounts matching a query. Returns `users`, an array of objects each containing `user_info` (nickname, unique_id, signature/bio, follower_count, following_count, avatar) and associated `items`. Paginate with `cursor` from the previous response.","inputSchema":{"type":"object","properties":{"query":{"type":"string","description":"Search query for users"},"cursor":{"type":"number","description":"Cursor to get more users. Get 'cursor' from previous response. (e.g. 10)"},"trim":{"type":"boolean","description":"Set to true to get a trimmed response"}},"required":["query"]}},"v1_tiktok_search_hashtag":{"name":"v1_tiktok_search_hashtag","description":"Searches for TikTok videos under a specific hashtag — useful for finding content by topic or trend. Returns `aweme_list`, an array of video objects each with `aweme_id`, `desc` (caption), `statistics` (play_count, digg_count/likes, comment_count, share_count), `video` info, and `author` details. Paginate with `cursor` from the previous response.","inputSchema":{"type":"object","properties":{"hashtag":{"type":"string","description":"Hashtag to search for (without #)"},"region":{"type":"string","description":"Region the proxy will be set to. Note: this isn't going to grab you all tiktoks from this region, you're just setting the proxy there. (e.g. US)"},"cursor":{"type":"number","description":"Cursor to get more videos. Get 'cursor' from previous response. (e.g. 10)"},"trim":{"type":"boolean","description":"Set to true to get a trimmed response"}},"required":["hashtag"]}},"v1_tiktok_search_keyword":{"name":"v1_tiktok_search_keyword","description":"Searches for TikTok videos by keyword or phrase — the general video search across all of TikTok. Returns `search_item_list`, an array of objects each containing `aweme_info` with `aweme_id`, `desc` (caption), `statistics` (play_count, digg_count/likes, comment_count, share_count), `video` info, and `author` details. Paginate with `cursor`.","inputSchema":{"type":"object","properties":{"query":{"type":"string","description":"Keyword to search for"},"date_posted":{"type":"string","description":"Time Frame (e.g. all-time)","enum":["yesterday","this-week","this-month","last-3-months","last-6-months","all-time"]},"sort_by":{"type":"string","description":"Sort by (e.g. relevance)","enum":["relevance","most-liked","date-posted"]},"region":{"type":"string","description":"Note, this doesn't filter the tiktoks only in a specfic region, it puts the proxy there. Use it in case you want to scrape posts only available for some country. Use 2 letter country codes like US, GB, FR, etc"},"cursor":{"type":"number","description":"Cursor to get more videos. Get 'cursor' from previous response. (e.g. 10)"},"trim":{"type":"boolean","description":"Set to true to get a trimmed response"}},"required":["query"]}},"v1_tiktok_search_top":{"name":"v1_tiktok_search_top","description":"Searches TikTok's 'Top' results by query — returns both videos and photo carousels, unlike keyword search which only returns videos. Returns `items`, an array of objects each with `id`, `desc` (caption), `content_type` (video or photo carousel), `statistics` (play_count, digg_count/likes, comment_count, share_count), `video` info, and `images` for carousels. Paginate with `cursor`.","inputSchema":{"type":"object","properties":{"query":{"type":"string","description":"Keyword to search for (e.g. funny)"},"publish_time":{"type":"string","description":"Time Frame TikTok was posted (e.g. all-time)","enum":["yesterday","this-week","this-month","last-3-months","last-6-months","all-time"]},"sort_by":{"type":"string","description":"Sort by (e.g. relevance)","enum":["relevance","most-liked","date-posted"]},"region":{"type":"string","description":"Note, this doesn't filter the tiktoks only in a specfic region, it puts the proxy there. Use it in case you want to scrape posts only available for some country. Use 2 letter country codes like US, GB, FR, etc"},"cursor":{"type":"number","description":"Cursor to get more videos. Get 'cursor' from previous response. (e.g. 0)"}},"required":["query"]}},"v1_tiktok_creators_popular":{"name":"v1_tiktok_creators_popular","description":"Discovers trending and popular TikTok creators, filterable by follower count range, creator country, and audience country. Returns `creator_list`, an array of creator objects each with `nickname`, `unique_id`, `follower_count`, `likes_count`, `video_views`, `engagement_rate`, and avatar URLs. Sortable by engagement, follower count, or average views.","inputSchema":{"type":"object","properties":{"page":{"type":"number","description":"Page number (e.g. 1)"},"sortBy":{"type":"string","description":"Sort creators by engagement, follower count, or average views (e.g. engagement)","enum":["engagement","follower","avg_views"]},"followerCount":{"type":"string","description":"Filter by follower count range (e.g. 10K-100K)","enum":["10K-100K","100K-1M","1M-10M","10M+"]},"creatorCountry":{"type":"string","description":"Country code of the creator (e.g. US)","enum":["AU","BR","CA","EG","FR","DE","ID","IL","IT","JP","MY","PH","RU","SA","SG","KR","ES","TW","TH","TR","AE","GB","US","VN"]},"audienceCountry":{"type":"string","description":"Country code of the audience/follower (e.g. US)","enum":["AU","BR","CA","EG","FR","DE","ID","IL","IT","JP","MY","PH","RU","SA","SG","KR","ES","TW","TH","TR","AE","GB","US","VN"]}},"required":[]}},"v1_tiktok_hashtags_popular":{"name":"v1_tiktok_hashtags_popular","description":"Discovers trending and popular TikTok hashtags, filterable by time period (7/30/120 days) and country. Returns a list of hashtag objects each with `hashtag_name`, `rank`, `trend` data, and related video examples. Useful for identifying viral topics and content trends on TikTok.","inputSchema":{"type":"object","properties":{"period":{"type":"string","description":"Time period in days (7, 30, or 120) (e.g. 7)","enum":[7,30,120]},"page":{"type":"number","description":"Page number (e.g. 1)"},"countryCode":{"type":"string","description":"Country code to get popular hashtags from (e.g. US)","enum":["AU","BR","CA","EG","FR","DE","ID","IL","IT","JP","MY","PH","RU","SA","SG","KR","ES","TW","TH","TR","AE","GB","US","VN"]},"newOnBoard":{"type":"boolean","description":"Show only newly trending hashtags"},"industry":{"type":"string","description":"Industry to get popular hashtags from.","enum":["apparel-and-accessories","baby-kids-and-maternity","beauty-and-personal-care","business-services","education","financial-services","food-and-beverage","games","health","home-improvement","household-products","life-services","news-and-entertainment","pets","sports-and-outdoor","tech-and-electronics","travel","vehicle-and-transportation"]}},"required":[]}},"v1_tiktok_song":{"name":"v1_tiktok_song","description":"Fetches detailed metadata for a specific TikTok sound or song by its clipId. Returns `music_info` with `title`, `author`, `album`, `duration`, `user_count` (number of videos using this sound), `play_url`, cover art, and artist details. Use the `clipId` from a sound URL or from the popular songs endpoint.","inputSchema":{"type":"object","properties":{"clipId":{"type":"string","description":"This is a little confusing because this isn't songId like you'd think. It is the clipId. I guess because you can clip different portions of a song 🤷‍♂️ (e.g. 7439295283975702544)"}},"required":["clipId"]}},"v1_tiktok_song_videos":{"name":"v1_tiktok_song_videos","description":"Fetches TikTok videos that use a specific sound or song, identified by its clipId. Returns `aweme_list`, an array of video objects each with `aweme_id`, `desc` (caption), `statistics` (play_count, digg_count/likes, comment_count, share_count), `video` info, and `author` details. Paginate with `cursor` from the previous response.","inputSchema":{"type":"object","properties":{"clipId":{"type":"string","description":"This is clipId. Can be found on a url like so: https://www.tiktok.com/music/That%27s-Who-I-Praise-7370375686554782506, where 7370375686554782506 is the clipId (e.g. 7439295283975702544)"},"cursor":{"type":"number","description":"The cursor to get the next page of results. (e.g. 12)"}},"required":[]}},"v1_tiktok_get_trending_feed":{"name":"v1_tiktok_get_trending_feed","description":"Fetches TikTok's trending/For You feed for a given region — useful for discovering viral content and what's currently popular. Returns `aweme_list`, an array of video objects each with `aweme_id`, `desc` (caption), `statistics` (play_count, digg_count/likes, comment_count, share_count, collect_count), `video` (playback and download URLs, cover), `author` info, and `image_post_info` for photo carousels.","inputSchema":{"type":"object","properties":{"region":{"type":"string","description":"Where you want the proxy to be. This doesn't mean that you will only see TikToks from this region, you will just see the content that isn't banned in that region. (e.g. US)"},"trim":{"type":"boolean","description":"Set to true to get a trimmed response."}},"required":["region"]}},"v1_tiktok_shop_search":{"name":"v1_tiktok_shop_search","description":"Searches TikTok Shop for products matching a keyword query. Returns an array of product objects each with `title`, `cover` image, `url` (product page link), `price`, `sold_count`, `review_count`, `rating`, and `shop_name`. Paginate with `page`; filter by region.","inputSchema":{"type":"object","properties":{"query":{"type":"string","description":"Term you want to search for (e.g. shoes)"},"page":{"type":"number","description":"Page number to retrieve (e.g. 1)"},"region":{"type":"string","description":"Region to search shop products in. (e.g. US)","enum":["US","GB","DE","FR","IT","ID","MY","MX","PH","SG","ES","TH","VN","BR","JP","IE"]}},"required":["query"]}},"v1_tiktok_shop_products":{"name":"v1_tiktok_shop_products","description":"Lists all products from a specific TikTok Shop store by its URL. Returns an array of product objects each with `title`, `cover` images, `url`, `price` info, `sold_count`, `review_count`, and `rating`. Paginate with `cursor` from the previous response; filter by region.","inputSchema":{"type":"object","properties":{"url":{"type":"string","description":"The TikTok Shop store URL. (e.g. https://www.tiktok.com/shop/store/goli-nutrition/7495794203056835079)"},"cursor":{"type":"string","description":"Cursor parameter from the previous response to retrieve the next page of products. Omit for the first page."},"region":{"type":"string","description":"Region to get shop products from. Defaults to US if not provided. (e.g. US)","enum":["US","GB","DE","FR","IT","ID","MY","MX","PH","SG","ES","TH","VN","BR","JP","IE"]}},"required":["url"]}},"v1_tiktok_product":{"name":"v1_tiktok_product","description":"Fetches full details for a specific TikTok Shop product by its URL, including stock levels and affiliate videos. Returns `product_info` with `product_base` (title, images, sold_count, price), `skus` (variants with exact `stock` counts), and `product_detail_review` (product_rating, review_count, sample reviews); also returns `shop_info` (shop_name, shop_rating, followers_count) and `related_videos` (affiliate TikToks promoting the product). Related videos are only available in the US region.","inputSchema":{"type":"object","properties":{"url":{"type":"string","description":"The URL of the product to get details for. (e.g. https://www.tiktok.com/shop/pdp/goli-ashwagandha-gummies-with-vitamin-d-ksm-66-vegan-non-gmo/1729587769570529799)"},"region":{"type":"string","description":"Region the proxy will be set to so you can access products from that country. Use 2 letter country codes like US, GB, FR, etc. For England, don't use UK, use GB. (e.g. US)"}},"required":["url"]}},"v1_tiktok_shop_product_reviews":{"name":"v1_tiktok_shop_product_reviews","description":"Fetches customer reviews for a TikTok Shop product by URL or product_id. Returns `product_reviews`, an array of review objects each with `rating`, `display_text`, `review_timestamp_fmt`, `review_user` (name, avatar), and `sku_specification` (variant purchased); also returns `total_reviews` count and `rating_distribution`. Paginate with `page`.","inputSchema":{"type":"object","properties":{"url":{"type":"string","description":"The URL of the product (required if product_id is not provided) (e.g. https://www.tiktok.com/shop/pdp/cat-nail-clipper-by-potaroma-adjustable-sizes-built-in-file-safe-for-kittens-cats/1731578642912612516)"},"product_id":{"type":"string","description":"The ID of the product (required if url is not provided) (e.g. 1731578642912612516)"},"region":{"type":"string","description":"The region of the product. This is *very* important. (e.g. US)"},"page":{"type":"number","description":"The page number of the reviews (e.g. 1)"}},"required":[]}},"v1_tiktok_user_showcase":{"name":"v1_tiktok_user_showcase","description":"Fetches products featured in a TikTok user's public showcase — the products a creator promotes on their profile. Returns an array of product objects each with title, price, images, and shop details. Use POST request if pagination is cutting off too early. Just send the query params in the body.","inputSchema":{"type":"object","properties":{"handle":{"type":"string","description":"The handle of the user (e.g. mrtiktokreviews)"},"region":{"type":"string","description":"Region to put the proxy in (e.g. US)"},"cursor":{"type":"string","description":"The cursor to the next page of products (e.g. 21)"}},"required":["handle"]}},"v1_instagram_profile":{"name":"v1_instagram_profile","description":"Retrieves comprehensive public Instagram profile information including biography, bio links, follower and following counts, verification status, and profile picture URLs. Also returns recent timeline posts with engagement metrics such as likes, comments, and video view counts, plus a list of related profiles. Useful for account overview, audience analysis, or discovering similar creators.","inputSchema":{"type":"object","properties":{"handle":{"type":"string","description":"Instagram handle (e.g. jane)"},"trim":{"type":"boolean","description":"Set to true to get a trimmed response"}},"required":["handle"]}},"v1_instagram_basic_profile":{"name":"v1_instagram_basic_profile","description":"Fetches a lightweight Instagram profile summary by user ID, returning username, full name, biography, profile picture URL, verification status, follower count, following count, media count, and account privacy and type. Ideal for quick lookups or enrichment when you already have the numeric user ID.","inputSchema":{"type":"object","properties":{"userId":{"type":"string","description":"Instagram user id (e.g. 314216)"}},"required":[]}},"v2_instagram_user_posts":{"name":"v2_instagram_user_posts","description":"Returns a paginated feed of a user's public Instagram posts, including photos, videos, and carousels. Each item includes media type, shortcode, caption text, like count, comment count, play count, video URLs, image URLs, and tagged users. Play counts reflect Instagram-only views and exclude cross-posted Facebook views. Supports cursor-based pagination via next_max_id for scrolling through the full timeline.","inputSchema":{"type":"object","properties":{"handle":{"type":"string","description":"Instagram handle"},"next_max_id":{"type":"string","description":"Cursor to get next page of results."},"trim":{"type":"boolean","description":"Set to true to get a trimmed response"}},"required":["handle"]}},"v1_instagram_user_reels":{"name":"v1_instagram_user_reels","description":"Returns a paginated list of a user's public Instagram reels (short-form videos). Each reel includes its shortcode, play count, like count, comment count, video versions with download URLs, thumbnail image, and owner info. Note that reel captions are not returned by this endpoint. Play counts are Instagram-only views and exclude cross-posted Facebook views. Supports cursor-based pagination via max_id; providing a user_id instead of a handle yields faster responses.","inputSchema":{"type":"object","properties":{"user_id":{"type":"string","description":"Instagram user id. Use this for faster response times. (e.g. 2700692569)"},"handle":{"type":"string","description":"Instagram handle. Use user_id for faster response times. (e.g. jane)"},"max_id":{"type":"string","description":"Max id to get more reels. Get 'max_id' from previous response. (e.g. QVFCVzNnS2lI...==)"},"trim":{"type":"boolean","description":"Set to true for a trimmed down version of the response"}},"required":[]}},"v1_instagram_post":{"name":"v1_instagram_post","description":"Fetches detailed metadata for a single Instagram post or reel by shortcode or URL. Returns caption text, like count, comment count, video URL, video play count, video duration, display images, owner info, tagged users, and carousel sidecar children when applicable. Play counts are Instagram-only views and exclude cross-posted Facebook views.","inputSchema":{"type":"object","properties":{"url":{"type":"string","description":"Instagram post or reel URL"},"region":{"type":"string","description":"2 letter country code to set the proxy in (e.g. US)"},"trim":{"type":"boolean","description":"Set to true to get a trimmed response"},"download_media":{"type":"boolean","description":"Set to true to download the video/images and get back permanent Supabase URLs. Costs 10 credits if media is found, 1 credit otherwise."}},"required":["url"]}},"v2_instagram_media_transcript":{"name":"v2_instagram_media_transcript","description":"Generates an AI-powered speech-to-text transcription for an Instagram video post or reel. The video must be under 2 minutes long. Returns a transcripts array with each item's shortcode and transcribed text; carousel posts produce one transcript per video slide. Expect 10-30 second response times, and null when no speech is detected.","inputSchema":{"type":"object","properties":{"url":{"type":"string","description":"Instagram post or reel URL"}},"required":["url"]}},"v2_instagram_reels_search":{"name":"v2_instagram_reels_search","description":"Searches for Instagram reels matching a keyword or phrase via Google Search, bypassing Instagram's login-gated search. Returns a list of reels with shortcode, caption, thumbnail, video URL, play count, like count, comment count, video duration, owner details, location, and audio attribution info. Play counts are Instagram-only views and exclude cross-posted Facebook views. Supports page-based pagination for browsing additional results.","inputSchema":{"type":"object","properties":{"query":{"type":"string","description":"The keyword to search for (e.g. dogs)"},"date_posted":{"type":"string","description":"Date posted (e.g. last-hour)","enum":["last-hour","last-day","last-week","last-month","last-year"]},"page":{"type":"number","description":"The page number to return. (e.g. 1)"}},"required":["query"]}},"v2_instagram_post_comments":{"name":"v2_instagram_post_comments","description":"Retrieves comments on a public Instagram post or reel. Each comment includes the comment text, creation timestamp, and commenter details such as username, user ID, verification status, and profile picture URL. Supports cursor-based pagination to load additional comment pages.","inputSchema":{"type":"object","properties":{"url":{"type":"string","description":"The URL of the post or reel to get comments from (e.g. https://www.instagram.com/reel/DOq6eV6iIgD)"},"cursor":{"type":"string","description":"The cursor to get more comments. Get 'cursor' from previous response. (e.g. eyJjYWNoZWRfY29tbWVud...)"}},"required":["url"]}},"v1_instagram_user_highlights":{"name":"v1_instagram_user_highlights","description":"Lists all story highlight albums for an Instagram user. Each highlight includes its ID, title, cover thumbnail URL, and owner info with username and profile picture. Accepts either a user_id or handle; providing user_id yields faster responses.","inputSchema":{"type":"object","properties":{"user_id":{"type":"string","description":"Instagram user id. Use for faster response times. (e.g. 2700692569)"},"handle":{"type":"string","description":"Instagram handle. Use user_id for faster response times. (e.g. jane)"}},"required":[]}},"v1_instagram_user_highlight_detail":{"name":"v1_instagram_user_highlight_detail","description":"Fetches the full contents of a specific Instagram story highlight album by its ID. Returns the highlight's cover image, title, user info, and an items array containing each story with its media type, image or video URLs, dimensions, timestamp, and sticker/interactive element data. Useful for archiving or analyzing individual highlight reels.","inputSchema":{"type":"object","properties":{"id":{"type":"string","description":"The ID of the highlight to get details for (e.g. 18067016518767507)"}},"required":[]}},"v1_instagram_song_reels":{"name":"v1_instagram_song_reels","description":"DEPRECATED — this endpoint is no longer functional. Instagram removed the public audio pages that this endpoint relied on, so it cannot return data. Do not use this endpoint; there is currently no replacement available.","inputSchema":{"type":"object","properties":{"audio_id":{"type":"string","description":"If you're looking for this, it is sometimes called 'audio_cluster_id', or it can be just 'audio_id'. (e.g. 844716519067330)"},"max_id":{"type":"string","description":"How you paginate the results. Pass the max_id from the previous response to get the next set of reels. (e.g. GvYhgPbWtJ....)"}},"required":["audio_id"]}},"v1_instagram_user_embed":{"name":"v1_instagram_user_embed","description":"Returns the raw HTML embed snippet for an Instagram user's profile widget. The response contains a single html string that can be inserted into a webpage to render an embeddable Instagram profile card. Requires the user's handle as input.","inputSchema":{"type":"object","properties":{"handle":{"type":"string","description":"Instagram handle (e.g. jane)"}},"required":["handle"]}},"v1_youtube_channel":{"name":"v1_youtube_channel","description":"Retrieves comprehensive YouTube channel profile data including name, avatar images, subscriber count (subscribers), total video and view counts, join date, tags, and linked social accounts like Twitter and Instagram. Accepts a channelId, handle, or full channel URL as input. Returns channel metadata such as country, email, and external store links when available.","inputSchema":{"type":"object","properties":{"channelId":{"type":"string","description":"YouTube channel ID. Can pass a channelId, handle or url (e.g. UC-9-kyTW8ZkZNDHQJ6FgpwQ)"},"handle":{"type":"string","description":"YouTube channel handle. Can pass a channelId, handle or url (e.g. ThePatMcAfeeShow)"},"url":{"type":"string","description":"YouTube channel URL. Can pass a channelId, handle or url (e.g. https://www.youtube.com/@ThePatMcAfeeShow)"}},"required":[]}},"v1_youtube_channel_videos":{"name":"v1_youtube_channel_videos","description":"Fetches a paginated list of videos uploaded by a YouTube channel, including each video's title, URL, thumbnail, view count (views), publish date, duration, and description. Supports sorting by latest or popular, and use the continuationToken to page through all results. Optionally include extras like like count, comment count, and descriptions for each video.","inputSchema":{"type":"object","properties":{"channelId":{"type":"string","description":"YouTube channel ID (e.g. UC-9-kyTW8ZkZNDHQJ6FgpwQ)"},"handle":{"type":"string","description":"YouTube channel handle (e.g. ThePatMcAfeeShow)"},"sort":{"type":"string","description":"Sort by latest or popular (e.g. latest)","enum":["latest","popular"]},"continuationToken":{"type":"string","description":"Continuation token to get more videos. Get 'continuationToken' from previous response. (e.g. 4qmFsgKrCBIYVUNkRkpXVWE0M3NtUm00SXBIQnB)"},"includeExtras":{"type":"string","description":"This will get you the like + comment count and the description. To get the full details of the video, use the /v1/youtube/video endpoint. Honestly, if you use this param, the error rate is higher. We might deprecate this param in the future."}},"required":[]}},"v1_youtube_channel_shorts":{"name":"v1_youtube_channel_shorts","description":"Retrieves a paginated list of short-form videos (Shorts) from a YouTube channel, including each short's title, URL, view count (views), likes, comments, and description. Supports sorting by newest or popular, and use the continuationToken to page through all results. Returns data in the shorts array.","inputSchema":{"type":"object","properties":{"handle":{"type":"string","description":"Can pass channelId or handle (e.g. starterstory)"},"channelId":{"type":"string","description":"Can pass channelId or handle (e.g. UC-9-kyTW8ZkZNDHQJ6FgpwQ)"},"sort":{"type":"string","description":"Sort by newest or popular (e.g. newest)","enum":["newest","popular"]},"continuationToken":{"type":"string","description":"Continuation token to get more videos. Get 'continuationToken' from previous response. (e.g. 4qmFsgKrCBIYVUNkRkpXVWE0M3NtUm00SXBIQnB)"}},"required":[]}},"v1_youtube_video":{"name":"v1_youtube_video","description":"Fetches full details for a YouTube video or short, including title, description, thumbnail, view count (views), like count (likes), comment count, publish date, duration, genre, keywords, chapters, collaborators, and available caption tracks (subtitles/captions). Also returns related recommended videos in watchNextVideos and channel info for the uploader.","inputSchema":{"type":"object","properties":{"url":{"type":"string","description":"YouTube video or short URL (e.g. https://www.youtube.com/watch?v=Y2Ah_DFr8cw)"},"language":{"type":"string","description":"Preferred response language (mapped to Accept-Language header; not guaranteed due to YouTube localization behavior). 2 letter language code, ie 'en', 'es', 'fr' etc. (e.g. en)"}},"required":["url"]}},"v1_youtube_video_transcript":{"name":"v1_youtube_video_transcript","description":"Retrieves the captions, subtitles, or transcript of a YouTube video or short. Returns both a timestamped transcript array with start/end times and a plain-text version in transcript_only_text. Supports specifying a language code. Note: the video must be under 2 minutes for transcript extraction to work.","inputSchema":{"type":"object","properties":{"url":{"type":"string","description":"YouTube video or short URL (e.g. https://www.youtube.com/watch?v=bjVIDXPP7Uk)"},"language":{"type":"string","description":"2 letter language code, ie 'en', 'es', 'fr' etc. If the transcript is not available in the language you specify, the transcript will be null. (e.g. en)"}},"required":["url"]}},"v1_youtube_search":{"name":"v1_youtube_search","description":"Searches YouTube by keyword query and returns matching videos, channels, playlists, shorts, shelves, and live streams. Each video result includes title, URL, thumbnail, view count (views), publish date, duration, channel info, and badges. Supports filtering by upload date, sorting by relevance or popularity, and paginating with continuationToken.","inputSchema":{"type":"object","properties":{"query":{"type":"string","description":"Search query"},"uploadDate":{"type":"string","description":"Upload date","enum":["today","this_week","this_month","this_year"]},"sortBy":{"type":"string","description":"Sort by (e.g. relevance)","enum":["relevance","popular"]},"type":{"type":"string","description":"Type of content to search for (e.g. videos)","enum":["videos","shorts","channels","playlists"]},"duration":{"type":"string","description":"Duration of the video. Only applies to videos (not shorts). (e.g. under_3_min)","enum":["under_3_min","between_3_and_20_min","over_20_min"]},"region":{"type":"string","description":"2 letter country code of the country to put the proxy in. (e.g. US)"},"continuationToken":{"type":"string","description":"Continuation token to get more videos. Get 'continuationToken' from previous response. (e.g. 4qmFsgKrCBIYVUNkRkpXVWE0M3NtUm00SXBIQnB)"},"includeExtras":{"type":"string","description":"This will get you the like + comment count and the description. To get the full details of the video, use the /v1/youtube/video endpoint. *This will slow down the response slightly.*"}},"required":["query"]}},"v1_youtube_search_hashtag":{"name":"v1_youtube_search_hashtag","description":"Searches YouTube for content matching a specific hashtag and returns matching videos with title, URL, thumbnail, view count (views), publish date, duration, and channel info. Supports pagination via continuationToken and filtering to return all content types or only shorts.","inputSchema":{"type":"object","properties":{"hashtag":{"type":"string","description":"Hashtag to search for (e.g. funny)"},"continuationToken":{"type":"string","description":"Continuation token to get more videos. Get 'continuationToken' from previous response. (e.g. 4qmFsgKrCBIYVUNkRkpXVWE0M3NtUm00SXBIQnB)"},"type":{"type":"string","description":"Search for all types of content or only shorts (e.g. all)","enum":["all","shorts"]}},"required":["hashtag"]}},"v1_youtube_video_comments":{"name":"v1_youtube_video_comments","description":"Fetches comments and replies from a YouTube video, including each comment's text content, author details, like count, reply count, and publish date. Supports ordering by top or newest, and paginating with continuationToken. Limited to approximately 1,000 top comments or 7,000 newest comments.","inputSchema":{"type":"object","properties":{"url":{"type":"string","description":"YouTube video URL (e.g. https://www.youtube.com/watch?v=dQw4w9WgXcQ)"},"continuationToken":{"type":"string","description":"Continuation token to get more comments. Get 'continuationToken' from previous response. (e.g. 4qmFsgKrCBIYVUNkRkpXVWE0M3NtUm00SXBIQnB)"},"order":{"type":"string","description":"Order of comments (e.g. top)","enum":["top","newest"]}},"required":["url"]}},"v1_youtube_video_comment_replies":{"name":"v1_youtube_video_comment_replies","description":"Fetches replies to a specific comment on a YouTube video, including each reply's text content, author details (name, channel ID, avatar, verified/creator status), like count, and publish date. Requires a continuationToken obtained from the 'repliesContinuationToken' field on comments returned by the Comments endpoint. Supports paginating through additional replies with the continuationToken returned in each response.","inputSchema":{"type":"object","properties":{"continuationToken":{"type":"string","description":"Continuation token for the comment replies. Use 'repliesContinuationToken' from the Comments endpoint, or 'continuationToken' from a previous replies response to paginate. (e.g. Eg0SC2RRdzR3OVdnWGNRGAYygwEaUBIa...)"}},"required":["continuationToken"]}},"v1_youtube_shorts_trending":{"name":"v1_youtube_shorts_trending","description":"Fetches approximately 48 currently trending YouTube Shorts (viral/popular short-form videos) per call, returning each short's title, URL, thumbnail, view count (views), like count (likes), comment count, publish date, channel info, keywords, and duration. Each subsequent call returns a fresh batch of different trending shorts.","inputSchema":{"type":"object","properties":{},"required":[]}},"v1_youtube_playlist":{"name":"v1_youtube_playlist","description":"Retrieves all videos in a YouTube playlist, including the playlist title, owner info, total video count, and each video's title, URL, thumbnail, duration, and channel. Accepts the playlist ID found in the 'list' URL parameter.","inputSchema":{"type":"object","properties":{"playlist_id":{"type":"string","description":"The ID of the YouTube playlist. In the YouTube URL it will be the 'list' parameter. (e.g. PLP32wGpgzmIlInfgKVFfCwVsxgGqZNIiS)"}},"required":["playlist_id"]}},"v1_youtube_community_post":{"name":"v1_youtube_community_post","description":"Retrieves the full details of a YouTube community post, including its text content, attached images, like count, publish date, and associated channel info. Also returns a linked video if the post includes one.","inputSchema":{"type":"object","properties":{"url":{"type":"string","description":"The URL of the YouTube community post to get (e.g. https://www.youtube.com/post/Ugkxvj2KoApYAXoqLWnKVr6zZe5JjeHrQeP8)"}},"required":["url"]}},"v1_linkedin_profile":{"name":"v1_linkedin_profile","description":"Retrieves a person's public LinkedIn profile data, including their name, photo, location, follower count (followers), about/bio summary, recent posts, work experience, education, articles, activity feed, publications, projects, recommendations, and similar profiles. Only returns publicly available information visible in an incognito browser.","inputSchema":{"type":"object","properties":{"url":{"type":"string","description":"The URL of the LinkedIn profile to get (e.g. https://www.linkedin.com/in/parrsam/)"}},"required":["url"]}},"v1_linkedin_company":{"name":"v1_linkedin_company","description":"Fetches a LinkedIn company page with details including name, description, logo, cover image, slogan, location, headquarters, employee count (headcount/staff size), website, industry, company type, founded year, specialties, funding rounds with investors, featured employees, recent posts, and similar company pages.","inputSchema":{"type":"object","properties":{"url":{"type":"string","description":"The URL of the LinkedIn company page to get (e.g. https://linkedin.com/company/shopify)"}},"required":["url"]}},"v1_linkedin_company_posts":{"name":"v1_linkedin_company_posts","description":"Retrieves paginated posts from a LinkedIn company page, including each post's URL, ID, publication date, and full text content. Supports page-based pagination up to a maximum of 7 pages due to a LinkedIn platform limitation.","inputSchema":{"type":"object","properties":{"url":{"type":"string","description":"The URL of the LinkedIn company page to get (e.g. https://linkedin.com/company/shopify)"},"page":{"type":"number","description":"The page number to get (e.g. 1)"}},"required":["url"]}},"v1_linkedin_post":{"name":"v1_linkedin_post","description":"Fetches a single LinkedIn post or article, returning the title, headline, full description text, author info with follower count, publication date, like count (reactions), comment count, and individual comments. Also includes related articles from the same author in moreArticles.","inputSchema":{"type":"object","properties":{"url":{"type":"string","description":"The URL of the LinkedIn post to get (e.g. https://www.linkedin.com/pulse/being-father-has-made-me-better-leader-vice-versa-austen-allred/)"}},"required":["url"]}},"v1_facebook_profile":{"name":"v1_facebook_profile","description":"Retrieves public Facebook page details including category, address, email, phone, website, services, priceRange, rating, likeCount, and followerCount. Also returns adLibrary status with the page's ad activity and pageId. Optionally includes businessHours when get_business_hours is set to true.","inputSchema":{"type":"object","properties":{"url":{"type":"string","description":"Facebook profile URL (e.g. https://www.facebook.com/mantraindianfolsom)"},"get_business_hours":{"type":"string","description":"Get the business's hours"}},"required":["url"]}},"v1_facebook_profile_reels":{"name":"v1_facebook_profile_reels","description":"Fetches up to 10 reels per request from a public Facebook page. Each reel includes id, url, view_count, description, creation_time, video_url, thumbnail, play_time_in_ms, and music details. Pagination requires passing both next_page_id and cursor from the previous response.","inputSchema":{"type":"object","properties":{"url":{"type":"string","description":"Facebook page URL (e.g. https://www.facebook.com/pacemorby)"},"next_page_id":{"type":"string","description":"To paginate through to the next page (e.g. YXBwX2NvbGxlY3Rpb2......)"},"cursor":{"type":"string","description":"To paginate through to the next page (e.g. AQHSFZtzkBauSDHgy8y......)"}},"required":["url"]}},"v1_facebook_profile_photos":{"name":"v1_facebook_profile_photos","description":"Fetches photos from a public Facebook page with pagination support. Each photo includes photo_id, accessibility_caption, viewer_image with uri, height, and width, plus a thumbnail and direct url. Pagination requires passing both next_page_id and cursor from the previous response.","inputSchema":{"type":"object","properties":{"url":{"type":"string","description":"Facebook page URL (e.g. https://www.facebook.com/Spurs)"},"next_page_id":{"type":"string","description":"To paginate through to the next page (e.g. YXBwX2NvbGxlY3Rpb2......)"},"cursor":{"type":"string","description":"To paginate through to the next page (e.g. AQHSRM68MZ-AJKGSgRb0......)"}},"required":["url"]}},"v1_facebook_profile_posts":{"name":"v1_facebook_profile_posts","description":"Returns publicly visible Facebook profile posts, limited to 3 posts per page due to API limitations. Each post includes id, text, url, reactionCount, commentCount, publishTime, videoDetails with sdUrl, hdUrl, and thumbnailUrl, plus topComments. Accepts either a url or pageId parameter, where pageId is faster.","inputSchema":{"type":"object","properties":{"url":{"type":"string","description":"Facebook profile URL (e.g. https://www.facebook.com/pacemorby)"},"pageId":{"type":"string","description":"Facebook profile page id (e.g. 100063669491743)"},"cursor":{"type":"string","description":"To paginate through the posts (e.g. Cg8Ob3JnYW5pY19jdXJzb3IJA...)"}},"required":[]}},"v1_facebook_profile_events":{"name":"v1_facebook_profile_events","description":"Get the events of a public Facebook page","inputSchema":{"type":"object","properties":{"url":{"type":"string","description":"The URL of the public Facebook page (e.g. https://www.facebook.com/brickyardoldtown)"},"cursor":{"type":"string","description":"The cursor to paginate to get more events (e.g. eyJpZCI6IllYQndYMk52Ykd......)"}},"required":["url"]}},"v1_facebook_post":{"name":"v1_facebook_post","description":"Retrieves a single public Facebook post or reel by URL. Returns post_id, like_count, comment_count, share_count, view_count, description, creation_time, and author details. For video posts, includes video sd_url, hd_url, thumbnail, and length_in_second. Optionally fetches comments and transcript via get_comments and get_transcript parameters.","inputSchema":{"type":"object","properties":{"url":{"type":"string","description":"The URL of the post to get (e.g. https://www.facebook.com/reel/1535656380759655)"}},"required":["url"]}},"v1_facebook_post_transcript":{"name":"v1_facebook_post_transcript","description":"Extracts the transcript text from a Facebook video post or reel. Returns the transcript as a single text string with line breaks. Only works on videos under 2 minutes in length.","inputSchema":{"type":"object","properties":{"url":{"type":"string","description":"Facebook post URL"}},"required":["url"]}},"v1_facebook_post_comments":{"name":"v1_facebook_post_comments","description":"Fetches comments from a Facebook post or reel with cursor-based pagination. Each comment includes id, text, created_at, reply_count, reaction_count, and author details with name and profile_picture. Passing a feedback_id instead of a url significantly speeds up the request.","inputSchema":{"type":"object","properties":{"url":{"type":"string","description":"Facebook post URL (or reel URL) (e.g. https://www.facebook.com/reel/753347914167361)"},"feedback_id":{"type":"string","description":"Using feedback_id (instead of url) will *really* speed up the request. You can get the feedback_id when you make a request to /v1/facebook/post. (e.g. ZmVlZGJhY2s6MTQ0NzY1NjMyMzM4Mzg0OA==)"},"cursor":{"type":"string","description":"Cursor to get more comments. Get 'cursor' from previous response. (e.g. MToxNzU3MTA2NzYyOgF1P1VkxpkA9Ds4...)"}},"required":[]}},"v1_facebook_group_posts":{"name":"v1_facebook_group_posts","description":"Fetches posts from a public Facebook group, limited to 3 posts per page due to API limitations. Each post includes id, text, url, reactionCount, commentCount, publishTime, videoDetails, and topComments. Supports sorting by TOP_POSTS, RECENT_ACTIVITY, CHRONOLOGICAL, or CHRONOLOGICAL_LISTINGS, with cursor-based pagination.","inputSchema":{"type":"object","properties":{"url":{"type":"string","description":"The URL of the group (e.g. https://www.facebook.com/groups/1270525996445602/)"},"group_id":{"type":"string","description":"The ID of the group (e.g. 742354120555345)"},"sort_by":{"type":"string","description":"How to sort the posts (e.g. TOP_POSTS)","enum":["TOP_POSTS","RECENT_ACTIVITY","CHRONOLOGICAL","CHRONOLOGICAL_LISTINGS"]},"cursor":{"type":"string","description":"The cursor to paginate to the next page (e.g. AQHRBjJCelNvdGRjH8s2j-6...)"}},"required":[]}},"v1_facebook_events_search":{"name":"v1_facebook_events_search","description":"Search for events by name. You can take a look at the page from Facebook we are getting the data from [here](https://www.facebook.com/events/search/?q=dogs)","inputSchema":{"type":"object","properties":{"query":{"type":"string","description":"The query to search for (e.g. Event name or description)"},"cursor":{"type":"string","description":"The cursor to paginate to the next page (e.g. Abr1gHMU6H....)"}},"required":["query"]}},"v1_facebook_events":{"name":"v1_facebook_events","description":"Get the events of a city. Check out this [link](https://www.facebook.com/events/explore/saint-petersburg-florida/111326725552547) for an example of where we are getting the data from.","inputSchema":{"type":"object","properties":{"url":{"type":"string","description":"The URL of the city's Facebook Events page (e.g. https://www.facebook.com/events/explore/saint-petersburg-florida/111326725552547)"},"time":{"type":"string","description":"The time frame to search for. Defaults to all time","enum":["today","this_week","next_week"]},"cursor":{"type":"string","description":"The cursor to paginate to the next page (e.g. eyJzdGFydF...)"}},"required":["url"]}},"v1_facebook_event_details":{"name":"v1_facebook_event_details","description":"Get a specific event by its URL or id","inputSchema":{"type":"object","properties":{"id":{"type":"string","description":"The ID of the event (e.g. 2255360061870188)"},"url":{"type":"string","description":"The URL of the event (e.g. https://www.facebook.com/events/2255360061870188/)"}},"required":["url"]}},"v1_facebook_adLibrary_ad":{"name":"v1_facebook_adLibrary_ad","description":"Retrieves detailed information about a specific Facebook ad by its ID or URL. Returns adArchiveID, pageName, isActive, startDate, endDate, and a snapshot containing body, images, videos, display_format, link_url, and cta_text. For ads with multiple versions, the ad creative is found in the snapshot.cards array rather than snapshot.body.","inputSchema":{"type":"object","properties":{"id":{"type":"string","description":"Facebook Ad Id (e.g. 702369045530963)"},"url":{"type":"string","description":"Facebook Ad URL (e.g. https://www.facebook.com/ads/library?id=1185617869915074)"},"get_transcript":{"type":"boolean","description":"Get the transcript of the ad. Only works if the video is under 2 minutes."},"trim":{"type":"boolean","description":"Set to true for a trimmed down version of the response"}},"required":[]}},"v1_facebook_adLibrary_search_ads":{"name":"v1_facebook_adLibrary_search_ads","description":"Searches the Meta Ad Library by keyword and returns matching ads. Each result includes ad_archive_id, page_name, is_active, publisher_platform, and a snapshot with body text, images, videos, and cta_text. Results cap around 1,500 via GET due to cursor size limits; switch to POST method with body params for larger result sets.","inputSchema":{"type":"object","properties":{"query":{"type":"string","description":"Keyword to search for (e.g. running)"},"sort_by":{"type":"string","description":"Sort by impressions (high to low), or Most Recent (relevancy_monthly_grouped). Defaults to impressions. (e.g. total_impressions)","enum":["total_impressions","relevancy_monthly_grouped"]},"search_type":{"type":"string","description":"If you want to search by exact phrase or not (e.g. keyword_unordered)","enum":["keyword_unordered","keyword_exact_phrase"]},"ad_type":{"type":"string","description":"Search for all ads or only political and issue ads (e.g. all)","enum":["all","political_and_issue_ads"]},"country":{"type":"string","description":"This can only be one country. It has to be the 2 letter code for the country. It defaults to ALL. (e.g. ALL)"},"status":{"type":"string","description":"Status of the ad. Defaults to ACTIVE. (e.g. ACTIVE)","enum":["ALL","ACTIVE","INACTIVE"]},"media_type":{"type":"string","description":"Media type of the ad. Defaults to ALL. Meme just means the ad has text and an image. No clue why they call it meme. (e.g. ALL)","enum":["ALL","IMAGE","VIDEO","MEME","IMAGE_AND_MEME","NONE"]},"start_date":{"type":"string","description":"Impressions start date. Needs to be in YYYY-MM-DD format. (e.g. 2025-01-05)"},"end_date":{"type":"string","description":"Impressions end date. Needs to be in YYYY-MM-DD format. (e.g. 2025-02-16)"},"cursor":{"type":"string","description":"Cursor to paginate through results (e.g. AQHRYLVDkoMkvGv7yK1rcce-vJmKiKv330R4v3j9KHSOaYvmF1bq1QkotG0rgW8Fkrj-)"},"trim":{"type":"boolean","description":"Set to true for a trimmed down version of the response"}},"required":["query"]}},"v1_facebook_adLibrary_company_ads":{"name":"v1_facebook_adLibrary_company_ads","description":"Fetches all ads currently running for a specific company from the Meta Ad Library. Each ad includes ad_archive_id, page_name, is_active, publisher_platform, and a snapshot with body, images, videos, and display_format. Supports filtering by country, media_type, date range, and language with cursor-based pagination.","inputSchema":{"type":"object","properties":{"pageId":{"type":"string","description":"The companies ad library page id. You can get this with my Search For Companies Endpoint. Can either use this or companyName (e.g. 367152833370567)"},"companyName":{"type":"string","description":"The name of the company. Can either use this or pageId (e.g. Lululemon)"},"country":{"type":"string","description":"This can only be one country. It has to be the 2 letter code for the country. It defaults to ALL. (e.g. ALL)"},"status":{"type":"string","description":"Status of the ad. Defaults to ACTIVE. (e.g. ACTIVE)","enum":["ALL","ACTIVE","INACTIVE"]},"media_type":{"type":"string","description":"Media type of the ad. Defaults to ALL. Meme refers to ads with image and text. Not sure why they call it meme. (e.g. ALL)","enum":["ALL","IMAGE","VIDEO","MEME","IMAGE_AND_MEME","NONE"]},"language":{"type":"string","description":"Language to filter ads on. Needs to be 2 letter language code, ie EN, ES, FR, etc (e.g. EN)"},"sort_by":{"type":"string","description":"Sort by impressions (high to low), or Most Recent (relevancy_monthly_grouped). Defaults to impressions. (e.g. total_impressions)","enum":["total_impressions","relevancy_monthly_grouped"]},"start_date":{"type":"string","description":"Start date to search for. Format: YYYY-MM-DD (e.g. 2025-01-01)"},"end_date":{"type":"string","description":"End date to search for. Format: YYYY-MM-DD (e.g. 2025-12-31)"},"cursor":{"type":"string","description":"Cursor to paginate through results (e.g. AQHRBUAxNmFlxBVMFL6uTb1ICFsV65O4SqmPbcVZJhiveBpPS1hFHAmL6yCJcF760cXP)"},"trim":{"type":"boolean","description":"Set to true for a trimmed down version of the response"}},"required":[]}},"v1_facebook_adLibrary_search_companies":{"name":"v1_facebook_adLibrary_search_companies","description":"Searches for companies by name in the Meta Ad Library and returns their page IDs for use with other ad library endpoints. Each result includes page_id, name, category, likes, verification status, and Instagram details like ig_username and ig_followers.","inputSchema":{"type":"object","properties":{"query":{"type":"string","description":"Keyword to search for (e.g. nike)"}},"required":["query"]}},"v1_google_company_ads":{"name":"v1_google_company_ads","description":"Fetches public ads for a company from the Google Ad Transparency Library by domain or advertiser_id. Each ad includes advertiserId, creativeId, format, adUrl, advertiserName, domain, firstShown, and lastShown. Costs 25 credits per request when get_ad_details=true; without it, only advertiserId and creativeId are returned at 1 credit.","inputSchema":{"type":"object","properties":{"domain":{"type":"string","description":"The domain of the company (e.g. lululemon.com)"},"advertiser_id":{"type":"string","description":"The advertiser id of the company (e.g. AR01614014350098432001)"},"topic":{"type":"string","description":"The topic to search for. If you search for 'political', you will also need to pass a 'region', like 'US' or 'AU' (e.g. all)","enum":["all","political"]},"region":{"type":"string","description":"The region to search for. Defaults to anywhere (e.g. US)"},"start_date":{"type":"string","description":"Start date to search for. Format: YYYY-MM-DD (e.g. 2025-08-01)"},"end_date":{"type":"string","description":"End date to search for. Format: YYYY-MM-DD (e.g. 2025-08-11)"},"get_ad_details":{"type":"string","description":"Set to true to get the ad details. Will cost 25 credits."},"cursor":{"type":"string","description":"Cursor to paginate through results (e.g. CgoAP7znOo9RPjf%2FEhD5utgx8m75NrTTbU0AAAAAGgn8%2BJyW%2BJQK40A%3D)"}},"required":[]}},"v1_google_ad":{"name":"v1_google_ad","description":"Retrieves detailed information about a specific Google ad including advertiserId, creativeId, format, firstShown, lastShown, and overallImpressions. Returns creativeRegions, regionStats with per-region impression data, and variations with destinationUrl, headline, description, and imageUrl. Text extraction uses OCR, so accuracy may vary.","inputSchema":{"type":"object","properties":{"url":{"type":"string","description":"The url of the ad (e.g. https://adstransparency.google.com/advertiser/AR01614014350098432001/creative/CR10449491775734153217)"}},"required":["url"]}},"v1_google_adLibrary_advertisers_search":{"name":"v1_google_adLibrary_advertisers_search","description":"Searches the Google Ad Transparency Library for advertisers by name. Returns a list of matching advertisers with their name, advertiser_id, and region, plus a list of associated website domains. Use the returned advertiser_id to look up a company's ads.","inputSchema":{"type":"object","properties":{"query":{"type":"string","description":"The query to search for (e.g. lululemon)"}},"required":["query"]}},"v1_linkedin_ads_search":{"name":"v1_linkedin_ads_search","description":"Searches the LinkedIn Ad Library by company name, keyword, or companyId with optional country and date filters. Each ad includes id, description, headline, adType, advertiser, targeting details, image or video URLs, totalImpressions, and impressionsByCountry. Supports pagination via paginationToken.","inputSchema":{"type":"object","properties":{"company":{"type":"string","description":"The company name to search for. 'Microsoft' for example (e.g. microsoft)"},"keyword":{"type":"string","description":"The keyword to search for (e.g. scraping)"},"companyId":{"type":"string","description":"The company id to search for (e.g. 157238)"},"countries":{"type":"string","description":"Comma separated list of countries. Example: US,CA,MX (e.g. US,CA,MX)"},"startDate":{"type":"string","description":"Start date to search for. Format: YYYY-MM-DD (e.g. 2024-01-01)"},"endDate":{"type":"string","description":"End date to search for. Format: YYYY-MM-DD (e.g. 2024-01-10)"},"paginationToken":{"type":"string","description":"Pagination token to paginate through results (e.g. 640547184-1743616612000)"}},"required":[]}},"v1_linkedin_ad":{"name":"v1_linkedin_ad","description":"Retrieves detailed information about a specific LinkedIn ad by URL. Returns id, description, headline, adType, advertiser, and targeting with language, location, and audience criteria. Also includes totalImpressions, impressionsByCountry, adDuration, startDate, and endDate.","inputSchema":{"type":"object","properties":{"url":{"type":"string","description":"The url of the ad (e.g. https://www.linkedin.com/ad-library/detail/666281156)"}},"required":["url"]}},"v1_twitter_profile":{"name":"v1_twitter_profile","description":"Retrieves a Twitter user's profile by handle, including account metadata and statistics. Returns name, screen_name, description, followers_count, friends_count, statuses_count, favourites_count, location, profile_image_url_https, and is_blue_verified. Also includes verification_info, tipjar_settings, highlights_info, and creator_subscriptions_count.","inputSchema":{"type":"object","properties":{"handle":{"type":"string","description":"Twitter handle (e.g. Austen)"}},"required":["handle"]}},"v1_twitter_user_tweets":{"name":"v1_twitter_user_tweets","description":"Fetches tweets from a Twitter user's profile by handle. Note: Twitter publicly returns only ~100 of the user's most popular tweets, not chronological or latest. Each tweet includes rest_id, full_text, views count, favorite_count, retweet_count, reply_count, bookmark_count, quote_count, created_at, media entities, and url. Supports a trim parameter for a lighter response.","inputSchema":{"type":"object","properties":{"handle":{"type":"string","description":"Twitter handle (e.g. levelsio)"},"trim":{"type":"boolean","description":"Set to true for a trimmed down version of the response"}},"required":["handle"]}},"v1_twitter_tweet":{"name":"v1_twitter_tweet","description":"Retrieves detailed information about a specific tweet by URL, including the author's profile and engagement metrics. Returns rest_id, full_text, views count, favorite_count, retweet_count, reply_count, bookmark_count, quote_count, created_at, source, and media entities. Supports a trim parameter for a lighter response.","inputSchema":{"type":"object","properties":{"url":{"type":"string","description":"Tweet URL"},"trim":{"type":"boolean","description":"Set to true for a trimmed down version of the response"}},"required":["url"]}},"v1_twitter_tweet_transcript":{"name":"v1_twitter_tweet_transcript","description":"Extracts the transcript from a Twitter video tweet using AI-powered transcription. The video must be under 2 minutes long. Returns a success flag and the full transcript text. This endpoint is slower than others due to the AI processing step.","inputSchema":{"type":"object","properties":{"url":{"type":"string","description":"Tweet URL (e.g. https://x.com/TheoVon/status/1916982720317821050)"}},"required":["url"]}},"v1_twitter_community":{"name":"v1_twitter_community","description":"Retrieves details about a Twitter/X Community by URL. Returns the community name, description, rest_id, join_policy, created_at, member_count, rules, and creator_results with the creator's profile. Also includes members_facepile_results with avatar images of recent members.","inputSchema":{"type":"object","properties":{"url":{"type":"string","description":"Community URL (e.g. https://x.com/i/communities/1926186499399139650)"}},"required":["url"]}},"v1_twitter_community_tweets":{"name":"v1_twitter_community_tweets","description":"Fetches tweets posted within a Twitter/X Community by URL. Returns an array of tweets, each with id, full_text, view_count, favorite_count, retweet_count, reply_count, bookmark_count, quote_count, created_at, and source. Each tweet includes a user object with the author's name, screen_name, avatar, followers_count, and is_blue_verified status.","inputSchema":{"type":"object","properties":{"url":{"type":"string","description":"Community URL (e.g. https://x.com/i/communities/1926186499399139650)"}},"required":["url"]}},"v1_reddit_subreddit_details":{"name":"v1_reddit_subreddit_details","description":"Retrieves metadata about a subreddit by name or URL. The subreddit name must be case-sensitive. Returns display_name, description, subscribers, weekly_active_users, weekly_contributions, rules, icon_img, header_img, advertiser_category, submit_text, and created_at.","inputSchema":{"type":"object","properties":{"subreddit":{"type":"string","description":"Subreddit name. MUST be case sensitive. So 'AskReddit' not 'askreddit'. (e.g. AskReddit)"},"url":{"type":"string","description":"Subreddit URL (e.g. https://www.reddit.com/r/AbsoluteUnits/)"}},"required":[]}},"v1_reddit_subreddit":{"name":"v1_reddit_subreddit","description":"Fetches posts from a subreddit with sorting and filtering options. Each post includes title, author, selftext, score, ups, upvote_ratio, num_comments, created_utc, url, permalink, subreddit_subscribers, and is_video. Supports sort (best, hot, new, top, rising), timeframe filtering, pagination via the after token, and a trim parameter for lighter responses.","inputSchema":{"type":"object","properties":{"subreddit":{"type":"string","description":"Subreddit name"},"timeframe":{"type":"string","description":"Timeframe to get posts from","enum":["all","day","week","month","year"]},"sort":{"type":"string","description":"Sort order","enum":["best","hot","new","top","rising"]},"after":{"type":"string","description":"After to get more posts. Get 'after' from previous response. (e.g. t3_1234567890)"},"trim":{"type":"boolean","description":"Set to true for a trimmed down version of the response"}},"required":["subreddit"]}},"v1_reddit_subreddit_search":{"name":"v1_reddit_subreddit_search","description":"Searches within a specific subreddit for posts, comments, and media matching a query. Returns posts with title, votes, num_comments, url, and created_at; comments with author, body, votes, and parent post info; and media with title, media_type, image dimensions, and gallery_count. Supports sort, timeframe filtering, and cursor-based pagination.","inputSchema":{"type":"object","properties":{"subreddit":{"type":"string","description":"Subreddit name (e.g. 'Fitness', not 'r/Fitness' or a full URL)"},"query":{"type":"string","description":"Search query to find matching content (e.g. push ups)"},"sort":{"type":"string","description":"Sort order. For posts/media: relevance, hot, top, new, comments. For comments: relevance, top, new","enum":["relevance","hot","top","new","comments"]},"timeframe":{"type":"string","description":"Timeframe to filter results","enum":["all","year","month","week","day","hour"]},"cursor":{"type":"string","description":"Cursor to get more results. Get 'cursor' from previous response. (e.g. eyJjYW5kaWRhdGVzX3JldHVybmVkIjoi...)"}},"required":["subreddit"]}},"v1_reddit_post_comments":{"name":"v1_reddit_post_comments","description":"Retrieves comments and post details from a Reddit post by URL. Returns the post with title, author, score, ups, upvote_ratio, num_comments, and created_utc, plus a comments array where each comment includes author, body, body_html, score, created_utc, parent_id, permalink, and nested replies. Supports cursor-based pagination for loading more comments and a trim parameter for lighter responses.","inputSchema":{"type":"object","properties":{"url":{"type":"string","description":"Reddit post URL (e.g. https://www.reddit.com/r/AskReddit/comments/ablzuq/people_who_havent_pooped_in_2019_yet_why_are_you/)"},"cursor":{"type":"string","description":"Cursor to get more comments, or replies. (e.g. ed1lvsa,ed3fnpq,ed25l2w)"},"trim":{"type":"boolean","description":"Set to true for a trimmed down version of the response"}},"required":["url"]}},"v1_reddit_search":{"name":"v1_reddit_search","description":"Searches across all of Reddit for posts matching a query. Each post includes title, author, selftext, subreddit, score, ups, upvote_ratio, num_comments, created_utc, url, permalink, and is_video. Supports sort (relevance, new, top, comment_count), timeframe filtering, pagination via the after token, and a trim parameter for lighter responses.","inputSchema":{"type":"object","properties":{"query":{"type":"string","description":"Search query"},"sort":{"type":"string","description":"Sort by (e.g. relevance)","enum":["relevance","new","top","comment_count"]},"timeframe":{"type":"string","description":"Timeframe (e.g. all)","enum":["all","day","week","month","year"]},"after":{"type":"string","description":"Used to paginate to next page (e.g. t3_1i8z28z)"},"trim":{"type":"boolean","description":"Set to true for a trimmed down version of the response"}},"required":["query"]}},"v1_truthsocial_profile":{"name":"v1_truthsocial_profile","description":"Retrieves a Truth Social user's public profile including display_name, username, avatar, header, followers_count, following_count, statuses_count, verified status, website, and created_at. Only prominent public figures (e.g., Trump, Vance) are accessible without authentication; most other accounts will not work.","inputSchema":{"type":"object","properties":{"handle":{"type":"string","description":"Truth Social username (e.g. realDonaldTrump)"}},"required":["handle"]}},"v1_truthsocial_user_posts":{"name":"v1_truthsocial_user_posts","description":"Fetches a paginated list of posts from a Truth Social user, returning text, id, created_at, url, content, account info, media_attachments, card link previews, replies_count, reblogs_count, and favourites_count. Supports pagination via next_max_id and a trim option for lighter responses. Only prominent public figures (e.g., Trump, Vance) are accessible without authentication.","inputSchema":{"type":"object","properties":{"handle":{"type":"string","description":"Truth Social username (e.g. realDonaldTrump)"},"user_id":{"type":"string","description":"Truth Social user id. Use this for faster response times. Trumps is 107780257626128497. It is the 'id' field in the profile endpoint. (e.g. 107780257626128497)"},"next_max_id":{"type":"string","description":"Used to paginate to next page (e.g. 107780257626128497)"},"trim":{"type":"boolean","description":"Set to true for a trimmed down version of the response"}},"required":[]}},"v1_truthsocial_post":{"name":"v1_truthsocial_post","description":"Fetches a single Truth Social post by URL, returning text, id, created_at, url, content, account details, media_attachments, card link previews, replies_count, reblogs_count, and favourites_count. Only posts from prominent public figures (e.g., Trump, Vance) are accessible without authentication.","inputSchema":{"type":"object","properties":{"url":{"type":"string","description":"Truth Social post URL (e.g. https://truthsocial.com/@realDonaldTrump/posts/114315219437063160)"}},"required":["url"]}},"v1_threads_profile":{"name":"v1_threads_profile","description":"Retrieves a Threads user's public profile including username, full_name, biography, profile_pic_url, follower_count, is_verified, bio_links, and hd_profile_pic_versions. Also indicates whether the account is a threads-only user via is_threads_only_user.","inputSchema":{"type":"object","properties":{"handle":{"type":"string","description":"Threads username (e.g. trendspider)"}},"required":["handle"]}},"v1_threads_user_posts":{"name":"v1_threads_user_posts","description":"Fetches the most recent posts from a Threads user, returning id, caption text, code, like_count, reshare_count, direct_reply_count, repost_count, image_versions2, video_versions, and taken_at. Only the last 20-30 posts are publicly visible. Supports a trim option for lighter responses.","inputSchema":{"type":"object","properties":{"handle":{"type":"string","description":"Threads username (e.g. trendspider)"},"trim":{"type":"boolean","description":"Set to true for a trimmed down version of the response"}},"required":["handle"]}},"v1_threads_post":{"name":"v1_threads_post","description":"Fetches a single Threads post by URL, returning the post's caption, like_count, view_counts, reshare_count, direct_reply_count, image_versions2, and taken_at. Also includes comments and related_posts arrays. Supports a trim option for lighter responses.","inputSchema":{"type":"object","properties":{"url":{"type":"string","description":"The URL of the post to get (e.g. https://www.threads.com/@trendspider/post/DIU8naHS6q_)"},"trim":{"type":"boolean","description":"Set to true for a trimmed down version of the response"}},"required":["url"]}},"v1_threads_search":{"name":"v1_threads_search","description":"Searches Threads for posts matching a keyword, returning up to 10 results with caption text, like_count, reshare_count, direct_reply_count, user info, and image_versions2. Supports optional start_date and end_date filters plus a trim option. Only 10 results are returned per request due to public API limitations.","inputSchema":{"type":"object","properties":{"query":{"type":"string","description":"Keyword to search for (e.g. basketball)"},"start_date":{"type":"string","description":"Start date to search for (e.g. 2026-01-01)"},"end_date":{"type":"string","description":"End date to search for (e.g. 2026-01-01)"},"trim":{"type":"boolean","description":"Set to true for a trimmed down version of the response"}},"required":["query"]}},"v1_threads_search_users":{"name":"v1_threads_search_users","description":"Searches for Threads users by username, returning matching profiles with username, full_name, profile_pic_url, is_verified, and pk. Useful for finding user accounts before fetching their profile or posts.","inputSchema":{"type":"object","properties":{"query":{"type":"string","description":"Username to search for (e.g. shams)"}},"required":["query"]}},"v1_bluesky_profile":{"name":"v1_bluesky_profile","description":"Retrieves a Bluesky user's public profile including handle, displayName, avatar, description, followersCount, followsCount, postsCount, createdAt, and verification status. The associated field shows counts for lists, feed generators, and starter packs.","inputSchema":{"type":"object","properties":{"handle":{"type":"string","description":"Bluesky handle (e.g. espn.com)"}},"required":["handle"]}},"v1_bluesky_user_posts":{"name":"v1_bluesky_user_posts","description":"Fetches a paginated feed of posts from a Bluesky user, returning each post's uri, record text, author info, embed content, replyCount, repostCount, likeCount, quoteCount, and indexedAt. Supports pagination via cursor. Use user_id (the 'did') instead of handle for faster response times.","inputSchema":{"type":"object","properties":{"handle":{"type":"string","description":"Bluesky handle (e.g. espn.com)"},"user_id":{"type":"string","description":"Bluesky 'did'. (For some reason Bluesky calls their user ids, 'did' for whatever reason) (e.g. did:plc:x7d6j54pm22ufehkes6jo4jf)"}},"required":[]}},"v1_bluesky_post":{"name":"v1_bluesky_post","description":"Fetches a single Bluesky post by URL, returning the post's record text, author info, embed content, replyCount, repostCount, likeCount, and quoteCount. Also includes a replies array with threaded reply posts.","inputSchema":{"type":"object","properties":{"url":{"type":"string","description":"Bluesky post URL (e.g. https://bsky.app/profile/espn.com/post/3lqdfq7fkvm2g)"}},"required":["url"]}},"v1_pinterest_search":{"name":"v1_pinterest_search","description":"Searches Pinterest for pins matching a query, returning results with id, url, title, description, images, link, domain, board info, and pinner details. Supports pagination via cursor and a trim option for lighter responses.","inputSchema":{"type":"object","properties":{"query":{"type":"string","description":"Search query (e.g. Italian Pot Roast)"},"cursor":{"type":"string","description":"Cursor (e.g. Y2JVSG81V2sxcmNHRlpWM1J...)"},"trim":{"type":"boolean","description":"Set to true for a trimmed down version of the response"}},"required":["query"]}},"v1_pinterest_pin":{"name":"v1_pinterest_pin","description":"Fetches detailed information about a single Pinterest pin by URL, returning title, description, link, dominantColor, originPinner, pinner, images at multiple resolutions (imageSpec_236x through imageSpec_orig), and pinJoin with visual annotations. Supports a trim option for lighter responses.","inputSchema":{"type":"object","properties":{"url":{"type":"string","description":"Pinterest pin URL (e.g. https://www.pinterest.com/pin/1124351863225567517/)"},"trim":{"type":"boolean","description":"Set to true for a trimmed down version of the response"}},"required":["url"]}},"v1_pinterest_user_boards":{"name":"v1_pinterest_user_boards","description":"Fetches a paginated list of boards for a Pinterest user, returning each board's name, url, description, pin_count, follower_count, owner info, cover_images, and created_at. Supports pagination via cursor and a trim option for lighter responses.","inputSchema":{"type":"object","properties":{"handle":{"type":"string","description":"The username of the user to get boards for. (e.g. broadstbullycom from https://www.pinterest.com/broadstbullycom/) (e.g. broadstbullycom)"},"trim":{"type":"boolean","description":"Set to true for a trimmed down version of the response"}},"required":["handle"]}},"v1_pinterest_board":{"name":"v1_pinterest_board","description":"Fetches a paginated list of pins from a Pinterest board by URL, returning each pin's id, description, title, images, board info, pin_join annotations, and aggregated_pin_data. Supports pagination via cursor and a trim option for lighter responses.","inputSchema":{"type":"object","properties":{"url":{"type":"string","description":"The URL of the board to get (e.g. https://www.pinterest.com/lizmrodgers/moms-night/)"},"cursor":{"type":"string","description":"The cursor to get the next page of results (e.g. Y2JURlEwTWsxNlp6Vk9SR2MwV....)"},"trim":{"type":"boolean","description":"Set to true for a trimmed down version of the response"}},"required":["url"]}},"v1_google_search":{"name":"v1_google_search","description":"Performs a Google search and returns organic results with url, title, and description for each result. Supports an optional region parameter (2-letter country code) to get localized results from a specific country.","inputSchema":{"type":"object","properties":{"query":{"type":"string","description":"Search query (e.g. austen allred)"},"region":{"type":"string","description":"2 letter country code, ie US, UK, CA, etc This will show results from that country (e.g. US)"},"date_posted":{"type":"string","description":"Date posted (e.g. last-hour)","enum":["last-hour","last-day","last-week","last-month","last-year"]},"page":{"type":"number","description":"Page number to retrieve (e.g. 1)"}},"required":["query"]}},"v1_twitch_profile":{"name":"v1_twitch_profile","description":"Retrieves a Twitch user's public profile by handle, including identity, social links, and content. Returns id, handle, displayName, description, followers count, and linked social accounts (instagram, x, tiktok). Also includes allVideos with game info, duration, and view counts, featuredClips with clip metadata and thumbnails, and similarStreamers.","inputSchema":{"type":"object","properties":{"handle":{"type":"string","description":"Twitch handle (e.g. ishowspeed)"}},"required":["handle"]}},"v1_twitch_user_videos":{"name":"v1_twitch_user_videos","description":"Fetches a list of videos (100 max) for a Twitch user, returning each video's id, slug, url, embedURL, title, viewCount, language, durationSeconds, game info, broadcaster details with follower count, thumbnailURL, and videoQualities at multiple resolutions with a signed videoURL for playback. Supports pagination via cursor and a trim option for lighter responses.","inputSchema":{"type":"object","properties":{"handle":{"type":"string","description":"Twitch handle (e.g. ishowspeed)"},"filter_by":{"type":"string","description":"Filter by","enum":["HIGHLIGHT","ARCHIVE","UPLOAD"]},"sort_by":{"type":"string","description":"Sort by","enum":["TIME","VIEWS"]}},"required":["handle"]}},"v1_twitch_user_schedule":{"name":"v1_twitch_user_schedule","description":"Fetches a user's schedule by handle, returning a list of scheduled events with start time, end time, title, description, and thumbnail URL. Supports pagination via cursor and a trim option for lighter responses.","inputSchema":{"type":"object","properties":{"handle":{"type":"string","description":"Twitch handle (e.g. emongg)"}},"required":["handle"]}},"v1_twitch_clip":{"name":"v1_twitch_clip","description":"Fetches detailed data for a Twitch clip by URL, including metadata and direct video URLs. Returns clip id, slug, url, embedURL, title, viewCount, language, durationSeconds, game info, broadcaster details with follower count, thumbnailURL, and videoQualities at multiple resolutions with a signed videoURL for playback. Also includes additional clips from the same broadcaster.","inputSchema":{"type":"object","properties":{"url":{"type":"string","description":"Twitch clip URL (e.g. https://www.twitch.tv/staryuuki/clip/CloudySavageMarjoramRuleFive--ErzsYbE7UWvgCMQ?filter=clips&range=all&sort=time)"}},"required":["url"]}},"v1_spotify_artist":{"name":"v1_spotify_artist","description":"Retrieves detailed information about a Spotify artist by their handle, including name, followers count, genres, and related artists. Accepts a handle as input and returns artist metadata such as id, name, followers, genres, and related artists.","inputSchema":{"type":"object","properties":{"id":{"type":"string","description":"Spotify artist id. If you'd prefer to use the URL instead, you can use the url parameter instead. (e.g. 0cGUm45nv7Z6M6qdXYQGTX)"},"url":{"type":"string","description":"Spotify artist URL. If you'd prefer to use the id instead, you can use the id parameter instead. (e.g. https://open.spotify.com/artist/0cGUm45nv7Z6M6qdXYQGTX)"}},"required":[]}},"v1_soundcloud_artist":{"name":"v1_soundcloud_artist","description":"Fetches detailed information about a SoundCloud artist by its handle or URL. Returns artist metadata including id, name, followers, etc","inputSchema":{"type":"object","properties":{"handle":{"type":"string","description":"SoundCloud artist handle. If you'd prefer to use the URL instead, you can use the url parameter instead. (e.g. kehlanimusic)"},"url":{"type":"string","description":"SoundCloud artist URL. If you'd prefer to use the handle instead, you can use the handle parameter instead. (e.g. https://soundcloud.com/kehlanimusic)"}},"required":[]}},"v1_kick_clip":{"name":"v1_kick_clip","description":"Fetches detailed data for a Kick clip by URL, including video, metadata, and channel info. Returns clip id, title, clip_url, thumbnail_url, video_url, view_count, likes_count, duration, privacy status, and is_mature flag. Also includes category details (name, slug), creator info (username), and channel info (username, profile_picture).","inputSchema":{"type":"object","properties":{"url":{"type":"string","description":"Kick clip URL (e.g. https://kick.com/xqc/clips/clip_01JGJHB6CEVFCQRYTVPM8DW892)"}},"required":["url"]}},"v1_snapchat_profile":{"name":"v1_snapchat_profile","description":"Retrieves a Snapchat user's public profile by handle, including identity, stories, and spotlight content. Returns userProfile with username, title, snapcodeImageUrl, subscriberCount, bio, and profilePictureUrl. Also includes highlightStoryMetadata with individual story snaps (mediaUrl, mediaType, thumbnailUrl) and spotlightStoryMetadata with video details and engagement stats (viewCount, shareCount, commentCount).","inputSchema":{"type":"object","properties":{"handle":{"type":"string","description":"Snapchat username (e.g. zane)"}},"required":["handle"]}},"v1_linktree":{"name":"v1_linktree","description":"Scrapes a Linktree page by URL, extracting the creator's profile and all their links. Returns id, username, profilePictureUrl, description, verticals, timezone, and links — an array of link objects each with id, type, title, and url. Also includes detected social accounts (instagram, tiktok, spotify, youtube, soundcloud, apple_music) and email_address.","inputSchema":{"type":"object","properties":{"url":{"type":"string","description":"URL to Linktree page (e.g. https://linktr.ee/miguelangeles)"}},"required":["url"]}},"v1_komi":{"name":"v1_komi","description":"Scrapes a Komi page by URL, extracting the creator's profile, social links, and featured content. Returns id, username, avatar, displayName, bio, and social accounts (instagram, tiktok, youtube, twitter, facebook, snapchat). Also includes links, an array of link and product objects each with id, url, title, type, thumbnail, and optional price and currency for products.","inputSchema":{"type":"object","properties":{"url":{"type":"string","description":"URL to Komi page (e.g. https://kimkardashian.komi.io/)"}},"required":["url"]}},"v1_pillar":{"name":"v1_pillar","description":"Scrapes a Pillar page by URL, extracting the creator's profile, social links, and products. Returns id, first_name, last_name, email, location, and social accounts (tiktok, spotify, twitter, youtube, facebook, linkedin, instagram, and more). Also includes links with click counts and products with title, price, description, and image.","inputSchema":{"type":"object","properties":{"url":{"type":"string","description":"URL to Pillar page (e.g. https://pillar.io/angelstrife)"}},"required":["url"]}},"v1_linkbio":{"name":"v1_linkbio","description":"Scrapes a Linkbio (lnk.bio) page by URL, extracting the creator's profile and all their links. Returns handle, id, social accounts (instagram, tiktok, youtube, twitter, whatsapp), email, website, and links — an array of link objects each with url and text.","inputSchema":{"type":"object","properties":{"url":{"type":"string","description":"URL to Linkbio (lnk.bio) page (e.g. https://lnk.bio/msjennafischer)"}},"required":["url"]}},"v1_amazon_shop":{"name":"v1_amazon_shop","description":"Scrapes a creator's Amazon Shop page by URL, returning their storefront profile and product collections. Returns avatar, name, description, socials, and lists with title and itemCount. Also includes trendingPicks with price and discount, curations with title and postCount, and a pageToken for pagination.","inputSchema":{"type":"object","properties":{"url":{"type":"string","description":"URL to Amazon Shop page (e.g. https://www.amazon.com/shop/sydneydelrey)"}},"required":["url"]}},"v1_detect_age_gender":{"name":"v1_detect_age_gender","description":"Uses AI to analyze a creator's profile photo and estimate their age and gender. Returns ageRange with low and high bounds, gender, and a confidence score for the gender prediction. The profile photo must contain a clear, visible face for accurate results.","inputSchema":{"type":"object","properties":{"url":{"type":"string","description":"URL to users social profile (e.g. https://twitter.com/levelsio)"}},"required":["url"]}},"v1_account_credit_balance":{"name":"v1_account_credit_balance","description":"Returns the number of API credits remaining on your Scrape Creators account. The response contains a single creditCount field with your current balance.","inputSchema":{"type":"object","properties":{},"required":[]}},"v1_account_get_api_usage":{"name":"v1_account_get_api_usage","description":"Returns a paginated list of your API requests, including the endpoint called, status code, credits used, and timestamp. Useful for debugging and monitoring your API usage. Supports filtering by endpoint name and status code.","inputSchema":{"type":"object","properties":{"page":{"type":"string","description":"Page number for pagination (max 100) (e.g. 1)"},"endpoint":{"type":"string","description":"Filter by endpoint name (partial match) (e.g. /v1/tiktok/profile)"},"statusCode":{"type":"string","description":"Filter by HTTP status code (e.g. 200)"}},"required":[]}},"v1_account_get_daily_usage_count":{"name":"v1_account_get_daily_usage_count","description":"Returns aggregated daily usage statistics for the last 30 days, including total credits consumed and number of requests per day.","inputSchema":{"type":"object","properties":{},"required":[]}},"v1_account_get_most_used_routes":{"name":"v1_account_get_most_used_routes","description":"Returns your top 20 most called API endpoints ranked by call count, along with total credits consumed per endpoint. Defaults to the last 24 hours. Supports custom time ranges up to 1 year.","inputSchema":{"type":"object","properties":{"start_time":{"type":"string","description":"Start of time range (ISO 8601 format) (e.g. 2025-04-01T00:00:00.000Z)"},"end_time":{"type":"string","description":"End of time range (ISO 8601 format) (e.g. 2025-04-15T23:59:59.000Z)"}},"required":[]}},"v1_linkme":{"name":"v1_linkme","description":"Retrieves a Linkme profile by URL, including identity, social links, and contact details. Returns profile with id, firstName, username, bio, profileVisitCount, profileImage, verifiedAccount, and isAmbassador flag. Also includes infoLinks (email addresses) and webLinks, an array of categorized social platform links (Spotify, Instagram, YouTube, Twitter, Facebook, and more) each with linkValue and faceValue.","inputSchema":{"type":"object","properties":{"url":{"type":"string","description":"Linkme profile URL (e.g. https://link.me/danucd)"}},"required":["url"]}}},"resources":[],"prompts":[]}}