Claude

Capture what Claude (Anthropic) answers for a prompt and receive it as the canonical Envelope. Claude typically returns a prose answer with provenance on how it was captured.

How Claude is captured today: unlike our browser-first surfaces, the claude.ai consumer app is login-walled, so auto routes Claude through the official Anthropic model lane for now. How a capture was acquired is an internal detail — the Envelope’s provenance is lane-free and does not expose a capture method. Live browser capture of the Claude UI is on the roadmap. See GET /v1/surfaces for the capability matrix.

Property	Value
`surfaces` value	`claude`
Provider	Anthropic
Capture lane	Official Anthropic model (internal — not exposed in the Envelope; browser capture on the roadmap)
Credits per capture	3
Commonly returns	`answer`, `provenance`

Request

Add "claude" to surfaces on POST /v1/search. A single-surface request with no webhook runs synchronously by default (a 200 with the Envelope inline). Add ?mode=async for the durable path — 202 with a parent job and one child per surface × region, read via GET /v1/jobs/:id or a webhook.

curl -X POST "https://api.aisearchapi.dev/v1/search?mode=async" \
  -H "Authorization: Bearer $AISEARCH_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "what is retrieval augmented generation",
    "surfaces": ["claude"],
    "regions": [{ "country": "US" }]
  }'

const res = await fetch('https://api.aisearchapi.dev/v1/search?mode=async', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.AISEARCH_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    query: 'what is retrieval augmented generation',
    surfaces: ['claude'],
    regions: [{ country: 'US' }],
  }),
});

const job = await res.json();
console.log(res.status, job); // 202

import os
import requests

res = requests.post(
    "https://api.aisearchapi.dev/v1/search",
    params={"mode": "async"},
    headers={
        "Authorization": f"Bearer {os.environ['AISEARCH_API_KEY']}",
        "Content-Type": "application/json",
    },
    json={
        "query": "what is retrieval augmented generation",
        "surfaces": ["claude"],
        "regions": [{"country": "US"}],
    },
)

print(res.status_code, res.json())  # 202

Response `202 Accepted`

{
  "jobId": "job_8t2q",
  "status": "processing",
  "children": ["job_8t2q.claude.us"]
}

Read the dotted child id with GET /v1/jobs/job_8t2q.claude.us to fetch its Envelope.

Per-surface alias

POST /v1/search/claude targets Claude only — sync by default like any single-surface call. It accepts two convenience fields: prompt (alias of query) and country (flat sugar for regions: [{ "country": "..." }]). It returns 200 with the result inline.

curl -X POST https://api.aisearchapi.dev/v1/search/claude \
  -H "Authorization: Bearer $AISEARCH_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "what is retrieval augmented generation",
    "country": "US"
  }'

const res = await fetch('https://api.aisearchapi.dev/v1/search/claude', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.AISEARCH_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    prompt: 'what is retrieval augmented generation',
    country: 'US',
  }),
});

const result = await res.json();
console.log(res.status, result.children[0].answer.markdown); // 200

import os
import requests

res = requests.post(
    "https://api.aisearchapi.dev/v1/search/claude",
    headers={
        "Authorization": f"Bearer {os.environ['AISEARCH_API_KEY']}",
        "Content-Type": "application/json",
    },
    json={"prompt": "what is retrieval augmented generation", "country": "US"},
)

print(res.status_code, res.json()["children"][0]["answer"]["markdown"])  # 200

Envelope

A completed Claude child returns the canonical four-section Envelope. Below is a trimmed example. answer.markdown is always populated, and answer.blocks[] carry the answer as typed blocks.

{
  "job": {
    "id": "job_8t2q.claude.us",
    "query": "what is retrieval augmented generation",
    "surface": "claude",
    "region": "us",
    "status": "completed",
    "warnings": [],
    "requestedAt": "2026-06-30T17:02:11.000Z",
    "completedAt": "2026-06-30T17:02:26.000Z"
  },
  "provenance": {
    "model": {
      "providerId": "claude-sonnet-4-5",
      "observedLabel": "Claude",
      "inferred": false,
      "confidence": 0.97
    },
    "webSearch": { "enabled": false, "known": true },
    "triggerState": "parametric",
    "persona": "anonymous_default_model",
    "loginState": "unknown",
    "surfacePresent": true,
    "region": { "requested": "US", "effective": "US" },
    "capturedAt": "2026-06-30T17:02:26.000Z",
    "callUuid": "call_5c0b0d3f9a7e4b1c8d2e6f4a1b3c5d7e",
    "schemaVersion": "2026-06-27"
  },
  "answer": {
    "text": "Retrieval augmented generation (RAG) combines a language model with a retrieval step...",
    "markdown": "**Retrieval augmented generation (RAG)** combines a language model with a retrieval step...",
    "blocks": [
      {
        "type": "paragraph",
        "text": "Retrieval augmented generation (RAG)...",
        "referenceIds": []
      }
    ]
  },
  "evidence": {
    "sources": [],
    "fanOut": { "provenance": "none", "queries": [] },
    "mentions": null,
    "shopping": null,
    "ads": null
  }
}

See The Envelope for every field, and how text, markdown, and blocks relate.

If Claude returns nothing for a prompt, the job still completes: provenance.surfacePresent is false, job.warnings carries a surface_absent warning, and answer is empty. An empty capture costs no credits.

Credits

Each successful Claude capture costs 3 credits — priced for the official-api lane (no browser session), the full Envelope, every field included. Credits are charged only on success; failed or empty captures are free. See Credits.

Regions

Request Claude in specific locations with regions. One child is created per surface × region, and each child’s provenance.region reports the requested vs effective location if it could not be honored exactly.

{
  "query": "best project management tools",
  "surfaces": ["claude"],
  "regions": [
    { "country": "US" },
    { "country": "GB", "city": "London" },
    { "country": "DE", "language": "de" }
  ]
}

This fans out to job_<id>.claude.us, job_<id>.claude.gb:london, and job_<id>.claude.de:de. See Regions.

Create a search

Full request body, sync variants, and idempotency.

The Envelope

Every field in the canonical per-surface result.

Surfaces

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

Credits

What each surface costs and when you are charged.

Endpoints

Account & discovery

Watches

By surface

Request

Response `202 Accepted`

Per-surface alias

Envelope

Credits

Regions

Create a search

The Envelope

Surfaces

Credits

​Request

​Response 202 Accepted

​Per-surface alias

​Envelope

​Credits

​Regions

Create a search

The Envelope

Surfaces

Credits

Request

Response `202 Accepted`

Per-surface alias

Envelope

Credits

Regions