> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tryprofound.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Query Fanouts
The search queries an AI generates behind the scenes when answering a prompt.
**Coverage is partial:** metrics cover only runs that emitted fanout data (see
`info.coverage_note`).
* **Metrics:** `total_fanouts` (query count), `fanouts_per_execution` (avg queries per execution), `query_variations` (distinct fanout queries), `share`.
* **`group_by`:** `prompt` (default), `query`, `model`, `region`, `date`.
* `query` requires `prompt` in `group_by`; `share` requires `query`; `query_variations` can't be combined with `query`.
* **`analysis_type`** filter defaults to `visibility`.
New to the v2 reports? See [Filtering & concepts](/rest-api/reports/reports-v2-overview) for the shared request shape, filter tree, grouping, and pagination.
`POST /v2/reports/query-fanouts/stream` takes the **same request body** and
returns [Server-Sent Events](https://developer.mozilla.org/docs/Web/API/Server-sent_events):
one `summary` event (the `info` block), then one `result` event per row.
`limit`/`cursor` are ignored; it returns everything by default. Pass
`max_results` to cap.
```text Response (text/event-stream) theme={null}
event: summary
data: { ...the info block... }
event: result ← one per row, same shape as data[] above
data: {"prompt": "AI search optimization startups...", "rank": 1, "total_fanouts": 190, "fanouts_per_execution": 3.0, "query_variations": 143}
```
```bash cURL theme={null}
curl -X POST https://api.tryprofound.com/v2/reports/query-fanouts \
-H "X-API-Key: " \
-H "Content-Type: application/json" \
-d '{
"category_id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
"start_date": "2026-06-09",
"end_date": "2026-06-15"
}'
```
```json 200 theme={null}
{
"info": {
"total_results": 322,
"count": 10,
"next_cursor": "Z0FBQUFBQnFQcVJ3R1RlcGtXc0g5eTZT...",
"models": ["ChatGPT", "Google Gemini", "Perplexity", "Claude", "..."],
"metrics": ["total_fanouts", "fanouts_per_execution", "query_variations"],
"start_date": "2026-06-09",
"end_date": "2026-06-15",
"coverage_note": "Fanout metrics cover only runs that emitted query-fanout data.",
"filter": null
},
"data": [
{ "prompt": "AI search optimization startups...", "rank": 1, "total_fanouts": 190, "fanouts_per_execution": 3.0, "query_variations": 143 },
{ "prompt": "Best AI visibility products...", "rank": 2, "total_fanouts": 168, "fanouts_per_execution": 2.7, "query_variations": 143 }
// ...8 more rows in this page (count: 10, total_results: 322); paginate with next_cursor
]
}
```
## OpenAPI
````yaml POST /v2/reports/query-fanouts
openapi: 3.1.0
info:
title: External API
version: 6c43b49565a0c4e7cb023e22242cc3df28ee7153
servers:
- url: https://api.tryprofound.com
description: Production Server
security: []
paths:
/v2/reports/query-fanouts:
post:
tags:
- Reports
- Reports
summary: Query Fanouts V2
operationId: query_fanouts_v2_v2_reports_query_fanouts_post
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/QueryFanoutsV2Query'
required: true
responses:
'200':
description: Successful Response
content:
application/json:
schema:
additionalProperties: true
type: object
title: Response Query Fanouts V2 V2 Reports Query Fanouts Post
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
security:
- APIKeyHeader: []
- BearerAuth: []
x-codeSamples:
- lang: JavaScript
source: |-
import Profound from '@profoundai/client';
const client = new Profound({
apiKey: process.env['PROFOUND_API_KEY'], // This is the default and can be omitted
});
const response = await client.reports.queryQueryFanouts({
category_id: 'category_id',
end_date: 'end_date',
start_date: 'start_date',
});
console.log(response);
- lang: Python
source: |-
import os
from profound import Profound
client = Profound(
api_key=os.environ.get("PROFOUND_API_KEY"), # This is the default and can be omitted
)
response = client.reports.query_query_fanouts(
category_id="category_id",
end_date="end_date",
start_date="start_date",
)
print(response)
components:
schemas:
QueryFanoutsV2Query:
properties:
category_id:
type: string
title: Category Id
start_date:
type: string
title: Start Date
description: YYYY-MM-DD, ET, inclusive
end_date:
type: string
title: End Date
description: YYYY-MM-DD, ET, inclusive
group_by:
items:
type: string
enum:
- date
- model
- region
- prompt
- query
type: array
title: Group By
metrics:
anyOf:
- items:
type: string
enum:
- fanouts_per_execution
- total_fanouts
- share
- query_variations
type: array
- type: 'null'
title: Metrics
interval:
type: string
enum:
- day
- week
- month
title: Interval
default: day
filter:
anyOf:
- $ref: '#/components/schemas/FilterNode'
- type: 'null'
sort:
anyOf:
- $ref: >-
#/components/schemas/app__routes__v2__answer_engine_insights__reports__query_fanouts__SortSpec
- type: 'null'
limit:
anyOf:
- type: integer
maximum: 50
exclusiveMinimum: 0
- type: 'null'
title: Limit
description: Page size; default 10, max 50.
max_results:
anyOf:
- type: integer
exclusiveMinimum: 0
- type: 'null'
title: Max Results
description: >-
Stream endpoint only: cap the number of streamed rows (default:
all).
cursor:
anyOf:
- type: string
- type: 'null'
title: Cursor
additionalProperties: false
type: object
required:
- category_id
- start_date
- end_date
title: QueryFanoutsV2Query
HTTPValidationError:
properties:
detail:
items:
$ref: '#/components/schemas/ValidationError'
type: array
title: Detail
type: object
title: HTTPValidationError
FilterNode:
properties:
and:
anyOf:
- items:
$ref: '#/components/schemas/FilterNode'
type: array
- type: 'null'
title: And
or:
anyOf:
- items:
$ref: '#/components/schemas/FilterNode'
type: array
- type: 'null'
title: Or
not:
anyOf:
- $ref: '#/components/schemas/FilterNode'
- type: 'null'
field:
anyOf:
- type: string
- type: 'null'
title: Field
op:
anyOf:
- type: string
- type: 'null'
title: Op
value:
title: Value
additionalProperties: false
type: object
title: FilterNode
description: A leaf (`field`/`op`/`value`) or an `and`/`or`/`not` group.
app__routes__v2__answer_engine_insights__reports__query_fanouts__SortSpec:
properties:
field:
type: string
title: Field
dir:
type: string
enum:
- asc
- desc
title: Dir
default: desc
additionalProperties: false
type: object
required:
- field
title: SortSpec
ValidationError:
properties:
loc:
items:
anyOf:
- type: string
- type: integer
type: array
title: Location
msg:
type: string
title: Message
type:
type: string
title: Error Type
input:
title: Input
ctx:
type: object
title: Context
type: object
required:
- loc
- msg
- type
title: ValidationError
securitySchemes:
APIKeyHeader:
type: apiKey
in: header
name: X-API-Key
BearerAuth:
type: http
scheme: bearer
````