Skip to main content
Glama

AIsa SERP — Google

Live Google Dataset Info Advanced

post_dataforseo_serp_google_dataset_info_live
Destructive

‌ 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.

Usage-based billing; Default request estimate: $0.02 USD (not a fixed price). Account-specific pricing and final settlement may differ.

Input Schema

NameRequiredDescriptionDefault
bodyNo

Output Schema

NameRequiredDescriptionDefault

No arguments

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • changedInput schema / properties / body / items / oneOf
      Previous value: -[
      -  {
      -    "example": [
      -      {
      -        "dataset_id": "L2cvMTFqbl85ZHN6MQ=="
      -      }
      -    ],
      -    "properties": {
      -      "dataset_id": {
      -        "description": "<p><em>ID of the dataset</em><p><strong>required field</strong><p>you can find dataset ID in the dataset URL or <code>dataset</code> item of <a href=\"https://docs.dataforseo.com/v3/serp/google/dataset_search/live/advanced\">Google Dataset Search</a> result<p>example:<p><code>L2cvMTFqbl85ZHN6MQ==</code></p>",
      -        "type": "string"
      -      },
      -      "device": {
      -        "description": "<p><em>device type</em><p>optional field<p>return results for a specific device type<p>possible value: <code>desktop</code></p>",
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "language_code": {
      -        "description": "<p><em>search engine language code</em><p>optional field<p>if you use this field, you don't need to specify <code>language_name</code><p>possible value:<p><code class=\"long-string\">en</code></p>",
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "language_name": {
      -        "description": "<p><em>full name of search engine language</em><p>optional field<p>if you use this field, you don't need to specify <code>language_code</code><p>possible value:<p><code class=\"long-string\">English</code></p>",
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "os": {
      -        "description": "<p><em>device operating system</em><p>optional field<p>possible values: <code>windows</code>, <code>macos</code><p>default value: <code>windows</code></p>",
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "tag": {
      -        "description": "<p><em>user-defined task identifier</em><p>optional field<p><em>the character limit is 255</em><p>you can use this parameter to identify the task and match it with the result<p>you will find the specified <code>tag</code> value in the <code>data</code> object of the response</p>",
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      }
      -    },
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "properties": {
      +      "dataset_id": {
      +        "description": "<p><em>ID of the dataset</em><p><strong>required field</strong><p>you can find dataset ID in the dataset URL or <code>dataset</code> item of <a href=\"https://docs.dataforseo.com/v3/serp/google/dataset_search/live/advanced\">Google Dataset Search</a> result<p>example:<p><code>L2cvMTFqbl85ZHN6MQ==</code></p>",
      +        "type": "string"
      +      },
      +      "device": {
      +        "description": "<p><em>device type</em><p>optional field<p>return results for a specific device type<p>possible value: <code>desktop</code></p>",
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "language_code": {
      +        "description": "<p><em>search engine language code</em><p>optional field<p>if you use this field, you don't need to specify <code>language_name</code><p>possible value:<p><code class=\"long-string\">en</code></p>",
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "language_name": {
      +        "description": "<p><em>full name of search engine language</em><p>optional field<p>if you use this field, you don't need to specify <code>language_code</code><p>possible value:<p><code class=\"long-string\">English</code></p>",
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "os": {
      +        "description": "<p><em>device operating system</em><p>optional field<p>possible values: <code>windows</code>, <code>macos</code><p>default value: <code>windows</code></p>",
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "tag": {
      +        "description": "<p><em>user-defined task identifier</em><p>optional field<p><em>the character limit is 255</em><p>you can use this parameter to identify the task and match it with the result<p>you will find the specified <code>tag</code> value in the <code>data</code> object of the response</p>",
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      }
      +    },
      +    "type": "object"
      +  }
      +]
  2. Changed2 schema fields changed
    • removedInput schema / properties / body / items / anyOf
      Removed value: -[
      -  {
      -    "example": [
      -      {
      -        "dataset_id": "L2cvMTFqbl85ZHN6MQ=="
      -      }
      -    ],
      -    "properties": {
      -      "dataset_id": {
      -        "description": "<p><em>ID of the dataset</em><p><strong>required field</strong><p>you can find dataset ID in the dataset URL or <code>dataset</code> item of <a href=\"https://docs.dataforseo.com/v3/serp/google/dataset_search/live/advanced\">Google Dataset Search</a> result<p>example:<p><code>L2cvMTFqbl85ZHN6MQ==</code></p>",
      -        "type": "string"
      -      },
      -      "device": {
      -        "description": "<p><em>device type</em><p>optional field<p>return results for a specific device type<p>possible value: <code>desktop</code></p>",
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "language_code": {
      -        "description": "<p><em>search engine language code</em><p>optional field<p>if you use this field, you don't need to specify <code>language_name</code><p>possible value:<p><code class=\"long-string\">en</code></p>",
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "language_name": {
      -        "description": "<p><em>full name of search engine language</em><p>optional field<p>if you use this field, you don't need to specify <code>language_code</code><p>possible value:<p><code class=\"long-string\">English</code></p>",
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "os": {
      -        "description": "<p><em>device operating system</em><p>optional field<p>possible values: <code>windows</code>, <code>macos</code><p>default value: <code>windows</code></p>",
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "tag": {
      -        "description": "<p><em>user-defined task identifier</em><p>optional field<p><em>the character limit is 255</em><p>you can use this parameter to identify the task and match it with the result<p>you will find the specified <code>tag</code> value in the <code>data</code> object of the response</p>",
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      }
      -    },
      -    "type": "object"
      -  }
      -]
    • addedInput schema / properties / body / items / oneOf
      Added value: +[
      +  {
      +    "example": [
      +      {
      +        "dataset_id": "L2cvMTFqbl85ZHN6MQ=="
      +      }
      +    ],
      +    "properties": {
      +      "dataset_id": {
      +        "description": "<p><em>ID of the dataset</em><p><strong>required field</strong><p>you can find dataset ID in the dataset URL or <code>dataset</code> item of <a href=\"https://docs.dataforseo.com/v3/serp/google/dataset_search/live/advanced\">Google Dataset Search</a> result<p>example:<p><code>L2cvMTFqbl85ZHN6MQ==</code></p>",
      +        "type": "string"
      +      },
      +      "device": {
      +        "description": "<p><em>device type</em><p>optional field<p>return results for a specific device type<p>possible value: <code>desktop</code></p>",
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "language_code": {
      +        "description": "<p><em>search engine language code</em><p>optional field<p>if you use this field, you don't need to specify <code>language_name</code><p>possible value:<p><code class=\"long-string\">en</code></p>",
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "language_name": {
      +        "description": "<p><em>full name of search engine language</em><p>optional field<p>if you use this field, you don't need to specify <code>language_code</code><p>possible value:<p><code class=\"long-string\">English</code></p>",
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "os": {
      +        "description": "<p><em>device operating system</em><p>optional field<p>possible values: <code>windows</code>, <code>macos</code><p>default value: <code>windows</code></p>",
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "tag": {
      +        "description": "<p><em>user-defined task identifier</em><p>optional field<p><em>the character limit is 255</em><p>you can use this parameter to identify the task and match it with the result<p>you will find the specified <code>tag</code> value in the <code>data</code> object of the response</p>",
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      }
      +    },
      +    "type": "object"
      +  }
      +]
  3. Changed7 schema fields changed
    • addedInput schema / properties / body / example
      Added value: +[
      +  {
      +    "dataset_id": "L2cvMTFqbl85ZHN6MQ=="
      +  }
      +]
    • addedInput schema / properties / body / items / anyOf
      Added value: +[
      +  {
      +    "example": [
      +      {
      +        "dataset_id": "L2cvMTFqbl85ZHN6MQ=="
      +      }
      +    ],
      +    "properties": {
      +      "dataset_id": {
      +        "description": "<p><em>ID of the dataset</em><p><strong>required field</strong><p>you can find dataset ID in the dataset URL or <code>dataset</code> item of <a href=\"https://docs.dataforseo.com/v3/serp/google/dataset_search/live/advanced\">Google Dataset Search</a> result<p>example:<p><code>L2cvMTFqbl85ZHN6MQ==</code></p>",
      +        "type": "string"
      +      },
      +      "device": {
      +        "description": "<p><em>device type</em><p>optional field<p>return results for a specific device type<p>possible value: <code>desktop</code></p>",
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "language_code": {
      +        "description": "<p><em>search engine language code</em><p>optional field<p>if you use this field, you don't need to specify <code>language_name</code><p>possible value:<p><code class=\"long-string\">en</code></p>",
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "language_name": {
      +        "description": "<p><em>full name of search engine language</em><p>optional field<p>if you use this field, you don't need to specify <code>language_code</code><p>possible value:<p><code class=\"long-string\">English</code></p>",
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "os": {
      +        "description": "<p><em>device operating system</em><p>optional field<p>possible values: <code>windows</code>, <code>macos</code><p>default value: <code>windows</code></p>",
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "tag": {
      +        "description": "<p><em>user-defined task identifier</em><p>optional field<p><em>the character limit is 255</em><p>you can use this parameter to identify the task and match it with the result<p>you will find the specified <code>tag</code> value in the <code>data</code> object of the response</p>",
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      }
      +    },
      +    "type": "object"
      +  }
      +]
    • removedInput schema / properties / body / items / properties
      Removed value: -{
      -  "dataset_id": {
      -    "description": "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==",
      -    "type": "string"
      -  },
      -  "device": {
      -    "description": "device type optional field return results for a specific device type possible value: desktop",
      -    "type": "string"
      -  },
      -  "language_code": {
      -    "description": "search engine language code optional field if you use this field, you don't need to specify language_name possible value: en",
      -    "type": "string"
      -  },
      -  "language_name": {
      -    "description": "full name of search engine language optional field if you use this field, you don't need to specify language_code possible value: English",
      -    "type": "string"
      -  }
      -}
    • removedInput schema / properties / body / items / required
      Removed value: -[
      -  "dataset_id"
      -]
    • changedInput schema / properties / body / items / type
      Previous value: -"object"New value: +[
      +  "object",
      +  "null"
      +]
    • changedInput schema / required
      Previous value: -[
      -  "body"
      -]New value: +[]
    • addedOutput schema / x-fastmcp-wrap-result
      Added value: +true
  4. Changed7 schema fields changed
    • removedInput schema / properties / body / example
      Removed value: -[
      -  {
      -    "dataset_id": "L2cvMTFqbl85ZHN6MQ=="
      -  }
      -]
    • removedInput schema / properties / body / items / anyOf
      Removed value: -[
      -  {
      -    "example": [
      -      {
      -        "dataset_id": "L2cvMTFqbl85ZHN6MQ=="
      -      }
      -    ],
      -    "properties": {
      -      "dataset_id": {
      -        "description": "<p><em>ID of the dataset</em><p><strong>required field</strong><p>you can find dataset ID in the dataset URL or <code>dataset</code> item of <a href=\"https://docs.dataforseo.com/v3/serp/google/dataset_search/live/advanced\">Google Dataset Search</a> result<p>example:<p><code>L2cvMTFqbl85ZHN6MQ==</code></p>",
      -        "type": "string"
      -      },
      -      "device": {
      -        "description": "<p><em>device type</em><p>optional field<p>return results for a specific device type<p>possible value: <code>desktop</code></p>",
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "language_code": {
      -        "description": "<p><em>search engine language code</em><p>optional field<p>if you use this field, you don't need to specify <code>language_name</code><p>possible value:<p><code class=\"long-string\">en</code></p>",
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "language_name": {
      -        "description": "<p><em>full name of search engine language</em><p>optional field<p>if you use this field, you don't need to specify <code>language_code</code><p>possible value:<p><code class=\"long-string\">English</code></p>",
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "os": {
      -        "description": "<p><em>device operating system</em><p>optional field<p>possible values: <code>windows</code>, <code>macos</code><p>default value: <code>windows</code></p>",
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      },
      -      "tag": {
      -        "description": "<p><em>user-defined task identifier</em><p>optional field<p><em>the character limit is 255</em><p>you can use this parameter to identify the task and match it with the result<p>you will find the specified <code>tag</code> value in the <code>data</code> object of the response</p>",
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      }
      -    },
      -    "type": "object"
      -  }
      -]
    • addedInput schema / properties / body / items / properties
      Added value: +{
      +  "dataset_id": {
      +    "description": "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==",
      +    "type": "string"
      +  },
      +  "device": {
      +    "description": "device type optional field return results for a specific device type possible value: desktop",
      +    "type": "string"
      +  },
      +  "language_code": {
      +    "description": "search engine language code optional field if you use this field, you don't need to specify language_name possible value: en",
      +    "type": "string"
      +  },
      +  "language_name": {
      +    "description": "full name of search engine language optional field if you use this field, you don't need to specify language_code possible value: English",
      +    "type": "string"
      +  }
      +}
    • addedInput schema / properties / body / items / required
      Added value: +[
      +  "dataset_id"
      +]
    • changedInput schema / properties / body / items / type
      Previous value: -[
      -  "object",
      -  "null"
      -]New value: +"object"
    • changedInput schema / required
      Previous value: -[]New value: +[
      +  "body"
      +]
    • removedOutput schema / x-fastmcp-wrap-result
      Removed value: -true
  5. Changed7 schema fields changed
    • addedInput schema / properties / body / example
      Added value: +[
      +  {
      +    "dataset_id": "L2cvMTFqbl85ZHN6MQ=="
      +  }
      +]
    • addedInput schema / properties / body / items / anyOf
      Added value: +[
      +  {
      +    "example": [
      +      {
      +        "dataset_id": "L2cvMTFqbl85ZHN6MQ=="
      +      }
      +    ],
      +    "properties": {
      +      "dataset_id": {
      +        "description": "<p><em>ID of the dataset</em><p><strong>required field</strong><p>you can find dataset ID in the dataset URL or <code>dataset</code> item of <a href=\"https://docs.dataforseo.com/v3/serp/google/dataset_search/live/advanced\">Google Dataset Search</a> result<p>example:<p><code>L2cvMTFqbl85ZHN6MQ==</code></p>",
      +        "type": "string"
      +      },
      +      "device": {
      +        "description": "<p><em>device type</em><p>optional field<p>return results for a specific device type<p>possible value: <code>desktop</code></p>",
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "language_code": {
      +        "description": "<p><em>search engine language code</em><p>optional field<p>if you use this field, you don't need to specify <code>language_name</code><p>possible value:<p><code class=\"long-string\">en</code></p>",
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "language_name": {
      +        "description": "<p><em>full name of search engine language</em><p>optional field<p>if you use this field, you don't need to specify <code>language_code</code><p>possible value:<p><code class=\"long-string\">English</code></p>",
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "os": {
      +        "description": "<p><em>device operating system</em><p>optional field<p>possible values: <code>windows</code>, <code>macos</code><p>default value: <code>windows</code></p>",
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "tag": {
      +        "description": "<p><em>user-defined task identifier</em><p>optional field<p><em>the character limit is 255</em><p>you can use this parameter to identify the task and match it with the result<p>you will find the specified <code>tag</code> value in the <code>data</code> object of the response</p>",
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      }
      +    },
      +    "type": "object"
      +  }
      +]
    • removedInput schema / properties / body / items / properties
      Removed value: -{
      -  "dataset_id": {
      -    "description": "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==",
      -    "type": "string"
      -  },
      -  "device": {
      -    "description": "device type optional field return results for a specific device type possible value: desktop",
      -    "type": "string"
      -  },
      -  "language_code": {
      -    "description": "search engine language code optional field if you use this field, you don't need to specify language_name possible value: en",
      -    "type": "string"
      -  },
      -  "language_name": {
      -    "description": "full name of search engine language optional field if you use this field, you don't need to specify language_code possible value: English",
      -    "type": "string"
      -  }
      -}
    • removedInput schema / properties / body / items / required
      Removed value: -[
      -  "dataset_id"
      -]
    • changedInput schema / properties / body / items / type
      Previous value: -"object"New value: +[
      +  "object",
      +  "null"
      +]
    • changedInput schema / required
      Previous value: -[
      -  "body"
      -]New value: +[]
    • addedOutput schema / x-fastmcp-wrap-result
      Added value: +true
  6. Changed4 schema fields changed
    • changedInput schema / properties / body / items / properties / dataset_id / description
      Previous value: -"ID of the dataset"New value: +"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=="
    • changedInput schema / properties / body / items / properties / device / description
      Previous value: -"Device type; possible value: desktop"New value: +"device type optional field return results for a specific device type possible value: desktop"
    • changedInput schema / properties / body / items / properties / language_code / description
      Previous value: -"Search engine language code"New value: +"search engine language code optional field if you use this field, you don't need to specify language_name possible value: en"
    • changedInput schema / properties / body / items / properties / language_name / description
      Previous value: -"Full name of search engine language"New value: +"full name of search engine language optional field if you use this field, you don't need to specify language_code possible value: English"
  7. First observed

TDQS

B3.2/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

The pricing block adds genuine behavioral context ($0.02 estimate, usage-based billing, settlement may differ) and the description describes the returned content. However, it never discloses that this is a live POST endpoint keyed on dataset_id, nor how that id is obtained, and there is noticeable tension between the 'provides real-time data' framing and annotations declaring destructiveHint=true / readOnlyHint=false.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Three short, front-loaded sentences that state the purpose before the pricing boilerplate. Minor noise from the stray zero-width character and the HTML-comment wrapper, but nothing that wastes an agent's attention.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

An output schema exists, so return-value detail is not required, and cost is covered. Still missing for a live-fetch endpoint: how to acquire dataset_id, the relationship to the dataset_search sibling, and any indication that a POST body is the calling convention.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Reported schema description coverage is 0% and the description adds no parameter meaning at all (no mention of dataset_id, language_code, device, os, or tag). The nested schema properties do carry their own descriptions and an example, and dataset_id is flagged there as required despite an empty required array — a discrepancy the description could have resolved but does not.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb+resource: retrieves real-time data for a specified Google dataset, enumerating the payload (content, authors, licenses, description) and noting it is displayed separately from the SERP. It never names or contrasts with the obvious sibling post_dataforseo_serp_google_dataset_search_live, so an agent cannot tell which of the two dataset endpoints to pick from the text alone.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No when-to-use guidance, no prerequisites, no alternatives. The only usage-adjacent statement is 'the dataset you specify in the request,' which does not tell the agent under what conditions to choose this over dataset_search or any other SERP endpoint.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources