How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

DataForSEO AiOptimization API

The AiOptimization API from DataForSEO — 44 operation(s) for aioptimization.

DataForSEO AiOptimization API is one of 12 APIs that DataForSEO publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

This API exposes 1 JSON Schema definition.

Tagged areas include AI Optimization. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, and 1 JSON Schema.

This API exposes 44 operations across 44 paths, and defines 173 schemas. It is described by OpenAPI 3.2.0, at version 1.0.0.

Requests are made against 2 base URLs: https://api.dataforseo.com, https://sandbox.dataforseo.com.

44 operations 44 paths 173 schemas 25 GET19 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
1.0.0
Base URL
https://api.dataforseo.com
Authentication
HTTP Basic
Resource Areas
1

Authentication & Security 1

DataForSEO AiOptimization API declares 1 security scheme for authenticating requests. It accepts HTTP basic authentication (basicAuth).

Paths & Operations 44

Across 44 paths, the API surfaces 44 operations — 25 GET, 19 POST. Each is listed below with its method, path, parameters, and response codes.

AiOptimization 44
GET
/v3/ai_optimization/chat_gpt/llm_scraper/locations
Chat gpt llm scraper locations
ChatGptLlmScraperLocations → 200
GET
/v3/ai_optimization/chat_gpt/llm_scraper/locations/{country}
Chat gpt llm scraper locations country
ChatGptLlmScraperLocationsCountry 1 param → 200
GET
/v3/ai_optimization/chat_gpt/llm_scraper/languages
Chat gpt llm scraper languages
ChatGptLlmScraperLanguages → 200
POST
/v3/ai_optimization/chat_gpt/llm_scraper/task_post
Chat gpt llm scraper task post
ChatGptLlmScraperTaskPost body → 200
GET
/v3/ai_optimization/chat_gpt/llm_scraper/tasks_ready
Chat gpt llm scraper tasks ready
ChatGptLlmScraperTasksReady → 200
GET
/v3/ai_optimization/chat_gpt/llm_scraper/task_get/advanced/{id}
Chat gpt llm scraper task get advanced
ChatGptLlmScraperTaskGetAdvanced 1 param → 200
GET
/v3/ai_optimization/chat_gpt/llm_scraper/task_get/html/{id}
Chat gpt llm scraper task get html
ChatGptLlmScraperTaskGetHtml 1 param → 200
POST
/v3/ai_optimization/chat_gpt/llm_scraper/live/advanced
Chat gpt llm scraper live advanced
ChatGptLlmScraperLiveAdvanced body → 200
POST
/v3/ai_optimization/chat_gpt/llm_scraper/live/html
Chat gpt llm scraper live html
ChatGptLlmScraperLiveHtml body → 200
GET
/v3/ai_optimization/llm_mentions/locations_and_languages
Llm mentions locations and languages
LlmMentionsLocationsAndLanguages → 200
GET
/v3/ai_optimization/llm_mentions/available_filters
Llm mentions available filters
LlmMentionsAvailableFilters → 200
POST
/v3/ai_optimization/llm_mentions/search/live
Llm mentions search live
LlmMentionsSearchLive body → 200
POST
/v3/ai_optimization/llm_mentions/top_pages/live
Llm mentions top pages live
LlmMentionsTopPagesLive body → 200
POST
/v3/ai_optimization/llm_mentions/top_domains/live
Llm mentions top domains live
LlmMentionsTopDomainsLive body → 200
POST
/v3/ai_optimization/llm_mentions/aggregated_metrics/live
Llm mentions aggregated metrics live
LlmMentionsAggregatedMetricsLive body → 200
POST
/v3/ai_optimization/llm_mentions/cross_aggregated_metrics/live
Llm mentions cross aggregated metrics live
LlmMentionsCrossAggregatedMetricsLive body → 200
GET
/v3/ai_optimization/chat_gpt/llm_responses/models
Chat gpt llm responses models
ChatGptLlmResponsesModels → 200
POST
/v3/ai_optimization/chat_gpt/llm_responses/live
Chat gpt llm responses live
ChatGptLlmResponsesLive body → 200
POST
/v3/ai_optimization/chat_gpt/llm_responses/task_post
Chat gpt llm responses task post
ChatGptLlmResponsesTaskPost body → 200
GET
/v3/ai_optimization/chat_gpt/llm_responses/tasks_ready
Chat gpt llm responses tasks ready
ChatGptLlmResponsesTasksReady → 200
GET
/v3/ai_optimization/chat_gpt/llm_responses/task_get/{id}
Chat gpt llm responses task get
ChatGptLlmResponsesTaskGet 1 param → 200
GET
/v3/ai_optimization/claude/llm_responses/models
Claude llm responses models
ClaudeLlmResponsesModels → 200
POST
/v3/ai_optimization/claude/llm_responses/live
Claude llm responses live
ClaudeLlmResponsesLive body → 200
POST
/v3/ai_optimization/claude/llm_responses/task_post
Claude llm responses task post
ClaudeLlmResponsesTaskPost body → 200
GET
/v3/ai_optimization/claude/llm_responses/tasks_ready
Claude llm responses tasks ready
ClaudeLlmResponsesTasksReady → 200
GET
/v3/ai_optimization/claude/llm_responses/task_get/{id}
Claude llm responses task get
ClaudeLlmResponsesTaskGet 1 param → 200
GET
/v3/ai_optimization/gemini/llm_responses/models
Gemini llm responses models
GeminiLlmResponsesModels → 200
POST
/v3/ai_optimization/gemini/llm_responses/task_post
Gemini llm responses task post
GeminiLlmResponsesTaskPost body → 200
GET
/v3/ai_optimization/gemini/llm_responses/tasks_ready
Gemini llm responses tasks ready
GeminiLlmResponsesTasksReady → 200
GET
/v3/ai_optimization/gemini/llm_responses/task_get/{id}
Gemini llm responses task get
GeminiLlmResponsesTaskGet 1 param → 200
POST
/v3/ai_optimization/gemini/llm_responses/live
Gemini llm responses live
GeminiLlmResponsesLive body → 200
GET
/v3/ai_optimization/gemini/llm_scraper/locations
Gemini llm scraper locations
GeminiLlmScraperLocations → 200
GET
/v3/ai_optimization/gemini/llm_scraper/languages
Gemini llm scraper languages
GeminiLlmScraperLanguages → 200
POST
/v3/ai_optimization/gemini/llm_scraper/task_post
Gemini llm scraper task post
GeminiLlmScraperTaskPost body → 200
GET
/v3/ai_optimization/gemini/llm_scraper/tasks_ready
Gemini llm scraper tasks ready
GeminiLlmScraperTasksReady → 200
GET
/v3/ai_optimization/gemini/llm_scraper/task_get/advanced/{id}
Gemini llm scraper task get advanced
GeminiLlmScraperTaskGetAdvanced 1 param → 200
GET
/v3/ai_optimization/gemini/llm_scraper/task_get/html/{id}
Gemini llm scraper task get html
GeminiLlmScraperTaskGetHtml 1 param → 200
POST
/v3/ai_optimization/gemini/llm_scraper/live/advanced
Gemini llm scraper live advanced
GeminiLlmScraperLiveAdvanced body → 200
POST
/v3/ai_optimization/gemini/llm_scraper/live/html
Gemini llm scraper live html
GeminiLlmScraperLiveHtml body → 200
GET
/v3/ai_optimization/perplexity/llm_responses/models
Perplexity llm responses models
PerplexityLlmResponsesModels → 200
POST
/v3/ai_optimization/perplexity/llm_responses/live
Perplexity llm responses live
PerplexityLlmResponsesLive body → 200
GET
/v3/ai_optimization/ai_keyword_data/available_filters
Ai keyword data available filters
AiKeywordDataAvailableFilters → 200
GET
/v3/ai_optimization/ai_keyword_data/locations_and_languages
Ai keyword data locations and languages
AiKeywordDataLocationsAndLanguages → 200
POST
/v3/ai_optimization/ai_keyword_data/keywords_search_volume/live
Ai keyword data keywords search volume live
AiKeywordDataKeywordsSearchVolumeLive body → 200

