AI Mode

{
  "query": "What is machine learning?",
  "countryCode": "at",
  "languageCode": "de",
  "screenshots": true,
  "fields": {
    "citations": ["url", "text", "favicon"],
    "relatedLinks": ["url", "title", "description", "source", "icon"],
    "paragraphs": {
      "text": true,
      "citations": ["url", "text"]
    }
  },
  "cache": {
    "enabled": true,
    "ttl": 7200
  }
}

{
  "status": true,
  "data": {
    "isCached": false,
    "cacheExpiresIn": null,
    "results": {
      "text": "Die Evergreen Media AR GmbH ist [...rest]",
      "citations": [
        {
          "url": "https://www.evergreen.media/impressum/",
          "text": "Innsbruck"
        }
        // ... rest
      ],
      "relatedLinks": [
        {
          "url": "https://firmen.wko.at/evergreen-media-ar-gmbh-evergreen-media-ar-gmbh/tirol/",
          "title": "Evergreen Media AR GmbH - WKO Firmen A-Z",
          "description": "Evergreen Media ist ein internationales Beratungsunternehmen für digitales Wachstum. Wir arbeiten mit mittelständischen Unternehme...",
          "source": "wko.at",
          "icon": "data:image/png;base64,iVBOR [...rest]"
        }
        // ... rest
      ],
      "paragraphs": [
        {
          "text": "Die Evergreen Media AR GmbH ist ein internationales Beratungsunternehmen...",
          "citations": [
            {
              "url": "https://www.evergreen.media/impressum/",
              "text": "Innsbruck"
            }
          ]
        }
        // ... rest
      ],
      "screenshots": {
        "initial": "https://tedi-cdn.evergreens.ai/jobs/debug-ai-mode/WfRoNg-2XM/screenshot-initial.png",
        "beforeSubmit": "https://tedi-cdn.evergreens.ai/jobs/debug-ai-mode/WfRoNg-2XM/screenshot-before-submit.png",
        "response": "https://tedi-cdn.evergreens.ai/jobs/debug-ai-mode/WfRoNg-2XM/screenshot-response.png"
      }
    }
  }
}

POST

https://api.evergreens.ai

networks

browser

ai-mode

{
  "query": "What is machine learning?",
  "countryCode": "at",
  "languageCode": "de",
  "screenshots": true,
  "fields": {
    "citations": ["url", "text", "favicon"],
    "relatedLinks": ["url", "title", "description", "source", "icon"],
    "paragraphs": {
      "text": true,
      "citations": ["url", "text"]
    }
  },
  "cache": {
    "enabled": true,
    "ttl": 7200
  }
}

{
  "status": true,
  "data": {
    "isCached": false,
    "cacheExpiresIn": null,
    "results": {
      "text": "Die Evergreen Media AR GmbH ist [...rest]",
      "citations": [
        {
          "url": "https://www.evergreen.media/impressum/",
          "text": "Innsbruck"
        }
        // ... rest
      ],
      "relatedLinks": [
        {
          "url": "https://firmen.wko.at/evergreen-media-ar-gmbh-evergreen-media-ar-gmbh/tirol/",
          "title": "Evergreen Media AR GmbH - WKO Firmen A-Z",
          "description": "Evergreen Media ist ein internationales Beratungsunternehmen für digitales Wachstum. Wir arbeiten mit mittelständischen Unternehme...",
          "source": "wko.at",
          "icon": "data:image/png;base64,iVBOR [...rest]"
        }
        // ... rest
      ],
      "paragraphs": [
        {
          "text": "Die Evergreen Media AR GmbH ist ein internationales Beratungsunternehmen...",
          "citations": [
            {
              "url": "https://www.evergreen.media/impressum/",
              "text": "Innsbruck"
            }
          ]
        }
        // ... rest
      ],
      "screenshots": {
        "initial": "https://tedi-cdn.evergreens.ai/jobs/debug-ai-mode/WfRoNg-2XM/screenshot-initial.png",
        "beforeSubmit": "https://tedi-cdn.evergreens.ai/jobs/debug-ai-mode/WfRoNg-2XM/screenshot-before-submit.png",
        "response": "https://tedi-cdn.evergreens.ai/jobs/debug-ai-mode/WfRoNg-2XM/screenshot-response.png"
      }
    }
  }
}

Entity Reference:

AiModeEntity — extends SearchEntity

Example

The image below illustrates how the AI Mode response maps to the Google AI Mode interface:

The yellow highlighted boxes in the image indicate the different response components returned by the API.

UI Element	API Field	Description
🔴 Main AI Response (red bordered area)	`text`	The AI-generated answer text displayed in the main content area, synthesized from multiple sources.
🟡 Inline Citations (yellow boxes within text)	`citations`	References embedded within the AI response (e.g., “Evergreen Media +4”, “wko.at +6”). Each citation links to a source URL with the specific referenced text.
🔵 Source Panel (right sidebar)	`relatedLinks`	The list of source websites displayed on the right side, including title, description, source domain, and favicon.

The citations array provides granular source attribution for specific claims within the AI response, while relatedLinks offers a broader overview of all referenced websites with their metadata.

Request

query

string

required

The search query string used to generate an AI-based answer.

