Search AI Mode generative results

Run one live AI Mode search for generative answer evidence, cited sources, and target-domain visibility.

Pricing — $ · min $0.01

Minimum 10 credits ($0.01) per call. Records returned above the minimum bill 1 credit ($0.001) each.

Authorization

bearerAuth

AuthorizationBearer <token>

UnifAPI API key. Provider credentials are managed by UnifAPI.

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

query*string

Search query to inspect in AI Mode.

Length1 <= length <= 700

target?string

Optional domain or URL to mark when it appears in AI Mode answers, links, or cited references.

Length1 <= length

location?|

Search location as a country code/name, DataForSEO location code, full location name, or latitude,longitude,radius coordinate string. Defaults to us.

language?string

Search language as an ISO code or full language name. Defaults to en.

Length2 <= length <= 80

device?string

AI SERP device type. Defaults to desktop.

Value in"desktop" | "mobile"

include_pixel_rankings?boolean

When true, request pixel rectangle data for visual AI SERP analysis.

view?string

Value in"summary" | "standard" | "full"

Response Body

`application/json`

curl -X POST "https://example.com/geo/serp" \  -H "Content-Type: application/json" \  -d '{    "query": "string"  }'

{
  "request_id": "string",
  "data": {
    "query": "string",
    "location": "string",
    "language": "string",
    "device": "desktop",
    "surface": "google_ai_mode",
    "view": "summary",
    "observed_at": "string",
    "search_url": "string",
    "total_results": 0,
    "serp_features": [
      "string"
    ],
    "results": [
      {
        "rank": 0,
        "group_rank": 0,
        "type": "string",
        "title": "string",
        "text": "string",
        "markdown": "string",
        "page": 0,
        "position": "string",
        "references": [
          {
            "title": "string",
            "url": "string",
            "domain": "string",
            "source": "string",
            "snippet": "string",
            "position": "string",
            "is_target": true
          }
        ],
        "links": [
          {
            "title": "string",
            "url": "string",
            "domain": "string",
            "snippet": "string",
            "is_target": true
          }
        ],
        "images": [
          {
            "alt": "string",
            "url": "string",
            "image_url": "string"
          }
        ],
        "sections": [
          {
            "type": "string",
            "title": "string",
            "text": "string",
            "markdown": "string",
            "url": "string",
            "domain": "string",
            "source": "string",
            "snippet": "string",
            "references": [
              {
                "title": "string",
                "url": "string",
                "domain": "string",
                "source": "string",
                "snippet": "string",
                "position": "string",
                "is_target": true
              }
            ],
            "links": [
              {
                "title": "string",
                "url": "string",
                "domain": "string",
                "snippet": "string",
                "is_target": true
              }
            ],
            "images": [
              {
                "alt": "string",
                "url": "string",
                "image_url": "string"
              }
            ],
            "table": null,
            "nested_items": [
              null
            ],
            "is_target": true,
            "extras": {
              "property1": null,
              "property2": null
            }
          }
        ],
        "is_billable": true,
        "is_target": true,
        "extras": {
          "property1": null,
          "property2": null
        }
      }
    ],
    "target": {
      "value": "string",
      "domain": "string",
      "present": true,
      "best_rank": 0,
      "matches": [
        {
          "rank": 0,
          "type": "string",
          "title": "string",
          "domain": "string",
          "url": "string"
        }
      ],
      "citations": [
        {
          "title": "string",
          "url": "string",
          "domain": "string",
          "source": "string",
          "snippet": "string",
          "position": "string",
          "is_target": true,
          "result_rank": 0,
          "result_type": "string",
          "result_title": "string"
        }
      ]
    },
    "competitors": [
      {
        "domain": "string",
        "best_rank": 0,
        "citation_count": 0
      }
    ]
  },
  "billing": {
    "credits_charged": 0,
    "records_charged": 0,
    "balance_remaining": 0,
    "truncated_due_to_balance": true
  }
}

{
  "error": {
    "type": "validation_error",
    "message": "string",
    "request_id": "string",
    "issues": [
      null
    ],
    "billing": {
      "credits_required": 0,
      "credits_charged": 0,
      "records_charged": 0,
      "balance_remaining": 0,
      "truncated_due_to_balance": true
    }
  }
}

{
  "error": {
    "type": "validation_error",
    "message": "string",
    "request_id": "string",
    "issues": [
      null
    ],
    "billing": {
      "credits_required": 0,
      "credits_charged": 0,
      "records_charged": 0,
      "balance_remaining": 0,
      "truncated_due_to_balance": true
    }
  }
}

{
  "error": {
    "type": "validation_error",
    "message": "string",
    "request_id": "string",
    "issues": [
      null
    ],
    "billing": {
      "credits_required": 0,
      "credits_charged": 0,
      "records_charged": 0,
      "balance_remaining": 0,
      "truncated_due_to_balance": true
    }
  }
}

{
  "error": {
    "type": "validation_error",
    "message": "string",
    "request_id": "string",
    "issues": [
      null
    ],
    "billing": {
      "credits_required": 0,
      "credits_charged": 0,
      "records_charged": 0,
      "balance_remaining": 0,
      "truncated_due_to_balance": true
    }
  }
}

{
  "error": {
    "type": "validation_error",
    "message": "string",
    "request_id": "string",
    "issues": [
      null
    ],
    "billing": {
      "credits_required": 0,
      "credits_charged": 0,
      "records_charged": 0,
      "balance_remaining": 0,
      "truncated_due_to_balance": true
    }
  }
}

{
  "error": {
    "type": "validation_error",
    "message": "string",
    "request_id": "string",
    "issues": [
      null
    ],
    "billing": {
      "credits_required": 0,
      "credits_charged": 0,
      "records_charged": 0,
      "balance_remaining": 0,
      "truncated_due_to_balance": true
    }
  }
}

{
  "error": {
    "type": "validation_error",
    "message": "string",
    "request_id": "string",
    "issues": [
      null
    ],
    "billing": {
      "credits_required": 0,
      "credits_charged": 0,
      "records_charged": 0,
      "balance_remaining": 0,
      "truncated_due_to_balance": true
    }
  }
}

{
  "error": {
    "type": "validation_error",
    "message": "string",
    "request_id": "string",
    "issues": [
      null
    ],
    "billing": {
      "credits_required": 0,
      "credits_charged": 0,
      "records_charged": 0,
      "balance_remaining": 0,
      "truncated_due_to_balance": true
    }
  }
}

Search AI Mode generative results

Authorization

Request Body

Response Body

200application/json

400application/json

401application/json

402application/json

404application/json

429application/json

500application/json

502application/json

503application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`