AI Search - Fan Out - Conductor Documentation

Get AI Search Fan Out Data (Async)

curl --request POST \
  --url https://api-universal.conductor.com/data-api/v1/async/ai_search_fan_out \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "account_id": 101,
  "start_date": "2025-11-02",
  "end_date": "2025-11-08",
  "collection_frequency": "WEEKLY",
  "web_property_ids": [
    122556,
    987654
  ],
  "ai_search_engines": [
    "chatgptsearch",
    "perplexity"
  ],
  "locodes": [
    "US",
    "CA",
    "US NYC",
    "US-TX"
  ],
  "languages": [
    "en_US",
    "hant_TW"
  ],
  "topics": [
    "marketing automation",
    "website optimization"
  ],
  "prompts": [
    "best crm",
    "top crm"
  ],
  "prompt_type": "branded",
  "intents": [
    "Education",
    "Purchase"
  ],
  "personas": [
    "young adults",
    "developers"
  ],
  "prompts_groups": [
    "Comparison Prompts"
  ],
  "prompts_groups_match": "any"
}
'

import requests

url = "https://api-universal.conductor.com/data-api/v1/async/ai_search_fan_out"

payload = {
    "account_id": 101,
    "start_date": "2025-11-02",
    "end_date": "2025-11-08",
    "collection_frequency": "WEEKLY",
    "web_property_ids": [122556, 987654],
    "ai_search_engines": ["chatgptsearch", "perplexity"],
    "locodes": ["US", "CA", "US NYC", "US-TX"],
    "languages": ["en_US", "hant_TW"],
    "topics": ["marketing automation", "website optimization"],
    "prompts": ["best crm", "top crm"],
    "prompt_type": "branded",
    "intents": ["Education", "Purchase"],
    "personas": ["young adults", "developers"],
    "prompts_groups": ["Comparison Prompts"],
    "prompts_groups_match": "any"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    account_id: 101,
    start_date: '2025-11-02',
    end_date: '2025-11-08',
    collection_frequency: 'WEEKLY',
    web_property_ids: [122556, 987654],
    ai_search_engines: ['chatgptsearch', 'perplexity'],
    locodes: ['US', 'CA', 'US NYC', 'US-TX'],
    languages: ['en_US', 'hant_TW'],
    topics: ['marketing automation', 'website optimization'],
    prompts: ['best crm', 'top crm'],
    prompt_type: 'branded',
    intents: ['Education', 'Purchase'],
    personas: ['young adults', 'developers'],
    prompts_groups: ['Comparison Prompts'],
    prompts_groups_match: 'any'
  })
};

