Find filtered webpage mentions of a brand or phrase

Get up to 10 DataForSEO citation records by supplying a target term, text that the excerpt should contain, page types, a filter and one sorting rule. Available details include source URLs, excerpts and page metadata.

Your AI

Use with your AI

For tasks with several steps, continue in the AI you already use.

CodexClaude CodeCursorWindsurfCline

View instructions

Use Toolmu’s content-analysis-search-dataforseo for the user’s indexed web citation search. Keep the existing Toolmu connection; if setup is needed, follow https://toolmu.com/SKILL.md. Ask only for missing required criteria, check current availability and price, and stay within the user’s existing authorization and budget. Supply all seven request properties: keyword; keyword_fields with its required snippet; page_type with 1–5 supported values; search_mode="as_is"; one complete flat three-string filters condition; order_by containing exactly one field,direction string; and integer limit=10. Use a target keyword of 3–256 characters for supplier compatibility; preserve literal double quotes for an exact multiword phrase. The supplier lowercases the target keyword. Keep snippet text as supplied within 1–256 characters, without assuming the same minimum or normalization. Supported page types are ecommerce, news, blogs, message-boards and organization. A filter such as ["country","=","US"] refers to domain registration, or use ["main_domain","=","reviewfinder.ca"] for that main domain. Do not add nested or numeric filters. A documented sorting example is ["content_info.sentiment_connotations.anger,desc"]; it orders a supplier emotion index, not search-engine ranking or verified opinion. Present each available citation URL and excerpt with reported metadata. Keep repeated records and missing/null values visible, distinguish returned row counts from database matches, and separate crawler visits from publication dates. Do not claim full articles, current monitoring, complete coverage or additional pages.

Task:
Find up to 10 [news pages] on websites registered in [the United States] that mention [logitech]. Make sure [logitech] also appears in the short text shown for each page. Show [more angry-sounding pages] first, with links and dates when available.

Paste into your connected AI's conversation.

Connection guide

Up to 0.11 credits / call

The final charge is based on confirmed usage. Unused reserved credits return to your available balance.

DataForSEO

Find filtered webpage mentions of a brand or phrase

You receive

Receive a collection of up to 10 indexed web citation records for your supplied conditions. Available records can show where a mention was found, an excerpt, headings and reported source details such as author, language or dates. Your Agent can organize the links and excerpts into a reading list for closer inspection.

Start with your task

Find up to 10 [news pages] on websites registered in [the United States] that mention [logitech]. Make sure [logitech] also appears in the short text shown for each page. Show [more angry-sounding pages] first, with links and dates when available.

What to know

These are records from DataForSEO’s content index, not complete or continuously monitored web coverage. A URL or domain can appear more than once, and 10 is a maximum rather than a guaranteed count. Excerpts are partial text; source dates do not prove current availability. This Tool has no next-page input.

Inputs & outputs

Inspect the current inputs, availability, and maximum charge before starting.

Input schema

