- 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.
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: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?”
Keyword Search
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?”
AI Search
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?”
Data API
Access to Data API endpoints requires a subscription to Conductor’s Intelligence product.
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?”
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.
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?”
