# AI Answers API

> Complete reference documentation for the OpenWeb Ninja AI Answers API. Includes code examples, data samples, and usage guides for querying OpenAI ChatGPT, Gemini, Copilot, Google AI Mode, and AI Overviews through one API with live web access, continuous conversations, and structured output.

## Overview

Complete reference documentation for the OpenWeb Ninja AI Answers API. Includes code examples, data samples, and usage guides for querying OpenAI ChatGPT, Gemini, Copilot, Google AI Mode, and AI Overviews through one API with live web access, continuous conversations, and structured output.

This API exposes 5 REST endpoints (Chat, Chat, Copilot, AI Mode, AI Overviews), returning structured JSON. See the endpoints below for parameters and full URLs.

Need help integrating? Contact support@openwebninja.com.
For high volume / large scale plans, please contact support@openwebninja.com.

## Endpoints

### POST /chatgpt/chat - Chat
Chat with OpenAI ChatGPT with live web access and structured output, with support for markdown/plain-text.
Parameters:
- **message** (string, required, e.g. `Hello`): Message to send to ChatGPT.
- markdown (boolean, default: `true`): Whether to return the ChatGPT response message in markdown format. By default, the bot reply is in markdown format.
- conversation_hint (string, default: ``, allowed:  | SEARCH | STUDY): Optional hint to steer the conversation. Use SEARCH to bias ChatGPT toward web search, STUDY for study/learning mode, or leave empty for default behavior.
- debug (boolean, default: `false`): Whether to include the raw upstream response in the output for debugging purposes.
Full URL: `https://api.openwebninja.com/ai-answers/chatgpt/chat`

### POST /gemini/chat - Chat
Chat with Google Gemini with web access and continuous conversation support.
Parameters:
- **message** (string, required, e.g. `Hello`): Message to send to Google Gemini.
- conversation_id (string, e.g. `null`): Conversation Id. In case not supplied, a new conversation will be created and conversation_id will be returned by the endpoint.
- markdown (boolean, default: `true`): Whether to return the Google Gemini response message in markdown format. By default, the bot reply is in plain text.
Full URL: `https://api.openwebninja.com/ai-answers/gemini/chat`

### POST /copilot/copilot - Copilot
Chat with Copilot with web access and continuous conversation support.
Parameters:
- message (array of string, e.g. `Hello`): Message to send to Copilot.
- conversation_id (array of string, e.g. `BEo5jhxYmas6nphKeTbyL`): Conversation id. In case not supplied, a new conversation will be created and conversation_id will be returned by the endpoint.
- mode (array of string, e.g. `CHAT`): Use normal chat mode (i.e. CHAT), reasoning mode (i.e. REASONING), or GPT-5 (SMART).
- markdown (array of boolean, e.g. `true`): Whether to return the Copilot response message in markdown format. By default, the bot reply is in plain text.
Full URL: `https://api.openwebninja.com/ai-answers/copilot/copilot`

### GET /google-ai-mode/ai-mode - AI Mode
Send a prompt/query and get structured results and reference links from Google AI Mode.
Parameters:
- **prompt** (string, required): AI Mode prompt.
- session_token (string): Specify a session token from previous AI Mode response to continue the chat from the same point (preserving history in context for continuous conversation).
- tbs (string): Advanced search parameters that are not possible in the regular query field (e.g. specifying date ranges).
- gl (string, default: `us`): The country / region for which to make the query. 2-letter country code, see ISO 3166-1 alpha-2.
- hl (string, default: `en`): The language to use for the search (Google's hl parameter). 2-letter country code, see ISO 639-1 alpha-2.
Full URL: `https://api.openwebninja.com/ai-answers/google-ai-mode/ai-mode`

### POST /google-ai-mode/ai-mode - AI Mode (POST)
Send a prompt/query via a JSON request body (useful for long prompts) and get structured results and reference links from Google AI Mode.
Parameters:
- **prompt** (string, required, e.g. `How to make a pizza step by step?`): AI Mode prompt.
- session_token (string): Specify a session token from previous AI Mode response to continue the chat from the same point (preserving history in context for continuous conversation).
- tbs (string): Advanced search parameters that are not possible in the regular query field (e.g. specifying date ranges).
- gl (string, default: `us`): The country / region for which to make the query. 2-letter country code, see ISO 3166-1 alpha-2.
- hl (string, default: `en`): The language to use for the search (Google's hl parameter). 2-letter country code, see ISO 639-1 alpha-2.
Full URL: `https://api.openwebninja.com/ai-answers/google-ai-mode/ai-mode`

### GET /ai-overviews/ai-overviews - AI Overviews
Get Google Search AI Overviews, including text parts (paragraphs and lists) and reference links.
Parameters:
- **q** (string, required): Search query.
- location (string): Where you want the search to originate from. It is recommended to specify location at the city level in order to simulate a real user’s search (e.g. London, England, United Kingdom).
- gl (string, default: `us`): The country / region for which to make the query. 2-letter country code, see ISO 3166-1 alpha-2.
- hl (string, default: `en`): The language to use for the search (Google's hl parameter). 2-letter country code, see ISO 639-1 alpha-2.
Full URL: `https://api.openwebninja.com/ai-answers/ai-overviews/ai-overviews`

## Base URL and Authentication

- Base URL: `https://api.openwebninja.com/ai-answers`
- Auth: API key in the `x-api-key` header. Get a key by subscribing (free tier available) at https://app.openwebninja.com/api/ai-answers

## Links

- API page: https://www.openwebninja.com/api/ai-answers
- Get an API key / subscribe: https://app.openwebninja.com/api/ai-answers
- Pricing & plans: https://app.openwebninja.com/api/ai-answers/pricing
- Website: https://www.openwebninja.com
- OpenAPI spec: https://openwebninja.s3.us-east-1.amazonaws.com/portal/openapi/ai_answers.yaml
- Support: support@openwebninja.com

_Last updated: 2026-05-27_