Input schema
Field / Path	Type	Requirement	Meaning
Web citation search request`request`	`object`	Required	Required object containing all seven settings: target keyword, snippet field filter, page types, fixed as_is mode, one filter, one sorting rule and fixed limit 10. There are no date or next-page controls. Required fields `keyword_fields, keyword, page_type, search_mode, filters, order_by, limit`
Maximum citation records`request.limit`	`integer`	Required	Required integer fixed to 10. This caps the returned citation records; it is not a guaranteed count of ten distinct URLs or domains. Fixed value `10`
One results filter`request.filters`	`array`	Required	Required string array, accepting 1–3 items in Toolmu. Supply a complete flat three-string field/operator/value condition, for example ["country","=","US"] or ["main_domain","=","reviewfinder.ca"]. Country is domain registration. Nested conditions and numeric or Boolean values are not accepted. Minimum items `1` Maximum items `3`
Filter component`request.filters[]`	`string`	—	Each component is a nonempty string of up to 256 characters. The three positions are field name, operator and string value, in that order; shorter arrays do not form a complete supplier condition. Minimum length `1` Maximum length `256`
Target brand name or phrase`request.keyword`	`string`	Required	Required UTF-8 target text, 1–256 characters in Toolmu. Use at least 3 characters for supplier compatibility. The supplier lowercases this keyword. Preserve literal double quotes for an exact multiword phrase. Minimum length `1` Maximum length `256`
One sorting rule`request.order_by`	`array`	Required	Required array containing exactly one sorting expression. It selects the requested ordering, not an automatic best or newest list. Minimum items `1` Maximum items `1`
Sorting expression`request.order_by[]`	`string`	—	Each item is a 1–256 character field,direction string, using asc or desc. A documented example is content_info.sentiment_connotations.anger,desc, which sorts a supplier emotion index, not a search-engine rank. Minimum length `1` Maximum length `256`
Page types to include`request.page_type`	`array`	Required	Required array of 1–5 page-type strings. Choose the documented types listed for each item; this is a page-type constraint, not a source-language or date setting. Minimum items `1` Maximum items `5`
Page-type item`request.page_type[]`	`string`	—	Each item is a string of 1–256 characters. Supported names are ecommerce, news, blogs, message-boards and organization. Minimum length `1` Maximum length `256`
Citation grouping mode`request.search_mode`	`string`	Required	Required fixed value as_is. Retains citation records rather than selecting one per domain; repeated source URLs or domains may occur. Fixed value `as_is`
Excerpt text condition`request.keyword_fields`	`object`	Required	Required closed object containing only the required snippet property. Adds a field-containing-text condition alongside the target keyword. Required fields `snippet`
Text the excerpt should contain`request.keyword_fields.snippet`	`string`	Required	Required nonempty text, 1–256 characters. Supply the text the indexed content excerpt should contain, alongside the target keyword. Minimum length `1` Maximum length `256`

View raw JSON

{
  "type": "object",
  "required": [
    "request"
  ],
  "properties": {
    "request": {
      "type": "object",
      "required": [
        "keyword_fields",
        "keyword",
        "page_type",
        "search_mode",
        "filters",
        "order_by",
        "limit"
      ],
      "properties": {
        "limit": {
          "type": "integer",
          "const": 10
        },
        "filters": {
          "type": "array",
          "items": {
            "type": "string",
            "maxLength": 256,
            "minLength": 1
          },
          "maxItems": 3,
          "minItems": 1
        },
        "keyword": {
          "type": "string",
          "maxLength": 256,
          "minLength": 1
        },
        "order_by": {
          "type": "array",
          "items": {
            "type": "string",
            "maxLength": 256,
            "minLength": 1
          },
          "maxItems": 1,
          "minItems": 1
        },
        "page_type": {
          "type": "array",
          "items": {
            "type": "string",
            "maxLength": 256,
            "minLength": 1
          },
          "maxItems": 5,
          "minItems": 1
        },
        "search_mode": {
          "type": "string",
          "const": "as_is"
        },
        "keyword_fields": {
          "type": "object",
          "required": [
            "snippet"
          ],
          "properties": {
            "snippet": {
              "type": "string",
              "maxLength": 256,
              "minLength": 1
            }
          },
          "additionalProperties": false
        }
      },
      "additionalProperties": false
    }
  },
  "additionalProperties": false
}

Result schema

Output fields have not been documented yet.

Additional notes

The DataForSEO Content Analysis Search reference explains the supplier’s citation records. Its snippet is an excerpt of indexed content, not a Google search-results snippet.

Questions about this tool.

Inputs, results and details to know before running it.

Get connected

The keyword is the search target. The snippet setting adds a condition on text that the indexed excerpt should contain. Both are required, even when you use the same word in each. Use literal double quotes in the target keyword for an exact multiword phrase. Check the excerpt to confirm that the mention concerns the company you mean.

Find filtered webpage mentions of a brand or phrase

Find filtered webpage mentions of a brand or phrase

You receive

Start with your task

What to know

Inputs & outputs

Input schema

Result schema

Choose what to look for

Choose page types and website location

Understand the sorted results

Questions about this tool.

You receive

Start with your task

What to know

Inputs & outputs

Input schema

Result schema

Choose what to look for

Choose page types and website location

Understand the sorted results

Questions about this tool.

Why do I need both a keyword and snippet text?

Does country = US mean the readers or article are in the US?

Are the returned records a complete set of unique pages?

What does the anger sorting example mean?

Are the displayed dates publication dates?