Query AI Search Citations Data (Async)

curl --request POST \
  --url https://api-universal.conductor.com/data-api/v1/async/ai_search_citations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "account_id": 101,
  "start_date": "2025-11-02",
  "end_date": "2025-11-29",
  "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"
  ],
  "root_domains": [
    "conductor.com",
    "abc.com"
  ],
  "domains": [
    "blog.conductor.com",
    "about.conductor.com"
  ],
  "citation_urls": [
    "https://www.conductor.com/blog/conductor-record-enterprise-momentum-ai-search/",
    "https://www.conductor.com/academy/debunking-ai-prompt-volume/"
  ],
  "citation_attributions": [
    "You",
    "Partner",
    "SEO Competitor",
    "Other"
  ]
}
'

import requests

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

payload = {
    "account_id": 101,
    "start_date": "2025-11-02",
    "end_date": "2025-11-29",
    "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"],
    "root_domains": ["conductor.com", "abc.com"],
    "domains": ["blog.conductor.com", "about.conductor.com"],
    "citation_urls": ["https://www.conductor.com/blog/conductor-record-enterprise-momentum-ai-search/", "https://www.conductor.com/academy/debunking-ai-prompt-volume/"],
    "citation_attributions": ["You", "Partner", "SEO Competitor", "Other"]
}
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-29',
    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'],
    root_domains: ['conductor.com', 'abc.com'],
    domains: ['blog.conductor.com', 'about.conductor.com'],
    citation_urls: [
      'https://www.conductor.com/blog/conductor-record-enterprise-momentum-ai-search/',
      'https://www.conductor.com/academy/debunking-ai-prompt-volume/'
    ],
    citation_attributions: ['You', 'Partner', 'SEO Competitor', 'Other']
  })
};

fetch('https://api-universal.conductor.com/data-api/v1/async/ai_search_citations', 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_citations",
  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-29',
    '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'
    ],
    'root_domains' => [
        'conductor.com',
        'abc.com'
    ],
    'domains' => [
        'blog.conductor.com',
        'about.conductor.com'
    ],
    'citation_urls' => [
        'https://www.conductor.com/blog/conductor-record-enterprise-momentum-ai-search/',
        'https://www.conductor.com/academy/debunking-ai-prompt-volume/'
    ],
    'citation_attributions' => [
        'You',
        'Partner',
        'SEO Competitor',
        'Other'
    ]
  ]),
  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_citations"

	payload := strings.NewReader("{\n  \"account_id\": 101,\n  \"start_date\": \"2025-11-02\",\n  \"end_date\": \"2025-11-29\",\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  \"root_domains\": [\n    \"conductor.com\",\n    \"abc.com\"\n  ],\n  \"domains\": [\n    \"blog.conductor.com\",\n    \"about.conductor.com\"\n  ],\n  \"citation_urls\": [\n    \"https://www.conductor.com/blog/conductor-record-enterprise-momentum-ai-search/\",\n    \"https://www.conductor.com/academy/debunking-ai-prompt-volume/\"\n  ],\n  \"citation_attributions\": [\n    \"You\",\n    \"Partner\",\n    \"SEO Competitor\",\n    \"Other\"\n  ]\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_citations")
  .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-29\",\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  \"root_domains\": [\n    \"conductor.com\",\n    \"abc.com\"\n  ],\n  \"domains\": [\n    \"blog.conductor.com\",\n    \"about.conductor.com\"\n  ],\n  \"citation_urls\": [\n    \"https://www.conductor.com/blog/conductor-record-enterprise-momentum-ai-search/\",\n    \"https://www.conductor.com/academy/debunking-ai-prompt-volume/\"\n  ],\n  \"citation_attributions\": [\n    \"You\",\n    \"Partner\",\n    \"SEO Competitor\",\n    \"Other\"\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

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

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-29\",\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  \"root_domains\": [\n    \"conductor.com\",\n    \"abc.com\"\n  ],\n  \"domains\": [\n    \"blog.conductor.com\",\n    \"about.conductor.com\"\n  ],\n  \"citation_urls\": [\n    \"https://www.conductor.com/blog/conductor-record-enterprise-momentum-ai-search/\",\n    \"https://www.conductor.com/academy/debunking-ai-prompt-volume/\"\n  ],\n  \"citation_attributions\": [\n    \"You\",\n    \"Partner\",\n    \"SEO Competitor\",\n    \"Other\"\n  ]\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",
      "best AEO and GEO platforms",
      "best AEO and GEO platforms 2026 - complete guide",
      "unbranded",
      "Educational",
      "broad audience",
      "Conductor | The Leading Organic Marketing Platform",
      "https://www.conductor.com/",
      "conductor.com",
      "blog.conductor.com",
      "you",
      "true",
      "true"
    ]
  ],
  "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": "citation_title",
      "type": "string"
    },
    {
      "name": "citation_url",
      "type": "string"
    },
    {
      "name": "citation_domain",
      "type": "string"
    },
    {
      "name": "citation_web_property_segment",
      "type": "string"
    },
    {
      "name": "citation_attribution",
      "type": "string"
    },
    {
      "name": "ai_response_collected",
      "type": "boolean"
    },
    {
      "name": "web_search_triggered",
      "type": "boolean"
    }
  ],
  "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:e6ab4daf-c25b-4a9d-d8e4-bf7b5caa3d26",
  "requestId": "7b5fbc42-ad6a-4e8b-cf4c-9abc5b7eac63"
}

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

