{"info":{"contact":{"email":"tmhsuct6yv4@uberip.com"},"description":"Public Telegram channel data for AI agents, x402 exact (USDC on Base)","title":"data-services-x402","version":"1.0","x-guidance":"Paid public-Telegram-channel data for AI agents (USDC on Base, x402 exact). GET /channel?handle=<name> = metrics for one channel (subscribers, avg/median views, ER%, posts/week, last post, language, ad-sales contact, top posts) from a fresh parse. GET /channels and /slice = filtered slices (JSON / CSV), GET /dataset = the whole base as CSV. Every paid path answers 402 with the x402 requirement in the PAYMENT-REQUIRED header and the same JSON in the body; pay it and retry the identical URL. Free: /health, /coverage, /sample.csv, /llms.txt, /agents.json, /.well-known/x402."},"openapi":"3.1.0","paths":{"/channel":{"get":{"operationId":"channel","parameters":[{"description":"Telegram channel @handle, e.g. blumcrypto","in":"query","name":"handle","required":false,"schema":{"type":"string"}},{"description":"t.me link (optional)","in":"query","name":"url","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"data"},"402":{"description":"payment required"}},"summary":"Metrics for one public Telegram channel: subscribers, avg/median views, ER%, posts per week, last post, language, ad-sales contact, top posts (live parse)","x-payment-info":{"price":{"amount":"0.010000","currency":"USD","mode":"fixed"},"protocols":[{"x402":{}}]}}},"/channels":{"get":{"operationId":"channels","parameters":[{"description":"crypto, finance or a word from the title","in":"query","name":"topic","required":false,"schema":{"type":"string"}},{"description":"ru or en","in":"query","name":"lang","required":false,"schema":{"type":"string"}},{"description":"minimum subscribers","in":"query","name":"min_subs","required":false,"schema":{"type":"string"}},{"description":"maximum subscribers","in":"query","name":"max_subs","required":false,"schema":{"type":"string"}},{"description":"minimum ER%, e.g. 20","in":"query","name":"min_er","required":false,"schema":{"type":"string"}},{"description":"minimum average views","in":"query","name":"min_views","required":false,"schema":{"type":"string"}},{"description":"only channels posted within N days","in":"query","name":"max_days","required":false,"schema":{"type":"string"}},{"description":"1 = only channels with an ad contact","in":"query","name":"ad_contact_only","required":false,"schema":{"type":"string"}},{"description":"1 = only channels live within 7 days","in":"query","name":"fresh","required":false,"schema":{"type":"string"}},{"description":"rows, max 500, default 200","in":"query","name":"limit","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"data"},"402":{"description":"payment required"}},"summary":"Filtered slice of the Telegram channel database: topic, subscribers, language, ER%, freshness, ad contact (JSON)","x-payment-info":{"price":{"amount":"0.050000","currency":"USD","mode":"fixed"},"protocols":[{"x402":{}}]}}},"/contacts":{"get":{"operationId":"contacts","parameters":[{"description":"crypto or finance","in":"query","name":"topic","required":false,"schema":{"type":"string"}},{"description":"minimum subscribers","in":"query","name":"min_subs","required":false,"schema":{"type":"string"}},{"description":"ru or en","in":"query","name":"lang","required":false,"schema":{"type":"string"}},{"description":"rows, max 500","in":"query","name":"limit","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"data"},"402":{"description":"payment required"}},"summary":"Ad-sales contacts (@admin) of public Telegram channels in a niche, with subscribers, views and ER%: buy-side list for ad placements","x-payment-info":{"price":{"amount":"0.010000","currency":"USD","mode":"fixed"},"protocols":[{"x402":{}}]}}},"/dataset":{"get":{"operationId":"dataset","responses":{"200":{"description":"data"},"402":{"description":"payment required"}},"summary":"Full crypto/finance Telegram channel dataset as CSV: 18 fields per channel","x-payment-info":{"price":{"amount":"2.000000","currency":"USD","mode":"fixed"},"protocols":[{"x402":{}}]}}},"/health":{"get":{"operationId":"health","responses":{"200":{"description":"ok"}},"security":[],"summary":"Liveness of the data service"}},"/live":{"get":{"operationId":"live","parameters":[{"description":"lookback window, default 7","in":"query","name":"days","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"data"},"402":{"description":"payment required"}},"summary":"List of crypto/finance Telegram channels that posted within the last N days (JSON)","x-payment-info":{"price":{"amount":"0.010000","currency":"USD","mode":"fixed"},"protocols":[{"x402":{}}]}}},"/scrape":{"get":{"operationId":"scrape","parameters":[{"description":"t.me link (optional)","in":"query","name":"url","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"data"},"402":{"description":"payment required"}},"summary":"Parse any public Telegram channel right now by t.me URL or @handle: views, ER, posting frequency, ad contact, top posts","x-payment-info":{"price":{"amount":"0.020000","currency":"USD","mode":"fixed"},"protocols":[{"x402":{}}]}}},"/search":{"get":{"operationId":"search","parameters":[{"description":"keyword: handle, title or ad contact","in":"query","name":"q","required":false,"schema":{"type":"string"}},{"description":"rows, max 200","in":"query","name":"limit","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"data"},"402":{"description":"payment required"}},"summary":"Search public crypto/finance Telegram channels by keyword: returns handle, title, subscribers, average views, ER%, posts per week, language, ad-sales contact","x-payment-info":{"price":{"amount":"0.010000","currency":"USD","mode":"fixed"},"protocols":[{"x402":{}}]}}},"/slice":{"get":{"operationId":"slice","parameters":[{"description":"crypto, finance or a word from the title","in":"query","name":"topic","required":false,"schema":{"type":"string"}},{"description":"ru or en","in":"query","name":"lang","required":false,"schema":{"type":"string"}},{"description":"minimum subscribers","in":"query","name":"min_subs","required":false,"schema":{"type":"string"}},{"description":"maximum subscribers","in":"query","name":"max_subs","required":false,"schema":{"type":"string"}},{"description":"minimum ER%, e.g. 20","in":"query","name":"min_er","required":false,"schema":{"type":"string"}},{"description":"minimum average views","in":"query","name":"min_views","required":false,"schema":{"type":"string"}},{"description":"only channels posted within N days","in":"query","name":"max_days","required":false,"schema":{"type":"string"}},{"description":"1 = only channels with an ad contact","in":"query","name":"ad_contact_only","required":false,"schema":{"type":"string"}},{"description":"1 = only channels live within 7 days","in":"query","name":"fresh","required":false,"schema":{"type":"string"}},{"description":"rows, max 500, default 200","in":"query","name":"limit","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"data"},"402":{"description":"payment required"}},"summary":"Filtered slice of the Telegram channel database as CSV (same filters as /channels)","x-payment-info":{"price":{"amount":"0.200000","currency":"USD","mode":"fixed"},"protocols":[{"x402":{}}]}}}},"servers":[{"url":"https://temka-data.loca.lt"}]}