DEVELOPER PREVIEW
Your Telegram Ads data.
One connection.
Bring accounts, ads and performance into your own tools. Connect your session once, then use the API or your MCP client.
Typed responses · Personal access · 14 read-only MCP tools
YOUR FIRST REQUESTGET
- curl
- TypeScript
curl https://tgads.tlmtr.dev/v1/connections \
-H "Authorization: Bearer $TGADS_TOKEN"
const response = await fetch(
'https://tgads.tlmtr.dev/v1/connections',
{ headers: {
Authorization: `Bearer ${process.env.TGADS_TOKEN}`
} }
);
if (!response.ok) throw new Error('Request failed');
const { connections } = await response.json();
START HERE
From browser to your first request
A short setup guide, with screenshots at every key step.
BUILT FOR YOUR WORKFLOW
API for your product.
MCP for your assistant.
Use the same owned connection for both. Explore response schemas, copy request examples, or discover the read tools in your MCP client.
Accounts & creativesList ads, inspect copy and targeting.
Performance & reportsRead daily statistics and monthly JSON/CSV reports.
Discovery & previewFind targets and location candidates; validate a preview.
This integration uses the Telegram Ads web interface. Coverage is verified per operation.
See supported operations and known limits →