fetch('https://api-universal.conductor.com/data-api/v1/async/ai_search_fan_out', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api-universal.conductor.com/data-api/v1/async/ai_search_fan_out",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'account_id' => 101,
    'start_date' => '2025-11-02',
    'end_date' => '2025-11-08',
    'collection_frequency' => 'WEEKLY',
    'web_property_ids' => [
        122556,
        987654
    ],
    'ai_search_engines' => [
        'chatgptsearch',
        'perplexity'
    ],
    'locodes' => [
        'US',
        'CA',
        'US NYC',
        'US-TX'
    ],
    'languages' => [
        'en_US',
        'hant_TW'
    ],
    'topics' => [
        'marketing automation',
        'website optimization'
    ],
    'prompts' => [
        'best crm',
        'top crm'
    ],
    'prompt_type' => 'branded',
    'intents' => [
        'Education',
        'Purchase'
    ],
    'personas' => [
        'young adults',
        'developers'
    ],
    'prompts_groups' => [
        'Comparison Prompts'
    ],
    'prompts_groups_match' => 'any'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api-universal.conductor.com/data-api/v1/async/ai_search_fan_out"

	payload := strings.NewReader("{\n  \"account_id\": 101,\n  \"start_date\": \"2025-11-02\",\n  \"end_date\": \"2025-11-08\",\n  \"collection_frequency\": \"WEEKLY\",\n  \"web_property_ids\": [\n    122556,\n    987654\n  ],\n  \"ai_search_engines\": [\n    \"chatgptsearch\",\n    \"perplexity\"\n  ],\n  \"locodes\": [\n    \"US\",\n    \"CA\",\n    \"US NYC\",\n    \"US-TX\"\n  ],\n  \"languages\": [\n    \"en_US\",\n    \"hant_TW\"\n  ],\n  \"topics\": [\n    \"marketing automation\",\n    \"website optimization\"\n  ],\n  \"prompts\": [\n    \"best crm\",\n    \"top crm\"\n  ],\n  \"prompt_type\": \"branded\",\n  \"intents\": [\n    \"Education\",\n    \"Purchase\"\n  ],\n  \"personas\": [\n    \"young adults\",\n    \"developers\"\n  ],\n  \"prompts_groups\": [\n    \"Comparison Prompts\"\n  ],\n  \"prompts_groups_match\": \"any\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api-universal.conductor.com/data-api/v1/async/ai_search_fan_out")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"account_id\": 101,\n  \"start_date\": \"2025-11-02\",\n  \"end_date\": \"2025-11-08\",\n  \"collection_frequency\": \"WEEKLY\",\n  \"web_property_ids\": [\n    122556,\n    987654\n  ],\n  \"ai_search_engines\": [\n    \"chatgptsearch\",\n    \"perplexity\"\n  ],\n  \"locodes\": [\n    \"US\",\n    \"CA\",\n    \"US NYC\",\n    \"US-TX\"\n  ],\n  \"languages\": [\n    \"en_US\",\n    \"hant_TW\"\n  ],\n  \"topics\": [\n    \"marketing automation\",\n    \"website optimization\"\n  ],\n  \"prompts\": [\n    \"best crm\",\n    \"top crm\"\n  ],\n  \"prompt_type\": \"branded\",\n  \"intents\": [\n    \"Education\",\n    \"Purchase\"\n  ],\n  \"personas\": [\n    \"young adults\",\n    \"developers\"\n  ],\n  \"prompts_groups\": [\n    \"Comparison Prompts\"\n  ],\n  \"prompts_groups_match\": \"any\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api-universal.conductor.com/data-api/v1/async/ai_search_fan_out")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"account_id\": 101,\n  \"start_date\": \"2025-11-02\",\n  \"end_date\": \"2025-11-08\",\n  \"collection_frequency\": \"WEEKLY\",\n  \"web_property_ids\": [\n    122556,\n    987654\n  ],\n  \"ai_search_engines\": [\n    \"chatgptsearch\",\n    \"perplexity\"\n  ],\n  \"locodes\": [\n    \"US\",\n    \"CA\",\n    \"US NYC\",\n    \"US-TX\"\n  ],\n  \"languages\": [\n    \"en_US\",\n    \"hant_TW\"\n  ],\n  \"topics\": [\n    \"marketing automation\",\n    \"website optimization\"\n  ],\n  \"prompts\": [\n    \"best crm\",\n    \"top crm\"\n  ],\n  \"prompt_type\": \"branded\",\n  \"intents\": [\n    \"Education\",\n    \"Purchase\"\n  ],\n  \"personas\": [\n    \"young adults\",\n    \"developers\"\n  ],\n  \"prompts_groups\": [\n    \"Comparison Prompts\"\n  ],\n  \"prompts_groups_match\": \"any\"\n}"

response = http.request(request)
puts response.read_body

{
  "results": [
    [
      "Conductor Organization",
      "base64-encoded-organization-id",
      "Conductor Account",
      "123",
      "conductor.com",
      "456",
      "2026-01-11",
      "2026-01-17",
      "WEEKLY",
      "US",
      "en_US",
      "chatgpt",
      "marketing automation",
      "best crm tools",
      "unbranded",
      "Purchase",
      "developers",
      "best crm tools for small business 2026",
      "1",
      "8",
      "true",
      "true",
      "Comparison Prompts"
    ]
  ],
  "schema": [
    {
      "name": "organization_name",
      "type": "string"
    },
    {
      "name": "organization_id",
      "type": "string"
    },
    {
      "name": "account_name",
      "type": "string"
    },
    {
      "name": "account_id",
      "type": "integer"
    },
    {
      "name": "web_property_name",
      "type": "string"
    },
    {
      "name": "web_property_id",
      "type": "integer"
    },
    {
      "name": "time_period_start",
      "type": "date"
    },
    {
      "name": "time_period_end",
      "type": "date"
    },
    {
      "name": "collection_frequency",
      "type": "string"
    },
    {
      "name": "locode",
      "type": "string"
    },
    {
      "name": "language",
      "type": "string"
    },
    {
      "name": "ai_search_engine",
      "type": "string"
    },
    {
      "name": "topic",
      "type": "string"
    },
    {
      "name": "prompt",
      "type": "string"
    },
    {
      "name": "prompt_type",
      "type": "string"
    },
    {
      "name": "intent",
      "type": "string"
    },
    {
      "name": "persona",
      "type": "string"
    },
    {
      "name": "fan_out_query",
      "type": "string"
    },
    {
      "name": "fan_out_query_position",
      "type": "integer"
    },
    {
      "name": "amount_of_searches",
      "type": "integer"
    },
    {
      "name": "web_search",
      "type": "boolean"
    },
    {
      "name": "ai_response_received",
      "type": "boolean"
    },
    {
      "name": "prompt_group_names",
      "type": "string"
    }
  ],
  "executionState": "COMPLETED",
  "executionId": "enga:f47ac10b-58cc-4372-a567-0e02b2c3d479",
  "requestId": "9e3b7c12-f4a5-48d1-b6e9-0c32d5a8e1b4",
  "nextPageId": "87QUIJAKFQ9UIRJklafkg8wyuijFIAOqwfL9UIQOr==",
  "totalRowCount": 1000
}

