Search a platform by query for ads, advertisers, albums, channels, comments, communities, events, groups, hashtags, issues, jobs, places, playlists, podcasts, posts, products, profiles, repositories, sounds, suggestions or top. Pass platform, type and query. Types by platform: amazon: products; applemusic: albums, profiles, playlists, posts; bluesky: posts; facebook: ads, advertisers, events, groups, products, places, posts, profiles; github: issues, profiles, repositories; google: ads, profiles, suggestions; hackernews: comments, posts; instagram: hashtags, places, posts, profiles, sounds, suggestions; linkedin: ads, jobs, posts, profiles; pinterest: posts; reddit: comments, posts, profiles, communities; rumble: posts; spotify: albums, profiles, playlists, podcasts, posts; telegram: channels; threads: posts, profiles; tiktok: ads, hashtags, posts, profiles, sounds, suggestions, top; tiktokshop: products; x: communities, hashtags, posts, profiles. Price per successful page: Amazon, Apple Music, Bluesky, GitHub, Google, Hacker News, Instagram, Pinterest, Reddit, Rumble, Spotify, Threads, TikTok Shop: 1 credit. Facebook, LinkedIn, Telegram, TikTok, X: 1 credit + 1 per result filled in. Follow next_cursor while it is set; a short page is not the end.
View input schema
{
"type": "object",
"properties": {
"platform": {
"description": "The platform to search.",
"enum": [
"amazon",
"applemusic",
"bluesky",
"facebook",
"github",
"google",
"hackernews",
"instagram",
"linkedin",
"pinterest",
"reddit",
"rumble",
"spotify",
"telegram",
"threads",
"tiktok",
"tiktokshop",
"x"
],
"type": "string"
},
"type": {
"description": "What to search for. Each platform searches some types (the tool's description lists them).",
"enum": [
"ads",
"advertisers",
"albums",
"channels",
"comments",
"communities",
"events",
"groups",
"hashtags",
"issues",
"jobs",
"places",
"playlists",
"podcasts",
"posts",
"products",
"profiles",
"repositories",
"sounds",
"suggestions",
"top"
],
"type": "string"
},
"query": {
"description": "The words to search for.",
"maxLength": 1024,
"type": "string"
},
"country": {
"description": "Only on some platforms (find_endpoint lists which). Region: an ISO 3166-1 alpha-2 country code such as US or BR (case-insensitive).",
"type": "string"
},
"sort": {
"description": "Only on some platforms (find_endpoint lists which). Order of the results.",
"enum": [
"relevance",
"price_asc",
"price_desc",
"newest",
"popular",
"nearest",
"oldest",
"recent_activity",
"most_comments",
"spend"
],
"type": "string"
},
"lang": {
"description": "Only for Apple Music (every type), Bluesky posts, Facebook ads, Spotify (every type). Preferred language: a BCP-47 tag such as en or pt-BR (case-insensitive; _ is read as -).",
"type": "string"
},
"kind": {
"description": "Only for Apple Music playlists or posts, GitHub issues, Hacker News posts, Spotify profiles or posts. Differs by platform: find_endpoint gives each endpoint's.",
"enum": [
"playlist",
"station",
"song",
"music_video",
"radio_episode",
"all",
"issue",
"pull_request",
"story",
"ask_hn",
"show_hn",
"launch_hn",
"job",
"poll",
"artist",
"listener",
"track",
"episode"
],
"type": "string"
},
"author": {
"description": "Only for Bluesky posts, Hacker News (every type). Differs by platform: find_endpoint gives each endpoint's.",
"maxLength": 300,
"type": "string"
},
"mentions": {
"description": "Only for Bluesky posts. Only posts that mention this account: a handle, a DID or a profile link.",
"maxLength": 300,
"type": "string"
},
"tag": {
"description": "Only for Bluesky posts. Only posts with this hashtag, with or without the #.",
"maxLength": 100,
"type": "string"
},
"domain": {
"description": "Only for Bluesky posts. Only posts that link to this domain or a subdomain of it.",
"maxLength": 253,
"type": "string"
},
"links_to": {
"description": "Only for Bluesky posts. Only posts that link to this page: a full URL.",
"maxLength": 2000,
"type": "string"
},
"since": {
"description": "Only on some platforms (find_endpoint lists which). Only items at or after this time: RFC 3339 (2026-10-01T12:00:00Z) or a date (2026-10-01, midnight UTC).",
"type": "string"
},
"until": {
"description": "Only on some platforms (find_endpoint lists which). Only items before this time (exclusive): RFC 3339 or a date (midnight UTC).",
"type": "string"
},
"status": {
"description": "Only for Facebook ads, GitHub issues, TikTok ads. Only items that are still running (active), only items that stopped (inactive), or both (all).",
"enum": [
"active",
"inactive",
"all"
],
"type": "string"
},
"location": {
"description": "Only for Facebook events or products, LinkedIn jobs. Differs by platform: find_endpoint gives each endpoint's.",
"maxLength": 2048,
"type": "string"
},
"fill": {
"description": "Only on some platforms (find_endpoint lists which). true also fetches each result's item from the platform: its full, current record in details (exact counts, its ID), as the platform's own endpoint for that kind returns it.",
"enum": [
"true",
"false"
],
"type": "string"
},
"lat": {
"description": "Only for Facebook products or places. Differs by platform: find_endpoint gives each endpoint's.",
"maximum": 90,
"minimum": -90,
"type": "number"
},
"lng": {
"description": "Only for Facebook products or places. Differs by platform: find_endpoint gives each endpoint's.",
"maximum": 180,
"minimum": -180,
"type": "number"
},
"radius_km": {
"description": "Only for Facebook products. How far around the place to search, in kilometers (default 65).",
"maximum": 805,
"minimum": 1,
"type": "integer"
},
"min_price": {
"description": "Only for Facebook products. Only listings at this price or above, in major units of the local currency.",
"maximum": 2147483647,
"minimum": 0,
"type": "number"
},
"max_price": {
"description": "Only for Facebook products. Only listings at this price or below, in major units of the local currency.",
"maximum": 2147483647,
"minimum": 0,
"type": "number"
},
"period": {
"description": "Only for Facebook products, LinkedIn jobs. The window the ranking counts over, in days back from the platform's latest update (each endpoint lists its own).",
"enum": [
"1",
"7",
"30"
],
"type": "string"
},
"condition": {
"description": "Only for Facebook products. Only listings in these conditions, comma-separated: new, used_like_new, used_good, used_fair.",
"maxLength": 60,
"type": "string"
},
"availability": {
"description": "Only for Facebook products. available (default): listings for sale now.",
"enum": [
"available",
"sold"
],
"type": "string"
},
"delivery_method": {
"description": "Only for Facebook products. all (default), only listings the buyer can pick up (local_pickup), or only those the seller ships (shipping), which can come from far away.",
"enum": [
"all",
"local_pickup",
"shipping"
],
"type": "string"
},
"category_id": {
"description": "Only for Facebook products. Only listings in this Marketplace category (data[].category_id of a listing, such as 1658310421102081 for Bicycles).",
"maxLength": 25,
"type": "string"
},
"media": {
"description": "Only for Facebook posts, Reddit posts. Differs by platform: find_endpoint gives each endpoint's.",
"enum": [
"video",
"image",
"carousel",
"any"
],
"type": "string"
},
"account_type": {
"description": "Only for Facebook profiles, LinkedIn profiles. Differs by platform: find_endpoint gives each endpoint's.",
"enum": [
"page",
"person",
"company",
"school",
"showcase",
"member"
],
"type": "string"
},
"topic": {
"description": "Only for Google ads. political: only the election ads that lead to the website (the center's Political ads view), with their impressions and spend; needs country.",
"enum": [
"all",
"political"
],
"type": "string"
},
"format": {
"description": "Only for Google ads. Only ads of this format.",
"enum": [
"text",
"image",
"video"
],
"type": "string"
},
"service": {
"description": "Only for Google ads. Only ads shown on this Google service.",
"enum": [
"google_search",
"google_maps",
"google_play",
"google_shopping",
"youtube"
],
"type": "string"
},
"story": {
"description": "Only for Hacker News comments. Only comments on this story, replies included: a story's link (news.ycombinator.com/item?id=8863) or its item ID.",
"maxLength": 300,
"type": "string"
},
"search_in": {
"description": "Only for Hacker News (every type). Differs by platform: find_endpoint gives each endpoint's.",
"enum": [
"all",
"text",
"title",
"url"
],
"type": "string"
},
"min_points": {
"description": "Only for Hacker News posts. Only stories with at least this many points.",
"maximum": 1000000,
"minimum": 0,
"type": "integer"
},
"min_comments": {
"description": "Only for Hacker News posts. Only stories with at least this many comments.",
"maximum": 1000000,
"minimum": 0,
"type": "integer"
},
"front_page": {
"description": "Only for Hacker News posts. Only the stories on Hacker News' front page now.",
"type": "boolean"
},
"search_by": {
"description": "Only for LinkedIn ads, TikTok ads. Differs by platform: find_endpoint gives each endpoint's.",
"enum": [
"keyword",
"advertiser",
"advertiser_id",
"payer"
],
"type": "string"
},
"advertiser": {
"description": "Only for LinkedIn ads. Only ads of advertisers with these words in their name, for a keyword or payer search.",
"maxLength": 200,
"type": "string"
},
"advertiser_id": {
"description": "Only for LinkedIn ads, TikTok ads. Differs by platform: find_endpoint gives each endpoint's.",
"maxLength": 500,
"type": "string"
},
"countries": {
"description": "Only for LinkedIn ads. Only ads shown in any of these countries: ISO 3166-1 alpha-2 codes with commas.",
"maxLength": 750,
"type": "string"
},
"company_id": {
"description": "Only for LinkedIn jobs. Only jobs at these companies: a company's numeric LinkedIn ID, or several with commas.",
"maxLength": 500,
"type": "string"
},
"easy_apply": {
"description": "Only for LinkedIn jobs. Only jobs applied for on LinkedIn itself (Easy Apply).",
"type": "boolean"
},
"under_10_applicants": {
"description": "Only for LinkedIn jobs. Only jobs with fewer than ten applicants so far.",
"type": "boolean"
},
"subreddit": {
"description": "Only for Reddit comments or posts. Differs by platform: find_endpoint gives each endpoint's.",
"maxLength": 256,
"type": "string"
},
"include_body": {
"description": "Only for Reddit posts. Differs by platform: find_endpoint gives each endpoint's.",
"type": "boolean"
},
"tab": {
"description": "Only for Rumble posts. The search tab to list: videos (default; videos and live streams) or shorts.",
"enum": [
"videos",
"shorts"
],
"type": "string"
},
"duration": {
"description": "Only for Rumble posts. Only short videos (Rumble's Under 4 minutes) or long ones (Over 20 minutes).",
"enum": [
"short",
"long"
],
"type": "string"
},
"limit": {
"description": "Items per page, 1 to the endpoint's page size (its default and maximum; larger values are reduced to it).",
"maximum": 100,
"minimum": 1,
"type": "integer"
},
"detail": {
"default": "concise",
"description": "concise (default) returns the fields that answer most questions; full returns every field. Same price.",
"enum": [
"concise",
"full"
],
"type": "string"
},
"max_age": {
"description": "Accept a cached response up to this many seconds old. Cache hits cost 0 credits. Omit to always fetch fresh.",
"minimum": 0,
"type": "integer"
},
"cursor": {
"description": "next_cursor from this tool's previous result: the next page, or the rest of a cut result. Send the same other arguments.",
"type": "string"
}
},
"required": [
"platform",
"type",
"query"
],
"additionalProperties": false
}