Schemas 173

The contract defines 173 schemas that model the data the API accepts and returns. The most detailed are AiOptimizationLlmMentionsSearchLiveRequestInfo (20 properties), AiOptimizationLlmMentionsTopDomainsLiveRequestInfo (19 properties), AiOptimizationLlmMentionsCrossAggregatedMetricsLiveRequestInfo (19 properties), AiOptimizationLlmMentionsTopPagesLiveRequestInfo (19 properties). Each schema is shown below with its type and property counts.

AiOptimizationGeminiLlmScraperTaskGetHtmlTaskInfo
object
AiOptimizationAiKeywordDataAvailableFiltersResultInfo
object
1 property
AiOptimizationLlmMentionsAvailableFiltersResponseInfo
object
AiOptimizationGeminiLlmScraperTasksReadyResultInfo
object
7 properties
AiOptimizationGeminiLlmScraperTaskPostResponseInfo
object
AiOptimizationClaudeLlmResponsesLiveTaskInfo
object
AiOptimizationAiKeywordDataAvailableFiltersResponseInfo
object
AiOptimizationGeminiLlmResponsesTaskPostTaskInfo
object
AiOptimizationGeminiLlmScraperTaskGetHtmlResponseInfo
object
AiOptimizationGeminiLlmResponsesTaskGetTaskInfo
object
AiOptimizationLlmMentionsAggregatedMetricsLiveResponseInfo
object
AiOptimizationGeminiLlmResponsesTaskGetResponseInfo
object
AiOptimizationGeminiLlmScraperTaskGetHtmlResultInfo
object
6 properties
AiOptimizationGeminiLlmScraperLanguagesResponseInfo
object
AiOptimizationAiKeywordDataLocationsAndLanguagesResponseInfo
object
AiOptimizationClaudeLlmResponsesTaskGetResponseInfo
object
AiOptimizationGeminiLlmScraperLiveAdvancedResultInfo
object
11 properties
AiOptimizationGeminiLlmScraperLiveHtmlTaskInfo
object
AiOptimizationAiKeywordDataKeywordsSearchVolumeLiveItem
object
3 properties
AiOptimizationChatGptLlmResponsesTaskPostTaskInfo
object
AiOptimizationGeminiLlmScraperLanguagesResultInfo
object
2 properties
AiOptimizationChatGptLlmResponsesTaskPostResponseInfo
object
ResultAvailableLanguages
object
4 properties
ChatgptSearchResult
object
6 properties
AiOptimizationGeminiLlmScraperLiveAdvancedResponseInfo
object
AiOptimizationGeminiLlmScraperTaskGetAdvancedResultInfo
object
11 properties
AiOptimizationLlmMentionsTopDomainsLiveRequestInfo
object
19 properties
AiOptimizationChatGptLlmScraperTasksReadyTaskInfo
object
AiOptimizationChatGptLlmResponsesTasksReadyResultInfo
object
6 properties
AiOptimizationClaudeLlmResponsesTaskPostResponseInfo
object
AiOptimizationClaudeLlmResponsesModelsResponseInfo
object
AiOptimizationLlmMentionsSearchLiveResultInfo
object
5 properties
AiOptimizationGeminiLlmScraperTaskGetAdvancedResponseInfo
object
AiOptimizationGeminiLlmResponsesModelsTaskInfo
object
AiOptimizationClaudeLlmResponsesTaskGetTaskInfo
object
SourceInfo
object
9 properties
AiOptimizationChatGptLlmScraperLiveAdvancedRequestInfo
object
7 properties
AiOptimizationChatGptLlmScraperTaskGetHtmlResponseInfo
object
AiOptimizationGeminiLlmScraperTaskGetAdvancedTaskInfo
object
AiOptimizationPerplexityLlmResponsesModelsResultInfo
object
3 properties
AiOptimizationAiKeywordDataKeywordsSearchVolumeLiveResponseInfo
object
AiOptimizationGeminiLlmResponsesTaskGetResultInfo
object
9 properties
AiOptimizationGeminiLlmResponsesModelsResponseInfo
object
AiOptimizationGeminiLlmResponsesLiveRequestInfo
object
10 properties
HtmlItemInfo
object
3 properties
LlmMessageSectionInfo
object
3 properties
AiOptimizationGeminiLlmResponsesModelsResultInfo
object
3 properties
AiOptimizationGeminiLlmScraperTasksReadyTaskInfo
object
AiOptimizationChatGptLlmScraperLocationsResultInfo
object
5 properties
AiOptimizationGeminiLlmScraperLiveHtmlResultInfo
object
6 properties
AiOptimizationLlmMentionsLocationsAndLanguagesResultInfo
object
3 properties
AiOptimizationLlmMentionsCrossAggregatedMetricsLiveRequestInfo
object
19 properties
AiOptimizationChatGptLlmScraperLocationsCountryTaskInfo
object
AiOptimizationClaudeLlmResponsesLiveRequestInfo
object
13 properties
AiOptimizationLlmMentionsCrossAggregatedMetricsLiveResponseInfo
object
AiOptimizationChatGptLlmScraperTaskGetHtmlTaskInfo
object
AiOptimizationLlmMentionsTopPagesLiveResponseInfo
object
AiOptimizationChatGptLlmResponsesTaskGetTaskInfo
object
LlmMessageChainItem
object
2 properties
AiOptimizationClaudeLlmResponsesModelsResultInfo
object
3 properties
MonthlySearchesInfo
object
3 properties
AiOptimizationGeminiLlmScraperLiveAdvancedTaskInfo
object
AiOptimizationGeminiLlmScraperLocationsResponseInfo
object
AiOptimizationChatGptLlmScraperTaskGetAdvancedResultInfo
object
15 properties
AiOptimizationChatGptLlmScraperLocationsResponseInfo
object
AiOptimizationChatGptLlmScraperLiveAdvancedResultInfo
object
15 properties
BrandEntities
object
3 properties
AiOptimizationClaudeLlmResponsesTaskGetResultInfo
object
9 properties
AiOptimizationAiKeywordDataAvailableFiltersTaskInfo
object
AiOptimizationAiKeywordDataKeywordsSearchVolumeLiveTaskInfo
object
AiOptimizationChatGptLlmScraperLiveHtmlResultInfo
object
6 properties
Sources
object
9 properties
AiOptimizationLlmMentionsCrossAggregatedMetricsLiveResultInfo
object
2 properties
AiOptimizationChatGptLlmScraperLocationsCountryResultInfo
object
5 properties
ChatGptBrandEntity
object
5 properties
AiOptimizationPerplexityLlmResponsesLiveTaskInfo
object
AiOptimizationGeminiLlmScraperLanguagesTaskInfo
object
SearchResults
object
7 properties
AiOptimizationChatGptLlmScraperTasksReadyResultInfo
object
8 properties
AiOptimizationChatGptLlmResponsesTaskGetResultInfo
object
9 properties
AiOptimizationGeminiLlmResponsesTaskPostResponseInfo
object
AiOptimizationChatGptLlmScraperLanguagesTaskInfo
object
AiOptimizationLlmMentionsAvailableFiltersResultInfo
object
1 property
AiOptimizationLlmMentionsAggregatedMetricsLiveRequestInfo
object
17 properties
AiOptimizationChatGptLlmResponsesTasksReadyResponseInfo
object
AiOptimizationLlmMentionsSearchLiveTaskInfo
object
AiOptimizationChatGptLlmResponsesLiveResponseInfo
object
AiOptimizationChatGptLlmScraperTaskGetAdvancedTaskInfo
object
AiOptimizationLlmMentionsTopPagesLiveTaskInfo
object
AiOptimizationLlmMentionsTopDomainsLiveResultInfo
object
2 properties
AiOptimizationLlmMentionsAggregatedMetricsLiveTaskInfo
object
AiOptimizationChatGptLlmScraperTaskGetAdvancedResponseInfo
object
AiOptimizationChatGptLlmScraperLiveAdvancedResponseInfo
object
BaseAiOptimizationLLmMentionsTargetElement
object
2 properties
AiOptimizationChatGptLlmResponsesModelsResultInfo
object
3 properties
BaseChatGptLlmScraperElementItem
object
3 properties
AiOptimizationClaudeLlmResponsesTasksReadyTaskInfo
object
AiOptimizationLlmMentionsLocationsAndLanguagesResponseInfo
object
AiOptimizationGeminiLlmScraperLocationsTaskInfo
object
AiOptimizationGeminiLlmScraperLiveHtmlRequestInfo
object
7 properties
AiOptimizationChatGptLlmResponsesLiveResultInfo
object
9 properties
AiOptimizationChatGptLlmResponsesTasksReadyTaskInfo
object
AiOptimizationChatGptLlmScraperTaskPostResponseInfo
object
AiOptimizationPerplexityLlmResponsesModelsTaskInfo
object
AiOptimizationGeminiLlmScraperTaskPostTaskInfo
object
AiOptimizationLlmMentionsSearchLiveResponseInfo
object
AiOptimizationClaudeLlmResponsesLiveResponseInfo
object
AiOptimizationGeminiLlmResponsesLiveResultInfo
object
9 properties
AiOptimizationGeminiLlmResponsesLiveResponseInfo
object
AiOptimizationPerplexityLlmResponsesLiveResponseInfo
object
BaseResponseInfo
object
7 properties
AiOptimizationChatGptLlmScraperLanguagesResultInfo
object
2 properties
AiOptimizationClaudeLlmResponsesLiveResultInfo
object
9 properties
AiOptimizationPerplexityLlmResponsesLiveRequestInfo
object
9 properties
AiOptimizationGeminiLlmScraperLiveHtmlResponseInfo
object
AiOptimizationChatGptLlmScraperTaskGetHtmlResultInfo
object
6 properties
AiOptimizationGeminiLlmResponsesTaskPostRequestInfo
object
12 properties
AiOptimizationGeminiLlmResponsesTasksReadyTaskInfo
object
AiOptimizationClaudeLlmResponsesTasksReadyResultInfo
object
6 properties
AiOptimizationLlmMentionsLocationsAndLanguagesTaskInfo
object
AiOptimizationLlmMentionsSearchLiveRequestInfo
object
20 properties
AiOptimizationGeminiLlmScraperLocationsResultInfo
object
5 properties
AiOptimizationChatGptLlmScraperTaskPostRequestInfo
object
12 properties
AiOptimizationChatGptLlmScraperLocationsCountryResponseInfo
object
AiOptimizationClaudeLlmResponsesTasksReadyResponseInfo
object
AiOptimizationLlmMentionsTopPagesLiveRequestInfo
object
19 properties
AiOptimizationChatGptLlmScraperLiveHtmlResponseInfo
object
GroupElement
object
5 properties
BaseGeminiLlmScraperElementItem
object
4 properties
AiOptimizationClaudeLlmResponsesTaskPostTaskInfo
object
AiOptimizationPerplexityLlmResponsesLiveResultInfo
object
9 properties
AiOptimizationLlmMentionsCrossAggregatedMetricsLiveTaskInfo
object
AiOptimizationLlmMentionsTopDomainsLiveTaskInfo
object
AvailableLanguages
object
5 properties
AiOptimizationGeminiLlmScraperTasksReadyResponseInfo
object
AiOptimizationGeminiLlmResponsesTasksReadyResultInfo
object
6 properties
MessageAiOptimizationLlmResponseElementItem
object
AiOptimizationResultTotalInfo
object
7 properties
AiOptimizationChatGptLlmScraperTaskPostTaskInfo
object
AiOptimizationGeminiLlmScraperTaskPostRequestInfo
object
11 properties
AiOptimizationGeminiLlmScraperLiveAdvancedRequestInfo
object
6 properties
AiOptimizationLlmMentionsTopDomainsLiveResponseInfo
object
AnnotationInfo
object
2 properties
AiOptimizationAiKeywordDataKeywordsSearchVolumeLiveRequestInfo
object
6 properties
AiOptimizationAiKeywordDataKeywordsSearchVolumeLiveResultInfo
object
4 properties
AiOptimizationAiKeywordDataLocationsAndLanguagesResultInfo
object
3 properties
AiOptimizationChatGptLlmResponsesTaskPostRequestInfo
object
10 properties
AiOptimizationChatGptLlmScraperTasksReadyResponseInfo
object
AiMonthlySearches
object
3 properties
AiOptimizationGeminiLlmResponsesLiveTaskInfo
object
AiOptimizationChatGptLlmResponsesModelsTaskInfo
object
BaseResponseTaskInfo
object
8 properties
AiOptimizationClaudeLlmResponsesModelsTaskInfo
object
AiOptimizationClaudeLlmResponsesTaskPostRequestInfo
object
15 properties
AiOptimizationLlmMentionsSearchLiveItem
object
14 properties
AiOptimizationChatGptLlmScraperLanguagesResponseInfo
object
AiOptimizationGeminiLlmResponsesTasksReadyResponseInfo
object
BaseAiOptimizationLlmResponseElementItem
object
1 property
AiOptimizationChatGptLlmResponsesModelsResponseInfo
object
AiOptimizationLlmMentionsTopPagesLiveResultInfo
object
2 properties
AiOptimizationPerplexityLlmResponsesModelsResponseInfo
object
AiOptimizationChatGptLlmScraperLocationsTaskInfo
object
AiOptimizationChatGptLlmScraperLiveAdvancedTaskInfo
object
AiOptimizationLlmMentionsAvailableFiltersTaskInfo
object
AiOptimizationChatGptLlmResponsesTaskGetResponseInfo
object
AiOptimizationChatGptLlmScraperLiveHtmlRequestInfo
object
8 properties
AiOptimizationChatGptLlmResponsesLiveRequestInfo
object
12 properties
AiOptimizationAiKeywordDataLocationsAndLanguagesTaskInfo
object
AiOptimizationChatGptLlmResponsesLiveTaskInfo
object
AiOptimizationLlmMentionsAggregatedMetricsLiveResultInfo
object
2 properties
AiOptimizationLLmMentionsCrossAggregateMetricsTargetInfo
object
2 properties
AiOptimizationLlmMentionssLiveItem
object
8 properties
AiOptimizationChatGptLlmScraperLiveHtmlTaskInfo
object

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

dataforseo-aioptimization-api-openapi.yml Raw ↑

Other APIs DataForSEO publishes across the network.

DataForSEO Appendix API
DataForSEO Backlinks API
DataForSEO BusinessData API
DataForSEO DataforseoLabs API
DataForSEO DomainAnalytics API
DataForSEO KeywordsData API
DataForSEO Merchant API
DataForSEO OnPage API
DataForSEO Serp API
DataForSEO App Data API
DataForSEO Content Analysis API
Where this information came from

This is an independent, third-party profile of DataForSEO AiOptimization API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.