{
  "results": [],
  "schema": [],
  "executionState": "IN_PROGRESS",
  "executionId": "enga:d5fa3c9e-b14a-4f8c-c7d3-ae6a4b9f2c15",
  "requestId": "6a4eab31-9c5f-4d7a-be3b-8fab4a6d9b52"
}

{
  "error": "INVALID_PARAMETERS",
  "message": "start_date must be before end_date"
}

{
  "error": "Execution not found",
  "message": "No query execution matches this executionId, or it has expired. Submit the query again to get a new executionId."
}

{
  "results": [],
  "schema": [],
  "executionState": "FAILED",
  "executionId": "enga:f47ac10b-58cc-4372-a567-0e02b2c3d479",
  "requestId": "9e3b7c12-f4a5-48d1-b6e9-0c32d5a8e1b4",
  "error": "QUERY_RESOURCES_EXHAUSTED",
  "message": "The query needed more resources than a single request allows. Narrow it (for example a shorter date range, or fewer accounts or web properties) and submit it again."
}

POST

data-api

async

ai_search_fan_out

Get AI Search Fan Out Data (Async)

curl --request POST \
  --url https://api-universal.conductor.com/data-api/v1/async/ai_search_fan_out \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "account_id": 101,
  "start_date": "2025-11-02",
  "end_date": "2025-11-08",
  "collection_frequency": "WEEKLY",
  "web_property_ids": [
    122556,
    987654
  ],
  "ai_search_engines": [
    "chatgptsearch",
    "perplexity"
  ],
  "locodes": [
    "US",
    "CA",
    "US NYC",
    "US-TX"
  ],
  "languages": [
    "en_US",
    "hant_TW"
  ],
  "topics": [
    "marketing automation",
    "website optimization"
  ],
  "prompts": [
    "best crm",
    "top crm"
  ],
  "prompt_type": "branded",
  "intents": [
    "Education",
    "Purchase"
  ],
  "personas": [
    "young adults",
    "developers"
  ],
  "prompts_groups": [
    "Comparison Prompts"
  ],
  "prompts_groups_match": "any"
}
'

import requests

url = "https://api-universal.conductor.com/data-api/v1/async/ai_search_fan_out"

payload = {
    "account_id": 101,
    "start_date": "2025-11-02",
    "end_date": "2025-11-08",
    "collection_frequency": "WEEKLY",
    "web_property_ids": [122556, 987654],
    "ai_search_engines": ["chatgptsearch", "perplexity"],
    "locodes": ["US", "CA", "US NYC", "US-TX"],
    "languages": ["en_US", "hant_TW"],
    "topics": ["marketing automation", "website optimization"],
    "prompts": ["best crm", "top crm"],
    "prompt_type": "branded",
    "intents": ["Education", "Purchase"],
    "personas": ["young adults", "developers"],
    "prompts_groups": ["Comparison Prompts"],
    "prompts_groups_match": "any"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    account_id: 101,
    start_date: '2025-11-02',
    end_date: '2025-11-08',
    collection_frequency: 'WEEKLY',
    web_property_ids: [122556, 987654],
    ai_search_engines: ['chatgptsearch', 'perplexity'],
    locodes: ['US', 'CA', 'US NYC', 'US-TX'],
    languages: ['en_US', 'hant_TW'],
    topics: ['marketing automation', 'website optimization'],
    prompts: ['best crm', 'top crm'],
    prompt_type: 'branded',
    intents: ['Education', 'Purchase'],
    personas: ['young adults', 'developers'],
    prompts_groups: ['Comparison Prompts'],
    prompts_groups_match: 'any'
  })
};