AI Search

AI Search - Citations

Execute a query to retrieve citation-focused data from AI search responses. This endpoint follows the asynchronous query flow.

Usage Patterns:

Submit: Create a query (Initial request). Returns executionId.
Poll: Use executionId to check status. Returns 200 with results when COMPLETED.
Paginate: Use executionId and nextPageId from the previous response.

Rate Limits:

Submit: 40 req/min (Hard), 5 req/min (Recommended).
Poll/Paginate: 5000 req/min (Hard), 1000 req/min (Recommended).

Sequential Pagination:

Pagination must be performed sequentially. Each request for the next page must use the nextPageId returned in the previous response. Parallel pagination is not supported.

POST

data-api

async

ai_search_citations

Query AI Search Citations Data (Async)

curl --request POST \
  --url https://api-universal.conductor.com/data-api/v1/async/ai_search_citations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "account_id": 101,
  "start_date": "2025-11-02",
  "end_date": "2025-11-29",
  "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"
  ],
  "root_domains": [
    "conductor.com",
    "abc.com"
  ],
  "domains": [
    "blog.conductor.com",
    "about.conductor.com"
  ],
  "citation_urls": [
    "https://www.conductor.com/blog/conductor-record-enterprise-momentum-ai-search/",
    "https://www.conductor.com/academy/debunking-ai-prompt-volume/"
  ],
  "citation_attributions": [
    "You",
    "Partner",
    "SEO Competitor",
    "Other"
  ]
}
'

import requests

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

payload = {
    "account_id": 101,
    "start_date": "2025-11-02",
    "end_date": "2025-11-29",
    "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"],
    "root_domains": ["conductor.com", "abc.com"],
    "domains": ["blog.conductor.com", "about.conductor.com"],
    "citation_urls": ["https://www.conductor.com/blog/conductor-record-enterprise-momentum-ai-search/", "https://www.conductor.com/academy/debunking-ai-prompt-volume/"],
    "citation_attributions": ["You", "Partner", "SEO Competitor", "Other"]
}
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-29',
    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'],
    root_domains: ['conductor.com', 'abc.com'],
    domains: ['blog.conductor.com', 'about.conductor.com'],
    citation_urls: [
      'https://www.conductor.com/blog/conductor-record-enterprise-momentum-ai-search/',
      'https://www.conductor.com/academy/debunking-ai-prompt-volume/'
    ],
    citation_attributions: ['You', 'Partner', 'SEO Competitor', 'Other']
  })
};

