DataForSEO — Serp / Google / Dataset Info / Live / Advanced

Retrieve serp Google Dataset Info Live Advanced with the DataForSEO API. Review the selected endpoint’s request fields before calling. Use it to audit or monitor a site’s search visibility.

Selected price
$0.002 / callPublished pricing
Sellers / implementations
1 / 1
Requests · 30d
—Loading...
Success rate · 30d
—Loading...

Run sends a real API request. Charges follow the published API contract.

Request parameters
body* array
body[0]* object | null
ID of the dataset required field you can find dataset ID in the dataset URL or dataset item of Google Dataset Search result example: L2cvMTFqbl85ZHN6MQ==
Optional parameters (5)
device type optional field return results for a specific device type possible value: desktop
search engine language code optional field if you use this field, you don't need to specify language_name possible value: en
full name of search engine language optional field if you use this field, you don't need to specify language_code possible value: English
device operating system optional field possible values: windows, macos default value: windows
user-defined task identifier optional field the character limit is 255 you can use this parameter to identify the task and match it with the result you will find the specified tag value in the data object of the response
‌ Live Google Dataset Info provides real-time data on the dataset you specify in the request. You will get data from a page of the dataset displayed separately from the SERP. It contains information about dataset content, authors, licenses, and description on the SERP.

Sample response

{
  "cost": 0.002,
  "status_code": 20000,
  "status_message": "Ok.",
  "tasks": [
    {
      "cost": 0.002,
      "data": {
        "api": "serp",
        "dataset_id": "L2cvMTFqbl85ZHN6MQ==",
        "device": "desktop",
        "function": "live",
        "os": "windows",
        "se": "google",
        "se_type": "dataset_info"
      },
      "id": "01161747-1535-0139-0000-08e4f80efe02",
      "path": [
        "v3",
        "serp",
        "google",
        "dataset_info",
        "live",
        "advanced"
      ],
      "result": [
        {
          "check_url": "https://datasetsearch.research.google.com/search?docid=L2cvMTFqbl85ZHN6MQ%3D%3D&hl=en",
          "datetime": "2023-01-16 15:48:06 +00:00",
          "item_types": [
            "dataset"
          ],
          "items": [
            {
              "area_covered": null,
              "authors": null,
              "dataset_description": {
                "links": [
                  {
                    "description": null,
                    "domain": null,
                    "title": "https://www.canada.ca/environmental-indicators",
                    "type": "link_element",
                    "url": "https://www.google.com/url?q=https%3A%2F%2Fwww.canada.ca%2Fenvironmental-indicators&source=datasetsearch"
                  }
                ],
                "text": "The Canadian Environmental Sustainability Indicators (CESI) program provides data and information to track Canada's performance on key environmental sustainability issues. The Water quality in Canadian rivers indicators provide a measure of the ability of river water across Canada to support plants and animals. At each monitoring site, water quality data are compared to water quality guidelines to create a rating for the site. If measured water quality is below the guidelines, it can maintain a healthy ecosystem. Water quality at a monitoring site is considered excellent when parameters in a river very rarely exceed their guidelines. Conversely, water quality is rated poor when parameters usually exceed their guidelines, sometimes by a wide margin. These indicators provide information about the state of surface water quality and its change through time, to support water resource management. Information is provided to Canadians in a number of formats including: static and interactive maps, charts and graphs, HTML and CSV data tables and downloadable reports. See the supplementary documentation for the data sources and details on how the data were collected and how the indicator was calculated. Supplemental Information Canadian Environmental Sustainability Indicators - Home page: https://www.canada.ca/environmental-indicatorsn"
              },
              "dataset_id": "L2cvMTFqbl85ZHN6MQ==",
              "dataset_providers": [
                {
                  "domain": "www.ec.gc.ca",
                  "title": "Environment and Climate Change Canada",
                  "type": "dataset_providers_element",
                  "url": "http://www.ec.gc.ca/"
                }
              ],
              "formats": [
                {
                  "format": "html",
                  "size": null,
                  "type": "formats_element"
                },
                {
                  "format": "csv",
                  "size": null,
                  "type": "formats_element"
                }
              ],
              "image_url": "https://encrypted-tbn3.gstatic.com/images?q=tbn:ANd9GcRSk0xXK2Wz-UFr7EbQBu8SrSbLPM82jfh3zL_BybsBwBiVnIzF",
              "licenses": [
                {
                  "domain": "open.canada.ca",
                  "title": "Open Government Licence - Canada 2.0",
                  "type": "licenses_element",
                  "url": "https://open.canada.ca/en/open-government-licence-canada"
                }
              ],
              "links": [
                {
                  "description": null,
                  "domain": "open.canada.ca",
                  "title": "canada.ca",
                  "type": "link_element",
                  "url": "http://open.canada.ca/"
                }
              ],
              "period_covered": {
                "displayed_date": "Jan 1, 2002 - Dec 31, 2017",
                "end_date": "2017-12-31 02:00:00 +00:00",
                "start_date": "2002-01-01 02:00:00 +00:00"
              },
              "position": "left",
              "rank_absolute": 1,
              "rank_group": 1,
              "scholarly_citations_count": 1,
              "title": "Water quality in Canadian rivers – Federal data files",
              "type": "dataset",
              "updated_date": "2019-06-24 03:00:00 +00:00",
              "xpath": null
            }
          ],
          "items_count": 1,
          "keyword": "L2cvMTFqbl85ZHN6MQ==",
          "language_code": "en",
          "refinement_chips": null,
          "se_domain": "datasetsearch.research.google.com",
          "se_results_count": 1,
          "spell": null
        }
      ],
      "result_count": 1,
      "status_code": 20000,
      "status_message": "Ok.",
      "time": "12.0367 sec."
    }
  ],
  "tasks_count": 1,
  "tasks_error": 0,
  "time": "12.0954 sec.",
  "version": "0.1.20221214"
}

