# OpenAPI spec

The full SerpWiz API is described in an **OpenAPI 3.1** document:

- **JSON:** [`https://serpwiz.com/openapi.json`](https://serpwiz.com/openapi.json)

It covers every endpoint, parameter, response schema, error code and the `X-API-Key` security scheme.

## Uses

- **Generate a client** in any language:

  ```bash
  npx @openapitools/openapi-generator-cli generate \
    -i https://serpwiz.com/openapi.json -g python -o serpwiz-client
  ```

- **Import into Postman, Insomnia or Bruno** — paste the URL as a new import.
- **Give an AI agent a tool definition.** Most agent frameworks can load OpenAPI directly as tools (for example, OpenAPI toolkits in LangChain, Semantic Kernel or custom GPT actions). See [AI agents & LLMs](/docs/ai-agents).

The spec is generated from the same configuration that serves the API, so it always matches production.