AI Optimization top_mentioned_domains live

$0.103 per callanswers within 60s

Top_mentioned_domains live via DataForSEO AI Optimization. One task per call, priced by the vendor's own rate card; an empty result set is reported as no result.

Contract snapshot: 2026-09-29. Inspect in Glasser for current terms.

json

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "location_code",
    "language_code",
    "limit",
    "target"
  ],
  "properties": {
    "tag": {
      "type": "string",
      "maxLength": 2048,
      "minLength": 1
    },
    "limit": {
      "type": "integer",
      "maximum": 20,
      "minimum": 1
    },
    "offset": {
      "type": "integer",
      "maximum": 10000,
      "minimum": 0
    },
    "target": {
      "type": "array",
      "items": {
        "anyOf": [
          {
            "type": "object",
            "required": [
              "domain"
            ],
            "properties": {
              "domain": {
                "type": "string",
                "pattern": "^(?!https?:\\/\\/)(?!www\\.)[a-z0-9.-]+$",
                "maxLength": 63,
                "minLength": 1
              },
              "search_scope": {
                "type": "array",
                "items": {
                  "enum": [
                    "any",
                    "sources",
                    "search_results"
                  ],
                  "type": "string"
                },
                "maxItems": 3,
                "minItems": 1
              },
              "search_filter": {
                "enum": [
                  "include",
                  "exclude"
                ],
                "type": "string"
              },
              "include_subdomains": {
                "type": "boolean"
              }
            },
            "additionalProperties": false
          },
          {
            "type": "object",
            "required": [
              "keyword"
            ],
            "properties": {
              "keyword": {
                "type": "string",
                "maxLength": 250,
                "minLength": 1
              },
              "match_type": {
                "enum": [
                  "word_match",
                  "partial_match"
                ],
                "type": "string"
              },
              "search_scope": {
                "type": "array",
                "items": {
                  "enum": [
                    "any",
                    "question",
                    "answer",
                    "brand_entities",
                    "fan_out_queries"
                  ],
                  "type": "string"
                },
                "maxItems": 5,
                "minItems": 1
              },
              "search_filter": {
                "enum": [
                  "include",
                  "exclude"
                ],
                "type": "string"
              }
            },
            "additionalProperties": false
          }
        ]
      },
      "maxItems": 10,
      "minItems": 1
    },
    "platform": {
      "type": "string",
      "maxLength": 2048,
      "minLength": 1
    },
    "links_scope": {
      "type": "string",
      "maxLength": 2048,
      "minLength": 1
    },
    "language_code": {
      "type": "string",
      "maxLength": 2048,
      "minLength": 1
    },
    "location_code": {
      "type": "integer"
    },
    "exclude_domains": {
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 2048,
        "minLength": 1
      },
      "maxItems": 100,
      "minItems": 1
    },
    "include_domains": {
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 2048,
        "minLength": 1
      },
      "maxItems": 100,
      "minItems": 1
    },
    "internal_list_limit": {
      "type": "integer"
    }
  },
  "additionalProperties": false
}

json

{
  "limit": 20,
  "target": [
    {
      "keyword": "bmw",
      "search_scope": [
        "answer"
      ]
    }
  ],
  "language_code": "en",
  "location_code": 2840
}

How to run it

Two fields identify it: the Provider and the endpoint key. The key looks like a path because it usually mirrors the Provider's own, but it is an opaque identifier — not a URL you can open. The same provider:endpoint pair is what your Policy lists.

Once: paste this into your agent's chat. The Skill installs the CLI and logs in by itself. For an agent that cannot use a shell, connect it over MCP instead.

Setup prompt

set up https://glasser.ai/SKILL.md

Then ask for this Endpoint:

Agent prompt

Run the DataForSEO Endpoint /v3/ai_optimization/llm_mentions/top_mentioned_domains/live on Glasser with input {"limit":20,"target":[{"keyword":"bmw","search_scope":["answer"]}],"language_code":"en","location_code":2840}

bash

glasser run -p dataforseo -e '/v3/ai_optimization/llm_mentions/top_mentioned_domains/live' -i '{"limit":20,"target":[{"keyword":"bmw","search_scope":["answer"]}],"language_code":"en","location_code":2840}' --endpoint-version 1

Pinned to version 1, the one this page shows: if a newer version is published first, the Run is refused instead of charged under new terms. Install and log in first on Get Started.

Once per Run:

bash

IDEMPOTENCY_KEY=$(uuidgen)

Run it, and copy this same block to send it again:

bash

curl -X POST https://api.glasser.ai/v1/runs \
  -H "Authorization: Bearer gl_..." \
  -H "Idempotency-Key: $IDEMPOTENCY_KEY" \
  -H "Content-Type: application/json" \
  -d '{"provider":"dataforseo","endpoint":"/v3/ai_optimization/llm_mentions/top_mentioned_domains/live","input":{"limit":20,"target":[{"keyword":"bmw","search_scope":["answer"]}],"language_code":"en","location_code":2840},"endpoint_version":1}'

Reuse the same Idempotency-Key to send it again: the second send is a read of the first Run. A new key is a new Run and a new Charge. Pinned to version 1 for the same reason as the CLI.

What each outcome charges

No result	The Provider answered: nothing matched.	$0.103
Provider error	The Provider failed to answer.	$0.00
Timed out	The deadline won.	$0.00
Internal failure	Our defect.	$0.00

Method POSTVersion 1Provider documentation ↗

Use this endpoint ↗

By platform

By task

AI Optimization top_mentioned_domains live

How to run it

What each outcome charges