Response result

Response structure

Inferred from examples
  • costnumber
  • status_codeinteger
  • status_messagestring
  • tasksobject[]
    • costnumber
    • dataobject
      • apistring
      • dataset_idstring
      • devicestring
      • functionstring
      • osstring
      • sestring
      • se_typestring
    • idstring
    • pathstring[]
    • resultobject[]
      • check_urlstring
      • datetimestring
      • item_typesstring[]
      • itemsobject[]
        • area_coverednull
        • authorsnull
        • dataset_descriptionobject
          • linksobject[]
            • descriptionnull
            • domainnull
            • titlestring
            • typestring
            • urlstring
          • textstring
        • dataset_idstring
        • dataset_providersobject[]
          • domainstring
          • titlestring
          • typestring
          • urlstring
        • formatsobject[]
          • formatstring
          • sizenull
          • typestring
        • image_urlstring
        • licensesobject[]
          • domainstring
          • titlestring
          • typestring
          • urlstring
        • linksobject[]
          • descriptionnull
          • domainstring
          • titlestring
          • typestring
          • urlstring
        • period_coveredobject
          • displayed_datestring
          • end_datestring
          • start_datestring
        • positionstring
        • rank_absoluteinteger
        • rank_groupinteger
        • scholarly_citations_countinteger
        • titlestring
        • typestring
        • updated_datestring
        • xpathnull
      • items_countinteger
      • keywordstring
      • language_codestring
      • refinement_chipsnull
      • se_domainstring
      • se_results_countinteger
      • spellnull
    • result_countinteger
    • status_codeinteger
    • status_messagestring
    • timestring
  • tasks_countinteger
  • tasks_errorinteger
  • timestring
  • versionstring

Common questions

Do I need a separate key for every provider?

Use your OpenAny API key for standard API access. Read it from OPENANY_API_KEY in your environment and keep it out of prompts, source code and logs.

Are these providers interchangeable?

No. Each offering has its own inputs, pricing and response contract. Selecting a catalog offering does not establish automatic routing or fallback. Confirm the service contract before calling.

How is this API billed?

API-key calls use your shared balance at the selected implementation's published rate. Check the billing unit and request-specific pricing rules before making a paid call. Recorded usage determines the final charge under that contract.

Where do the price and contract come from?

The selected implementation publishes its provider, request contract, revision and billing rules through OpenAny's public API catalog. A revision number identifies a contract version, not a price update date. A price update timestamp is not supplied; do not treat a page date as one.

How do OpenAny Balance and x402 differ?

OpenAny Balance uses an API key and one shared balance. Card, USDC and x402 top-ups, card auto top-up and USDC subscriptions fund that balance; available routes appear on the Credits page. Direct x402 is a separate pay-per-request flow, available only on listings that show it and requiring an authorized payment client.

Does Playground send a paid request?

Yes. After you sign in, Run sends a real API request using an active OpenAny API key. Charges follow the published API contract and use your shared balance. Selecting an implementation, editing inputs and viewing sample responses do not send requests.

Use DataForSEO — Serp / Google / Dataset Info / Live / Advanced with your agent

Inspect endpoint contracts and confirm availability and pricing before a paid call.