---
title: "Search"
method: POST
path: "/search"
---

# Search

`POST /search`

## Request

- Base URL: `https://www.agentseo.dev/api/v1`
- URL: `https://www.agentseo.dev/api/v1/search`
- Auth: API key in header `x-api-key`

## Query parameters

- `sync` boolean

## Headers

- `x-project-id` string
- `x-workflow-id` string

## Request body

- SearchParams
  - `query` string, required
  - `location` string: Human-friendly location input. If provided with location_code, location_code wins.
  - `location_code` integer: Optional search location code for deterministic geo-targeting.
  - `limit` integer
  - `include_domains` string[]
  - `exclude_domains` string[]
  - `language` string

## Response `200`

Completed search primitive with agent_support

- SearchResponse
  - `items` object[]
  - `search_parameters` object
  - `serp_features` object[]
  - `keyword_metrics` object, nullable
  - `agent_support` SearchAgentSupport
    - `summary` string
    - `likely_intent` 'informational' | 'commercial_investigation' | 'transactional' | 'local'
    - `top_domains` string[]
    - `evidence` object[]
      - `finding` string
      - `detail` string
    - `recommended_next_calls` AgentWorkflowNextCall[]
      - `endpoint` string
      - `reason` string
    - `limitations` string[]
    - `confidence` number
  - `markdown_summary` string

## Other responses

- `202`: Job queued or still processing
- `4XX`: Error

---

[API](https://skmtc.dev/agentseo/apis/agentseo-api.md) · [All operations](https://skmtc.dev/agentseo/apis/agentseo-api/llms.txt) · [OpenAPI document](https://skmtc.dev/agentseo/apis/agentseo-api/revisions/53a62da6f92c?raw)