Skip to content

API: Introduction

Capabilities

Once your extension is connected, you gain access to a powerful HTTP API that bridges your code to Google AI Mode.

Features:

  • Simple HTTP Interface: Standard POST requests.
  • Structured Output: Receive Markdown, source links, and follow-up questions as JSON.
  • Zero Auth Config: Authentication is handled by your browser's existing Google session.
  • Universal Access: call it from Python, Node.js, cURL, or any other tool.

Architecture Flow

It's important to understand that your browser is the worker. The API server is just a relay.

sequenceDiagram
    participant App as Your App/Code
    participant Server as Our Relay Server
    participant Ext as Your Extension
    participant Google as Google AI Mode

    App->>Server: POST /api/{id} (JSON)
    Server->>Ext: WebSocket Message
    Ext->>Google: Perform Search Query
    Google-->>Ext: Return HTML Content
    Ext->>Ext: Extract & Format Data
    Ext-->>Server: Return Structured JSON
    Server-->>App: HTTP 200 OK (JSON)

Key concept: The speed of the API depends on the speed of your internet and Google AI Mode's response time in your browser.

Documentation Sections