DataForSEO AiOptimization API

openapi: 3.2.0
info:
  title: DataForSEO AI Optimization API
  description: DataForSEO API is the starting point on your journey towards building powerful SEO software. With DataForSEO you can get all the data you need to build an efficient application while also saving your time and budget. DataForSEO API is using the REST technology for interchanging data between your application and our service. The data exchange is made through the widely used HTTP protocol, which allows applying our API to almost all programming languages.
  version: 1.0.0
servers:
- url: https://api.dataforseo.com
- url: https://sandbox.dataforseo.com
tags:
- name: AiOptimization
paths:
  /v3/ai_optimization/chat_gpt/llm_scraper/locations:
    get:
      tags:
      - AiOptimization
      description: 'You will receive the list of locations by this API call. You can filter the list of locations by country when setting a task.

        for more info please visit ''https://docs.dataforseo.com/v3/ai_optimization/chat_gpt/llm_scraper/locations/?bash'''
      operationId: ChatGptLlmScraperLocations
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                type:
                - object
                - 'null'
                oneOf:
                - $ref: '#/components/schemas/AiOptimizationChatGptLlmScraperLocationsResponseInfo'
      security:
      - basicAuth: []
  /v3/ai_optimization/chat_gpt/llm_scraper/locations/{country}:
    get:
      tags:
      - AiOptimization
      description: 'You will receive the list of locations by this API call. You can filter the list of locations by country when setting a task.

        for more info please visit ''https://docs.dataforseo.com/v3/ai_optimization/chat_gpt/llm_scraper/locations/?bash'''
      operationId: ChatGptLlmScraperLocationsCountry
      parameters:
      - name: country
        in: path
        description: country ISO codeoptional fieldspecify the ISO code if you want to filter the list of locations by countryexample:us
        required: true
        schema:
          type: string
        example: us
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                type:
                - object
                - 'null'
                oneOf:
                - $ref: '#/components/schemas/AiOptimizationChatGptLlmScraperLocationsCountryResponseInfo'
      security:
      - basicAuth: []
  /v3/ai_optimization/chat_gpt/llm_scraper/languages:
    get:
      tags:
      - AiOptimization
      description: 'You will receive the list of languages by calling this API.

        for more info please visit ''https://docs.dataforseo.com/v3/ai_optimization/chat_gpt/llm_scraper/languages/?bash'''
      operationId: ChatGptLlmScraperLanguages
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                type:
                - object
                - 'null'
                oneOf:
                - $ref: '#/components/schemas/AiOptimizationChatGptLlmScraperLanguagesResponseInfo'
      security:
      - basicAuth: []
  /v3/ai_optimization/chat_gpt/llm_scraper/task_post:
    post:
      tags:
      - AiOptimization
      description: 'ChatGPT LLM Scraper API provides results from ChatGPT searches. The results are specific to the selected location (see the List of Locations) and language (see the List of Languages) parameters.

        for more info please visit ''https://docs.dataforseo.com/v3/ai_optimization/chat_gpt/llm_scraper/task_post/?bash'''
      operationId: ChatGptLlmScraperTaskPost
      requestBody:
        content:
          application/json:
            schema:
              type: array
              items:
                type:
                - object
                - 'null'
                oneOf:
                - $ref: '#/components/schemas/AiOptimizationChatGptLlmScraperTaskPostRequestInfo'
              example:
              - language_code: en
                location_code: 2840
                keyword: what is chatgpt
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                type:
                - object
                - 'null'
                oneOf:
                - $ref: '#/components/schemas/AiOptimizationChatGptLlmScraperTaskPostResponseInfo'
      security:
      - basicAuth: []
  /v3/ai_optimization/chat_gpt/llm_scraper/tasks_ready:
    get:
      tags:
      - AiOptimization
      description: 'The ‘Tasks Ready’ endpoint is designed to provide you with the list of completed tasks, which haven’t been collected yet. If you use the Standard method without specifying the postback_url, you can receive the list of id for all completed tasks using this endpoint. Then, you can collect the results using the ‘Task GET’ endpoint.

        Learn more about task completion and obtaining a list of completed tasks in this help center article.

        for more info please visit ''https://docs.dataforseo.com/v3/ai_optimization/chat_gpt/llm_scraper/tasks_ready/?bash'''
      operationId: ChatGptLlmScraperTasksReady
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                type:
                - object
                - 'null'
                oneOf:
                - $ref: '#/components/schemas/AiOptimizationChatGptLlmScraperTasksReadyResponseInfo'
      security:
      - basicAuth: []
  /v3/ai_optimization/chat_gpt/llm_scraper/task_get/advanced/{id}:
    get:
      tags:
      - AiOptimization
      description: 'Description of the fields for sending a request:

        for more info please visit ''https://docs.dataforseo.com/v3/ai_optimization/chat_gpt/llm_scraper/task_get/advanced/?bash'''
      operationId: ChatGptLlmScraperTaskGetAdvanced
      parameters:
      - name: id
        in: path
        description: task identifiera universally unique identifier (UUID)unique task identifier in our systemyou will be able to use it within 30 days to request the results of the task at any time
        required: true
        schema:
          type: string
        example: 00000000-0000-0000-0000-000000000000
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                type:
                - object
                - 'null'
                oneOf:
                - $ref: '#/components/schemas/AiOptimizationChatGptLlmScraperTaskGetAdvancedResponseInfo'
      security:
      - basicAuth: []
  /v3/ai_optimization/chat_gpt/llm_scraper/task_get/html/{id}:
    get:
      tags:
      - AiOptimization
      description: 'Description of the fields for sending a request:

        for more info please visit ''https://docs.dataforseo.com/v3/ai_optimization/chat_gpt/llm_scraper/task_get/html/?bash'''
      operationId: ChatGptLlmScraperTaskGetHtml
      parameters:
      - name: id
        in: path
        description: task identifierunique task identifier in our system in the UUID formatyou will be able to use it within 7 days to request the results of the task at any time
        required: true
        schema:
          type: string
        example: 00000000-0000-0000-0000-000000000000
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                type:
                - object
                - 'null'
                oneOf:
                - $ref: '#/components/schemas/AiOptimizationChatGptLlmScraperTaskGetHtmlResponseInfo'
      security:
      - basicAuth: []
  /v3/ai_optimization/chat_gpt/llm_scraper/live/advanced:
    post:
      tags:
      - AiOptimization
      description: 'Live ChatGPT LLM Scraper endpoint provides results from ChatGPT searches. The results are specific to the selected location (see the List of Locations) and language (see the List of Languages) parameters.

        for more info please visit ''https://docs.dataforseo.com/v3/ai_optimization/chat_gpt/llm_scraper/live/advanced/'''
      operationId: ChatGptLlmScraperLiveAdvanced
      requestBody:
        content:
          application/json:
            schema:
              type: array
              items:
                type:
                - object
                - 'null'
                oneOf:
                - $ref: '#/components/schemas/AiOptimizationChatGptLlmScraperLiveAdvancedRequestInfo'
              example:
              - language_code: en
                location_code: 2840
                keyword: albert einstein
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                type:
                - object
                - 'null'
                oneOf:
                - $ref: '#/components/schemas/AiOptimizationChatGptLlmScraperLiveAdvancedResponseInfo'
      security:
      - basicAuth: []
  /v3/ai_optimization/chat_gpt/llm_scraper/live/html:
    post:
      tags:
      - AiOptimization
      description: 'Live ChatGPT LLM Scraper API HTML provides a raw HTML page of the results for the specified keyword, language, and location.

        for more info please visit ''https://docs.dataforseo.com/v3/ai_optimization/chat_gpt/llm_scraper/live/html/'''
      operationId: ChatGptLlmScraperLiveHtml
      requestBody:
        content:
          application/json:
            schema:
              type: array
              items:
                type:
                - object
                - 'null'
                oneOf:
                - $ref: '#/components/schemas/AiOptimizationChatGptLlmScraperLiveHtmlRequestInfo'
              example:
              - language_code: en
                location_code: 2840
                keyword: albert einstein
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                type:
                - object
                - 'null'
                oneOf:
                - $ref: '#/components/schemas/AiOptimizationChatGptLlmScraperLiveHtmlResponseInfo'
      security:
      - basicAuth: []
  /v3/ai_optimization/llm_mentions/locations_and_languages:
    get:
      tags:
      - AiOptimization
      description: 'Using this endpoint you can get the full list of locations and languages supported in AI Optimization LLM Mentions API.

        for more info please visit ''https://docs.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages/'''
      operationId: LlmMentionsLocationsAndLanguages
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                type:
                - object
                - 'null'
                oneOf:
                - $ref: '#/components/schemas/AiOptimizationLlmMentionsLocationsAndLanguagesResponseInfo'
      security:
      - basicAuth: []
  /v3/ai_optimization/llm_mentions/available_filters:
    get:
      tags:
      - AiOptimization
      description: 'Here you will find all the necessary information about filters that can be used with AI Optimization LLM Mentions API endpoints.

        for more info please visit ''https://docs.dataforseo.com/v3/ai_optimization/llm_mentions/filters/'''
      operationId: LlmMentionsAvailableFilters
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                type:
                - object
                - 'null'
                oneOf:
                - $ref: '#/components/schemas/AiOptimizationLlmMentionsAvailableFiltersResponseInfo'
      security:
      - basicAuth: []
  /v3/ai_optimization/llm_mentions/search/live:
    post:
      tags:
      - AiOptimization
      description: 'Live LLM Mentions Search endpoint provides mention data and related metrics from AI searches. The results are specific to the selected platform (google for Google’s  AI Overview or chat_gpt for ChatGPT), as well as location and language parameters (see the List of Locations & Languages).

        for more info please visit ''https://docs.dataforseo.com/v3/ai_optimization/llm_mentions/search/live/'''
      operationId: LlmMentionsSearchLive
      requestBody:
        content:
          application/json:
            schema:
              type: array
              items:
                type:
                - object
                - 'null'
                oneOf:
                - $ref: '#/components/schemas/AiOptimizationLlmMentionsSearchLiveRequestInfo'
              example:
              - language_name: English
                location_code: 2840
                target:
                - domain: dataforseo.com
                  search_filter: exclude
                - keyword: bmw
                  search_scope:
                  - answer
                platform: google
                filters:
                - - ai_search_volume
                  - '>'
                  - 1000
                order_by:
                - ai_search_volume,desc
                offset: 0
                limit: 3
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                type:
                - object
                - 'null'
                oneOf:
                - $ref: '#/components/schemas/AiOptimizationLlmMentionsSearchLiveResponseInfo'
      security:
      - basicAuth: []
  /v3/ai_optimization/llm_mentions/top_pages/live:
    post:
      tags:
      - AiOptimization
      description: 'Live LLM Mentions Top Pages endpoint provides aggregated LLM mentions metrics grouped by the most frequently mentioned pages for the specified target. The results are specific to the selected platform (google for Google’s  AI Overview or chat_gpt for ChatGPT), location and language parameters (see the List of Locations & Languages).

        for more info please visit ''https://docs.dataforseo.com/v3/ai_optimization/llm_mentions/top_pages/live/'''
      operationId: LlmMentionsTopPagesLive
      requestBody:
        content:
          application/json:
            schema:
              type: array
              items:
                type:
                - object
                - 'null'
                oneOf:
                - $ref: '#/components/schemas/AiOptimizationLlmMentionsTopPagesLiveRequestInfo'
              example:
              - language_code: en
                location_code: 2840
                platform: google
                target:
                - keyword: bmw
                  search_scope:
                  - answer
                - keyword: auto
                  search_scope:
                  - question
                  match_type: partial_match
                links_scope: sources
                initial_dataset_filters:
                - - ai_search_volume
                  - '>'
                  - 10
                items_list_limit: 3
                internal_list_limit: 2
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                type:
                - object
                - 'null'
                oneOf:
                - $ref: '#/components/schemas/AiOptimizationLlmMentionsTopPagesLiveResponseInfo'
      security:
      - basicAuth: []
  /v3/ai_optimization/llm_mentions/top_domains/live:
    post:
      tags:
      - AiOptimization
      description: 'Live LLM Mentions Top Domains endpoint provides aggregated LLM mentions metrics grouped by the most frequently mentioned domains for the specified target. The results are specific to the selected platform (google for Google’s  AI Overview or chat_gpt for ChatGPT), location and language parameters (see the List of Locations & Languages).

        for more info please visit ''https://docs.dataforseo.com/v3/ai_optimization/llm_mentions/top_domains/live/'''
      operationId: LlmMentionsTopDomainsLive
      requestBody:
        content:
          application/json:
            schema:
              type: array
              items:
                type:
                - object
                - 'null'
                oneOf:
                - $ref: '#/components/schemas/AiOptimizationLlmMentionsTopDomainsLiveRequestInfo'
              example:
              - language_code: en
                location_code: 2840
                platform: chat_gpt
                target:
                - keyword: bmw
                  search_scope:
                  - answer
                - keyword: auto
                  search_scope:
                  - question
                  match_type: partial_match
                links_scope: sources
                initial_dataset_filters:
                - - ai_search_volume
                  - '>'
                  - 10
                items_list_limit: 3
                internal_list_limit: 2
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                type:
                - object
                - 'null'
                oneOf:
                - $ref: '#/components/schemas/AiOptimizationLlmMentionsTopDomainsLiveResponseInfo'
      security:
      - basicAuth: []
  /v3/ai_optimization/llm_mentions/aggregated_metrics/live:
    post:
      tags:
      - AiOptimization
      description: 'Live LLM Mentions endpoint provides aggregated metrics for mentions of the keywords or domains specified in the target array of the request. The results are specific to the selected platform (google for Google’s  AI Overview or chat_gpt for ChatGPT), location and language parameters (see the List of Locations & Languages).

        for more info please visit ''https://docs.dataforseo.com/v3/ai_optimization/llm_mentions/aggregated_metrics/live/'''
      operationId: LlmMentionsAggregatedMetricsLive
      requestBody:
        content:
          application/json:
            schema:
              type: array
              items:
                type:
                - object
                - 'null'
                oneOf:
                - $ref: '#/components/schemas/AiOptimizationLlmMentionsAggregatedMetricsLiveRequestInfo'
              example:
              - language_code: es
                location_code: 2840
                platform: google
                target:
                - domain: en.wikipedia.org
                  search_filter: exclude
                - keyword: bmw
                  search_scope:
                  - answer
                initial_dataset_filters:
                - - ai_search_volume
                  - '>'
                  - 10
                internal_list_limit: 10
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                type:
                - object
                - 'null'
                oneOf:
                - $ref: '#/components/schemas/AiOptimizationLlmMentionsAggregatedMetricsLiveResponseInfo'
      security:
      - basicAuth: []
  /v3/ai_optimization/llm_mentions/cross_aggregated_metrics/live:
    post:
      tags:
      - AiOptimization
      description: 'Live LLM Mentions endpoint provides aggregated metrics grouped by custom keys for mentions of the keywords or domains specified in the target array of the request. Each item in the results array corresponds to the specified target. The results are specific to the selected platform (google for Google’s  AI Overview or chat_gpt for ChatGPT), location and language parameters (see the List of Locations & Languages).

        for more info please visit ''https://docs.dataforseo.com/v3/ai_optimization/llm_mentions/cross_aggregated_metrics/live/'''
      operationId: LlmMentionsCrossAggregatedMetricsLive
      requestBody:
        content:
          application/json:
            schema:
              type: array
              items:
                type:
                - object
                - 'null'
                oneOf:
                - $ref: '#/components/schemas/AiOptimizationLlmMentionsCrossAggregatedMetricsLiveRequestInfo'
              example:
              - language_code: en
                location_code: 2840
                platform: google
                targets:
                - aggregation_key: chat_gpt
                  target:
                  - keyword: chat gpt
                - aggregation_key: claude
                  target:
                  - keyword: claude
                - aggregation_key: gemini
                  target:
                  - keyword: gemini
                - aggregation_key: perplexity
                  target:
                  - keyword: perplexity
                    search_filter: include
                initial_dataset_filters:
                - - ai_search_volume
                  - '>'
                  - 10
                internal_list_limit: 5
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                type:
                - object
                - 'null'
                oneOf:
                - $ref: '#/components/schemas/AiOptimizationLlmMentionsCrossAggregatedMetricsLiveResponseInfo'
      security:
      - basicAuth: []
  /v3/ai_optimization/chat_gpt/llm_responses/models:
    get:
      tags:
      - AiOptimization
      description: 'You will receive the list of available Chat GPT AI models by calling this API.

         

        As a response of the API server, you will receive JSON-encoded data containing a tasks array with the information specific to the set tasks.

        for more info please visit ''https://docs.dataforseo.com/v3/ai_optimization/chat_gpt/llm_responses/models/'''
      operationId: ChatGptLlmResponsesModels
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                type:
                - object
                - 'null'
                oneOf:
                - $ref: '#/components/schemas/AiOptimizationChatGptLlmResponsesModelsResponseInfo'
      security:
      - basicAuth: []
  /v3/ai_optimization/chat_gpt/llm_responses/live:
    post:
      tags:
      - AiOptimization
      description: 'Live ChatGPT LLM Responses endpoint allows you to retrieve structured responses from a specific ChatGPT AI model, based on the input parameters.

        for more info please visit ''https://docs.dataforseo.com/v3/ai_optimization/chat_gpt/llm_responses/live/'''
      operationId: ChatGptLlmResponsesLive
      requestBody:
        content:
          application/json:
            schema:
              type: array
              items:
                type:
                - object
                - 'null'
                oneOf:
                - $ref: '#/components/schemas/AiOptimizationChatGptLlmResponsesLiveRequestInfo'
              example:
              - system_message: communicate as if we are in a business meeting
                message_chain:
                - role: user
                  message: Hello, what’s up?
                - role: ai
                  message: Hello! I’m doing well, thank you. How can I assist you today? Are there any specific topics or projects you’d like to discuss in our meeting?
                max_output_tokens: 200
                temperature: 0.3
                top_p: 0.5
                model_name: gpt-4.1-mini
                web_search: true
                web_search_country_iso_code: FR
                web_search_city: Paris
                user_prompt: provide information on how relevant the amusement park business is in France now
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                type:
                - object
                - 'null'
                oneOf:
                - $ref: '#/components/schemas/AiOptimizationChatGptLlmResponsesLiveResponseInfo'
      security:
      - basicAuth: []
  /v3/ai_optimization/chat_gpt/llm_responses/task_post:
    post:
      tags:
      - AiOptimization
      description: 'ChatGPT LLM Responses endpoint allows you to retrieve structured responses from a specific ChatGPT model, based on the input parameters.

        for more info please visit ''https://docs.dataforseo.com/v3/ai_optimization/chat_gpt/llm_responses/task_post/'''
      operationId: ChatGptLlmResponsesTaskPost
      requestBody:
        content:
          application/json:
            schema:
              type: array
              items:
                type:
                - object
                - 'null'
                oneOf:
                - $ref: '#/components/schemas/AiOptimizationChatGptLlmResponsesTaskPostRequestInfo'
              example:
              - system_message: communicate as if we are in a business meeting
                message_chain:
                - role: user
                  message: Hello, what’s up?
                - role: ai
                  message: Hello! I’m doing well, thank you. How can I assist you today? Are there any specific topics or projects you’d like to discuss in our meeting?
                model_name: gpt-4.1-mini
                user_prompt: provide information on how relevant the amusement park business is in France now
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                type:
                - object
                - 'null'
                oneOf:
                - $ref: '#/components/schemas/AiOptimizationChatGptLlmResponsesTaskPostResponseInfo'
      security:
      - basicAuth: []
  /v3/ai_optimization/chat_gpt/llm_responses/tasks_ready:
    get:
      tags:
      - AiOptimization
      description: 'This endpoint is designed to provide you with a list of completed tasks, which haven’t been collected yet. If you use the Standard method without specifying the postback_url, you can receive the list of id for all completed tasks using this endpoint. Then, you can collect the results using the ‘Task GET’ endpoint.

        for more info please visit ''https://docs.dataforseo.com/v3/ai_optimization/chat_gpt/llm_responses/tasks_ready/'''
      operationId: ChatGptLlmResponsesTasksReady
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                type:
                - object
                - 'null'
                oneOf:
                - $ref: '#/components/schemas/AiOptimizationChatGptLlmResponsesTasksReadyResponseInfo'
      security:
      - basicAuth: []
  /v3/ai_optimization/chat_gpt/llm_responses/task_get/{id}:
    get:
      tags:
      - AiOptimization
      description: 'Chat GPT LLM Responses endpoint allows you to retrieve structured responses from a specific Chat GPT model, based on the input parameters.

        for more info please visit ''https://docs.dataforseo.com/v3/ai_optimization/chat_gpt/llm_responses/task_get/'''
      operationId: ChatGptLlmResponsesTaskGet
      parameters:
      - name: id
        in: path
        description: task identifierunique task identifier in our system in the UUID formatyou will be able to use it within 30 days to request the results of the task at any time
        required: true
        schema:
          type: string
        example: 00000000-0000-0000-0000-000000000000
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                type:
                - object
                - 'null'
                oneOf:
                - $ref: '#/components/schemas/AiOptimizationChatGptLlmResponsesTaskGetResponseInfo'
      security:
      - basicAuth: []
  /v3/ai_optimization/claude/llm_responses/models:
    get:
      tags:
      - AiOptimization
      description: 'You will receive the list of available Claude AI models by calling this API.

         

        As a response of the API server, you will receive JSON-encoded data containing a tasks array with the information specific to the set tasks.

        for more info please visit ''https://docs.dataforseo.com/v3/ai_optimization/claude/llm_responses/models/'''
      operationId: ClaudeLlmResponsesModels
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                type:
                - object
                - 'null'
                oneOf:
                - $ref: '#/components/schemas/AiOptimizationClaudeLlmResponsesModelsResponseInfo'
      security:
      - basicAuth: []
  /v3/ai_optimization/claude/llm_responses/live:
    post:
      tags:
      - AiOptimization
      description: 'Live Claude LLM Responses endpoint allows you to retrieve structured responses from a specific Claude model, based on the input parameters.

        for more info please visit ''https://docs.dataforseo.com/v3/ai_optimization/claude/llm_responses/live/'''
      operationId: ClaudeLlmResponsesLive
      requestBody:
        content:
          application/json:
            schema:
              type: array
              items:
                type:
                - object
                - 'null'
                oneOf:
                - $ref: '#/components/schemas/AiOptimizationClaudeLlmResponsesLiveRequestInfo'
              example:
              - system_message: communicate as if we are in a business meeting
                message_chain:
                - role: user
                  message: Hello, what’s up?
                - role: ai
                  message: Hello! I’m doing well, thank you. How can I assist you today? Are there any specific topics or projects you’d like to discuss in our meeting?
                max_output_tokens: 200
                model_name: claude-opus-4-0
                temperature: 0.3
                web_search: true
                web_search_country_iso_code: FR
                user_prompt: provide information on how relevant the amusement park business is in France now
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                type:
                - object
                - 'null'
                oneOf:
                - $ref: '#/components/schemas/AiOptimizationClaudeLlmResponsesLiveResponseInfo'
      security:
      - basicAuth: []
  /v3/ai_optimization/claude/llm_responses/task_post:
    post:
      tags:
      - AiOptimization
      description: 'Claude LLM Responses endpoint allows you to retrieve structured responses from a specific Claude model, based on the input parameters.

        for more info please visit ''https://docs.dataforseo.com/v3/ai_optimization/claude/llm_responses/task_post/'''
      operationId: ClaudeLlmResponsesTaskPost
      requestBody:
        content:
          application/json:
            schema:
              type: array
              items:
                type:
                - object
                - 'null'
                oneOf:
                - $ref: '#/components/schemas/AiOptimizationClaudeLlmResponsesTaskPostRequestInfo'
              example:
              - system_message: communicate as if we are in a business meeting
                message_chain:
                - role: user
                  message: Hello, what’s up?
                - role: ai
                  message: Hello! I’m doing well, thank you. How can I assist you today? Are there any specific topics or projects you’d like to discuss in our meeting?
                max_output_tokens: 1024
                temperature: 0.3
                web_search_country_iso_code: FR
                model_name: claude-sonnet-4-0
                web_search: true
                user_prompt: provide information on how relevant the amusement park business is in France now
      responses:
        '200':
          descrip

# --- truncated at 32 KB (276 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/dataforseo/refs/heads/main/openapi/dataforseo-aioptimization-api-openapi.yml