# TrueScrape (remote · api.truescrape.com) Live context for your agent: competitors, mentions and markets, from public data. - Trust score: 62/100 (medium) - Registry status: active - Liveness: live - Owner verified: no - Last scored: 2026-11-04 ## Components - remote · `api.truescrape.com`: 62/100 (this document), [markdown](https://verifymcp.io/servers/truescrape-truescrape/api.md), [page](https://verifymcp.io/servers/truescrape-truescrape/api) - npm · `truescrape`: 49/100, [markdown](https://verifymcp.io/servers/truescrape-truescrape/truescrape.md), [page](https://verifymcp.io/servers/truescrape-truescrape/truescrape) ## Channel facts - Endpoint: `https://api.truescrape.com/mcp` - Transports: `streamable-http` - Auth: `none` - Version: `0.8.0` ## Trust breakdown How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog) Scored 2026-11-04. - **Endpoint Security**: 57/100 - The endpoint's TLS certificate is valid, in date, and uses a strong key. - Authorisation check failed: no authorisation is required to call this server, and it exposes a tool marked destructive (cancel_watch). - HTTPS is enforced; there's no plaintext access path. - HSTS check failed: the Strict-Transport-Security header is absent. - DNSSEC check failed: this domain isn't protected by DNSSEC. - **Transport & Reachability**: 100/100 - Verified streamable-http transport via a live MCP handshake. - **Schema Quality & AI Usability**: 64/100 - AI-judged instruction clarity (good). - Context-footprint check failed: tool/resource definitions use about 34170 tokens (~126/item across 271 items; 271 tools + 0 resources), over budget; trim descriptions and params. - Usage-examples check failed: none of the tools include examples. - **Stability & Change Management**: 16/100 - Stability check failed: schema churn in the 5 days we've observed: 0 tool removals, 1 breaking changes, 0 auth/transport breaks, 17 additions. - **Tool Coverage**: 88/100 - 100% of tools have a non-trivial description (not blank, and not just the tool's name). - 64% of tool parameters carry a description. - **Tool Safety**: 100/100 - No prompt-injection markers were found in the server instructions, tool names or descriptions we captured. - All 2 tool(s) whose name or description implies an irreversible operation declare an MCP destructiveHint annotation. - An AI judge read all 272 captured unit(s) of tool text and found none that tries to manipulate the model reading it. - **Capabilities**: 60/100 - Spec-recency check failed: implements MCP spec 2025-06-18; the latest is 2026-07-28. ## Install ### How do I install the TrueScrape MCP server? TrueScrape is a hosted endpoint at https://api.truescrape.com/mcp, so there is nothing to install locally. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation. ### Claude ```bash claude mcp add --transport http truescrape-truescrape 'https://api.truescrape.com/mcp' ``` ### Cursor ```json { "mcpServers": { "truescrape-truescrape": { "url": "https://api.truescrape.com/mcp" } } } ``` ### VS Code ```json { "servers": { "truescrape-truescrape": { "type": "http", "url": "https://api.truescrape.com/mcp" } } } ``` ### Codex ```toml [mcp_servers.truescrape-truescrape] url = "https://api.truescrape.com/mcp" ``` ### opencode ```json { "$schema": "https://opencode.ai/config.json", "mcp": { "truescrape-truescrape": { "type": "remote", "url": "https://api.truescrape.com/mcp", "enabled": true } } } ``` ### OpenClaw ```bash openclaw mcp add truescrape-truescrape --url 'https://api.truescrape.com/mcp' --transport streamable-http ``` ### Hermes ```yaml mcp_servers: truescrape-truescrape: url: "https://api.truescrape.com/mcp" ``` ### Netclaw ```json { "McpServers": { "truescrape-truescrape": { "Transport": "http", "Url": "https://api.truescrape.com/mcp" } } } ``` ### Vellum ```bash assistant mcp add truescrape-truescrape -t streamable-http -u 'https://api.truescrape.com/mcp' ``` ### Other ```json { "mcpServers": { "truescrape-truescrape": { "type": "http", "url": "https://api.truescrape.com/mcp" } } } ``` The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs. ## Changelog Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims. ### 2026-11-04 (score 62, 0) - [security] The server rewrote its instructions, which are the text every model session reads - [security] Tool “google_shopping” rewrote its description, which is the text the model reads - [security] Tool “identity_findSocialProfiles” rewrote its description, which is the text the model reads - [security] Tool “google_jobs” rewrote its description, which is the text the model reads - [security] Tool “google_search” rewrote its description, which is the text the model reads - [security] Tool “google_mapsSearch” rewrote its description, which is the text the model reads - [security] Tool “google_news” rewrote its description, which is the text the model reads - [functional] New tool “bilibili_video” - [functional] New tool “flickr_post” - [functional] New tool “mashable_video” - [functional] New tool “okru_video” - [functional] New tool “streamable_video” - [functional] New tool “vimeo_video” ### 2026-11-03 (score 62, +1) - [security] Tool “google_news” rewrote its description, which is the text the model reads - [security] Tool “google_search” rewrote its description, which is the text the model reads - [security] Tool “google_shopping” rewrote its description, which is the text the model reads - [security] Tool “google_jobs” rewrote its description, which is the text the model reads - [security] Tool “twitter_tweet” rewrote its description, which is the text the model reads - [security] Tool “twitter_userTweets” rewrote its description, which is the text the model reads - [security] Tool “google_mapsSearch” rewrote its description, which is the text the model reads - [cosmetic] “google_mapsSearch” reworded the description of “uule” - [cosmetic] “google_news” reworded the description of “tld” - [cosmetic] “google_news” reworded the description of “uule” - [cosmetic] “google_search” reworded the description of “date_posted” - [cosmetic] “google_search” reworded the description of “page” - [cosmetic] “google_shopping” reworded the description of “start” - [cosmetic] “google_shopping” reworded the description of “tbs” - [cosmetic] “google_shopping” reworded the description of “uule” - [cosmetic] “twitter_userTweets” reworded the description of “count” - [cosmetic] “google_jobs” reworded the description of “start” - [cosmetic] “google_jobs” reworded the description of “uule” ### 2026-11-02 (score 61, 0) - [security regression] Stability: 0.07 → fail - [security regression] A breaking change shipped without a version bump: still 0.1.0 - [security] The server rewrote its instructions, which are the text every model session reads - [security] Tool “create_monitor” rewrote its description, which is the text the model reads - [security] Tool “create_watch” rewrote its description, which is the text the model reads - [security] Tool “get_monitor_mentions” rewrote its description, which is the text the model reads - [functional regression] “create_monitor” added a required parameter “agent”, so existing callers break - [functional regression] “create_watch” added a required parameter “agent”, so existing callers break - [functional] New tool “call_tool” - [functional] New tool “check_monitor” - [functional] New tool “explore_tools” - [functional] New tool “find_mentions” - [functional] New tool “request_source” - [cosmetic] “get_monitor_mentions” added an optional parameter “query” - [cosmetic] “create_monitor” added an optional parameter “accounts” - [cosmetic] “create_monitor” added an optional parameter “max_credits” - [cosmetic] “create_monitor” added an optional parameter “schedule” - [cosmetic] “create_monitor” added an optional parameter “stop_at” - [cosmetic] “create_watch” added an optional parameter “max_credits” - [cosmetic] “create_watch” added an optional parameter “stop_at” - [cosmetic] “get_monitor_mentions” added an optional parameter “platform” - [cosmetic] “get_monitor_mentions” added an optional parameter “since” - [cosmetic] “get_monitor_mentions” added an optional parameter “source” - [cosmetic] “get_monitor_mentions” added an optional parameter “unread_only” - [cosmetic] “walmart_category” reworded the description of “category” ### 2026-11-01 (score 61, +1) - [security] The server rewrote its instructions, which are the text every model session reads - [security] New tool “delete_monitor”, which the server declares destructive - [functional] New tool “create_monitor” - [functional] New tool “get_monitor_mentions” - [functional] New tool “hackernews_search” - [functional] New tool “list_monitors” - [functional] New tool “bluesky_search” ### 2026-10-31 (score 60, 0) - [security] Tool “instagram_transcript” rewrote its description, which is the text the model reads - [functional improvement] Stability: unverified → 0.03 ### 2026-10-30 (score 60) First indexed and scored. ## MCP tools (271) ### `amazon_offers` (~180 tokens) amazon: All seller offers for a product All seller offers for a product. Every offer on an Amazon listing (price, seller, condition, Prime eligibility and shipping), alongside the product itself. Costs 3 credits. Input parameters: - `asin` (string, required): Amazon ASIN, e.g. "B08N5WRWNW" - `cache_max_age` (string) - `condition` (string): Filter offers to one condition. - `country_code` (string): Best-effort locale hint (ISO 3166-1 alpha-2). - `tld` (string): Marketplace TLD, default "com". One of: com, co.uk, ca, de, es, fr, ie, it, co.jp, co.za, in, cn, com.sg, com.mx, ae, com.br, nl, com.au, com.tr, sa, se, pl ### `amazon_product` (~164 tokens) amazon: Product details Product details. Public details for one Amazon listing: title, brand, price, availability, rating, specifications and an inline review sample. Costs 3 credits. Input parameters: - `asin` (string, required): Amazon ASIN, e.g. "B08N5WRWNW" - `cache_max_age` (string) - `country_code` (string): Best-effort locale hint (ISO 3166-1 alpha-2). - `tld` (string): Marketplace TLD, default "com". One of: com, co.uk, ca, de, es, fr, ie, it, co.jp, co.za, in, cn, com.sg, com.mx, ae, com.br, nl, com.au, com.tr, sa, se, pl ### `amazon_search` (~160 tokens) amazon: Search results Search results. Public Amazon search results for a query: position, price, rating and badges per item. Costs 3 credits. Input parameters: - `cache_max_age` (string) - `country_code` (string): Best-effort locale hint (ISO 3166-1 alpha-2). - `page` (number) - `query` (string, required): Search terms, e.g. "wireless mouse" - `tld` (string): Marketplace TLD, default "com". One of: com, co.uk, ca, de, es, fr, ie, it, co.jp, co.za, in, cn, com.sg, com.mx, ae, com.br, nl, com.au, com.tr, sa, se, pl ### `amazon_shop` (~270 tokens) amazon: Amazon Shop page Amazon Shop page. A creator's public Amazon storefront: their name, the product links the page exposes, and the storefront feed of idea lists (with Amazon's own item count), shoppable videos (id, title, thumbnail and attached ASINs) and shoppable photos. The first request needs no pageToken and already returns the videos embedded on the page. Pass `pagination.cursor` back as `pageToken`, unchanged, with the same shop URL for the next page; a page can carry lists, videos, photos or any mix. A continuation page carries the feed ONLY. Amazon serves it as a fragment with no profile markup, so every identity field (display name, bio, avatar) is null on page two onwards. ASINs are the products the storefront shows attached to an item, which for a long idea list is the first screenful rather than the whole list; `itemCount` is the true total. Costs 1 credit. Input parameters: - `cache_max_age` (string) - `pageToken` (string): Opaque page token returned by a previous response for the same shop URL. Pass it back unchanged and do not infer the response type from its value. - `url` (string, required): Storefront URL (https://www.amazon.com/shop/) or just the handle ### `appleMusic_album` (~84 tokens) apple-music: Album details Album details. Public Apple Music album: artist, release date, genre, artwork and total runtime. The track listing and copyright line are in `raw`, behind `include_raw=true`. Costs 1 credit. Input parameters: - `cache_max_age` (string) - `id` (string, required): Apple Music album id (1708308989) or a music.apple.com album URL ### `appleMusic_artist` (~82 tokens) apple-music: Artist details Artist details. Public Apple Music artist page: editorial bio, artist image, banner and genre. Apple publishes no follower or play counts, so those fields are null rather than guessed. Costs 1 credit. Input parameters: - `cache_max_age` (string) - `id` (string, required): Apple Music artist id (159260351) or a music.apple.com artist URL ### `appleMusic_search` (~102 tokens) apple-music: Search Search. Search the Apple Music catalogue for tracks, albums or artists. Tracks and albums come back as posts; artists come back as creators. Costs 1 credit. Input parameters: - `cache_max_age` (string) - `country` (string): Two-letter storefront, e.g. us, gb, de - `limit` (number) - `query` (string, required): Search terms - `type` (string): `song` is the same as `track` ### `appleMusic_track` (~82 tokens) apple-music: Track details Track details. Public Apple Music track: artist, album, duration, genre, release date and the 30-second preview URL. Costs 1 credit. Input parameters: - `cache_max_age` (string) - `id` (string, required): Apple Music track id (1833328840), a /song/ URL, or an album URL with ?i= ### `bilibili_video` (~128 tokens) bilibili: Video files and details Video files and details. A public Bilibili video's mp4 address (up to 720p), description, tags, duration and first frame. For a multi-part video, `?p=` in the URL selects the part. The title, the uploader, the counts and the upload date are null. The mp4 address expires 2 hours after it is issued. Costs 1 credit. Input parameters: - `cache_max_age` (string) - `url` (string, required): BV id (BV1GJ411x7h7) or a bilibili.com/video/BV… URL ### `bitchute_channel` (~85 tokens) bitchute: Channel profile Channel profile. A public BitChute channel: name, description, subscriber count, video count, total views and creation date. Costs 1 credit. Input parameters: - `cache_max_age` (string) - `channel` (string, required): Channel id (EhBWKghMUros), the channel name from its URL (nextnewsnetwork), or a bitchute.com/channel/... URL ### `bitchute_channelVideos` (~130 tokens) bitchute: Channel videos Channel videos. A BitChute channel's public videos, newest first, 50 per page, with view counts. Likes and comment counts are not in the list; `bitchute.video` has likes. Pass the `cursor` from the previous response to page. Costs 1 credit. Input parameters: - `cache_max_age` (string) - `channel` (string, required): Channel id (EhBWKghMUros), the channel name from its URL (nextnewsnetwork), or a bitchute.com/channel/... URL - `cursor` (string): `pagination.cursor` from the previous response ### `bitchute_search` (~82 tokens) bitchute: Search videos Search videos. Public BitChute video search, 50 per page, with view counts and the uploading channel. Costs 1 credit. Input parameters: - `cache_max_age` (string) - `cursor` (string): `pagination.cursor` from the previous response - `query` (string, required): Search terms, at least two characters - `sort` (string) ### `bitchute_video` (~97 tokens) bitchute: Video details Video details. A public BitChute video: title, description, hashtags, duration, publish date, channel, views and likes. Dislikes are in `raw`. `commentCount` is always null. Costs 1 credit. Input parameters: - `cache_max_age` (string) - `url` (string, required): BitChute video URL (bitchute.com/video/uIh_YOS_Lm4/) or a bare video id ### `bluesky_post` (~76 tokens) bluesky: Post Post. A single public Bluesky post with like, reply, repost and quote counts, plus any attached images or video. Costs 1 credit. Input parameters: - `cache_max_age` (string) - `url` (string, required): Post URL (https://bsky.app/profile//post/) or an at:// URI ### `bluesky_profile` (~80 tokens) bluesky: Profile Profile. Public profile for a Bluesky account: followers, following, post count, bio, avatar, banner, and verification status. Costs 1 credit. Input parameters: - `cache_max_age` (string) - `handle` (string, required): Handle (alice.bsky.social), a did:plc:… identifier, or a bsky.app profile URL ### `bluesky_search` (~65 tokens) bluesky: Search posts Search posts. Public Bluesky posts matching a keyword, newest first. Costs 1 credit. Input parameters: - `cache_max_age` (string) - `cursor` (string): `pagination.cursor` from a previous response - `query` (string, required): Keyword or phrase to search for ### `bluesky_userPosts` (~112 tokens) bluesky: User posts User posts. Recent public posts from a Bluesky account, newest first. Reposts are excluded by default so the feed reflects what the account actually wrote. Costs 1 credit. Input parameters: - `cache_max_age` (string) - `count` (number) - `cursor` (string): `pagination.cursor` from a previous response - `handle` (string, required): Handle, did, or bsky.app profile URL - `include_reposts` (string): Include reposts of other accounts. Default false. ### `dailymotion_channel` (~84 tokens) dailymotion: Channel profile Channel profile. Public profile of a Dailymotion channel: followers, following, video count, lifetime views, verification badge, country and creation date. Costs 1 credit. Input parameters: - `cache_max_age` (string) - `handle` (string, required): Channel username (wired), user id (x1audmk) or a dailymotion.com/ URL ### `dailymotion_channelVideos` (~111 tokens) dailymotion: Channel videos Channel videos. A Dailymotion channel's public uploads, newest first, 50 per page, all the way back to the first upload. Pass the `cursor` from the previous response to page. Costs 1 credit. Input parameters: - `cache_max_age` (string) - `cursor` (string): `pagination.cursor` from the previous response - `handle` (string, required): Channel username (wired), user id (x1audmk) or a dailymotion.com/ URL ### `dailymotion_search` (~98 tokens) dailymotion: Search videos Search videos. Public Dailymotion video search, 50 per page. Dailymotion returns at most the first 1,000 results for any query, so paging stops there. Costs 1 credit. Input parameters: - `cache_max_age` (string) - `cursor` (string): `pagination.cursor` from the previous response - `query` (string, required): Search terms - `sort` (string): `visited` is most viewed ### `dailymotion_video` (~95 tokens) dailymotion: Video details Video details. Public metadata for a Dailymotion video: views, likes, duration, tags, upload date and channel. Dailymotion has no public comments, so `commentCount` is null. Costs 1 credit. Input parameters: - `cache_max_age` (string) - `url` (string, required): Video id (x9529ik) or a dailymotion.com/video/… or dai.ly/… URL ### `dailymotion_transcript` (~111 tokens) dailymotion: Video transcript Video transcript. A Dailymotion video's captions as one text block plus timed cues. Returns the requested language when the video has it, otherwise the first track. Most are generated automatically by Dailymotion. Costs 1 credit. Input parameters: - `cache_max_age` (string) - `language` (string): Language code, e.g. "en" - `url` (string, required): Video id (x9529ik) or a dailymotion.com/video/… or dai.ly/… URL ### `deezer_album` (~91 tokens) deezer: Album details Album details. A Deezer album: title, artist, label, UPC, release date, fans (`likeCount`) and its tracks. Pass `cursor` to page the tracks of a long album. Costs 1 credit. Input parameters: - `cache_max_age` (string) - `cursor` (string): `pagination.cursor` from the previous response - `id` (string, required): Numeric Deezer album id ### `deezer_artist` (~54 tokens) deezer: Artist profile Artist profile. A Deezer artist: name, fans, album count, picture and link. Costs 1 credit. Input parameters: - `cache_max_age` (string) - `id` (string, required): Numeric Deezer artist id ### `deezer_artistAlbums` (~84 tokens) deezer: Artist albums Artist albums. An artist's albums, singles and EPs on Deezer. `likeCount` is the release's fans. Costs 1 credit. Input parameters: - `cache_max_age` (string) - `cursor` (string): `pagination.cursor` from the previous response - `id` (string, required): Numeric Deezer artist id - `limit` (number) ### `deezer_artistTopTracks` (~77 tokens) deezer: Artist top tracks Artist top tracks. An artist's most popular tracks on Deezer, most popular first. Costs 1 credit. Input parameters: - `cache_max_age` (string) - `cursor` (string): `pagination.cursor` from the previous response - `id` (string, required): Numeric Deezer artist id - `limit` (number) ### `deezer_charts` (~55 tokens) deezer: Charts Charts. Deezer's global top tracks, albums, artists, playlists or podcasts. Costs 1 credit. Input parameters: - `cache_max_age` (string) - `limit` (number) - `type` (string) ### `deezer_playlist` (~88 tokens) deezer: Playlist contents Playlist contents. A public Deezer playlist: title, owner, description, cover, track count, fans and its tracks. Pass `cursor` to page the tracks of a long playlist. Costs 1 credit. Input parameters: - `cache_max_age` (string) - `cursor` (string): `pagination.cursor` from the previous response - `id` (string, required): Numeric Deezer playlist id ### `deezer_podcast` (~67 tokens) deezer: Podcast details Podcast details. A Deezer podcast: title, description, artwork and fans. Deezer publishes no episode count, so `postCount` is null. Costs 1 credit. Input parameters: - `cache_max_age` (string) - `id` (string, required): Numeric Deezer podcast id ### `deezer_podcastEpisodes` (~72 tokens) deezer: Podcast episodes Podcast episodes. A Deezer podcast's episodes, newest first. Costs 1 credit. Input parameters: - `cache_max_age` (string) - `cursor` (string): `pagination.cursor` from the previous response - `id` (string, required): Numeric Deezer podcast id - `limit` (number) ### `deezer_search` (~79 tokens) deezer: Search Search. Search Deezer's catalogue for tracks, albums, artists, playlists or podcasts. Costs 1 credit. Input parameters: - `cache_max_age` (string) - `cursor` (string): `pagination.cursor` from the previous response - `limit` (number) - `query` (string, required): Search terms - `type` (string) ### `deezer_track` (~60 tokens) deezer: Track details Track details. A Deezer track: title, artist, album artwork, duration, release date, ISRC and tempo. Costs 1 credit. Input parameters: - `cache_max_age` (string) - `id` (string, required): Numeric Deezer track id ### `deezer_userPlaylists` (~69 tokens) deezer: User playlists User playlists. A Deezer user's public playlists. Costs 1 credit. Input parameters: - `cache_max_age` (string) - `cursor` (string): `pagination.cursor` from the previous response - `id` (string, required): Numeric Deezer user id - `limit` (number) ### `inference_ageGender` (~84 tokens) inference: Estimate age and gender from an image Estimate age and gender from an image. Apparent age and gender estimated from a public image URL. This is a model ESTIMATE, not measured platform data, and every response is labelled as such. Requires an inference provider to be configured on the deployment. Costs 1 credit. Input parameters: - `cache_max_age` (string) - `url` (string, required): Public image URL ### `ebay_product` (~170 tokens) ebay: eBay listing details eBay listing details. Public details for an eBay listing: title, price, condition, seller and an inline sample of reviews. Costs 1 credit. Pass either `product_id` or `url`. Input parameters: - `cache_max_age` (string) - `country_code` (string) - `product_id` (string): Numeric eBay item id, e.g. 166619046796 - `tld` (string): eBay marketplace, default com. One of: com, co.uk, com.au, de, ca, fr, it, es, at, ch, com.sg, com.my, ph, ie, pl, nl - `url` (string): eBay listing URL, e.g. https://www.ebay.com/itm/166619046796 ### `ebay_search` (~249 tokens) ebay: Search eBay listings Search eBay listings. Public eBay search results for a query, with eBay's own filters and sort orders. Costs 1 credit. Input parameters: - `buying_format` (string): Comma list: buy_it_now, auction, accepts_offers - `cache_max_age` (string) - `condition` (string): Comma list: new, used, open_box, refurbished, for_parts, not_working - `country_code` (string) - `items_per_page` (number) - `page` (number) - `query` (string, required): Search terms, e.g. "iphone 13" - `seller_id` (string) - `show_only` (string): Comma list: returns_accepted, authorized_seller, completed_items, sold_items, sale_items, listed_as_lots, search_in_description, benefits_charity, authenticity_guarantee - `sort_by` (string) - `tld` (string): eBay marketplace, default com. One of: com, co.uk, com.au, de, ca, fr, it, es, at, ch, com.sg, com.my, ph, ie, pl, nl ### `facebook_ad` (~127 tokens) facebook: Ad details Ad details. One ad from the Meta Ad Library by its archive id. Meta does not expose the archive as an addressable node for every ad; pass `page_id` as well and we find it by scanning that advertiser's archive instead. Costs 1 credit. Input parameters: - `cache_max_age` (string) - `country` (string): Reached country used by the fallback scan - `id` (string, required): Ad archive id, or an Ad Library URL containing `?id=` - `page_id` (string): The advertiser's page id. Enables the archive-scan fallback. ### `facebook_adTranscript` (~160 tokens) facebook: Ad video transcript Ad video transcript. Retrieves a transcript for a single Facebook Ad Library video ad by ID or URL, read from the caption track Facebook publishes for the ad's video (`source: "captions"`). Transcription of ad videos without captions is coming soon; until then those answer `not_configured` (501) and are not charged. Credits are only deducted when a transcript is actually returned. Costs 1 credit. Pass exactly one of `id` or `url`. Input parameters: - `cache_max_age` (string) - `id` (string): Ad archive id, or an Ad Library URL containing `?id=` - `language` (string): Preferred caption locale - `url` (string): An Ad Library URL containing `?id=` ### `facebook_adLibraryAdvertisers` (~129 tokens) facebook: Find advertisers running ads Find advertisers running ads. Distinct advertisers whose ads match a search term, with the `page_id` needed by /v1/facebook/ad-library/page-ads. Derived from the ads an Ad Library search returns, ranked by how many of them each advertiser ran. Costs 1 credit. Input parameters: - `cache_max_age` (string) - `country` (string) - `limit` (string): Ads sampled, 1-100. More ads means more advertisers. - `query` (string, required): Advertiser name or a term from their ad copy - `status` (string) ### `facebook_pageAds` (~291 tokens) facebook: All ads for one advertiser All ads for one advertiser. Ads a specific Facebook page is running or has run, from Meta's Ad Library. This is the competitor-monitoring endpoint. `pagination.cursor` is filled only where the deployment reads the Graph Ad Library API; otherwise `pagination.hasMore` says whether more exist. Costs 2 credits. Input parameters: - `ad_type` (string): `political` unlocks Meta's spend, impression and demographic fields. - `cache_max_age` (string) - `country` (string): ISO-3166 country code(s) the ad reached, comma-separated. Meta requires at least one. - `cursor` (string): `pagination.cursor` from a previous response - `end_date` (string): Latest delivery date, YYYY-MM-DD - `language` (string): Comma-separated BCP-47 codes, e.g. "en,es" - `limit` (string): Ads per page, 1-100. Default 25. - `media_type` (string) - `page_id` (string, required): Numeric page id, or an Ad Library URL containing `view_all_page_id` - `platform` (string): Comma-separated: facebook, instagram, messenger, audience_network, threads, whatsapp, oculus - `start_date` (string): Earliest delivery date, YYYY-MM-DD - `status` (string): Delivery status at the time of the query. ### `facebook_adLibrarySearch` (~309 tokens) facebook: Search the Meta Ad Library Search the Meta Ad Library. Facebook, Instagram, Messenger and Threads ads matching a search term, from Meta's Ad Library, in the Library's own order. Spend and impression ranges are filled for political and issue ads only where the deployment reads the Graph Ad Library API; `pagination.hasMore` says when more results exist. Costs 2 credits. Input parameters: - `ad_type` (string): `political` unlocks Meta's spend, impression and demographic fields. - `cache_max_age` (string) - `country` (string): ISO-3166 country code(s) the ad reached, comma-separated. Meta requires at least one. - `cursor` (string): `pagination.cursor` from a previous response - `end_date` (string): Latest delivery date, YYYY-MM-DD - `language` (string): Comma-separated BCP-47 codes, e.g. "en,es" - `limit` (string): Ads per page, 1-100. Default 25. - `media_type` (string) - `platform` (string): Comma-separated: facebook, instagram, messenger, audience_network, threads, whatsapp, oculus - `query` (string, required): Search term, matched against ad text and advertiser name - `search_type` (string): `exact_phrase` matches the words in order - `start_date` (string): Earliest delivery date, YYYY-MM-DD - `status` (string): Delivery status at the time of the query. ### `facebook_cityEvents` (~206 tokens) facebook: Get the events of a city Get the events of a city. Public events Facebook is suggesting for a city, from its Events Explore feed (e.g. https://www.facebook.com/events/explore/saint-petersburg-florida/111326725552547). `time` narrows the window to today, this week, or next week; without it Facebook returns whatever it has queued as upcoming, in whatever order it ranks them. Only the first, server-rendered page: host and description are not exposed on this listing (only on /v1/facebook/event). `pagination.hasMore` says whether Facebook has more; this endpoint returns no cursor to fetch them. Costs 1 credit. Input parameters: - `cache_max_age` (string) - `time` (string): Narrow to Facebook's own window. Defaults to all upcoming. - `url` (string, required): Explore URL ("facebook.com/events/explore//") or a bare "/" pair ### `facebook_commentReplies` (~116 tokens) facebook: Replies to a comment Replies to a comment. Replies under one comment on a public Facebook post, ten per page. Pass the post URL and the comment id (the `id` of any item from /v1/facebook/post-comments), then `pagination.cursor` for the next page. Costs 1 credit. Input parameters: - `cache_max_age` (string) - `comment_id` (string, required): Numeric comment id - `cursor` (string): `pagination.cursor` from a previous response - `url` (string, required): Full post URL the comment sits on ### `facebook_event` (~63 tokens) facebook: Event details Event details. Full details for one public Facebook event: description, start and end time, venue with coordinates, host and ticket price range. Costs 1 credit. Input parameters: - `cache_max_age` (string) - `url` (string, required): Event URL or numeric event id ### `facebook_eventsSearch` (~90 tokens) facebook: Search public events Search public events. Public Facebook events matching a search term. Results are ranked and biased toward where Facebook places the request, so the same query can return a different set on another call. Treat this as discovery, not as an enumerable list. Costs 1 credit. Input parameters: - `cache_max_age` (string) - `query` (string, required): What to search for, e.g. "jazz festival" ### `facebook_group` (~112 tokens) facebook: Public group info Public group info. Name, member count, privacy setting and description for a public Facebook group. Member count lands in `followerCount` (a group's equivalent of an audience size) and the privacy setting in `category`. Facebook rounds that count on large groups ("12K members"); `raw.memberCountIsApproximate` says whether the number you got was rounded. Costs 1 credit. Input parameters: - `cache_max_age` (string) - `url` (string, required): Group URL, group id, or group slug ### `facebook_groupPosts` (~106 tokens) facebook: Public group posts Public group posts. Recent posts from a public Facebook group, with reaction, comment and share counts where Facebook renders them. Only the newest few stories render to a logged-out visitor, the same limit /v1/facebook/page-posts has. Private groups return an empty result; their posts are not public and we do not log in. Costs 1 credit. Input parameters: - `cache_max_age` (string) - `url` (string, required): Group URL, group id, or group slug ### `facebook_marketplaceItem` (~82 tokens) facebook: Marketplace listing details Marketplace listing details. One public Facebook Marketplace listing: title, full description, price, location, delivery options and every photo. Facebook does not render the seller to a logged-out visitor, so seller identity is not returned. Costs 1 credit. Input parameters: - `cache_max_age` (string) - `url` (string, required): Marketplace item URL or numeric listing id ### `facebook_marketplaceLocations` (~97 tokens) facebook: Find a Marketplace location Find a Marketplace location. Resolve a place name to the Marketplace location ids /v1/facebook/marketplace/search accepts, plus the neighbouring locations Facebook offers around it. Marketplace is city-scoped, so this is how you search a city you are not sitting in. Costs 1 credit. Input parameters: - `cache_max_age` (string) - `query` (string, required): Place name, e.g. "London" or "San Francisco" ### `facebook_marketplaceSearch` (~244 tokens) facebook: Search Marketplace listings Search Marketplace listings. Public Facebook Marketplace listings matching a search term, with price, condition flags, location and photos. `location` takes a city slug or a location id from /v1/facebook/marketplace/locations; without one, Facebook picks the city it places the request in, which you do not control. Pass `location` for results you can repeat. Costs 1 credit. Input parameters: - `cache_max_age` (string) - `days_since_listed` (string): Only listings posted in the last N days - `delivery_method` (string): Restrict to collection-only or shipped listings - `location` (string): City slug ("nyc", "london") or a location id from /v1/facebook/marketplace/locations - `max_price` (string): Highest price, in the location's currency - `min_price` (string): Lowest price, in the location's currency - `query` (string, required): What to search for, e.g. "mountain bike" - `radius_km` (string): Search radius around the location, in kilometres - `sort_by` (string): Facebook's own sort keys ### `facebook_pagePosts` (~102 tokens) facebook: Public Page posts Public Page posts. Recent public posts from a Facebook Page, newest first, three per page, with text, reaction, comment and share counts, and the publish timestamp. Pass `pagination.cursor` back for the next three. Costs 1 credit. Input parameters: - `cache_max_age` (string) - `cursor` (string): `pagination.cursor` from a previous response - `url` (string, required): Page URL, @handle, slug, or numeric page id ### `facebook_pageReels` (~159 tokens) facebook: Public Page videos and reels Public Page videos and reels. Public videos and reels from a Facebook Page. Reads the Page's reels tab first, ten per page with `pagination.cursor` for the next ten, and falls back to its video grid, which renders around twenty entries with titles, view counts and durations and has no cursor, so a Page with no reels returns its videos rather than an error. Items are keyed by video id and can be passed straight to /v1/facebook/post or /v1/facebook/post-transcript. Costs 1 credit. Input parameters: - `cache_max_age` (string) - `cursor` (string): `pagination.cursor` from a previous response - `url` (string, required): Page URL, @handle, slug, or numeric page id ### `facebook_post` (~63 tokens) facebook: Single post, video, or reel Single post, video, or reel. One public Facebook post, video or reel by URL, with its text and engagement counts. Costs 1 credit. Input parameters: - `cache_max_age` (string) - `url` (string, required): Full post, video, or reel URL ### `facebook_postComments` (~189 tokens) facebook: Comments on a post Comments on a post. Top-level comments on a public Facebook post, with author, reaction count and reply count, in Facebook's "Most relevant" order. The first page is the head of the thread Facebook renders into the post, usually two comments; pass `pagination.cursor` back for the next ten. The post's full comment total is on /v1/facebook/post. Use /v1/facebook/comment-replies for the replies under one comment. `likeCount` is only as precise as Facebook publishes it: comment reactions ship in abbreviated form ("2.4K") with no exact figure anywhere in the payload, so counts above about a thousand are rounded at source. Costs 1 credit. Input parameters: - `cache_max_age` (string) - `cursor` (string): `pagination.cursor` from a previous response - `url` (string, required): Full post, video, or reel URL ### `facebook_postTranscript` (~130 tokens) facebook: Video transcript Video transcript. Transcript for a public Facebook video or reel, as one text block plus timed cues. Reads the caption track Facebook publishes for the video, auto-generated when the uploader added none (`source: "captions"`). Transcription of videos without captions is coming soon; until then such a video answers `not_configured` (501) and is not charged. Costs 1 credit. Input parameters: - `cache_max_age` (string) - `language` (string): Preferred caption locale, e.g. "en" or "en_US" - `url` (string, required): Full video or reel URL ### `facebook_profile` (~222 tokens) facebook: Public Page profile Public Page profile. Name, category, follower and like counts, description, banner and outbound links for a public Facebook Page. `followerCount` is as precise as Facebook renders it: exact on a small Page ("498 followers"), rounded on a large one ("28M followers", so ±500,000). `raw.followerCountIsApproximate` says which you got, and `raw.likeCount` carries the exact like figure Facebook always prints. Pass `extra_fetch=true` to also fill `createdAt`, the date the Page was created, which lives only on the Page transparency tab: it costs 1 extra credit and one large additional fetch, refunded if that fetch cannot be read. Costs 1 credit. Input parameters: - `cache_max_age` (string) - `extra_fetch` (string): When true, fetches each item's own page to fill fields the list page leaves null. Costs 1 extra credit per page fetched, up to the page size. - `url` (string, required): Page URL, @handle, slug, or numeric page id ### `facebook_profileEvents` (~111 tokens) facebook: Events on a Page Events on a Page. Events hosted by a public Facebook Page, upcoming ones first, with past events where Facebook still lists them, eight per page; pass `pagination.cursor` back for the next eight. Each carries start time, place, host and the cover photo. Costs 1 credit. Input parameters: - `cache_max_age` (string) - `cursor` (string): `pagination.cursor` from a previous response - `url` (string, required): Page URL, @handle, slug, or numeric page id ### `facebook_profilePhotos` (~117 tokens) facebook: Photos on a Page Photos on a Page. Photos from a public Facebook Page's photo grid, eight per page, newest first; pass `pagination.cursor` back for the next eight. Facebook exposes each photo's accessibility caption rather than the text of the post it came from, so that is what lands in `title`. Costs 1 credit. Input parameters: - `cache_max_age` (string) - `cursor` (string): `pagination.cursor` from a previous response - `url` (string, required): Page URL, @handle, slug, or numeric page id ### `identity_findSocialProfiles` (~626 tokens) identity: Find a creator's other social profiles Find a creator's other social profiles. Starts from one public profile and reports the other accounts that profile can be shown to own: profiles it links to directly, profiles reached through a recognised link-in-bio page (Linktree, Komi, Pillar, Lnk.Bio, LinkMe), and same-handle accounts on the other supported platforms that link back to the source or share a website only the owner controls. Covers Instagram, TikTok, YouTube, X and Facebook. A same-handle account with no corroboration is reported under `candidates`, never as a profile: the handle matching is a fact handed over, not a claim. There is no search-engine discovery and no display-name matching; neither is evidence of ownership. Every result carries the evidence type it rests on. Each entry in `failures` carries the inner error’s `code` and `message`, so "we checked and found nothing" (`upstream_not_found`, `empty_result`) stays distinguishable from "we could not check" (`upstream_unavailable`, `not_configured`); only the second kind sets `partial`. Not covered: any platform outside the five, and links a creator has not published. An X/Twitter source can only be resolved by same-handle probing, because X exposes no bio links at all to a logged-out caller. The 20-second budget stops the composite scheduling new inner fetches; it does not abort one already in flight, so a slow leg is reported as a timeout while its request finishes unread. Link-in-bio expansion is verified against fixtures only, because no channel sampled live from our network published a link-in-bio URL to expand. A `partial: true` answer is cached for the same seven days as a complete one, so pass `cache_max_age=0` to refetch after a transient failure rather than being served the gap for a week. Pricing is per source checked: the 10 credits buy the legs this call runs (the starting profile, each link-in-bio page expanded, and each same-handle probe), and a leg listed in `unchecked` is not charged for, so a partial answer costs `ceil(10 x… Input parameters: - `cache_max_age` (string) - `handle` (string, required): Bare handle (@nasa). YouTube also accepts a UC… channel id. URLs are rejected. - `platform` (string, required): Platform the handle belongs to. `x` is an alias for `twitter`. ### `flickr_post` (~139 tokens) flickr: Photo or video details Photo or video details. A public Flickr photo or video: title, description, owner, views, faves, comments, upload date and media addresses. A video lists one signed MP4 per encode, best first, and those links expire within minutes, so fetch them straight away. A photo lists its largest public size. `durationSeconds` is null because Flickr does not state it. Costs 1 credit. Input parameters: - `cache_max_age` (string) - `url` (string, required): Photo or video id (50843625323), a flickr.com/photos// URL or a flic.kr/p/… short link ### `github_repository` (~86 tokens) github: Repository details Repository details. Public details for a repository: stars, forks, open issues, topics, language and licence. Stars map to `likeCount`, forks to `shareCount`; open issues and pull requests are `openIssuesCount`. Costs 1 credit. Input parameters: - `cache_max_age` (string) - `url` (string, required): "owner/repo" or a github.com repository URL ### `github_trendingDevelopers` (~77 tokens) github: Trending developers Trending developers. The public github.com/trending/developers board. Counts are null: the board renders names and popular repositories, not follower numbers. Costs 1 credit. Input parameters: - `cache_max_age` (string) - `language` (string): Language slug, e.g. "rust" - `since` (string) ### `github_trendingRepositories` (~103 tokens) github: Trending repositories Trending repositories. The public github.com/trending board. `likeCount` is total stars, `shareCount` total forks and `starsInPeriod` the stars gained in the chosen period. Costs 1 credit. Input parameters: - `cache_max_age` (string) - `language` (string): Language slug, e.g. "typescript" - `since` (string) - `spoken_language_code` (string): Two-letter code, e.g. "en" ### `github_user` (~95 tokens) github: User or organisation profile User or organisation profile. Public profile for a GitHub user or organisation: followers, public repo count, bio, location and links. Costs 1 credit. Pass either `handle` or `url`. Input parameters: - `cache_max_age` (string) - `handle` (string): Username, e.g. "torvalds" - `url` (string): Profile URL, e.g. https://github.com/torvalds ### `github_activity` (~120 tokens) github: Public activity Public activity. Public events for a user: pushes, pull requests, issues, stars, forks and releases. GitHub caps this feed at 300 events / 90 days regardless of paging. Costs 1 credit. Pass either `handle` or `url`. Input parameters: - `cache_max_age` (string) - `cursor` (string): Page number from the previous response - `handle` (string): Username, e.g. "torvalds" - `url` (string): Profile URL, e.g. https://github.com/torvalds ### `github_contributions` (~122 tokens) github: Contributions calendar Contributions calendar. The contribution graph for one calendar year: a per-day count plus GitHub's 0–4 intensity level, and the annual total. Costs 1 credit. Pass either `handle` or `url`. Input parameters: - `cache_max_age` (string) - `handle` (string): Username, e.g. "torvalds" - `url` (string): Profile URL, e.g. https://github.com/torvalds - `year` (string): Calendar year, e.g. "2025". Defaults to the current year. ### `github_followers` (~110 tokens) github: Followers Followers. Accounts following this user, 30 per page. GitHub serves a reduced user payload here, so per-account counts are null. Costs 1 credit. Pass either `handle` or `url`. Input parameters: - `cache_max_age` (string) - `cursor` (string): Page number from the previous response - `handle` (string): Username, e.g. "torvalds" - `url` (string): Profile URL, e.g. https://github.com/torvalds ### `github_following` (~110 tokens) github: Following Following. Accounts this user follows, 30 per page. GitHub serves a reduced user payload here, so per-account counts are null. Costs 1 credit. Pass either `handle` or `url`. Input parameters: - `cache_max_age` (string) - `cursor` (string): Page number from the previous response - `handle` (string): Username, e.g. "torvalds" - `url` (string): Profile URL, e.g. https://github.com/torvalds ### `github_pullRequests` (~124 tokens) github: Pull requests by a user Pull requests by a user. Pull requests authored by a user across all public repositories, newest first. `since` / `until` filter on creation date. Costs 1 credit. Input parameters: - `cache_max_age` (string) - `cursor` (string): Page number from the previous response - `handle` (string, required): Username, e.g. "gaearon" - `since` (string): Only PRs created on or after this date (YYYY-MM-DD) - `until` (string): Only PRs created on or before this date (YYYY-MM-DD) ### `github_userRepositories` (~120 tokens) github: User repositories User repositories. Public repositories owned by a user or organisation, 30 per page. Costs 1 credit. Pass either `handle` or `url`. Input parameters: - `cache_max_age` (string) - `cursor` (string): Page number from the previous response - `direction` (string) - `handle` (string): Username, e.g. "torvalds" - `sort` (string) - `type` (string) - `url` (string): Profile URL, e.g. https://github.com/torvalds ### `google_ad` (~127 tokens) google: Ad details Ad details. One creative from the Ads Transparency Centre, with every rendering variant and the per-country dates it ran. For a text ad, `headline`, `body` and `linkUrl` come from its rendered preview, and `linkUrl` is the address the ad displays. Costs 1 credit. Input parameters: - `cache_max_age` (string) - `region` (string): Overrides the region in the URL - `url` (string, required): Creative URL, e.g. https://adstransparency.google.com/advertiser/AR.../creative/CR...?region=US ### `google_advertiserAds` (~165 tokens) google: Ads run by an advertiser or domain Ads run by an advertiser or domain. Creatives in the Ads Transparency Centre for one advertiser id or one verified domain, with first-shown and last-shown dates. Pass the `cursor` from the previous response to page. Costs 2 credits. Pass either `domain` or `advertiser_id`. Input parameters: - `advertiser_id` (string): Advertiser id from /ad-library/advertisers, e.g. "AR167..." - `cache_max_age` (string) - `cursor` (string): Continuation token from the previous response - `domain` (string): Verified advertiser domain, e.g. "nike.com" - `region` (string): Two-letter country code (US, GB, DE, IN, ...) or a Google geo criteria id ### `google_adLibraryAdvertisers` (~167 tokens) google: Find advertisers in the Ads Transparency Centre Find advertisers in the Ads Transparency Centre. Advertisers matching a name, with the advertiser id that /v1/google/ad-library/advertiser-ads needs, plus the verified domains Google suggests for the same term in `domains`. Without `region` every region is searched. `postCount` and `adCountUpper` are the lower and upper bounds of the ad-count range the archive publishes, counted within `region` when one is given. Costs 1 credit. Input parameters: - `cache_max_age` (string) - `query` (string, required): Advertiser or brand name, e.g. "nike" - `region` (string): Two-letter country code (US, GB, DE, IN, ...) or a Google geo criteria id. Omit to search every region. ### `google_jobs` (~270 tokens) google: Google Jobs results Google Jobs results. Job postings for a query: title, company, location and the board it was syndicated from. Results lean toward an area that can change between calls, so name the place in your query. Slower than most endpoints, often 20 seconds or more. A failed attempt returns `upstream_unavailable` and is not charged. Costs 5 credits. Input parameters: - `cache_max_age` (string) - `country_code` (string): Two-letter country code. Sets `gl` when `gl` is not given. - `gl` (string): Two-letter country code Google should bias results toward. - `hl` (string): Host language for the results page, e.g. "en", "de". Defaults to "en". - `query` (string, required): Search query - `start` (number): Not currently supported; any value returns `invalid_request`. - `tld` (string): Google marketplace TLD. One of: com, co.uk, ca, de, es, fr, it, co.jp, in, cn, com.sg, com.mx, ae, com.br, nl, com.au, com.tr, sa, se, pl. Defaults to "com". - `uule` (string): Not currently supported; any value returns `invalid_request`. ### `google_mapsSearch` (~263 tokens) google: Google Maps place search Google Maps place search. Business listings near a coordinate: name, address, phone, website, rating and hours, 20 per page. A failed attempt returns `upstream_unavailable` and is not charged. Costs 5 credits. Input parameters: - `cache_max_age` (string) - `country_code` (string): Two-letter country code. Sets `gl` when `gl` is not given. - `gl` (string): Two-letter country code Google should bias results toward. - `hl` (string): Host language for the results page, e.g. "en", "de". Defaults to "en". - `latitude` (number, required): Latitude of the search centre - `longitude` (number, required): Longitude of the search centre - `query` (string, required): Search query - `start` (number): 0-based result offset. - `tld` (string): Google marketplace TLD. One of: com, co.uk, ca, de, es, fr, it, co.jp, in, cn, com.sg, com.mx, ae, com.br, nl, com.au, com.tr, sa, se, pl. Defaults to "com". - `uule` (string): Not currently supported; any value returns `invalid_request`. ### `google_news` (~241 tokens) google: Google News results Google News results. News articles for a query: title, source and published time, up to about 100 items. `link` is Google's article link, not the publisher's URL. A failed attempt returns `upstream_unavailable` and is not charged. Costs 5 credits. Input parameters: - `cache_max_age` (string) - `country_code` (string): Two-letter country code. Sets `gl` when `gl` is not given. - `gl` (string): Two-letter country code Google should bias results toward. - `hl` (string): Host language for the results page, e.g. "en", "de". Defaults to "en". - `query` (string, required): Search query - `start` (number): 0-based result offset. - `tbs` (string): Time filter: hour/day/week/month/year, as Google's own `qdr` code. - `tld` (string): Must be "com", its default; any other value returns `invalid_request`. Use `gl` and `hl` for another country. - `uule` (string): Not currently supported; any value returns `invalid_request`. ### `google_search` (~147 tokens) google: Web search results Web search results. Google web results for a query, 20 per page, up to 6 pages. Ranking can differ from a signed-out search on google.com. A failed attempt returns `upstream_unavailable` and is not charged. Costs 1 credit. Input parameters: - `cache_max_age` (string) - `date_posted` (string): Not currently supported; any value returns `invalid_request`. - `page` (string): 1-based page number, up to 6. 20 results per page. - `query` (string, required) - `region` (string): Two-letter country code (US, GB, DE, IN, ...) or a Google geo criteria id ### `google_shopping` (~283 tokens) google: Google Shopping results Google Shopping results. Shopping listings for a query: title, price, currency and merchant. `url` and `availability` are null because the listing page does not carry them. Slower than most endpoints, often 20 seconds or more. A failed attempt returns `upstream_unavailable` and is not charged. Costs 5 credits. Input parameters: - `cache_max_age` (string) - `country_code` (string): Two-letter country code. Sets `gl` when `gl` is not given. - `gl` (string): Two-letter country code Google should bias results toward. - `hl` (string): Host language for the results page, e.g. "en", "de". Defaults to "en". - `query` (string, required): Search query - `start` (number): Not currently supported; any value returns `invalid_request`. - `tbs` (string): Not currently supported; any value returns `invalid_request`. - `tld` (string): Google marketplace TLD. One of: com, co.uk, ca, de, es, fr, it, co.jp, in, cn, com.sg, com.mx, ae, com.br, nl, com.au, com.tr, sa, se, pl. Defaults to "com". - `uule` (string): Not currently supported; any value returns `invalid_request`. ### `hackernews_search` (~103 tokens) hackernews: Search Search. Hacker News stories and comments matching a search, newest first. Points and comment counts are given for stories; comments come back as plain text with their item page as the URL. Costs 1 credit. Input parameters: - `cache_max_age` (string) - `cursor` (string): `pagination.cursor` from a previous response - `query` (string, required): Search text - `type` (string): `story`, `comment`, or `all` for both ### `instagram_audioReels` (~144 tokens) instagram: Reels using a sound Reels using a sound. Reels built on one audio track, the "N reels using this audio" list. Takes the numeric audio id or a /reels/audio/ URL. Falls back to the public audio page, which lists its first grid of reels only once rendered, as links and cover images. Costs 1 credit. Input parameters: - `audio_id` (string, required): Numeric audio id, or a /reels/audio// URL - `cache_max_age` (string) - `count` (string): Reels per page, 1-50. Default 12. - `cursor` (string): `pagination.cursor` from a previous response ### `instagram_commentReplies` (~150 tokens) instagram: Replies under one comment Replies under one comment. The full reply thread under a single comment. Take `comment_id` from `data.items[].id` on /v1/instagram/post-comments; the post URL is still required because Instagram addresses replies through the media that carries them. Costs 1 credit. Input parameters: - `cache_max_age` (string) - `comment_id` (string, required): `data.items[].id` from /v1/instagram/post-comments - `count` (string): Replies per page, 1-50. Default 24. - `cursor` (string): `pagination.cursor` from a previous response - `url` (string, required): Post, reel or IGTV URL, or a bare shortcode ### `instagram_hashtagPosts` (~220 tokens) instagram: Posts under a hashtag Posts under a hashtag. Posts carrying a hashtag. `tab=top` is Instagram's ranking (one fixed page, no cursor); `tab=recent` is chronological and paginates. Falls back to the server-rendered tag page when the JSON surface declines, which returns the top grid only. Set `extra_fetch=true` to fill each post's publish date, like and comment counts and caption from its own page: 1 credit per item fetched, up to the page size. Costs 1 credit. Input parameters: - `cache_max_age` (string) - `cursor` (string): `pagination.cursor` from a previous response. `recent` only - `extra_fetch` (string): When true, fetches each item's own page to fill fields the list page leaves null. Costs 1 extra credit per page fetched, up to the page size. - `hashtag` (string, required): Hashtag (#nasa or nasa), or an /explore/tags/ URL - `tab` (string): Instagram's ranking, or chronological ### `instagram_highlight` (~99 tokens) instagram: Stories inside a highlight Stories inside a highlight. Every story in one highlight reel, oldest first, with its media URLs. Takes the `id` from /v1/instagram/user-highlights, a bare numeric id, or a /stories/highlights/ URL. Costs 1 credit. Input parameters: - `cache_max_age` (string) - `id` (string, required): Highlight id ("highlight:17…" or the bare number), or a /stories/highlights/ URL ### `instagram_popularSearch` (~111 tokens) instagram: Top posts for a keyword Top posts for a keyword. Top posts for a keyword from Instagram's public Popular page for it, the page at instagram.com/popular//: reels, images and carousels together, in Instagram's order. One page; `hasMore` says whether Instagram holds more than it shows. Costs 1 credit. Input parameters: - `cache_max_age` (string) - `cursor` (string): `pagination.cursor` from a previous response - `query` (string, required): Keyword to search for ### `instagram_post` (~117 tokens) instagram: Post or reel details Post or reel details. One public post, reel or carousel with its caption, media URLs and engagement counts. Falls back to Instagram's public embed payload when the web client's persisted query is unavailable, so a Meta client release degrades this rather than breaking it. Play counts arrive in this same request, so there is no second fetch to skip and no play-count parameter to pass. Costs 1 credit. Input parameters: - `cache_max_age` (string) - `url` (string, required): Post, reel or IGTV URL, or a bare shortcode ### `instagram_postComments` (~182 tokens) instagram: Comments on a post or reel Comments on a post or reel. Top-level comments, newest first, about fifteen per page, each with its text, author, like count and date. Follow `pagination.cursor` for older comments. Set `include_replies=true` to also return any replies Instagram shipped inline with their parent. For the full reply thread under one comment, use /v1/instagram/comment-replies. Costs 1 credit. Input parameters: - `cache_max_age` (string) - `count` (string): Comments to ask for per page, 1-50. Default 24. Instagram serves at most about fifteen. - `cursor` (string): `pagination.cursor` from a previous response - `include_replies` (string): Include replies that arrived inline with their parent comment - `url` (string, required): Post, reel or IGTV URL, or a bare shortcode ### `instagram_profile` (~88 tokens) instagram: Profile details Profile details. Public profile for an Instagram account: followers, following, post count, bio, links and business category. Private accounts return their public shell with `isPrivate: true` rather than an error. That is a real answer. Costs 1 credit. Input parameters: - `cache_max_age` (string) - `handle` (string, required): Handle (@nike), or a full instagram.com profile URL ### `instagram_profilePostCount` (~135 tokens) instagram: Post count for a profile Post count for a profile. The total post count on a public Instagram profile, exact wherever Instagram publishes the exact figure. Call this when a fuller profile is not needed. `source` names which of the two dialects Instagram ships a count in carried it (`edge_owner_to_timeline_media.count` or `media_count`). Instagram does not expose this metadata for every profile: when neither is present, `postCount` is null and the request is not charged. Costs 1 credit. Input parameters: - `cache_max_age` (string) - `handle` (string, required): Handle (@nike), or a full instagram.com profile URL ### `instagram_profileSearch` (~91 tokens) instagram: Search accounts Search accounts. Accounts matching a query, as unified Creators. The follower counts on a search result are Instagram's own summary and are thinner than /v1/instagram/profile. Fetch that for one account you care about. One page only; this surface has no cursor. Costs 1 credit. Input parameters: - `cache_max_age` (string) - `query` (string, required): Handle or name to search for ### `instagram_reelsSearch` (~102 tokens) instagram: Search reels by keyword Search reels by keyword. Reels matching a keyword, from Instagram's own keyword search rather than its hashtag index. The two return genuinely different sets, so this never quietly substitutes one for the other. Results are whatever Instagram ranked for the query at that moment. Costs 1 credit. Input parameters: - `cache_max_age` (string) - `cursor` (string): `pagination.cursor` from a previous response - `query` (string, required): Keyword to search for ### `instagram_search` (~108 tokens) instagram: Search accounts, hashtags and places Search accounts, hashtags and places. Instagram's blended search, the one behind the search box. Returns three buckets: `users` as unified Creators, plus `hashtags` and `places`, which have no unified equivalent and keep Instagram's own shape. One page only; this surface has no cursor. Costs 1 credit. Input parameters: - `cache_max_age` (string) - `query` (string, required): What to search for - `type` (string): Restrict to one kind of result ### `instagram_transcript` (~121 tokens) instagram: Reel or video transcript Reel or video transcript. The caption track Instagram published for a reel or video, as one text block plus timed cues. This is Instagram's own track, never a transcription of the audio, so a transcript here is what the platform published rather than what a model guessed. Instagram has published no caption track on any reel checked so far, so most requests return `empty_result`, which is free. Costs 1 credit. Input parameters: - `cache_max_age` (string) - `url` (string, required): Reel, post or IGTV URL, or a bare shortcode ### `instagram_trendingReels` (~205 tokens) instagram: Reels trending on Explore Reels trending on Explore. Reels off Instagram's public Explore grid. Worth knowing what this is and is not: Explore is region-shaped, so what comes back depends on where the request exits, and it is Instagram's editorial surface rather than a global chart. There is no public trending feed on Instagram; this is the closest one that exists. Set `extra_fetch=true` to fill each reel's publish date, caption and duration from its own page: 1 credit per item fetched, up to the page size. Costs 1 credit. Input parameters: - `cache_max_age` (string) - `count` (string): Reels per page, 1-50. Default 24. - `cursor` (string): `pagination.cursor` from a previous response - `extra_fetch` (string): When true, fetches each item's own page to fill fields the list page leaves null. Costs 1 extra credit per page fetched, up to the page size. ### `instagram_userEmbed` (~144 tokens) instagram: Profile via the public embed card Profile via the public embed card. A profile read off Instagram's public embed card, with the embed HTML in `raw.html` for anyone who wants to render it. Instagram publishes embeds so third parties can display them, which makes this the profile path it has the least reason to gate. The same reasoning puts the post embed on /v1/instagram/post's fallback. It carries fewer fields than /v1/instagram/profile; reach for it when that one is blocked, or when you want the markup. Costs 1 credit. Input parameters: - `cache_max_age` (string) - `handle` (string, required): Handle (@nike), or a full instagram.com profile URL ### `instagram_userHighlights` (~155 tokens) instagram: Story highlight covers Story highlight covers. The highlight reels pinned to a profile: title, cover, and how many stories each holds. Pass an `id` from here to /v1/instagram/highlight for the stories inside one. Highlights are the only Instagram stories that stay public indefinitely: live stories expire in 24 hours and are not served logged-out. Costs 1 credit. Pass either `handle` or `user_id`. Input parameters: - `cache_max_age` (string) - `handle` (string): Handle (@nike), or a full instagram.com profile URL. Optional if `user_id` is given. - `user_id` (string): Numeric user id. Skips a lookup. Take it from `data.items[].authorId`. ### `instagram_userPosts` (~296 tokens) instagram: Posts and reels from a profile Posts and reels from a profile. A profile grid, newest first, twelve posts per page, each with its caption, type and owner. Follow `pagination.cursor` for older posts. On the first page, reels also carry like, comment and play counts; other posts, and every post on later pages, have them null, because the grid does not carry them. No page carries a publish date. Fetch /v1/instagram/post for a specific post to get its counts and date, or set `extra_fetch=true` to fill each post's publish date, like and comment counts and caption from its own page in one call: 1 credit per item fetched, up to the page size. `authorHandle` is read per post: a collab or tagged post appears in a profile grid owned by the OTHER account, and this reports the real owner rather than the handle you asked for. Costs 1 credit. Input parameters: - `cache_max_age` (string) - `count` (string): Posts per page, 1-12. Default 12. - `cursor` (string): `pagination.cursor` from a previous response - `extra_fetch` (string): When true, fetches each item's own page to fill fields the list page leaves null. Costs 1 extra credit per page fetched, up to the page size. - `handle` (string, required): Handle (@nike), or a full instagram.com profile URL ### `instagram_userReels` (~347 tokens) instagram: Reels from a profile Reels from a profile. A profile's reels, newest first, twelve per page, each with like, comment and play counts. Follow `pagination.cursor` for older reels. The first page also carries captions; later pages do not, so `text` is null there, and a collab reel owned by another account has `authorHandle` null. No page carries a publish date; fetch /v1/instagram/post for one reel's date, or set `extra_fetch=true` to fill each reel's publish date, caption and duration from its own page in one call: 1 credit per item fetched, up to the page size. If the reels tab is unavailable, the first page falls back to the clips in the profile grid, with captions but no counts and no cursor. An account with no public reels is an empty result, and is not charged. `raw.source` says which path answered. Costs 1 credit. Pass either `handle` or `user_id`. Input parameters: - `cache_max_age` (string) - `count` (string): Reels per page, 1-12. Default 12. - `cursor` (string): `pagination.cursor` from a previous response - `extra_fetch` (string): When true, fetches each item's own page to fill fields the list page leaves null. Costs 1 extra credit per page fetched, up to the page size. - `handle` (string): Handle (@nike), or a full instagram.com profile URL. Optional if `user_id` is given. - `user_id` (string): Numeric user id. Skips a lookup. Take it from `data.items[].authorId`. ### `instagram_userTaggedPosts` (~176 tokens) instagram: Posts a profile is tagged in Posts a profile is tagged in. Public posts by other accounts that tagged this user (the "Tagged" tab). Note this is other people's content: `authorHandle` is the poster, not the tagged account. Users can hide the tab, which returns `empty_result`. Costs 1 credit. Pass either `handle` or `user_id`. Input parameters: - `cache_max_age` (string) - `count` (string): Posts per page, 1-50. Default 12. - `cursor` (string): `pagination.cursor` from a previous response - `handle` (string): Handle (@nike), or a full instagram.com profile URL. Optional if `user_id` is given. - `user_id` (string): Numeric user id. Skips a lookup. Take it from `data.items[].authorId`. ### `kick_clip` (~84 tokens) kick: Clip Clip. A public Kick clip: title, creator, channel, duration, view count, and media URL. Costs 1 credit. Input parameters: - `cache_max_age` (string) - `url` (string, required): Clip URL (https://kick.com//clips/clip_XXXX or https://kick.com/?clip=clip_XXXX) or a clip id ### `komi_page` (~72 tokens) komi: Komi page Komi page. Public Komi page as a creator profile: display name, bio, avatar, and every outbound link in order. Costs 1 credit. Input parameters: - `cache_max_age` (string) - `url` (string, required): Page URL (https://komi.io/) or just the username ### `kwai_post` (~73 tokens) kwai: Post Post. A single public Kwai video with its view, like, comment and forward counts. Costs 1 credit. Input parameters: - `cache_max_age` (string) - `url` (string, required): Post URL (https://www.kwai.com/@/video/ or /photo/) ### `kwai_profile` (~70 tokens) kwai: Profile Profile. Public Kwai profile: follower and following counts, public video count, likes received, bio, avatar, and creator category. Costs 1 credit. Input parameters: - `cache_max_age` (string) - `handle` (string, required): Handle (@carlinhos) or a kwai.com profile URL ### `kwai_userPosts` (~102 tokens) kwai: User posts User posts. Public videos from a Kwai profile, newest first after any pinned ones, with view, like, comment and forward counts. Pass `pagination.cursor` back as `cursor` for the next page. Costs 1 credit. Input parameters: - `cache_max_age` (string) - `cursor` (string): `pagination.cursor` from a previous response - `handle` (string, required): Handle (@carlinhos) or a kwai.com profile URL ### `linkbio_page` (~76 tokens) linkbio: Lnk.Bio page Lnk.Bio page. Public Lnk.Bio page as a creator profile: display name, bio, avatar, and every outbound link in order. Costs 1 credit. Input parameters: - `cache_max_age` (string) - `url` (string, required): Page URL (https://lnk.bio/) or just the username ### `linkedin_ad` (~103 tokens) linkedin: Ad details Ad details. One ad from LinkedIn's public Ad Library: creative, copy, advertiser, and the paying entity. Ads covered by EU disclosure rules also carry run dates, target countries and impression bands; ads outside those rules do not, and those fields come back null rather than guessed. Costs 1 credit. Input parameters: - `cache_max_age` (string) - `url` (string, required): Ad Library URL (linkedin.com/ad-library/detail/...) or the numeric ad id ### `linkedin_adsSearch` (~209 tokens) linkedin: Search ads Search ads. Search LinkedIn's public Ad Library by advertiser or keyword. Pass `company` (a company page slug or numeric id) to list one advertiser's ads, `keyword` to search copy, or both. Returns the first page LinkedIn server-renders, about 25 ads; the total number of matches is in `raw.totalMatches`. Costs 1 credit. Pass `company`, `keyword`, or both. The Ad Library will not return an unfiltered archive. Input parameters: - `cache_max_age` (string) - `company` (string): Company page slug ("microsoft") or numeric company id ("1035") - `countries` (string): Comma-separated ISO-3166 country codes the ad reached, e.g. "US,GB" - `end_date` (string): Latest run date, YYYY-MM-DD - `keyword` (string): Words to match in the ad copy - `start_date` (string): Earliest run date, YYYY-MM-DD ### `linkedin_company` (~81 tokens) linkedin: Company page Company page. A LinkedIn company page: description, industry, follower count, headquarters, size, type, founding year, specialties, employee count and logo. Also works for school and showcase pages. Costs 1 credit. Input parameters: - `cache_max_age` (string) - `url` (string, required): Company URL (linkedin.com/company/...) or the company slug ### `linkedin_companyPosts` (~131 tokens) linkedin: Company posts Company posts. Recent posts from a company page, with reaction and comment counts. Read from the company page itself: LinkedIn's dedicated /posts/ tab is behind the sign-in wall, but the same updates render on the public page. That caps the result at roughly the last ten posts. There is no logged-out pagination, so `hasMore` is always false. Posts by members that the company features carry that member as the author. Costs 1 credit. Input parameters: - `cache_max_age` (string) - `url` (string, required): Company URL (linkedin.com/company/...) or the company slug ### `linkedin_post` (~91 tokens) linkedin: Post details Post details. One LinkedIn post: full text, media, author, publication time, reactions and comment count. Top-level comments LinkedIn publishes on the page ride along in `raw.comments`. Costs 1 credit. Input parameters: - `cache_max_age` (string) - `url` (string, required): Post URL (linkedin.com/posts/... or /feed/update/urn:li:activity:...) or the numeric id ### `linkedin_postTranscript` (~112 tokens) linkedin: Post transcript Post transcript. Captions for a LinkedIn video post, as one text block plus timed cues, read from the caption track LinkedIn publishes with the video, its automatic captions included. A post without video, or a video without a caption track, returns an empty result, which is never charged. Costs 1 credit. Input parameters: - `cache_max_age` (string) - `url` (string, required): Post URL, a urn:li:activity / ugcPost / share urn, or the numeric activity id ### `linkedin_profile` (~95 tokens) linkedin: Person's profile Person's profile. A LinkedIn member's public profile: name, headline, location, follower count, avatar, current employers and education. LinkedIn masks parts of a logged-out profile with asterisks; masked values are dropped rather than returned as `****`. Costs 1 credit. Input parameters: - `cache_max_age` (string) - `url` (string, required): Profile URL (linkedin.com/in/...) or the profile slug ### `linkedin_searchPosts` (~143 tokens) linkedin: Search posts Search posts. Keyword search over LinkedIn posts. LinkedIn gates content search behind sign-in for every logged-out caller (/search/results/content/ redirects to /uas/login regardless of origin IP), and we do not scrape authenticated sessions, so this endpoint reports the gate rather than pretending to be broken. It is shipped so callers get one clear, unbilled answer instead of a 404 on a documented route. Costs 1 credit. Input parameters: - `cache_max_age` (string) - `cursor` (string): `pagination.cursor` from a previous response - `date_posted` (string): Restrict to recent posts - `query` (string, required): Search terms ### `linkme_page` (~71 tokens) linkme: LinkMe page LinkMe page. Public LinkMe page as a creator profile: display name, bio, avatar, and every outbound link in order. Costs 1 credit. Input parameters: - `cache_max_age` (string) - `url` (string, required): Page URL (https://link.me/) or just the username ### `linktree_page` (~72 tokens) linktree: Linktree page Linktree page. Public Linktree page as a creator profile: display name, bio, avatar, and every outbound link in order. Costs 1 credit. Input parameters: - `cache_max_age` (string) - `url` (string, required): Page URL (https://linktr.ee/) or just the username ### `mashable_video` (~119 tokens) mashable: Video details Video details. A Mashable video: title, summary, author, tags, duration, thumbnail and the addresses of its video files, best quality first, then the stream. Mashable shows no view, like or comment counts, so those are null. `mediaUrls` is empty, and the call is free, when the file behind an older video is gone. Costs 1 credit. Input parameters: - `cache_max_age` (string) - `url` (string, required): A mashable.com/video/… URL, or the slug after /video/ ### `mastodon_post` (~78 tokens) mastodon: Post Post. A single public Mastodon post with its favourite, reply and boost counts and attached media. Costs 1 credit. Input parameters: - `cache_max_age` (string) - `url` (string, required): Post URL on the server that hosts it, e.g. https://mastodon.social/@Gargron/117498495330835648 ### `mastodon_postReplies` (~111 tokens) mastodon: Post replies Post replies. Public replies to a Mastodon post, in thread order, from every server the hosting server knows of. Servers return at most about 60 replies to a signed-out reader. Replies from accounts that opted out of search engine indexing are left out. Costs 1 credit. Input parameters: - `cache_max_age` (string) - `url` (string, required): Post URL on the server that hosts it, e.g. https://mastodon.social/@Gargron/117498495330835648 ### `mastodon_profile` (~100 tokens) mastodon: Profile Profile. A public Mastodon account, read from its own server: follower, following and post counts, bio, avatar, header image and profile links. Accounts that opted out of search engine indexing are refused, free. Costs 1 credit. Input parameters: - `cache_max_age` (string) - `handle` (string, required): Handle with its server (Gargron@mastodon.social or @Gargron@mastodon.social) or a profile URL ### `mastodon_userPosts` (~124 tokens) mastodon: User posts User posts. An account's public posts, newest first, with favourite, reply and boost counts. Boosts of other people's posts are left out. Costs 1 credit. Input parameters: - `cache_max_age` (string) - `count` (number) - `cursor` (string): `pagination.cursor` from a previous response - `exclude_replies` (string): Leave out replies to other posts - `handle` (string, required): Handle with its server (Gargron@mastodon.social or @Gargron@mastodon.social) or a profile URL ### `milkshake_page` (~72 tokens) milkshake: Milkshake page Milkshake page. Public Milkshake page as a creator profile: display name, bio, avatar, and every outbound link in order. Costs 1 credit. Input parameters: - `cache_max_age` (string) - `url` (string, required): Page URL (https://msha.ke/) or just the username ### `mixcloud_profile` (~67 tokens) mixcloud: Profile Profile. Public Mixcloud profile: followers, following, upload count, bio, avatar, cover image and location. Costs 1 credit. Input parameters: - `cache_max_age` (string) - `handle` (string, required): Mixcloud username (spartacus), or a mixcloud.com profile URL ### `mixcloud_search` (~102 tokens) mixcloud: Search Search. Search Mixcloud uploads, users or tags. Results are ranked by Mixcloud and can change between calls. Costs 1 credit. Input parameters: - `cache_max_age` (string) - `cursor` (string): `pagination.cursor` from the previous response - `limit` (number) - `query` (string, required): Search text - `type` (string): `cloudcast` for uploads, `user` for accounts, `tag` for tags ### `mixcloud_tag` (~96 tokens) mixcloud: Popular uploads for a tag Popular uploads for a tag. A tag's popular uploads as Mixcloud ranks them, with plays, favourites, reposts and comments. Costs 1 credit. Input parameters: - `cache_max_age` (string) - `cursor` (string): `pagination.cursor` from the previous response - `limit` (number) - `tag` (string, required): Tag slug (house, deep-house), or a mixcloud.com/genres/ URL ### `mixcloud_upload` (~111 tokens) mixcloud: Upload details Upload details. One Mixcloud upload: plays, favourites, reposts, comments, duration, tags and description. The tracklist, when the uploader published one, is in `raw.sections`. Costs 1 credit. Input parameters: - `cache_max_age` (string) - `handle` (string, required): Mixcloud username (spartacus), or a mixcloud.com profile URL - `slug` (string, required): The upload slug: the last part of its URL, e.g. "cinematic-soundscapes" ### `mixcloud_uploadComments` (~118 tokens) mixcloud: Upload comments Upload comments. Public comments on a Mixcloud upload. Pass the `cursor` from the previous response to page. Costs 1 credit. Input parameters: - `cache_max_age` (string) - `cursor` (string): `pagination.cursor` from the previous response - `handle` (string, required): Mixcloud username (spartacus), or a mixcloud.com profile URL - `limit` (number) - `slug` (string, required): The upload slug: the last part of its URL, e.g. "cinematic-soundscapes" ### `mixcloud_followers` (~99 tokens) mixcloud: User followers User followers. A user's followers, most recent first: username, display name and avatar. Counts are not part of this list; fetch a profile for them. Costs 1 credit. Input parameters: - `cache_max_age` (string) - `cursor` (string): `pagination.cursor` from the previous response - `handle` (string, required): Mixcloud username (spartacus), or a mixcloud.com profile URL - `limit` (number) ### `mixcloud_following` (~102 tokens) mixcloud: Accounts a user follows Accounts a user follows. Accounts a user follows, most recent first: username, display name and avatar. Counts are not part of this list; fetch a profile for them. Costs 1 credit. Input parameters: - `cache_max_age` (string) - `cursor` (string): `pagination.cursor` from the previous response - `handle` (string, required): Mixcloud username (spartacus), or a mixcloud.com profile URL - `limit` (number) ### `mixcloud_userUploads` (~100 tokens) mixcloud: User uploads User uploads. A user's public uploads, newest first, with plays, favourites, reposts and comments. Pass the `cursor` from the previous response to page. Costs 1 credit. Input parameters: - `cache_max_age` (string) - `cursor` (string): `pagination.cursor` from the previous response - `handle` (string, required): Mixcloud username (spartacus), or a mixcloud.com profile URL - `limit` (number) ### `odysee_channel` (~91 tokens) odysee: Channel Channel. Public metadata for an Odysee channel: title, description, avatar, banner, subscriber count, number of videos, website and creation date. Costs 1 credit. Input parameters: - `cache_max_age` (string) - `handle` (string, required): Channel name (@veritasium), name with claim suffix (@veritasium:f), or an odysee.com or lbry:// channel URL ### `odysee_channelVideos` (~113 tokens) odysee: Channel videos Channel videos. An Odysee channel's videos, newest first, 50 per page, with view and like counts. Pass the `cursor` from the previous response to page. Costs 1 credit. Input parameters: - `cache_max_age` (string) - `cursor` (string): `pagination.cursor` from the previous response - `handle` (string, required): Channel name (@veritasium), name with claim suffix (@veritasium:f), or an odysee.com or lbry:// channel URL ### `odysee_search` (~79 tokens) odysee: Search videos Search videos. Odysee videos matching a keyword, in Odysee search order, 20 per page, with view and like counts. Costs 1 credit. Input parameters: - `cache_max_age` (string) - `cursor` (string): `pagination.cursor` from the previous response - `query` (string, required): Keywords to search for ### `odysee_video` (~101 tokens) odysee: Video details Video details. Public metadata for an Odysee video: title, description, duration, tags, release date, channel, and view, like and comment counts. Dislikes are in `raw.dislikeCount`. Costs 1 credit. Input parameters: - `cache_max_age` (string) - `url` (string, required): Odysee video URL (odysee.com/@channel:x/video-name:y), lbry:// URL, or 40-character claim id ### `odysee_comments` (~109 tokens) odysee: Video comments Video comments. Top-level comments on an Odysee video, 50 per page, with like and reply counts. Pass the `cursor` from the previous response to page. Costs 1 credit. Input parameters: - `cache_max_age` (string) - `cursor` (string): `pagination.cursor` from the previous response - `url` (string, required): Odysee video URL (odysee.com/@channel:x/video-name:y), lbry:// URL, or 40-character claim id ### `okru_video` (~122 tokens) okru: Video details Video details. Public metadata for an OK.ru (Odnoklassniki) video: title, description, channel, duration, views, likes, comments, shares and upload date. `mediaUrls` lists the video files largest first, then the HLS playlist. Those links expire after about a day and answer only requests sent with a Chrome or Edge browser User-Agent. Costs 1 credit. Input parameters: - `cache_max_age` (string) - `url` (string, required): Video id (7475662490142) or an ok.ru/video/… link ### `peertube_channel` (~86 tokens) peertube: Channel profile Channel profile. Public profile of a PeerTube channel, read from the instance that hosts it: followers, following, video count, avatar, banner and creation date. Costs 1 credit. Input parameters: - `cache_max_age` (string) - `handle` (string, required): Channel as name@instance (blender_channel@video.blender.org) or a channel URL on its instance ### `peertube_channelVideos` (~117 tokens) peertube: Channel videos Channel videos. A PeerTube channel's public videos, newest first, 50 per page. Tags are not included in list items; `peertube.video` returns them. Pass the `cursor` from the previous response to page. Costs 1 credit. Input parameters: - `cache_max_age` (string) - `cursor` (string): `pagination.cursor` from the previous response - `handle` (string, required): Channel as name@instance (blender_channel@video.blender.org) or a channel URL on its instance ### `peertube_search` (~85 tokens) peertube: Search videos Search videos. Search public videos across PeerTube instances through Sepia Search, the PeerTube project's index, 50 per page. Covers the instances Sepia indexes, not every server. Costs 1 credit. Input parameters: - `cache_max_age` (string) - `cursor` (string): `pagination.cursor` from the previous response - `query` (string, required): Search terms ### `peertube_video` (~92 tokens) peertube: Video details Video details. Public metadata for a PeerTube video: views, likes, comment count, duration, tags, publish date and channel. Costs 1 credit. Input parameters: - `cache_max_age` (string) - `url` (string, required): Video URL (https://video.blender.org/w/9UhsEGd8vM4PTtg6bphpEM) or