Skip to main content
Conductor’s API gives organizations like yours programmatic access to Conductor’s proprietary search and content intelligence. It is organized into two offerings plus a shared set of configuration endpoints, all of which use a single base URL and authentication model:
  • Data API: integrate traditional and AI search insights directly into your data ecosystem to power custom dashboards, business intelligence tools, and cross-channel reporting.
  • Content API: create drafts, generate insights, and operationalize Conductor’s intelligence inside your content workflows.
  • Configuration: discover the accounts, web properties, and search scope you use to build and filter requests for either offering.
Because everything shares the same base URL and credentials, you can adopt one offering and add the other—or reuse the same configuration calls across both—without re-plumbing your integration.
Conductor provides other APIs for several different uses across its Conductor Monitoring and Conductor Intelligence products. This article describes Conductor’s API (whose Data API offering replaces Conductor Intelligence’s Legacy Reporting API).If you are looking for information about a different API offering, consider the following articles:

Base URL

All requests to Conductor’s API should be made to the following base URL:
https://api.conductor.com
Previously, the Data API used https://api-universal.conductor.com as its base URL. We will continue to support existing connections built on that base URL.

Available resources

Configuration

The configuration endpoints return the building blocks—accounts, web properties, and search scope—you reference when constructing requests to either offering. They are shared across the Data API and Content API.

Web Properties

Retrieve the web properties (domains and sites) configured for an account so you can resolve the IDs you filter requests by. /data-api/v1/async/web_properties_config
  • What it includes: the web properties available to an account and their identifiers
  • Key question it answers: “Which web properties can I query for this account?”

Comparison Web Properties

Retrieve the comparison web property sets—the competitor groupings—available to an account. /data-api/v1/async/comparison_web_properties_config
  • What it includes: the comparison web property sets available to an account and their identifiers
  • Key question it answers: “Which comparison sets can I filter by?”
Retrieve the keyword search scope—keywords, groups, and topics—you can filter traditional search requests by. /data-api/v1/async/keyword_search_config
  • What it includes: the keywords, groups, and topics configured for an account
  • Key question it answers: “Which keywords and groups can I filter by?”
Retrieve the AI search scope—prompts, topics, and related configuration—you can filter AI Search requests by. /data-api/v1/async/ai_search_config
  • What it includes: the prompts, topics, and other AI search scope configured for an account
  • Key question it answers: “Which prompts and topics can I filter AI Search by?”
Explore the shared reference in the Configuration API Reference.

Data API

Access to Data API endpoints requires a subscription to Conductor’s Intelligence product.
The Data API endpoints let you analyze how your brand appears in traditional organic search and in AI-generated search responses across engines like Google, ChatGPT, Perplexity, Google AIO, and more.

AI Search - Brands

Retrieve brand visibility data to understand how often and how prominently your brand appears in AI-generated search responses for your tracked prompts. /data-api/v1/async/ai_search_brands
  • What it includes: brand mention and visibility metrics across AI engines for your tracked prompts
  • Key question it answers: “How visible is my brand in AI-generated search responses?”

AI Search - Citations

Retrieve the sources cited in AI-generated responses so you can see which URLs influence answers for your tracked prompts. /data-api/v1/async/ai_search_citations
  • What it includes: the URLs and sources cited in AI responses for your tracked prompts
  • Key question it answers: “Which sources are AI engines citing for my tracked queries?”

AI Search - Response

Retrieve the full AI response content and related metadata returned for your tracked prompts. /data-api/v1/async/ai_search_response
  • What it includes: AI response content and related metadata for your tracked prompts
  • Key question it answers: “What responses are AI engines returning for my tracked queries?”

AI Search - Sentiments

Retrieve sentiment data to understand how AI-generated responses portray your brand. /data-api/v1/async/ai_search_sentiments
  • What it includes: sentiment scores and classifications for your brand in AI responses
  • Key question it answers: “What sentiment do AI engines express about my brand?”

Keyword Rankings

Retrieve your ranking positions for tracked keywords across traditional search engines. /data-api/v1/async/keyword_rankings
  • What it includes: ranking positions for your tracked keywords across traditional search engines
  • Key question it answers: “Where do my tracked keywords rank in traditional search?”

Highest Ranking URL per Keyword

Retrieve the highest-ranking URL for each tracked keyword to see which pages perform best. /data-api/v1/async/highest_ranking_url_per_keyword
  • What it includes: the highest-ranking URL for each of your tracked keywords
  • Key question it answers: “Which of my URLs ranks highest for each keyword?”
Explore the full Data API reference in the Data API playground.

Content API

Access to Content API endpoints requires a subscription to Conductor’s Creator product. Note that generating drafts with this API will consume the drafts you have allotted to your account.
The Content API endpoints bring Conductor’s intelligence directly into your content production workflows, spanning the full lifecycle from draft to optimized content.

Draft Management

Create, list, retrieve, update, and delete writing-assistant drafts for an account. Use these endpoints to start a content workflow and keep draft metadata and body copy synchronized with your own systems. /v4/accounts/{accountId}/drafts
  • What it includes: draft title, phrases, competitor URLs, rank source, status, and body copy
  • Key question it answers: “Which drafts can I manage or update for this account?”

Content Insights

Request and retrieve AI-driven recommendations for a draft, then update individual insight items based on user decisions. /v4/accounts/{accountId}/drafts/{draftId}/insights
  • What it includes: insight status, snippets, content profile data, and recommendation details
  • Key question it answers: “What optimization opportunities should this draft address?”

Content Generation

Generate or revise outlines, drafts, title tags, meta descriptions, expanded sections, and shortened text through a single mode-based endpoint. /v4/accounts/{accountId}/drafts/{draftId}/content-generations
  • What it includes: generation modes for outlines, drafts, revisions, metadata, text expansion, and text shortening
  • Key question it answers: “What content asset should Conductor generate for this draft?”

Content Guidance

Validate draft content against Content Guidance recommendations. /v4/accounts/{accountId}/drafts/{draftId}/validate
  • What it includes: content guidance insights for title, meta description, and body copy
  • Key question it answers: “How well does this content satisfy Content Guidance recommendations?”

Content Score

Request a full content score across intent alignment and topical coverage. /v4/accounts/{accountId}/drafts/{draftId}/content-score
  • What it includes: overall score, intent alignment, topical coverage, and improvement priorities
  • Key question it answers: “How well does this content satisfy audience expectations?”

Content Profiles

Create, list, retrieve, update, and delete reusable voice, tone, and language-rule profiles for an account. /v4/accounts/{accountId}/content-profiles
  • What it includes: profile name, description, voice and tone guidance, audience, and language rules
  • Key question it answers: “Which brand voice profile should content generation use?”

Internal Linking

Get anchor text and URL recommendations for internal links based on a customer’s embedded pages. /v4/accounts/{accountId}/internal-link-recommendations
  • What it includes: recommended anchor text and target URLs for a submitted block of text
  • Key question it answers: “Which internal links should this content include?”

SERP Analysis

Retrieve SERP URLs for multiple queries so you can understand the competitive pages shaping a topic. /v4/accounts/{accountId}/serp-urls
  • What it includes: ranked URLs for each submitted query
  • Key question it answers: “Which pages are ranking for the topics I want to analyze?”
Explore the full Content API reference in the Content API playground.

Developer playground

You can test calls to Conductor’s API right from the docs. See Using the playground to learn how to authenticate and send requests, then explore the Configuration, Data API, and Content API endpoints.