fetch('https://api-universal.conductor.com/data-api/v1/async/ai_search_fan_out', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api-universal.conductor.com/data-api/v1/async/ai_search_fan_out",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'account_id' => 101,
    'start_date' => '2025-11-02',
    'end_date' => '2025-11-08',
    'collection_frequency' => 'WEEKLY',
    'web_property_ids' => [
        122556,
        987654
    ],
    'ai_search_engines' => [
        'chatgptsearch',
        'perplexity'
    ],
    'locodes' => [
        'US',
        'CA',
        'US NYC',
        'US-TX'
    ],
    'languages' => [
        'en_US',
        'hant_TW'
    ],
    'topics' => [
        'marketing automation',
        'website optimization'
    ],
    'prompts' => [
        'best crm',
        'top crm'
    ],
    'prompt_type' => 'branded',
    'intents' => [
        'Education',
        'Purchase'
    ],
    'personas' => [
        'young adults',
        'developers'
    ],
    'prompts_groups' => [
        'Comparison Prompts'
    ],
    'prompts_groups_match' => 'any'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api-universal.conductor.com/data-api/v1/async/ai_search_fan_out"

	payload := strings.NewReader("{\n  \"account_id\": 101,\n  \"start_date\": \"2025-11-02\",\n  \"end_date\": \"2025-11-08\",\n  \"collection_frequency\": \"WEEKLY\",\n  \"web_property_ids\": [\n    122556,\n    987654\n  ],\n  \"ai_search_engines\": [\n    \"chatgptsearch\",\n    \"perplexity\"\n  ],\n  \"locodes\": [\n    \"US\",\n    \"CA\",\n    \"US NYC\",\n    \"US-TX\"\n  ],\n  \"languages\": [\n    \"en_US\",\n    \"hant_TW\"\n  ],\n  \"topics\": [\n    \"marketing automation\",\n    \"website optimization\"\n  ],\n  \"prompts\": [\n    \"best crm\",\n    \"top crm\"\n  ],\n  \"prompt_type\": \"branded\",\n  \"intents\": [\n    \"Education\",\n    \"Purchase\"\n  ],\n  \"personas\": [\n    \"young adults\",\n    \"developers\"\n  ],\n  \"prompts_groups\": [\n    \"Comparison Prompts\"\n  ],\n  \"prompts_groups_match\": \"any\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api-universal.conductor.com/data-api/v1/async/ai_search_fan_out")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"account_id\": 101,\n  \"start_date\": \"2025-11-02\",\n  \"end_date\": \"2025-11-08\",\n  \"collection_frequency\": \"WEEKLY\",\n  \"web_property_ids\": [\n    122556,\n    987654\n  ],\n  \"ai_search_engines\": [\n    \"chatgptsearch\",\n    \"perplexity\"\n  ],\n  \"locodes\": [\n    \"US\",\n    \"CA\",\n    \"US NYC\",\n    \"US-TX\"\n  ],\n  \"languages\": [\n    \"en_US\",\n    \"hant_TW\"\n  ],\n  \"topics\": [\n    \"marketing automation\",\n    \"website optimization\"\n  ],\n  \"prompts\": [\n    \"best crm\",\n    \"top crm\"\n  ],\n  \"prompt_type\": \"branded\",\n  \"intents\": [\n    \"Education\",\n    \"Purchase\"\n  ],\n  \"personas\": [\n    \"young adults\",\n    \"developers\"\n  ],\n  \"prompts_groups\": [\n    \"Comparison Prompts\"\n  ],\n  \"prompts_groups_match\": \"any\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api-universal.conductor.com/data-api/v1/async/ai_search_fan_out")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"account_id\": 101,\n  \"start_date\": \"2025-11-02\",\n  \"end_date\": \"2025-11-08\",\n  \"collection_frequency\": \"WEEKLY\",\n  \"web_property_ids\": [\n    122556,\n    987654\n  ],\n  \"ai_search_engines\": [\n    \"chatgptsearch\",\n    \"perplexity\"\n  ],\n  \"locodes\": [\n    \"US\",\n    \"CA\",\n    \"US NYC\",\n    \"US-TX\"\n  ],\n  \"languages\": [\n    \"en_US\",\n    \"hant_TW\"\n  ],\n  \"topics\": [\n    \"marketing automation\",\n    \"website optimization\"\n  ],\n  \"prompts\": [\n    \"best crm\",\n    \"top crm\"\n  ],\n  \"prompt_type\": \"branded\",\n  \"intents\": [\n    \"Education\",\n    \"Purchase\"\n  ],\n  \"personas\": [\n    \"young adults\",\n    \"developers\"\n  ],\n  \"prompts_groups\": [\n    \"Comparison Prompts\"\n  ],\n  \"prompts_groups_match\": \"any\"\n}"

