Gemini

Gemini (gemini) is part of the surface enum, but it has no live capture path in v1. It returns a 422 rather than a stand-in that isn’t the real Gemini experience.

Submitting surfaces: ["gemini"] today returns 422 UNSUPPORTED_METHOD_FOR_SURFACE. This is deliberate: nothing we currently offer clears the bar for a trustworthy Gemini capture (see below).

Property	Value
`surfaces` value	`gemini`
Provider	Google
Status	Not yet requestable
Listed credit price	4 per capture (applies once live)

Why there’s no v1 path

Every capture we serve must faithfully represent either the vendor’s official API or the real consumer experience — never a sanitized stand-in. Gemini doesn’t clear that bar yet:

Google’s Gemini API terms bar resale of its output, so serving it through Google’s own API isn’t on the table.
The Gemini web app is login-walled: every guest capture hits a login stop. Serving it faithfully needs an authenticated account pool, which isn’t provisioned yet.

You can confirm this at any time from the live capability matrix:

curl https://api.aisearchapi.dev/v1/surfaces

Excerpt

{
  "id": "gemini",
  "live": false
}

What a request returns today

curl -X POST https://api.aisearchapi.dev/v1/search \
  -H "Authorization: Bearer $AISEARCH_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "query": "best crm for startups", "surfaces": ["gemini"] }'

422 Unprocessable Entity

{
  "code": "UNSUPPORTED_METHOD_FOR_SURFACE",
  "error": "auto routing has no supported v1 method for surface 'gemini'; surface 'gemini' has no supported v1 method",
  "request_id": "req_9f2c1a7e4b5d48f1a3c6e8d0b2a4f6c8",
  "docs_url": "https://docs.aisearchapi.dev/guides/errors#unsupported_method_for_surface"
}

The rejection happens at admission — nothing is spawned and nothing is billed. On a batch, only the Gemini item is rejected; other items proceed.

Cover Google’s AI answers today

While Gemini is pending, Google’s AI-generated answers are live through two other surfaces:

Google AI Overview

The AI summary at the top of Google Search — live via real browser (google_ai_overview).

Google AI Mode

Google’s conversational AI search experience — live via real browser (google_ai_mode).

When it goes live

Gemini support lands once an authenticated account pool is provisioned. When it does, you’ll request it like any other surface — surfaces: ["gemini"], same request body, same canonical Envelope — with no integration changes. Watch the changelog or poll GET /v1/surfaces for the flip.

All surfaces

What’s live today and what’s coming next.

Errors

The 422 you’ll see if you request Gemini early.

Endpoints

Account & discovery

Watches

By surface

Why there’s no v1 path

What a request returns today

Cover Google’s AI answers today

Google AI Overview

Google AI Mode

When it goes live

All surfaces

Errors

​Why there’s no v1 path

​What a request returns today

​Cover Google’s AI answers today

Google AI Overview

Google AI Mode

​When it goes live

All surfaces

Errors

Why there’s no v1 path

What a request returns today

Cover Google’s AI answers today

When it goes live