fetch('https://api-universal.conductor.com/data-api/v1/async/ai_search_citations', 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_citations",
  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-29',
    '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'
    ],
    'root_domains' => [
        'conductor.com',
        'abc.com'
    ],
    'domains' => [
        'blog.conductor.com',
        'about.conductor.com'
    ],
    'citation_urls' => [
        'https://www.conductor.com/blog/conductor-record-enterprise-momentum-ai-search/',
        'https://www.conductor.com/academy/debunking-ai-prompt-volume/'
    ],
    'citation_attributions' => [
        'You',
        'Partner',
        'SEO Competitor',
        'Other'
    ]
  ]),
  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_citations"

	payload := strings.NewReader("{\n  \"account_id\": 101,\n  \"start_date\": \"2025-11-02\",\n  \"end_date\": \"2025-11-29\",\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  \"root_domains\": [\n    \"conductor.com\",\n    \"abc.com\"\n  ],\n  \"domains\": [\n    \"blog.conductor.com\",\n    \"about.conductor.com\"\n  ],\n  \"citation_urls\": [\n    \"https://www.conductor.com/blog/conductor-record-enterprise-momentum-ai-search/\",\n    \"https://www.conductor.com/academy/debunking-ai-prompt-volume/\"\n  ],\n  \"citation_attributions\": [\n    \"You\",\n    \"Partner\",\n    \"SEO Competitor\",\n    \"Other\"\n  ]\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_citations")
  .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-29\",\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  \"root_domains\": [\n    \"conductor.com\",\n    \"abc.com\"\n  ],\n  \"domains\": [\n    \"blog.conductor.com\",\n    \"about.conductor.com\"\n  ],\n  \"citation_urls\": [\n    \"https://www.conductor.com/blog/conductor-record-enterprise-momentum-ai-search/\",\n    \"https://www.conductor.com/academy/debunking-ai-prompt-volume/\"\n  ],\n  \"citation_attributions\": [\n    \"You\",\n    \"Partner\",\n    \"SEO Competitor\",\n    \"Other\"\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

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

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-29\",\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  \"root_domains\": [\n    \"conductor.com\",\n    \"abc.com\"\n  ],\n  \"domains\": [\n    \"blog.conductor.com\",\n    \"about.conductor.com\"\n  ],\n  \"citation_urls\": [\n    \"https://www.conductor.com/blog/conductor-record-enterprise-momentum-ai-search/\",\n    \"https://www.conductor.com/academy/debunking-ai-prompt-volume/\"\n  ],\n  \"citation_attributions\": [\n    \"You\",\n    \"Partner\",\n    \"SEO Competitor\",\n    \"Other\"\n  ]\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",
      "best AEO and GEO platforms",
      "best AEO and GEO platforms 2026 - complete guide",
      "unbranded",
      "Educational",
      "broad audience",
      "Conductor | The Leading Organic Marketing Platform",
      "https://www.conductor.com/",
      "conductor.com",
      "blog.conductor.com",
      "you",
      "true",
      "true"
    ]
  ],
  "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": "citation_title",
      "type": "string"
    },
    {
      "name": "citation_url",
      "type": "string"
    },
    {
      "name": "citation_domain",
      "type": "string"
    },
    {
      "name": "citation_web_property_segment",
      "type": "string"
    },
    {
      "name": "citation_attribution",
      "type": "string"
    },
    {
      "name": "ai_response_collected",
      "type": "boolean"
    },
    {
      "name": "web_search_triggered",
      "type": "boolean"
    }
  ],
  "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:e6ab4daf-c25b-4a9d-d8e4-bf7b5caa3d26",
  "requestId": "7b5fbc42-ad6a-4e8b-cf4c-9abc5b7eac63"
}

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

Authorizations

Authorization

string

header

required

Conductor API token, sent as Bearer cond_<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.

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

web_property_ids

integer[]

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

Required range: x >= 1

Example:

[122556, 987654]

ai_search_engines

string[]

(Optional) list of AI engines to filter.

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).

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).

Required string length: 2 - 7

Example:

["en_US", "hant_TW"]

topics

string[]

(Optional) list of topics to filter.

Example:

[
  "marketing automation",
  "website optimization"
]

prompts

string[]

(Optional) list of prompts to filter.

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.

Example:

["Education", "Purchase"]

personas

string[]

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

Example:

["young adults", "developers"]

root_domains

string[]

(Optional) list of root domains to filter.

Example:

["conductor.com", "abc.com"]

domains

string[]

(Optional) list of domains to filter (e.g., blog.conductor.com).

Example:

["blog.conductor.com", "about.conductor.com"]

citation_urls

string[]

(Optional) list of citation URLs to filter.

Example:

[
  "https://www.conductor.com/blog/conductor-record-enterprise-momentum-ai-search/",
  "https://www.conductor.com/academy/debunking-ai-prompt-volume/"
]

citation_attributions

string[]

(Optional) list of citation ownership to filter (case-insensitive).

Example:

["You", "Partner", "SEO Competitor", "Other"]

Response

Query completed successfully

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 Citation results. Column order matches the schema metadata. All values are returned as strings.

Minimum array length: 24

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.
FAILED: The query failed. Check the error message if available.

Available options:

IN_PROGRESS,

COMPLETED,

FAILED

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

AI Search - Brands

AI Search - Response

⌘I