response = http.request(request)
puts response.read_body

{
  "results": [
    [
      "Conductor Organization",
      "base64-encoded-organization-id",
      "Conductor Account",
      "123",
      "conductor.com",
      "456",
      "2026-01-11",
      "2026-01-17",
      "WEEKLY",
      "US",
      "en_US",
      "chatgpt",
      "marketing automation",
      "best crm tools",
      "unbranded",
      "Purchase",
      "developers",
      "best crm tools for small business 2026",
      "1",
      "8",
      "true",
      "true",
      "Comparison Prompts"
    ]
  ],
  "schema": [
    {
      "name": "organization_name",
      "type": "string"
    },
    {
      "name": "organization_id",
      "type": "string"
    },
    {
      "name": "account_name",
      "type": "string"
    },
    {
      "name": "account_id",
      "type": "integer"
    },
    {
      "name": "web_property_name",
      "type": "string"
    },
    {
      "name": "web_property_id",
      "type": "integer"
    },
    {
      "name": "time_period_start",
      "type": "date"
    },
    {
      "name": "time_period_end",
      "type": "date"
    },
    {
      "name": "collection_frequency",
      "type": "string"
    },
    {
      "name": "locode",
      "type": "string"
    },
    {
      "name": "language",
      "type": "string"
    },
    {
      "name": "ai_search_engine",
      "type": "string"
    },
    {
      "name": "topic",
      "type": "string"
    },
    {
      "name": "prompt",
      "type": "string"
    },
    {
      "name": "prompt_type",
      "type": "string"
    },
    {
      "name": "intent",
      "type": "string"
    },
    {
      "name": "persona",
      "type": "string"
    },
    {
      "name": "fan_out_query",
      "type": "string"
    },
    {
      "name": "fan_out_query_position",
      "type": "integer"
    },
    {
      "name": "amount_of_searches",
      "type": "integer"
    },
    {
      "name": "web_search",
      "type": "boolean"
    },
    {
      "name": "ai_response_received",
      "type": "boolean"
    },
    {
      "name": "prompt_group_names",
      "type": "string"
    }
  ],
  "executionState": "COMPLETED",
  "executionId": "enga:f47ac10b-58cc-4372-a567-0e02b2c3d479",
  "requestId": "9e3b7c12-f4a5-48d1-b6e9-0c32d5a8e1b4",
  "nextPageId": "87QUIJAKFQ9UIRJklafkg8wyuijFIAOqwfL9UIQOr==",
  "totalRowCount": 1000
}

{
  "results": [],
  "schema": [],
  "executionState": "IN_PROGRESS",
  "executionId": "enga:d5fa3c9e-b14a-4f8c-c7d3-ae6a4b9f2c15",
  "requestId": "6a4eab31-9c5f-4d7a-be3b-8fab4a6d9b52"
}

{
  "error": "INVALID_PARAMETERS",
  "message": "start_date must be before end_date"
}

{
  "error": "Execution not found",
  "message": "No query execution matches this executionId, or it has expired. Submit the query again to get a new executionId."
}

{
  "results": [],
  "schema": [],
  "executionState": "FAILED",
  "executionId": "enga:f47ac10b-58cc-4372-a567-0e02b2c3d479",
  "requestId": "9e3b7c12-f4a5-48d1-b6e9-0c32d5a8e1b4",
  "error": "QUERY_RESOURCES_EXHAUSTED",
  "message": "The query needed more resources than a single request allows. Narrow it (for example a shorter date range, or fewer accounts or web properties) and submit it again."
}

