---
title: "Generate Queries Endpoint"
method: POST
path: "/api/v1/wizard/generate-queries"
tags: ["Wizard"]
---

# Generate Queries Endpoint

`POST /api/v1/wizard/generate-queries`

## Request

- Base URL: `https://geo.sig.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://geo.sig.ai/api/v1/wizard/generate-queries`
- Auth: HTTP bearer

Generate AI-suggested search queries based on brand, verticals, and competitors.

Uses Claude (via Anthropic API or AWS Bedrock) to generate 4-6 relevant search queries:
- Non-branded queries: General category searches (e.g., "best data warehouse tools")
- Branded queries: Brand-specific or comparison searches (e.g., "Snowflake vs Databricks")

This helps users quickly get started with relevant tracking queries.

## Cookies

- `access_token` string, nullable

## Request body

- QueryGenerationRequest: Request schema for AI query generation.
  - `brand_name` string, required: The brand name
  - `verticals` string[], required: Selected verticals
  - `competitors` string[], required: List of competitors
  - `website_url` string, nullable: Optional website URL for context

## Response `200`

Successful Response

- QueryGenerationResponse: Response schema for query generation endpoint.
  - `brand_name` string, required
  - `queries` QueryGenerationOutput, required: AI output schema for query generation.
    - `suggested_queries` SuggestedQuery[], required: 4-6 suggested search queries
      - `query_text` string, required: The search query text
      - `category` 'non-branded' | 'branded', required: Query category
      - `reasoning` string, required: Why this query is relevant
  - `processing_time_ms` integer, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/sig/apis/ai-visibility-intelligence-api.md) · [All operations](https://skmtc.dev/sig/apis/ai-visibility-intelligence-api/llms.txt) · [OpenAPI document](https://skmtc.dev/sig/apis/ai-visibility-intelligence-api/revisions/3ec39f9be9e0?raw)