Brand Mention Search

Find mentions of a brand on Google: link, title, snippet, sentiment and type of source for each.

Pay by wallet (x402) AI-generated brand-mention-search

Example

Example answer

{
  "query": "\"test\"",
  "mentions": [
    {
      "url": "https://www.speedtest.net/",
      "title": "Speedtest by Ookla - The Global Broadband Speed Test",
      "snippet": "Test Again · Get more metrics, video testing, mobile coverage maps, and lots more... Get it on Google Play · Get more metrics, video testing, mobile coverage ...",
      "relevance": "high",
      "sentiment": "neutral",
      "source_type": "directory"
    },
    {
      "url": "https://fast.com/",
      "title": "Fast.com: Internet Speed Test",
      "snippet": "How fast is your download speed? In seconds, FAST.com's simple Internet speed test will estimate your ISP speed.",
      "relevance": "high",
      "sentiment": "neutral",
      "source_type": "directory"
    },
    {
      "url": "https://speedtest.xfinity.com/",
      "title": "Xfinity Speed Test - Check Your Internet Speed",
      "snippet": "Test your connection fast with Xfinity's internet speed test tool and get tips on how to improve your internet performance.",
      "relevance": "high",
      "sentiment": "neutral",
      "source_type": "directory"
    },
    {
      "url": "https://fiber.google.com/speedtest/",
      "title": "Internet Speed Test | Check Broadband Speed - Google Fiber",
      "snippet": "Take a speed test to see how strong the connection is in your home (and if you don't already have GFiber, see how it compares to our speeds).",
      "relevance": "high",
      "sentiment": "neutral",
      "source_type": "directory"
    },
    {
      "url": "https://speed.cloudflare.com/",
      "title": "Internet Speed Test - Measure Network Performance | Cloudflare",
      "snippet": "Test your Internet connection. Check your network performance with our Internet speed test. Powered by Cloudflare's global edge network.",
      "relevance": "high",
      "sentiment": "neutral",
      "source_type": "directory"
    },
    {
      "url": "https://www.att.com/support/speedtest/",
      "title": "Internet Speed Test – AT&T Official Site",
      "snippet": "Test the speed between your AT&T All-Fi Hub® or Wi-Fi Gateway and our network. This test reflects the internet speed coming into your location. Sign in.",
      "relevance": "high",
      "sentiment": "neutral",
      "source_type": "directory"
    }
  ],
  "brand_name": "test",
  "total_results_found": 6
}

Inputs

Field	Type	Required	What it is
`brand_name`	string	Yes	—
`max_results`	integer	No	—
`exclude_own_domain`	string	No	—

Output fields

How reliably each field appears in a successful answer.

Field	Type	Appears
`mentions`	array	Always (present in every successful answer)
`brand_name`	string	Always (present in every successful answer)
`total_results_found`	integer	Always (present in every successful answer)
`unresolved_url_count`	number	Always (present in every successful answer)

How to call it

The same tool through each route. MCP clients reach it through Strale’s server at https://api.strale.io/mcp; the call below is what the agent sends.

# Needs an API key. max_price_cents caps what this call may cost.
curl -X POST https://api.strale.io/v1/do \
  -H "Authorization: Bearer $STRALE_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "capability_slug": "brand-mention-search",
    "inputs": {
      "brand_name": "Stripe"
    },
    "max_price_cents": 30
  }'

{
  "tool": "strale_execute",
  "arguments": {
    "slug": "brand-mention-search",
    "inputs": {
      "brand_name": "Stripe"
    },
    "max_price_cents": 30
  }
}

import { Strale } from "straleio";

const strale = new Strale({ apiKey: process.env.STRALE_API_KEY! });
const result = await strale.do({
  capability_slug: "brand-mention-search",
  inputs: {
    "brand_name": "Stripe"
  },
  max_price_cents: 30,
});

import os
from straleio import Strale, DoRequest

strale = Strale(api_key=os.environ["STRALE_API_KEY"])
result = strale.do(DoRequest(
    capability_slug="brand-mention-search",
    inputs={
        "brand_name": "Stripe",
    },
    max_price_cents=30,
))

# No account. The first request answers 402 with the price in USDC;
# an x402 client pays it from your wallet and repeats the request.
curl -i 'https://api.strale.io/x402/v2/brand-mention-search?brand_name=Stripe'

Limitations

Social, private and paywalled mentions are excluded
Searches web results via Serper.dev — does not cover social media posts, private forums, or paywalled content
What to do instead: Check the brand’s official social accounts and relevant forums directly for mentions outside web-search coverage.
New mentions can take over 24 hours to appear
Results depend on Google's index — very recent mentions (under 24 hours) may not yet appear
What to do instead: Check the original publication directly for mentions from the last 24 hours.
Output size cap per call
Structured output is limited to about 3000 output tokens per call; requests exceeding this limit are refused rather than returned truncated. A high `max_results` value can exceed this limit; an identical retry does not help.
What to do instead: Reduce max_results to shrink the number of search results analysed per call