In-message ads

Send your LLM response text. Sidekick selects a relevant ad, appends it to the message, and returns everything in a single response. If no ad is available, the message comes back unchanged.

Authentication

Authorization: Bearer sk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Generate keys in your publisher settings.

Request body

* Required fields.

Response — ad served

{
  "message": "Python — это высокоуровневый язык программирования...\n\n<a href=\"https://t.me/heysidekick\">Реклама от Sidekick 👇</a>\n\n<a href=\"https://sidekick-ads.com/api/v1/click/imp_a8f3d2c1e9b7\">💡 Попробуй Cursor — AI-редактор для разработчиков</a>",
  "has_ad": true,
  "impression_id": "imp_a8f3d2c1e9b7",
  "ad": {
    "text": "💡 Попробуй Cursor — AI-редактор для разработчиков",
    "formatted_text": "💡 Попробуй <b>Cursor</b> — <a href=\"https://sidekick-ads.com/api/v1/click/imp_a8f3d2c1e9b7\">AI-редактор</a>",
    "button_text": "Попробовать Cursor →",
    "button_url": "https://sidekick-ads.com/api/v1/click/imp_a8f3d2c1e9b7"
  }
}

ad.formatted_text is the rich version of ad.text, already rendered into the parse_mode you sent — it can carry links and emphasis inside the copy. Use it when you render the ad yourself instead of sending our message. It is deliberately not wrapped in the click-tracking link (nested links are invalid in Telegram), so clicks on the text aren't counted — the button still is. When a campaign has no rich copy authored, this field equals ad.text.

The message field contains your original text with the ad appended. The ad object carries the button label and a click-tracking URL — use it to render an inline button in Telegram.

Response — no ad available

{
  "message": "Python — это высокоуровневый язык программирования...",
  "has_ad": false,
  "impression_id": null,
  "ad": null
}

When no campaign matches, the message is returned unchanged. Just use the message field regardless.

Error responses