DataForSEO Serp API

openapi: 3.0.1
info:
  title: DataForSEO AiOptimization Serp 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: Serp
paths:
  /v3/serp/id_list:
    post:
      tags:
      - Serp
      description: 'This endpoint is designed to provide you with a list of IDs and metadata for all SERP tasks created within the specified time period, including both successful and uncompleted tasks.

        for more info please visit ''https://docs.dataforseo.com/v3/serp/id_list/?bash'''
      operationId: IdList
      requestBody:
        content:
          application/json:
            schema:
              type: array
              items:
                type: object
                oneOf:
                - $ref: '#/components/schemas/SerpIdListRequestInfo'
                nullable: true
              example:
              - datetime_from: '2026-04-12 04:39:39 +00:00'
                datetime_to: '2026-04-14 04:39:39 +00:00'
                limit: 100
                offset: 0
                sort: desc
                include_metadata: true
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                type: object
                oneOf:
                - $ref: '#/components/schemas/SerpIdListResponseInfo'
                nullable: true
      security:
      - basicAuth: []
  /v3/serp/errors:
    post:
      tags:
      - Serp
      description: 'By calling this endpoint you will receive information about the SERP API tasks that returned an error within the past 7 days.

        for more info please visit ''https://docs.dataforseo.com/v3/serp/errors/?bash'''
      operationId: Errors
      requestBody:
        content:
          application/json:
            schema:
              type: array
              items:
                type: object
                oneOf:
                - $ref: '#/components/schemas/SerpErrorsRequestInfo'
                nullable: true
              example:
              - limit: 10
                offset: 0
                filtered_function: pingback_url
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                type: object
                oneOf:
                - $ref: '#/components/schemas/SerpErrorsResponseInfo'
                nullable: true
      security:
      - basicAuth: []
  /v3/serp/screenshot:
    post:
      tags:
      - Serp
      description: 'Using the Live Page Screenshot endpoint, you can capture a screenshot of any SERP page.

        for more info please visit ''https://docs.dataforseo.com/v3/serp/screenshot/?bash'''
      operationId: Screenshot
      requestBody:
        content:
          application/json:
            schema:
              type: array
              items:
                type: object
                oneOf:
                - $ref: '#/components/schemas/SerpScreenshotRequestInfo'
                nullable: true
              example:
              - task_id: 06211235-0696-0139-1000-36727fbd3c90
                browser_screen_scale_factor: 0.5
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                type: object
                oneOf:
                - $ref: '#/components/schemas/SerpScreenshotResponseInfo'
                nullable: true
      security:
      - basicAuth: []
  /v3/serp/ai_summary:
    post:
      tags:
      - Serp
      description: 'The purpose of the Live SERP API AI Summary endpoint is to provide a summary of the content found on any SERP and generate a response based on the user’s specified prompt.

        To obtain results, you have to specify task_id, which you can find in the response to the POST request.

        Learn more in our Help Center.

        for more info please visit ''https://docs.dataforseo.com/v3/serp/ai_summary/?bash'''
      operationId: AiSummary
      requestBody:
        content:
          application/json:
            schema:
              type: array
              items:
                type: object
                oneOf:
                - $ref: '#/components/schemas/SerpAiSummaryRequestInfo'
                nullable: true
              example:
              - task_id: 07031739-1535-0139-0000-9d1e639a5b7d
                prompt: explain what DataForSEO is
                include_links: true
                fetch_content: true
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                type: object
                oneOf:
                - $ref: '#/components/schemas/SerpAiSummaryResponseInfo'
                nullable: true
      security:
      - basicAuth: []
  /v3/serp/google/locations:
    get:
      tags:
      - Serp
      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/serp/google/locations/?bash'''
      operationId: GoogleLocations
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                type: object
                oneOf:
                - $ref: '#/components/schemas/SerpGoogleLocationsResponseInfo'
                nullable: true
      security:
      - basicAuth: []
  /v3/serp/google/locations/{country}:
    get:
      tags:
      - Serp
      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/serp/google/locations/?bash'''
      operationId: GoogleLocationsCountry
      parameters:
      - name: country
        in: path
        description: 'country ISO code

          optional field

          specify the ISO code if you want to filter the list of locations by country

          example:

          us'
        required: true
        schema:
          type: string
        example: us
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                type: object
                oneOf:
                - $ref: '#/components/schemas/SerpGoogleLocationsCountryResponseInfo'
                nullable: true
      security:
      - basicAuth: []
  /v3/serp/google/languages:
    get:
      tags:
      - Serp
      description: 'You will receive the list of languages by calling this API.

        for more info please visit ''https://docs.dataforseo.com/v3/serp/google/languages/?bash'''
      operationId: GoogleLanguages
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                type: object
                oneOf:
                - $ref: '#/components/schemas/SerpGoogleLanguagesResponseInfo'
                nullable: true
      security:
      - basicAuth: []
  /v3/serp/google/organic/task_post:
    post:
      tags:
      - Serp
      description: 'SERP API provides top 10 search engine results by default. These results are specific to the selected location (see the List of Locations) and language (see the List of Languages) settings.

        for more info please visit ''https://docs.dataforseo.com/v3/serp/google/organic/task_post/?bash'''
      operationId: GoogleOrganicTaskPost
      requestBody:
        content:
          application/json:
            schema:
              type: array
              items:
                type: object
                oneOf:
                - $ref: '#/components/schemas/SerpGoogleOrganicTaskPostRequestInfo'
                nullable: true
              example:
              - language_code: en
                location_code: 2840
                keyword: albert einstein
              - language_name: English
                location_name: United States
                keyword: albert einstein
                priority: 2
                tag: some_string_123
                pingback_url: https://your-server.com/pingscript?id=$id&tag=$tag
              - url: https://www.google.co.uk/search?q=albert%20einstein&hl=en&gl=GB&uule=w+CAIQIFISCXXeIa8LoNhHEZkq1d1aOpZS
                postback_data: html
                postback_url: https://your-server.com/postbackscript
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                type: object
                oneOf:
                - $ref: '#/components/schemas/SerpGoogleOrganicTaskPostResponseInfo'
                nullable: true
      security:
      - basicAuth: []
  /v3/serp/google/organic/tasks_ready:
    get:
      tags:
      - Serp
      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/serp/google/organic/tasks_ready/?bash'''
      operationId: GoogleOrganicTasksReady
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                type: object
                oneOf:
                - $ref: '#/components/schemas/SerpGoogleOrganicTasksReadyResponseInfo'
                nullable: true
      security:
      - basicAuth: []
  /v3/serp/tasks_ready:
    get:
      tags:
      - Serp
      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/serp/google/organic/tasks_ready/?bash'''
      operationId: TasksReady
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                type: object
                oneOf:
                - $ref: '#/components/schemas/SerpTasksReadyResponseInfo'
                nullable: true
      security:
      - basicAuth: []
  /v3/serp/google/organic/tasks_fixed:
    get:
      tags:
      - Serp
      description: 'The ‘Tasks Fixed’ endpoint is designed to provide you with the list of re-parsed 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 re-parsed tasks using this endpoint. Then, you can re-collect the fixed results using the ‘Task GET’ endpoint.

        for more info please visit ''https://docs.dataforseo.com/v3/serp/google/organic/tasks_fixed/?bash'''
      operationId: GoogleOrganicTasksFixed
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                type: object
                oneOf:
                - $ref: '#/components/schemas/SerpGoogleOrganicTasksFixedResponseInfo'
                nullable: true
      security:
      - basicAuth: []
  /v3/serp/google/organic/task_get/regular/{id}:
    get:
      tags:
      - Serp
      description: 'Description of the fields for sending a request:

        for more info please visit ''https://docs.dataforseo.com/v3/serp/google/organic/task_get/regular/?bash'''
      operationId: GoogleOrganicTaskGetRegular
      parameters:
      - name: id
        in: path
        description: 'task identifier

          unique task identifier in our system in the UUID format

          you 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
                oneOf:
                - $ref: '#/components/schemas/SerpGoogleOrganicTaskGetRegularResponseInfo'
                nullable: true
      security:
      - basicAuth: []
  /v3/serp/google/organic/task_get/advanced/{id}:
    get:
      tags:
      - Serp
      description: 'Description of the fields for sending a request:

        for more info please visit ''https://docs.dataforseo.com/v3/serp/google/organic/task_get/advanced/?bash'''
      operationId: GoogleOrganicTaskGetAdvanced
      parameters:
      - name: id
        in: path
        description: 'task identifier

          unique task identifier in our system in the UUID format

          you 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
                oneOf:
                - $ref: '#/components/schemas/SerpGoogleOrganicTaskGetAdvancedResponseInfo'
                nullable: true
      security:
      - basicAuth: []
  /v3/serp/google/organic/task_get/html/{id}:
    get:
      tags:
      - Serp
      description: 'Description of the fields for sending a request:

        for more info please visit ''https://docs.dataforseo.com/v3/serp/google/organic/task_get/html/?bash'''
      operationId: GoogleOrganicTaskGetHtml
      parameters:
      - name: id
        in: path
        description: 'task identifier

          unique task identifier in our system in the UUID format

          you 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
                oneOf:
                - $ref: '#/components/schemas/SerpGoogleOrganicTaskGetHtmlResponseInfo'
                nullable: true
      security:
      - basicAuth: []
  /v3/serp/google/organic/live/regular:
    post:
      tags:
      - Serp
      description: 'Live SERP provides real-time data on search engine results for the specified keyword, search engine, and location.

        for more info please visit ''https://docs.dataforseo.com/v3/serp/google/organic/live/regular/?bash'''
      operationId: GoogleOrganicLiveRegular
      requestBody:
        content:
          application/json:
            schema:
              type: array
              items:
                type: object
                oneOf:
                - $ref: '#/components/schemas/SerpGoogleOrganicLiveRegularRequestInfo'
                nullable: true
              example:
              - language_code: en
                location_code: 2840
                keyword: albert einstein
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                type: object
                oneOf:
                - $ref: '#/components/schemas/SerpGoogleOrganicLiveRegularResponseInfo'
                nullable: true
      security:
      - basicAuth: []
  /v3/serp/google/organic/live/advanced:
    post:
      tags:
      - Serp
      description: 'Live SERP provides real-time data on top search engine results for the specified keyword, search engine, and location. This endpoint will supply a complete overview of featured snippets and other extra elements of SERPs.

        for more info please visit ''https://docs.dataforseo.com/v3/serp/google/organic/live/advanced/?bash'''
      operationId: GoogleOrganicLiveAdvanced
      requestBody:
        content:
          application/json:
            schema:
              type: array
              items:
                type: object
                oneOf:
                - $ref: '#/components/schemas/SerpGoogleOrganicLiveAdvancedRequestInfo'
                nullable: true
              example:
              - language_code: en
                location_code: 2840
                keyword: albert einstein
                calculate_rectangles: true
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                type: object
                oneOf:
                - $ref: '#/components/schemas/SerpGoogleOrganicLiveAdvancedResponseInfo'
                nullable: true
      security:
      - basicAuth: []
  /v3/serp/google/organic/live/html:
    post:
      tags:
      - Serp
      description: 'Live SERP HTML provides a raw HTML page of search engine results for the specified keyword, search engine, and location.

        for more info please visit ''https://docs.dataforseo.com/v3/serp/google/organic/live/html/?bash'''
      operationId: GoogleOrganicLiveHtml
      requestBody:
        content:
          application/json:
            schema:
              type: array
              items:
                type: object
                oneOf:
                - $ref: '#/components/schemas/SerpGoogleOrganicLiveHtmlRequestInfo'
                nullable: true
              example:
              - language_code: en
                location_code: 2840
                keyword: albert einstein
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                type: object
                oneOf:
                - $ref: '#/components/schemas/SerpGoogleOrganicLiveHtmlResponseInfo'
                nullable: true
      security:
      - basicAuth: []
  /v3/serp/google/ai_mode/languages:
    get:
      tags:
      - Serp
      description: 'You will receive the list of languages 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/serp/google/ai_mode/languages/?bash'''
      operationId: GoogleAiModeLanguages
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                type: object
                oneOf:
                - $ref: '#/components/schemas/SerpGoogleAiModeLanguagesResponseInfo'
                nullable: true
      security:
      - basicAuth: []
  /v3/serp/google/ai_mode/task_post:
    post:
      tags:
      - Serp
      description: 'Google AI Mode SERP API provides search results from the AI Mode feature of Google Search.

        for more info please visit ''https://docs.dataforseo.com/v3/serp/google/ai_mode/task_post/?bash'''
      operationId: GoogleAiModeTaskPost
      requestBody:
        content:
          application/json:
            schema:
              type: array
              items:
                type: object
                oneOf:
                - $ref: '#/components/schemas/SerpGoogleAiModeTaskPostRequestInfo'
                nullable: true
              example:
              - language_code: en
                location_code: 2840
                keyword: what is google ai mode
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                type: object
                oneOf:
                - $ref: '#/components/schemas/SerpGoogleAiModeTaskPostResponseInfo'
                nullable: true
      security:
      - basicAuth: []
  /v3/serp/google/ai_mode/tasks_ready:
    get:
      tags:
      - Serp
      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/serp/google/ai_mode/tasks_ready/?bash'''
      operationId: GoogleAiModeTasksReady
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                type: object
                oneOf:
                - $ref: '#/components/schemas/SerpGoogleAiModeTasksReadyResponseInfo'
                nullable: true
      security:
      - basicAuth: []
  /v3/serp/google/ai_mode/tasks_fixed:
    get:
      tags:
      - Serp
      description: 'The ‘Tasks Fixed’ endpoint is designed to provide you with the list of re-parsed 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 re-parsed tasks using this endpoint. Then, you can re-collect the fixed results using the ‘Task GET’ endpoint.

        for more info please visit ''https://docs.dataforseo.com/v3/serp/google/ai_mode/tasks_fixed/?bash'''
      operationId: GoogleAiModeTasksFixed
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                type: object
                oneOf:
                - $ref: '#/components/schemas/SerpGoogleAiModeTasksFixedResponseInfo'
                nullable: true
      security:
      - basicAuth: []
  /v3/serp/google/ai_mode/task_get/advanced/{id}:
    get:
      tags:
      - Serp
      description: 'Description of the fields for sending a request:

        for more info please visit ''https://docs.dataforseo.com/v3/serp/google/ai_mode/task_get/advanced/?bash'''
      operationId: GoogleAiModeTaskGetAdvanced
      parameters:
      - name: id
        in: path
        description: 'task identifier

          a universally unique identifier (UUID)

          unique task identifier in our system

          you 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
                oneOf:
                - $ref: '#/components/schemas/SerpGoogleAiModeTaskGetAdvancedResponseInfo'
                nullable: true
      security:
      - basicAuth: []
  /v3/serp/google/ai_mode/task_get/html/{id}:
    get:
      tags:
      - Serp
      description: 'Description of the fields for sending a request:

        for more info please visit ''https://docs.dataforseo.com/v3/serp/google/ai_mode/task_get/html/?bash'''
      operationId: GoogleAiModeTaskGetHtml
      parameters:
      - name: id
        in: path
        description: 'task identifier

          unique task identifier in our system in the UUID format

          you 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
                oneOf:
                - $ref: '#/components/schemas/SerpGoogleAiModeTaskGetHtmlResponseInfo'
                nullable: true
      security:
      - basicAuth: []
  /v3/serp/google/ai_mode/live/advanced:
    post:
      tags:
      - Serp
      description: 'Google AI Mode SERP API provides search results from the AI Mode feature of Google Search.

        for more info please visit ''https://docs.dataforseo.com/v3/serp/google/ai_mode/live/advanced/?bash'''
      operationId: GoogleAiModeLiveAdvanced
      requestBody:
        content:
          application/json:
            schema:
              type: array
              items:
                type: object
                oneOf:
                - $ref: '#/components/schemas/SerpGoogleAiModeLiveAdvancedRequestInfo'
                nullable: true
              example:
              - language_code: en
                location_code: 2840
                keyword: what is google ai mode
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                type: object
                oneOf:
                - $ref: '#/components/schemas/SerpGoogleAiModeLiveAdvancedResponseInfo'
                nullable: true
      security:
      - basicAuth: []
  /v3/serp/google/ai_mode/live/html:
    post:
      tags:
      - Serp
      description: 'Live SERP HTML provides a raw HTML page of 100 search engine results for the specified keyword, search engine, and location.

        for more info please visit ''https://docs.dataforseo.com/v3/serp/google/ai_mode/live/html/?bash'''
      operationId: GoogleAiModeLiveHtml
      requestBody:
        content:
          application/json:
            schema:
              type: array
              items:
                type: object
                oneOf:
                - $ref: '#/components/schemas/SerpGoogleAiModeLiveHtmlRequestInfo'
                nullable: true
              example:
              - language_code: en
                location_code: 2840
                keyword: albert einstein
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                type: object
                oneOf:
                - $ref: '#/components/schemas/SerpGoogleAiModeLiveHtmlResponseInfo'
                nullable: true
      security:
      - basicAuth: []
  /v3/serp/google/maps/task_post:
    post:
      tags:
      - Serp
      description: 'SERP API provides top 100 search engine results. These results are specific to the selected location (see the List of Locations) and language (see the List of Languages) settings.

        for more info please visit ''https://docs.dataforseo.com/v3/serp/google/maps/task_post/?bash'''
      operationId: GoogleMapsTaskPost
      requestBody:
        content:
          application/json:
            schema:
              type: array
              items:
                type: object
                oneOf:
                - $ref: '#/components/schemas/SerpGoogleMapsTaskPostRequestInfo'
                nullable: true
              example:
              - language_code: en
                location_code: 2840
                keyword: albert einstein
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                type: object
                oneOf:
                - $ref: '#/components/schemas/SerpGoogleMapsTaskPostResponseInfo'
                nullable: true
      security:
      - basicAuth: []
  /v3/serp/google/maps/tasks_ready:
    get:
      tags:
      - Serp
      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/serp/google/maps/tasks_ready/?bash'''
      operationId: GoogleMapsTasksReady
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                type: object
                oneOf:
                - $ref: '#/components/schemas/SerpGoogleMapsTasksReadyResponseInfo'
                nullable: true
      security:
      - basicAuth: []
  /v3/serp/google/maps/tasks_fixed:
    get:
      tags:
      - Serp
      description: 'The ‘Tasks Fixed’ endpoint is designed to provide you with the list of re-parsed 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 re-parsed tasks using this endpoint. Then, you can re-collect the fixed results using the ‘Task GET’ endpoint.

        for more info please visit ''https://docs.dataforseo.com/v3/serp/google/maps/tasks_fixed/?bash'''
      operationId: GoogleMapsTasksFixed
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                type: object
                oneOf:
                - $ref: '#/components/schemas/SerpGoogleMapsTasksFixedResponseInfo'
                nullable: true
      security:
      - basicAuth: []
  /v3/serp/google/maps/task_get/advanced/{id}:
    get:
      tags:
      - Serp
      description: 'Description of the fields for sending a request:

        for more info please visit ''https://docs.dataforseo.com/v3/serp/google/maps/task_get/advanced/?bash'''
      operationId: GoogleMapsTaskGetAdvanced
      parameters:
      - name: id
        in: path
        description: 'task identifier

          a universally unique identifier (UUID)

          unique task identifier in our system

          you 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
                oneOf:
                - $ref: '#/components/schemas/SerpGoogleMapsTaskGetAdvancedResponseInfo'
                nullable: true
      security:
      - basicAuth: []
  /v3/serp/google/maps/live/advanced:
    post:
      tags:
      - Serp
      description: 'Live Google Maps SERP provides real-time data on top 100 search engine results for the specified keyword, search engine, and location.

        for more info please visit ''https://docs.dataforseo.com/v3/serp/google/maps/live/advanced/?bash'''
      operationId: GoogleMapsLiveAdvanced
      requestBody:
        content:
          application/json:
            schema:
              type: array
              items:
                type: object
                oneOf:
                - $ref: '#/components/schemas/SerpGoogleMapsLiveAdvancedRequestInfo'
                nullable: true
              example:
              - language_code: en
                location_code: 2840
                keyword: albert einstein
      responses:
        '200':
          description: Successful operation
          content:
            applicatio

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