Authentication
authFull Description
Get subscription and rate limit information. Optionally provide an API key to test.
Parameters (0 required, 1 optional)
apiKeystring/nullOptionally provide an alternate API key to test
Access comprehensive social analytics and market intelligence for companies, brands, stocks, and cryptocurrencies through LunarCrush's AI-data platform. Stream real-time social metrics, sentiment analysis, trending topics, and market data directly into your AI workflows.
authGet subscription and rate limit information. Optionally provide an API key to test.
apiKeystring/nullOptionally provide an alternate API key to test
creatorCreator's summary snapshot of social metrics and insights. Use for deeper research on a social media account/creator/influencer.
networkstringxtwittertiktokyoutuberedditinstagramscreenNamestringCan be the screen name or unique id
creator_postsTop social posts for a specific social media account by unique id or screen name and time period. Use for deeper research on a social media account/creator/influencer.
networkstringxtwittertiktokyoutuberedditinstagramscreenNamestringCan be the screen name or unique id
from_datestring/nullprovide a date range instead of interval with from_date and to_date to get posts for a specific day or range
intervalstring/nullDefault is most recent top posts or get the top x posts in the last 1d, 1w, 1m, 3m, 6m, 1y, all
1d1w1m3m6m1yalllimitnumber/null100to_datestring/nulloptional to_date for date range, leave blank to get posts only from the from_date
creator_time_seriesHistorical time-series metrics for a social media account by unique id or screen name.
networkstringxtwittertiktokyoutuberedditinstagramscreenNamestringCan be the screen name or unique id
intervalstring/nullDefault is 1w hourly data. Use 1m or longer for daily data. One of: 1d, 1w, 1m, 3m, 6m, 1y, all
1d1w1m3m6m1yallmetricsarray/nullLeave blank to show all metrics or isolate to one or more of (key - display name): interactions - Engagements, posts_active - Mentions, posts_created - Posts Created, influencer_rank - CreatorRank™, followers - Followers
cryptocurrenciesList of cryptocurrencies sorted by available metrics and filtered by a sector.
limitnumber/null100sectorstring/nullOne of (key - display name): stablecoin - Stablecoin, defi - DeFi, nft - NFTs & Collectibles, dot - Polkadot Ecosystem, bsc - BNB Chain Ecosystem, meme - Memecoins, avalanche - Avalanche Ecosystem, algorand - Algorand Ecosystem, dao - DAO, wallets - Wallets, ai - AI, arbitrum - Arbitrum Ecosystem, gaming - Gaming & Metaverse, layer-1 - Layer 1, layer-2 - Layer 2, lending-borrowing - Lending/Borrowing, liquid-staking-tokens - Liquid Staking Derivatives, brc20 - BRC-20, exchange-tokens - Exchange Tokens, real-world-assets - Real-World Assets, depin - DePin, fan - Fan Tokens, gambling - Gambling, runes - Runes, desci - DeSci, sports - Sports, socialfi - SocialFi, analytics - Analytics, events - Events, real-estate - Real Estate, bitcoin-ecosystem - Bitcoin Ecosystem, stacks-ecosystem - Stacks Ecosystem, base-ecosystem - Base Ecosystem, solana-ecosystem - Solana Ecosystem, ai-agents - AI Agents, defai - DeFAI, zk - Zero Knowledge Proofs, oracle - Oracles, storage - Storage, made-in-usa - Made In USA, sui - SUI Ecosystem, inj - Injective Ecosystem, cardano - Cardano Ecosystem, pow - Proof of Work (PoW), pos - Proof of Stake (PoS), music - Music, insurance - Insurance, privacy - Privacy, energy - Energy, pump-fun - Pump.Fun Ecosystem, prediction - Prediction Markets, entertainment - Entertainment, healthcare - Healthcare, btcfi - BTCfi, interoperability - Interoperability, move-to-earn - Move to Earn, bittensor-ecosystem - Bittensor Ecosystem, derivatives - Derivatives, perpetuals - Perpetuals, openclaw - Moltbook and Openclaw-Themed Coins
stablecoindefinftdotbscmemeavalanchealgoranddaowalletsaiarbitrumgaminglayer-1layer-2lending-borrowingliquid-staking-tokensbrc20exchange-tokensreal-world-assetsdepinfangamblingrunesdescisportssocialfianalyticseventsreal-estatebitcoin-ecosystemstacks-ecosystembase-ecosystemsolana-ecosystemai-agentsdefaizkoraclestoragemade-in-usasuiinjcardanopowposmusicinsuranceprivacyenergypump-funpredictionentertainmenthealthcarebtcfiinteroperabilitymove-to-earnbittensor-ecosystemderivativesperpetualsopenclawsortstring/nullOne of (key - display name): alt_rank - AltRank™, galaxy_score - Galaxy Score™, close - Price, percent_change_1h - 1h %, percent_change_24h - 24h %, percent_change_7d - 7d %, interactions - Engagements, posts_active - Mentions, contributors_active - Creators, sentiment - Sentiment, social_dominance - Social Dominance, market_cap - Market Cap, market_dominance - Market Dominance, volume_24h - Trading Volume, circulating_supply - Circulating Supply, topic_rank - TopicRank™
alt_rankgalaxy_scoreclosepercent_change_1hpercent_change_24hpercent_change_7dinteractionsposts_activecontributors_activesentimentsocial_dominancemarket_capmarket_dominancevolume_24hcirculating_supplytopic_rankfetchFetch a lunarcrush.ai context using a specific path like /topic/bitcoin or /topic/bitcoin/posts or /list/cryptocurrencies/altrank or /creator/x/lunarcrush or /post/x/1234567890
idstringid is a url-friendly path. Use slashes (/) to separate path parts. Example: /topic/bitcoin/posts/1m or /list/cryptocurrencies/altrank/100
keyword_postsTop social posts by interactions for a given time period. Identify the most influential narrative and the posts driving social metrics. Use for exact keyword/phrase analytics.
keywordstringKeyword/phrases must be lower case a-z, 0-9, #, $, _ and spaces are allowed. Examples: bitcoin, donald trump, my favorite food, taco bell
from_datestring/nullprovide a date range instead of interval with from_date and to_date to get posts for a specific day or range
intervalstring/nullDefault is most recent top posts or get the top x posts in the last 1d, 1w, 1m, 3m, 6m, 1y, all
1d1w1m3m6m1yalllimitnumber/null100networkstring/nullIf no network is specified default is to show all
allxtwittertiktokyoutuberedditinstagramnewsto_datestring/nulloptional to_date for date range, leave blank to get posts only from the from_date
keyword_time_seriesHistorical time series social metrics for any keyword or phrase. Use for exact keyword/phrase analytics.
keywordstringKeyword examples: bitcoin, donald trump, my favorite food, taco bell
intervalstring/nullDefault is 1w hourly data. Use 1m or longer for daily data. One of: 1d, 1w, 1m, 3m, 6m, 1y, all
1w1m3m6m1yallmetricsarray/nullLeave blank to show all metrics or isolate to one or more of (key - display name): interactions - Engagements, posts_active - Mentions, posts_created - Posts Created, contributors_active - Creators, contributors_created - Creators Posting, sentiment - Sentiment
networkstring/nullIf no network is specified default is to show all
allxtwittertiktokyoutuberedditinstagramnewslistList of social topics within a category sorted and filtered by available metrics and sectors.
categorystring/nullLeave blank for all categories
fashion-brandstechnology-brandssocial-networksbundesliganhlproductstravel-destinationsla-ligaautomotive-brandsvc-firmsncaa-footballluxury-brandsgamingnbanascarufcagenciesmusiciansnftsexchangescurrenciescelebritiesstocksncaa-basketballeventscountriesmlsmlbformula-1nflpremier-leaguefinancecryptocurrencieschampions-leaguepga-golfersliga-mxlimitnumber/null100sortstring/nullOne of (key - display name): interactions - Engagements, posts_active - Mentions, contributors_active - Creators, sentiment - Sentiment, social_dominance - Social Dominance, topic_rank - TopicRank™
interactionsposts_activecontributors_activesentimentsocial_dominancetopic_rankpostSocial post details. Ids of posts can be inferred by the public URL link to the post.
idstringnetworkstringxtwittertiktokyoutuberedditinstagramnewssearchSearch for any keyword or account. Returns matching topics, creator accounts, and the top social posts to help with exact topic lookup or ai context on a keyword.
querystringSearch query or phrase. Include keywords, metrics, or time intervals to expand the results with more context.
stocksList of stocks sorted by available metrics and filtered by a sector.
limitnumber/null100sectorstring/nullOne of (key - display name): basic-materials - Basic Materials, communication-services - Communication Services, consumer-cyclical - Consumer Cyclical, consumer-defensive - Consumer Defensive, energy - Energy, financial-services - Financial Services, healthcare - Healthcare, industrials - Industrials, real-estate - Real Estate, technology - Technology, utilities - Utilities, banks - Banks, etf - ETFs, bitcoin-spot-etf - Bitcoin Spot ETFs, bitcoin-futures-etf - Bitcoin Futures ETFs, ethereum-spot-etf - Ethereum Spot ETFs, bitcoin-treasuries - Bitcoin Treasuries, crypto-etfs - Crypto ETFs, defense - Defense, crypto-treasuries - Crypto Treasuries, bitcoin-miners - Bitcoin Miners
basic-materialscommunication-servicesconsumer-cyclicalconsumer-defensiveenergyfinancial-serviceshealthcareindustrialsreal-estatetechnologyutilitiesbanksetfbitcoin-spot-etfbitcoin-futures-etfethereum-spot-etfbitcoin-treasuriescrypto-etfsdefensecrypto-treasuriesbitcoin-minerssortstring/nullOne of (key - display name): alt_rank - AltRank™, galaxy_score - Galaxy Score™, close - Price, percent_change_24h - 24h %, interactions - Engagements, posts_active - Mentions, contributors_active - Creators, sentiment - Sentiment, social_dominance - Social Dominance, market_cap - Market Cap, market_dominance - Market Dominance, volume - Trading Volume, topic_rank - TopicRank™
alt_rankgalaxy_scoreclosepercent_change_24hinteractionsposts_activecontributors_activesentimentsocial_dominancemarket_capmarket_dominancevolumetopic_ranktopicSummary snapshot of all social metrics and insights for any social topic, keyword, cryptocurrency, stock, or custom search/collection slug like lc1s5M27Jq
topicstringNormalized to lower case a-z, 0-9, #, $, _ and spaces are allowed. Examples: bitcoin, $btc, $nvda, trump, lebron james, gucci, lc1s5M27Jq
topic_postsTop social posts by interactions for a given time period. Identify the most influential narrative and the posts driving social metrics.
topicstringNormalized to lower case a-z, 0-9, #, $, _ and spaces are allowed. Examples: bitcoin, $btc, $nvda, trump, lebron james, gucci, lc1s5M27Jq
from_datestring/nullprovide a date range instead of interval with from_date and to_date to get posts for a specific day or range
intervalstring/nullDefault is most recent top posts or get the top x posts in the last 1d, 1w, 1m, 3m, 6m, 1y, all
1d1w1m3m6m1yalllimitnumber/null100networkstring/nullIf no network is specified default is to show all
allxtwittertiktokyoutuberedditinstagramnewsto_datestring/nulloptional to_date for date range, leave blank to get posts only from the from_date
topic_time_seriesHistorical time-series metrics for a social topic, keyword, cryptocurrency, or stock, or custom search/collection slug like lc1s5M27Jq
topicstringNormalized to lower case a-z, 0-9, #, $, _ and spaces are allowed. Examples: bitcoin, $btc, $nvda, trump, lebron james, gucci, lc1s5M27Jq
intervalstring/nullDefault is 1w hourly data. Use 1m or longer for daily data. One of: 1d, 1w, 1m, 3m, 6m, 1y, all
1d1w1m3m6m1yallmetricsarray/nullLeave blank to show all metrics or isolate to one or more of (key - display name): alt_rank - AltRank™, galaxy_score - Galaxy Score™, close - Price, interactions - Engagements, posts_active - Mentions, posts_created - Posts Created, contributors_active - Creators, contributors_created - Creators Posting, sentiment - Sentiment, social_dominance - Social Dominance, market_cap - Market Cap, market_dominance - Market Dominance, volume_24h - Trading Volume, circulating_supply - Circulating Supply