# Telemost x402 API > Pay-per-call Telegram analytics and social media data for AI agents: channel analytics, statistics and audience metrics, subscriber growth, reach and engagement (ER/ERR), full-text post search, brand monitoring and mention tracking, social listening, sentiment analysis, competitor discovery and ad intelligence. Paid in USDC via the x402 protocol on Base and Solana, with no accounts or API keys. Start free: GET /v1/catalog returns every endpoint with prices, input/output schemas and examples at zero cost. Also available as an MCP server (Streamable HTTP) at POST /mcp, where every endpoint is an MCP tool. ## Discovery - [Catalog](https://api.telemost.io/v1/catalog): machine-readable list of all paid endpoints (prices, schemas, examples) - [OpenAPI](https://api.telemost.io/openapi.json): OpenAPI 3.1 specification - [MCP endpoint](https://api.telemost.io/mcp): MCP server (Streamable HTTP); every endpoint available as an MCP tool - [Status](https://api.telemost.io/status): live status and uptime ## Endpoints - [GET /v1/data/messages](https://api.telemost.io/v1/data/messages) ($0.0165): Telegram channel data and monitoring: fetch recent messages and posts from any public Telegram channel or group. Monitor news sources, track updates, or feed content into downstream analysis. Optional `since` filters by date. - [GET /v1/data/search](https://api.telemost.io/v1/data/search) ($0.075): Telegram search and discovery: find public Telegram channels, groups and posts by keyword. Discover sources, communities, competitors or content on any topic. - [GET /v1/data/entities](https://api.telemost.io/v1/data/entities) ($0.0165): Telegram content analytics and data extraction: pull structured entities from a channel's recent posts, links, @mentions, #hashtags, $cashtags, emails, phone numbers and bot commands. Contacts, tickers or outbound links at scale. Formatting-level entities, not semantic NER. - [GET /v1/data/sentiment](https://api.telemost.io/v1/data/sentiment) ($0.0165): Telegram sentiment analysis, raw inputs: recent posts and reactions for a channel, group or topic to run your own mood or opinion analysis. For a ready LLM verdict use /v1/data/sentiment/llm. - [GET /v1/data/sentiment/llm](https://api.telemost.io/v1/data/sentiment/llm) ($0.1865): Telegram sentiment analysis, LLM verdict: sentiment label, score, trend and a short summary for a channel, group or topic. Gauge audience mood or brand perception before acting. - [GET /v1/data/channel](https://api.telemost.io/v1/data/channel) ($0.0165): Telegram channel analytics and profile data: title, description, subscribers, category, country, language, links and verified flag. Vet a channel, enrich a dataset, or look up channel data in one call. - [GET /v1/data/post](https://api.telemost.io/v1/data/post) ($0.0165): Telegram post analytics: a single post with its statistics over time, views, forwards and reactions. Measure how a specific post performed. - [GET /v1/data/posts/search](https://api.telemost.io/v1/data/posts/search) ($2.10): Telegram post search and social listening: full-text search over posts across public channels to find who is talking about a keyword, brand or topic, with extended query syntax. Brand monitoring and market research; searches posts from the last 14 days. - [GET /v1/ads/networks](https://api.telemost.io/v1/ads/networks) ($0.0165): Telegram advertising data: available ad networks and their minimum deposits, compare where to run campaigns. - [GET /v1/ads/posts/search](https://api.telemost.io/v1/ads/posts/search) ($2.10): Telegram ad intelligence and competitor analysis: discover ad posts running on channels, what and where competitors advertised, with creatives. Searches posts from the last 14 days. - [GET /v1/stats/channel](https://api.telemost.io/v1/stats/channel) ($0.0165): Telegram channel analytics and statistics: subscribers and growth, average post views, reach, engagement and engagement rate (ERR/ERR24), plus mentions and forwards. A quick stats and health check of any public channel; individual metrics are populated where the channel exposes them. - [GET /v1/stats/subscribers](https://api.telemost.io/v1/stats/subscribers) ($0.0165): Telegram audience analytics: subscriber growth chart for a channel, track audience growth or decline over time (day/week/month/year). - [GET /v1/stats/mentions](https://api.telemost.io/v1/stats/mentions) ($0.075): Telegram mention tracking and brand monitoring: mentions and citations of a given channel across other channels, who is referencing @channel, and its share of voice. Up to a full year of history. For keyword or brand tracking across posts, use the word tracker or post search. - [GET /v1/stats/words](https://api.telemost.io/v1/stats/words) ($2.10): Telegram keyword and brand tracking: follow keyword or brand volume across public channels over time (by-period) or by channel (by-channels). Social listening and market research; searches posts from the last 14 days. - [GET /v1/stats/reach](https://api.telemost.io/v1/stats/reach) ($0.0165): Telegram reach analytics: average post reach chart for a channel, how many people typical posts reach over time. - [GET /v1/meta/dictionaries](https://api.telemost.io/v1/meta/dictionaries) ($0.0165): Reference data for the Telegram analytics API: countries, categories and languages used for filters and targeting. - [GET /v1/data/similar](https://api.telemost.io/v1/data/similar) ($0.0165): Telegram competitor analysis and channel discovery: find channels similar to a given one by topic and audience, discover competitors, alternatives or expansion targets. - [GET /v1/data/compilations](https://api.telemost.io/v1/data/compilations) ($0.0165): Telegram channel discovery and research: curated compilations of channels, ready-made lists by theme for market mapping and research. - [GET /v1/stats/engagement](https://api.telemost.io/v1/stats/engagement) ($0.0165): Telegram engagement analytics: engagement rate (ER), engagement rate by reach (ERR) and 24-hour reach engagement (ERR24) over time. Benchmark audience activity and channel performance. ## MCP clients - Remote (no local wallet): connect an MCP client to https://api.telemost.io/mcp - Local stdio bridge (pays from the agent wallet): npm package telemost-mcp-server (https://www.npmjs.com/package/telemost-mcp-server)