{
  "name": "LurkAPI",
  "description": "Public social media data as clean JSON. GET any endpoint below with your key in the x-api-key header.",
  "docs": "https://lurkapi.com/docs",
  "llms": "https://lurkapi.com/llms.txt",
  "openapi": "https://api.lurkapi.com/openapi.json",
  "mcp": "https://api.lurkapi.com/mcp",
  "get_a_key": "https://lurkapi.com/login",
  "endpoints": [
    {
      "method": "GET",
      "url": "https://api.lurkapi.com/v1/facebook/adLibrary/search/ads",
      "summary": "Find ads in Meta's Ad Library by keyword, with their copy, media, landing page and run dates.",
      "credits": 1,
      "docs": "https://lurkapi.com/docs/facebook/search-ads",
      "mcp_tool": "facebook_search_ads"
    },
    {
      "method": "GET",
      "url": "https://api.lurkapi.com/v1/facebook/adLibrary/company/ads",
      "summary": "Every ad one advertiser is running (or ran) on Facebook and Instagram, from Meta's Ad Library.",
      "credits": 1,
      "docs": "https://lurkapi.com/docs/facebook/company-ads",
      "mcp_tool": "facebook_company_ads"
    },
    {
      "method": "GET",
      "url": "https://api.lurkapi.com/v1/facebook/adLibrary/ad",
      "summary": "Full detail for one ad from Meta's Ad Library, by its id or URL.",
      "credits": 1,
      "docs": "https://lurkapi.com/docs/facebook/ad",
      "mcp_tool": "facebook_ad"
    },
    {
      "method": "GET",
      "url": "https://api.lurkapi.com/v1/facebook/adLibrary/search/companies",
      "summary": "Find an advertiser's Facebook page id by name in Meta's Ad Library, with followers and linked Instagram.",
      "credits": 1,
      "docs": "https://lurkapi.com/docs/facebook/search-companies",
      "mcp_tool": "facebook_search_companies"
    },
    {
      "method": "GET",
      "url": "https://api.lurkapi.com/v1/facebook/profile",
      "summary": "Public business Page metadata, pictures, verification and follower counts.",
      "credits": 1,
      "docs": "https://lurkapi.com/docs/facebook/profile",
      "mcp_tool": "facebook_profile"
    },
    {
      "method": "GET",
      "url": "https://api.lurkapi.com/v1/facebook/post",
      "summary": "A public post's text, author, engagement counts and attached media.",
      "credits": 1,
      "docs": "https://lurkapi.com/docs/facebook/post",
      "mcp_tool": "facebook_post"
    },
    {
      "method": "GET",
      "url": "https://api.lurkapi.com/v1/reddit/subreddit",
      "summary": "A subreddit's feed (hot, new, top, rising or best), with titles, text, scores and comment counts.",
      "credits": 1,
      "docs": "https://lurkapi.com/docs/reddit/subreddit-posts",
      "mcp_tool": "reddit_subreddit_posts"
    },
    {
      "method": "GET",
      "url": "https://api.lurkapi.com/v1/reddit/subreddit/details",
      "summary": "A community's size, activity, description, rules and images.",
      "credits": 1,
      "docs": "https://lurkapi.com/docs/reddit/subreddit-details",
      "mcp_tool": "reddit_subreddit_details"
    },
    {
      "method": "GET",
      "url": "https://api.lurkapi.com/v1/reddit/subreddit/search",
      "summary": "Search one subreddit's posts by keyword, returned as compact result cards.",
      "credits": 1,
      "docs": "https://lurkapi.com/docs/reddit/subreddit-search",
      "mcp_tool": "reddit_subreddit_search"
    },
    {
      "method": "GET",
      "url": "https://api.lurkapi.com/v1/reddit/search",
      "summary": "Search all of Reddit for posts matching a keyword.",
      "credits": 1,
      "docs": "https://lurkapi.com/docs/reddit/search",
      "mcp_tool": "reddit_search"
    },
    {
      "method": "GET",
      "url": "https://api.lurkapi.com/v1/reddit/post/comments",
      "summary": "A Reddit post and its comment thread, with nested replies.",
      "credits": 1,
      "docs": "https://lurkapi.com/docs/reddit/post-comments",
      "mcp_tool": "reddit_post_comments"
    },
    {
      "method": "GET",
      "url": "https://api.lurkapi.com/v1/youtube/video",
      "summary": "A video's or Short's title, description, exact views and likes, publish date, length, tags, chapters and channel.",
      "credits": 1,
      "docs": "https://lurkapi.com/docs/youtube/video",
      "mcp_tool": "youtube_video"
    },
    {
      "method": "GET",
      "url": "https://api.lurkapi.com/v1/youtube/video/transcript",
      "summary": "What's said in a video or Short: its captions as timed segments and as one block of text.",
      "credits": 1,
      "docs": "https://lurkapi.com/docs/youtube/transcript",
      "mcp_tool": "youtube_transcript"
    },
    {
      "method": "GET",
      "url": "https://api.lurkapi.com/v1/youtube/video/comments",
      "summary": "A video's comments, top or newest first, with likes, reply counts and who wrote them.",
      "credits": 1,
      "docs": "https://lurkapi.com/docs/youtube/comments",
      "mcp_tool": "youtube_comments"
    },
    {
      "method": "GET",
      "url": "https://api.lurkapi.com/v1/youtube/video/comment/replies",
      "summary": "The replies to one YouTube comment.",
      "credits": 1,
      "docs": "https://lurkapi.com/docs/youtube/comment-replies",
      "mcp_tool": "youtube_comment_replies"
    },
    {
      "method": "GET",
      "url": "https://api.lurkapi.com/v1/youtube/channel",
      "summary": "A channel's subscribers, total views, video count, join date, country, links and description.",
      "credits": 1,
      "docs": "https://lurkapi.com/docs/youtube/channel",
      "mcp_tool": "youtube_channel"
    },
    {
      "method": "GET",
      "url": "https://api.lurkapi.com/v1/youtube/channel-videos",
      "summary": "A channel's videos, newest or most popular first, with views, length and upload time.",
      "credits": 1,
      "docs": "https://lurkapi.com/docs/youtube/channel-videos",
      "mcp_tool": "youtube_channel_videos"
    },
    {
      "method": "GET",
      "url": "https://api.lurkapi.com/v1/youtube/channel/shorts",
      "summary": "A channel's Shorts, newest or most popular first, with titles and view counts.",
      "credits": 1,
      "docs": "https://lurkapi.com/docs/youtube/channel-shorts",
      "mcp_tool": "youtube_channel_shorts"
    },
    {
      "method": "GET",
      "url": "https://api.lurkapi.com/v1/youtube/search",
      "summary": "Search YouTube by keyword for videos, Shorts, channels and playlists, with date, length and type filters.",
      "credits": 1,
      "docs": "https://lurkapi.com/docs/youtube/search",
      "mcp_tool": "youtube_search"
    },
    {
      "method": "GET",
      "url": "https://api.lurkapi.com/v1/tiktok/profile",
      "summary": "A creator's bio, avatar, verification and exact follower, like and video counts.",
      "credits": 1,
      "docs": "https://lurkapi.com/docs/tiktok/profile",
      "mcp_tool": "tiktok_profile"
    },
    {
      "method": "GET",
      "url": "https://api.lurkapi.com/v2/tiktok/video",
      "summary": "One video or photo post: caption, stats, author, sound, hashtags and a playable MP4 URL.",
      "credits": 1,
      "docs": "https://lurkapi.com/docs/tiktok/video",
      "mcp_tool": "tiktok_video"
    },
    {
      "method": "GET",
      "url": "https://api.lurkapi.com/v1/tiktok/video/transcript",
      "summary": "What's said in a video, from TikTok's captions: WEBVTT with timestamps plus plain text.",
      "credits": 1,
      "docs": "https://lurkapi.com/docs/tiktok/transcript",
      "mcp_tool": "tiktok_transcript"
    },
    {
      "method": "GET",
      "url": "https://api.lurkapi.com/v3/tiktok/profile/videos",
      "summary": "A creator's videos and photo posts, newest first, up to 15 per page.",
      "credits": 1,
      "docs": "https://lurkapi.com/docs/tiktok/profile-videos",
      "mcp_tool": "tiktok_profile_videos"
    },
    {
      "method": "GET",
      "url": "https://api.lurkapi.com/v1/tiktok/video/comments",
      "summary": "A video's top-level comments, most relevant first, with like and reply counts.",
      "credits": 1,
      "docs": "https://lurkapi.com/docs/tiktok/comments",
      "mcp_tool": "tiktok_comments"
    },
    {
      "method": "GET",
      "url": "https://api.lurkapi.com/v1/tiktok/video/comment/replies",
      "summary": "The replies under one comment, oldest first.",
      "credits": 1,
      "docs": "https://lurkapi.com/docs/tiktok/comment-replies",
      "mcp_tool": "tiktok_comment_replies"
    },
    {
      "method": "GET",
      "url": "https://api.lurkapi.com/v1/tiktok/search/hashtag",
      "summary": "Videos posted with a hashtag, plus how big the hashtag is: total posts and views.",
      "credits": 1,
      "docs": "https://lurkapi.com/docs/tiktok/hashtag-videos",
      "mcp_tool": "tiktok_hashtag_videos"
    },
    {
      "method": "GET",
      "url": "https://api.lurkapi.com/v1/tiktok/song",
      "summary": "A TikTok sound: title, artist, album, length, cover, audio URL and how many videos use it.",
      "credits": 1,
      "docs": "https://lurkapi.com/docs/tiktok/song",
      "mcp_tool": "tiktok_song"
    },
    {
      "method": "GET",
      "url": "https://api.lurkapi.com/v1/tiktok/song/videos",
      "summary": "Videos that use a sound, 30 per page, with stats and creators.",
      "credits": 1,
      "docs": "https://lurkapi.com/docs/tiktok/song-videos",
      "mcp_tool": "tiktok_song_videos"
    },
    {
      "method": "GET",
      "url": "https://api.lurkapi.com/v1/tiktok/ad-library/search",
      "summary": "Ads shown in the EU, the UK, Switzerland and Turkey that match a keyword or an advertiser, 12 per page.",
      "credits": 1,
      "docs": "https://lurkapi.com/docs/tiktok/ad-library-search",
      "mcp_tool": "tiktok_ad_library_search"
    },
    {
      "method": "GET",
      "url": "https://api.lurkapi.com/v1/tiktok/ad-library/ad",
      "summary": "One ad from TikTok's EU Ad Library: creative, landing page, advertiser, who paid, targeting and reach by country, age and gender.",
      "credits": 1,
      "docs": "https://lurkapi.com/docs/tiktok/ad-library-ad",
      "mcp_tool": "tiktok_ad_library_ad"
    },
    {
      "method": "GET",
      "url": "https://api.lurkapi.com/v1/tiktok/user/live",
      "summary": "Whether a public creator is live, with the current room title, viewers and start time.",
      "credits": 1,
      "docs": "https://lurkapi.com/docs/tiktok/live",
      "mcp_tool": "tiktok_live"
    },
    {
      "method": "GET",
      "url": "https://api.lurkapi.com/v1/tiktok/user/stories",
      "summary": "A creator's active public stories, with captions, media and expiration times.",
      "credits": 1,
      "docs": "https://lurkapi.com/docs/tiktok/stories",
      "mcp_tool": "tiktok_stories"
    },
    {
      "method": "GET",
      "url": "https://api.lurkapi.com/v1/tiktok/product",
      "summary": "A US TikTok Shop product's price, images, seller, variants, sales and review totals.",
      "credits": 1,
      "docs": "https://lurkapi.com/docs/tiktok/product",
      "mcp_tool": "tiktok_product"
    },
    {
      "method": "GET",
      "url": "https://api.lurkapi.com/v1/google/adLibrary/advertisers/search",
      "summary": "Find an advertiser's Google Ads id by brand name, with how many ads they run, plus matching websites.",
      "credits": 1,
      "docs": "https://lurkapi.com/docs/google/search-advertisers",
      "mcp_tool": "google_search_advertisers"
    },
    {
      "method": "GET",
      "url": "https://api.lurkapi.com/v1/google/company/ads",
      "summary": "Every ad an advertiser or website runs on Google Search, YouTube, Maps, Play and Shopping, from the Ads Transparency Center.",
      "credits": 1,
      "docs": "https://lurkapi.com/docs/google/company-ads",
      "mcp_tool": "google_company_ads"
    },
    {
      "method": "GET",
      "url": "https://api.lurkapi.com/v1/google/ad",
      "summary": "One ad from Google's Ads Transparency Center: every version of the creative, where it ran and, for political ads, spend and targeting.",
      "credits": 1,
      "docs": "https://lurkapi.com/docs/google/ad",
      "mcp_tool": "google_ad"
    },
    {
      "method": "GET",
      "url": "https://api.lurkapi.com/v1/bluesky/profile",
      "summary": "An account's bio, avatar, banner and exact follower, following and post counts.",
      "credits": 1,
      "docs": "https://lurkapi.com/docs/bluesky/profile",
      "mcp_tool": "bluesky_profile"
    },
    {
      "method": "GET",
      "url": "https://api.lurkapi.com/v1/bluesky/user/posts",
      "summary": "An account's latest posts and reposts, newest first, with text, media and engagement counts.",
      "credits": 1,
      "docs": "https://lurkapi.com/docs/bluesky/user-posts",
      "mcp_tool": "bluesky_user_posts"
    },
    {
      "method": "GET",
      "url": "https://api.lurkapi.com/v1/bluesky/post",
      "summary": "A post with its replies (three levels deep) and the posts it replies to.",
      "credits": 1,
      "docs": "https://lurkapi.com/docs/bluesky/post",
      "mcp_tool": "bluesky_post"
    },
    {
      "method": "GET",
      "url": "https://api.lurkapi.com/v1/snapchat/profile",
      "summary": "A public profile with its live story, highlights and Spotlight videos, with direct media links.",
      "credits": 1,
      "docs": "https://lurkapi.com/docs/snapchat/profile",
      "mcp_tool": "snapchat_profile"
    },
    {
      "method": "GET",
      "url": "https://api.lurkapi.com/v1/truthsocial/profile",
      "summary": "An account's bio, avatar, follower and post counts, and verification.",
      "credits": 1,
      "docs": "https://lurkapi.com/docs/truthsocial/profile",
      "mcp_tool": "truthsocial_profile"
    },
    {
      "method": "GET",
      "url": "https://api.lurkapi.com/v1/truthsocial/user/posts",
      "summary": "An account's latest posts and ReTruths, newest first, 20 per page.",
      "credits": 1,
      "docs": "https://lurkapi.com/docs/truthsocial/user-posts",
      "mcp_tool": "truthsocial_user_posts"
    },
    {
      "method": "GET",
      "url": "https://api.lurkapi.com/v1/truthsocial/post",
      "summary": "One post with its text, media, link preview and engagement counts.",
      "credits": 1,
      "docs": "https://lurkapi.com/docs/truthsocial/post",
      "mcp_tool": "truthsocial_post"
    },
    {
      "method": "GET",
      "url": "https://api.lurkapi.com/v1/telegram/channel",
      "summary": "A public channel's name, bio, photo, exact subscriber count and media counts.",
      "credits": 1,
      "docs": "https://lurkapi.com/docs/telegram/channel",
      "mcp_tool": "telegram_channel"
    },
    {
      "method": "GET",
      "url": "https://api.lurkapi.com/v1/telegram/channel/posts",
      "summary": "A public channel's latest posts, newest first, with text, views, media, links and reactions.",
      "credits": 1,
      "docs": "https://lurkapi.com/docs/telegram/channel-posts",
      "mcp_tool": "telegram_channel_posts"
    },
    {
      "method": "GET",
      "url": "https://api.lurkapi.com/v1/telegram/post",
      "summary": "One public channel post by link, with text, views, media, links and reactions.",
      "credits": 1,
      "docs": "https://lurkapi.com/docs/telegram/post",
      "mcp_tool": "telegram_post"
    },
    {
      "method": "GET",
      "url": "https://api.lurkapi.com/v1/twitter/tweet",
      "summary": "One tweet: text, author, likes, replies, reposts, quotes, bookmarks, views, media and the tweet it quotes.",
      "credits": 1,
      "docs": "https://lurkapi.com/docs/twitter/tweet",
      "mcp_tool": "twitter_tweet"
    },
    {
      "method": "GET",
      "url": "https://api.lurkapi.com/v1/twitter/profile",
      "summary": "An account's bio, avatar, verification and exact follower, following, tweet and like counts.",
      "credits": 1,
      "docs": "https://lurkapi.com/docs/twitter/profile",
      "mcp_tool": "twitter_profile"
    },
    {
      "method": "GET",
      "url": "https://api.lurkapi.com/v1/twitter/user-tweets",
      "summary": "An account's tweets and retweets, about 20 per page, with text, media and engagement counts.",
      "credits": 1,
      "docs": "https://lurkapi.com/docs/twitter/user-tweets",
      "mcp_tool": "twitter_user_tweets"
    },
    {
      "method": "GET",
      "url": "https://api.lurkapi.com/v1/threads/profile",
      "summary": "Public profile biography, links, follower count and account metadata.",
      "credits": 1,
      "docs": "https://lurkapi.com/docs/threads/profile",
      "mcp_tool": "threads_profile"
    },
    {
      "method": "GET",
      "url": "https://api.lurkapi.com/v1/threads/user/posts",
      "summary": "One page of a public account's Threads posts, with text, media and engagement.",
      "credits": 1,
      "docs": "https://lurkapi.com/docs/threads/user-posts",
      "mcp_tool": "threads_user_posts"
    },
    {
      "method": "GET",
      "url": "https://api.lurkapi.com/v1/threads/post",
      "summary": "The text, author, media and engagement of one public Threads post.",
      "credits": 1,
      "docs": "https://lurkapi.com/docs/threads/post",
      "mcp_tool": "threads_post"
    },
    {
      "method": "GET",
      "url": "https://api.lurkapi.com/v1/instagram/profile",
      "summary": "A public profile's biography, links and follower counts.",
      "credits": 1,
      "docs": "https://lurkapi.com/docs/instagram/profile",
      "mcp_tool": "instagram_profile"
    },
    {
      "method": "GET",
      "url": "https://api.lurkapi.com/v2/instagram/user/posts",
      "summary": "A page of public posts with captions, media and engagement counts.",
      "credits": 1,
      "docs": "https://lurkapi.com/docs/instagram/user-posts",
      "mcp_tool": "instagram_user_posts"
    },
    {
      "method": "GET",
      "url": "https://api.lurkapi.com/v1/instagram/post",
      "summary": "A public photo, carousel, video or reel with its caption and counts.",
      "credits": 1,
      "docs": "https://lurkapi.com/docs/instagram/post",
      "mcp_tool": "instagram_post"
    },
    {
      "method": "GET",
      "url": "https://api.lurkapi.com/v2/instagram/post/comments",
      "summary": "A page of public comments with authors, timestamps and likes.",
      "credits": 1,
      "docs": "https://lurkapi.com/docs/instagram/post-comments",
      "mcp_tool": "instagram_post_comments"
    },
    {
      "method": "GET",
      "url": "https://api.lurkapi.com/v1/instagram/user/reels",
      "summary": "A page of public reel previews with play, like and comment counts.",
      "credits": 1,
      "docs": "https://lurkapi.com/docs/instagram/user-reels",
      "mcp_tool": "instagram_user_reels"
    },
    {
      "method": "GET",
      "url": "https://api.lurkapi.com/v2/instagram/media/transcript",
      "summary": "Transcribe speech from a public Instagram video or reel.",
      "credits": 1,
      "docs": "https://lurkapi.com/docs/instagram/media-transcript",
      "mcp_tool": "instagram_media_transcript"
    },
    {
      "method": "GET",
      "url": "https://api.lurkapi.com/v1/linkedin/company",
      "summary": "A company's public overview and latest updates.",
      "credits": 1,
      "docs": "https://lurkapi.com/docs/linkedin/company",
      "mcp_tool": "linkedin_company"
    },
    {
      "method": "GET",
      "url": "https://api.lurkapi.com/v1/linkedin/company/posts",
      "summary": "Latest public updates from a company page, with text, engagement and media.",
      "credits": 1,
      "docs": "https://lurkapi.com/docs/linkedin/company-posts",
      "mcp_tool": "linkedin_company_posts"
    },
    {
      "method": "GET",
      "url": "https://api.lurkapi.com/v1/linkedin/ads/search",
      "summary": "Search LinkedIn's public Ad Library by advertiser or keyword.",
      "credits": 1,
      "docs": "https://lurkapi.com/docs/linkedin/search-ads",
      "mcp_tool": "linkedin_search_ads"
    },
    {
      "method": "GET",
      "url": "https://api.lurkapi.com/v1/linkedin/ad",
      "summary": "One LinkedIn ad's creative, payer and public delivery disclosures.",
      "credits": 1,
      "docs": "https://lurkapi.com/docs/linkedin/ad",
      "mcp_tool": "linkedin_ad"
    },
    {
      "method": "GET",
      "url": "https://api.lurkapi.com/v1/linktree",
      "summary": "A public Linktree profile, its link cards and listed social accounts.",
      "credits": 1,
      "docs": "https://lurkapi.com/docs/linkinbio/linktree",
      "mcp_tool": "linkinbio_linktree"
    },
    {
      "method": "GET",
      "url": "https://api.lurkapi.com/v1/account/credit-balance",
      "summary": "Your credit balance and daily top-up. Free.",
      "credits": 0,
      "docs": "https://lurkapi.com/docs/account/credit-balance",
      "mcp_tool": "account_credit_balance"
    }
  ]
}