POST/v1/serp

Google SERP proxy. Submit a standard https://www.google.com/search URL and receive structured results. The API accepts Google's native URL parameters — no proprietary schema or vendor lock-in.

Quickstart

Construct a standard Google search URL with the required parameters. Device routing, rendering, captcha handling, and browser fingerprinting are managed automatically. The response is a compact semantic tree.

US search

curl -X POST https://api.amayalabs.io/v1/serp \
  -H "Authorization: Bearer $AMAYA_KEY" \
  -d 'url=https://www.google.com/search?q=openai+latest+models&gl=us&hl=en'

Localised with pagination

curl -X POST https://api.amayalabs.io/v1/serp \
  -H "Authorization: Bearer $AMAYA_KEY" \
  -d 'url=https://www.google.com/search?q=hotels+tokyo&gl=jp&hl=ja&start=10'

Standard Google search URL parameters are supported: gl, hl, start, tbs, tbm, and others. Each request uses an isolated device instance with a fresh browser fingerprint.

Request

Name	Type	Description
url	string	A standard Google search URL. Any Google URL parameter is supported: gl, hl, start, tbs, tbm, etc.

Output format

Compact semantic tree. Each node has a role, text, and bounds. No proprietary JSON schema — the tree mirrors the page structure. No provider lock-in. Designed for processing by LLMs and AI agents.

{
  "format": "chromium_compact_ax_tree_v1",
  "tree": {
    "role": "WebView",
    "children": [
      { "role": "heading",  "name": "...", "bounds": [0,0,320,48] },
      { "role": "link",     "name": "...", "bounds": [24,60,296,90] },
      { "role": "paragraph","name": "...", "bounds": [24,100,296,160] }
    ]
  }
}