Minimum length: 1 character
Maximum length: 500 characters

countryCode

string

default:"at"

The ISO 3166-1 alpha-2 country code to tailor the AI Mode results for a specific region.

languageCode

string

default:"de"

The ISO 639-1 language code to tailor the AI Mode results for a specific language.

screenshots

boolean

default:"true"

Whether to include screenshots from Tedi Browser in the search results.

AI Mode Tedi Browser Screenshots examples

Screenshot URLs are only available for 24 hours after generation. Make sure to download or cache them if you need to retain them longer.

fields

object

Specify which response fields to include. This allows you to optimize the response size by requesting only the data you need.

Show child attributes

fields.citations

array

Array of citation fields to include (e.g., ["url", "text", "favicon"]).

Array of related link fields to include (e.g., ["url", "title", "description", "source", "icon"]).

fields.paragraphs

object

Object specifying paragraph fields to include.

Show child attributes

fields.paragraphs.text

boolean

Whether to include paragraph text.

fields.paragraphs.citations

array

Array of citation fields to include within paragraphs (e.g., ["url", "text"]).

cache

object

An optional object to configure caching behavior for the request. By default, caching is enabled with a TTL of 120 seconds. You can customize these settings by providing the cache object.

Show child attributes

enabled

boolean

default:true

A boolean indicating whether caching is enabled for this request. Default is true.

ttl

number

Time-to-live (TTL) for the cache entry in seconds. Default is 120 seconds. Setting a longer TTL can improve performance for repeated requests with the same input, but may result in slightly outdated responses if the underlying data changes frequently.

Minimum TTL	Maximum TTL	Default TTL
120 seconds	86400 seconds	7200 seconds

Response

isCached

boolean

default:true

Indicates whether the response was served from cache.

cacheExpiresIn

number

default:7200

The time in seconds until the cached response expires. Default is 7200 seconds (2 hours).

results

AiModeEntity

required

Hide child attributes

text

string

required

The AI-generated summary or answer based on the search query.

citations

array

An array of web search result entities that were used as citations for the AI-generated answer.

Hide child attributes

url

string

The URL of the web page.

text

string

A brief text of the web page.

paragraphs

array

An array of paragraphs that compose the AI response, each containing its own text and associated citations.

Hide child attributes

text

string

The paragraph text content.

citations

array

An array of citations associated with this paragraph.

An array of related links relevant to the search query.

Hide child attributes

url

string

The URL of the related link.

title

string

The title of the related link.

description

string

A brief description of the related link.

source

string

The source of the related link (either the source name or the domain URL).

icon

string

The favicon URL of the related link (either a URL or a base64-encoded image).

screenshots

object

URLs to debugging screenshots captured during the AI Mode process by Tedi Browser.

Hide child attributes

initial

string

Screenshot of the initial state before the query is entered.

beforeSubmit

string

Screenshot of the state just before submitting the query.

response

string

Screenshot of the final rendered response.

{
  "query": "What is machine learning?",
  "countryCode": "at",
  "languageCode": "de",
  "screenshots": true,
  "fields": {
    "citations": ["url", "text", "favicon"],
    "relatedLinks": ["url", "title", "description", "source", "icon"],
    "paragraphs": {
      "text": true,
      "citations": ["url", "text"]
    }
  },
  "cache": {
    "enabled": true,
    "ttl": 7200
  }
}

{
  "status": true,
  "data": {
    "isCached": false,
    "cacheExpiresIn": null,
    "results": {
      "text": "Die Evergreen Media AR GmbH ist [...rest]",
      "citations": [
        {
          "url": "https://www.evergreen.media/impressum/",
          "text": "Innsbruck"
        }
        // ... rest
      ],
      "relatedLinks": [
        {
          "url": "https://firmen.wko.at/evergreen-media-ar-gmbh-evergreen-media-ar-gmbh/tirol/",
          "title": "Evergreen Media AR GmbH - WKO Firmen A-Z",
          "description": "Evergreen Media ist ein internationales Beratungsunternehmen für digitales Wachstum. Wir arbeiten mit mittelständischen Unternehme...",
          "source": "wko.at",
          "icon": "data:image/png;base64,iVBOR [...rest]"
        }
        // ... rest
      ],
      "paragraphs": [
        {
          "text": "Die Evergreen Media AR GmbH ist ein internationales Beratungsunternehmen...",
          "citations": [
            {
              "url": "https://www.evergreen.media/impressum/",
              "text": "Innsbruck"
            }
          ]
        }
        // ... rest
      ],
      "screenshots": {
        "initial": "https://tedi-cdn.evergreens.ai/jobs/debug-ai-mode/WfRoNg-2XM/screenshot-initial.png",
        "beforeSubmit": "https://tedi-cdn.evergreens.ai/jobs/debug-ai-mode/WfRoNg-2XM/screenshot-before-submit.png",
        "response": "https://tedi-cdn.evergreens.ai/jobs/debug-ai-mode/WfRoNg-2XM/screenshot-response.png"
      }
    }
  }
}

AI Overview ChatGPT

⌘I

Introduction

Account

Chat completions & observations

Tedi Network

Request

Response

Introduction

Account

Chat completions & observations

Tedi Network

​Request

​Response

Request

Response