Change Log

2026-08-28 · Added — AI Search Fan Out endpoint, returning one row per individual fan out query an AI engine runs before answering a tracked prompt.

Authorizations

Authorization

string

header

required

Conductor API token, sent as Bearer <your-api-token>. Generate a token from Integrations > API > Create API Token.

Body

application/json

Submit
Poll
Paginate

Submit a new query with filters and parameters. Returns an executionId to track the query.

account_id

integer

required

Required account ID to filter results. See Accounts.

Required range: x >= 1

Example:

101

start_date

string<date>

required

Start date of the time period (yyyy-MM-dd). If collection_frequency is WEEKLY or not set, this must be a Sunday. If collection_frequency is MONTHLY, this must be the first day of the month.

Example:

"2025-11-02"

end_date

string<date>

required

End date of the time period (yyyy-MM-dd). If collection_frequency is WEEKLY or not set, this must be a Saturday. If collection_frequency is MONTHLY, this must be the last day of the month.

Example:

"2025-11-29"

collection_frequency

enum<string>

default:WEEKLY

Frequency of data collection.

Available options:

DAILY,

WEEKLY,

MONTHLY

limit

integer

default:1000

Maximum number of results to return. Must be between 1 and 1,000 inclusive; a value outside that range is rejected with a 400.

Required range: 1 <= x <= 1000

Example:

100

web_property_ids

integer[]

(Optional) list of web property IDs to filter results. See Web Properties.

Required range: x >= 1

Example:

[122556, 987654]

ai_search_engines

string[]

(Optional) list of AI engines to filter. See AI Search.

Example:

["chatgptsearch", "perplexity"]

locodes

string[]

(Optional) list of locodes to filter (case-insensitive). Based on ISO names from a predefined dictionary. A locode can represent a country ("US"), city ("US NYC"), state ("PL-02"), or a specific location (e.g., an airport). See AI Search.

Required string length: 2 - 12

Example:

["US", "CA", "US NYC", "US-TX"]

languages

string[]

(Optional) list of search engine language codes to filter (case-insensitive; e.g., en_US, hant_TW). See AI Search.

Required string length: 2 - 7

Example:

["en_US", "hant_TW"]

topics

string[]

(Optional) list of topics to filter. See AI Search.

Example:

[
  "marketing automation",
  "website optimization"
]

prompts

string[]

(Optional) list of prompts to filter. See AI Search.

Example:

["best crm", "top crm"]

prompt_type

enum<string>

(Optional) indicates whether the prompt is branded or unbranded.

Available options:

branded,

unbranded

Example:

"branded"

intents

string[]

(Optional) list of intents to filter. Options include: Education, Brand/Service Navigation, Pricing, Support, Recommendations, Comparison, Purchase, Other. See AI Search.

Example:

["Education", "Purchase"]

personas

string[]

(Optional) list of user-defined personas to filter (e.g., "android user", "developers"). See AI Search.

Example:

["young adults", "developers"]

prompts_groups

string[]

(Optional) list of prompt group names to filter (case-insensitive). See AI Search with config_type=prompt_groups to discover group names.

Example:

["Comparison Prompts"]

prompts_groups_match

enum<string>

default:any

(Optional) how prompts_groups combines multiple group names: any (default) matches at least one; all matches every listed group.

Available options:

any,

all

Example:

"any"

Response

Successful query execution

results

string[][]

List of query results. Each item is a positional tuple row. Available only when executionState is COMPLETED.

Positional tuple row for AI Search Fan Out results. Column order matches the schema metadata. All values are returned as strings.

Minimum array length: 23

executionState

enum<string>

Current execution state of the query:

IN_PROGRESS: The query is still running. Poll again later.
COMPLETED: The query finished successfully. Results are available.

Available options:

IN_PROGRESS,

COMPLETED

executionId

string

Unique identifier for the query execution. Valid for 7 days. Use this for polling and pagination.

requestId

string

Unique identifier for the HTTP request, useful for support and debugging.

nextPageId

string

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.

totalRowCount

integer<int64>

Total number of rows across all pages (if available).

schema

object[]

Column metadata providing the name and type for each position in the results tuple.

Show child attributes

​Change Log

Authorizations

Body

Response

Change Log