AI Search - Response
Query full response-level data from AI search engines with Conductor’s asynchronous Data API to analyze how your brand appears in AI answers.
Change Log
- 2026-06-11 · Added — AI Search Response endpoint, returning the full response each AI engine gives for a tracked prompt, plus related metadata.
Authorizations
Conductor API token, sent as Bearer <your-api-token>. Generate a token from Integrations > API > Create API Token.
Body
- Submit
- Poll
- Paginate
Submit a new query with filters and parameters. Returns an executionId to track the query.
Start date of the time period; if collection_frequency is WEEKLY, this field must be Sunday; if MONTHLY, must be the first day of the month
"2025-11-02"
End date of the time period; if collection_frequency is WEEKLY, this field must be Saturday; if MONTHLY, must be the last day of the month
"2025-11-08"
Data collection frequency
DAILY, WEEKLY, MONTHLY Required account ID to filter results
x >= 1101
Maximum number of results to return
0 <= x <= 1000100
(Optional) comma-separated list of web property IDs to filter results. If not provided, results are not filtered by web property
x >= 1(Optional) comma-separated list of AI engines to filter
(Optional) comma-separated list of locodes to filter (case-insensitive; values will be uppercased). Supports locales like country codes "DE" or city locodes "US NYC" or state codes "PL-02"
2 - 12(Optional) comma-separated list of search engine language codes to filter (case-insensitive; values will be uppercased).
2 - 7(Optional) comma-separated list of topics to filter
(Optional) comma-separated list of prompts to filter
(Optional) comma-separated list of intents to filter
(Optional) comma-separated list of personas to filter
Response
Query completed successfully
List of query results. Each item is a positional tuple row.
Available only when executionState is COMPLETED.
Positional tuple row for AI Search Response results. Column order matches the schema metadata. All values are returned as strings.
19Current execution state of the query:
IN_PROGRESS: The query is still running. Poll again later.COMPLETED: The query finished successfully. Results are available.FAILED: The query failed. Check the error message if available.
IN_PROGRESS, COMPLETED, FAILED Unique identifier for the query execution. Valid for 7 days. Use this for polling and pagination.
Unique identifier for the HTTP request, useful for support and debugging.
Token for retrieving the next page of results. Available as long as the executionId is valid (7 days).
If null, there are no more pages available.
Total number of rows across all pages (if available).
Column metadata providing the name and type for each position in the results tuple.
