Skip to main content

Getting Started with Teads LLM Integration

Welcome to the Teads LLM/Chatbot Integration portal. This API allows Chatbot and LLM publishers to programmatically retrieve and inject contextually relevant ad recommendations into conversational interfaces.

Overview​

The Teads In-Chat API leverages real-time contextual signals from your chatbot conversations (such as user intent, keywords, and topics) to serve high-quality sponsored content.

Prerequisites​

Before you begin, ensure you have obtained the following from your Teads account representative:

  • API Key: Your unique authentication token (key).
  • Widget ID: Your specific placement ID (e.g., APP_12).
  • Content URL: The domain where your chatbot is hosted.

Basic Workflow​

  1. Fetch: Your application sends a POST request to Teads with the current chat context.
  2. Render: You display the ad "documents" (headline, image, and brand) to the user.
  3. Report: You fire the impression pixel (reportServed) to ensure the ad is tracked and monetized.