---
title: "Process Ad Query Endpoint"
method: POST
path: "/api/v1/research/process-ad-query"
tags: ["research"]
---

# Process Ad Query Endpoint

`POST /api/v1/research/process-ad-query`

Process natural language queries for ad research.
Example queries:
- "I want ads for Fruits in past 3 months"
- "Show me Puma ads from last year"
- "Find me Adidas running shoes promotional content"
- "Show me top 10 Nike running shoes from last 3 months"
- "Show me skincare industry ads"

## Query parameters

- `query` string, required

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/brandbooster/apis/fastapi.md) · [All operations](https://skmtc.dev/brandbooster/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/brandbooster/fastapi/revisions/624917d53409/schema)