---
title: "Web Pages"
method: POST
path: "/brand-radar/web-pages"
tags: ["Brand Radar"]
---

# Web Pages

`POST /brand-radar/web-pages`

## Request

- Base URL: `https://api.ahrefs.com/v3`
- URL: `https://api.ahrefs.com/v3/brand-radar/web-pages`
- Auth: HTTP bearer

Returns web pages that mention the requested brands or competitors. Brand mentions are matched against page titles and content from Ahrefs' web index.

## Request body

- object
  - `select` string[], required: A list of fields to return. - `content` - `domain_rating` - `referring_domains` - `title` - `traffic` - `traffic_value` - `url`
  - `where` object: The filter expression. The following column identifiers are recognized (this differs from the identifiers recognized by the `select` parameter). **content**: An excerpt of the page content containing the mention. type: string **title**: The title of the page. type: string **url**: The URL of the page mentioning a requested brand or competitor. type: url
  - `report_id` string: The ID of the report to use. If one is given, other parameters are taken from the report (brand, competitors, market, country, filters). If country or filters are provided, they override the ones in the report. You can find it in the URL of your Brand Radar report in Ahrefs: `https://app.ahrefs.com/brand-radar/reports/#report_id#/...`
  - `brands` union[]: A list of brand names and websites to find mentions of on web pages.
    - union
      - object
        - `names` string[], required: The names of the brand/competitor
        - `url_groups` object[]
          - `target` string, domain, required: The domain of the target
          - `scope` 'url' | 'path' | 'domain' | 'subdomains', required: Scope of the target.
      - object
        - `names` string[]: The names of the brand/competitor
        - `url_groups` object[], required
          - `target` string, domain, required: The domain of the target
          - `scope` 'url' | 'path' | 'domain' | 'subdomains', required: Scope of the target.
  - `competitors` union[]: A list of competitor names and websites to find mentions of on web pages.
    - union
      - object
        - `names` string[], required: The names of the brand/competitor
        - `url_groups` object[]
          - `target` string, domain, required: The domain of the target
          - `scope` 'url' | 'path' | 'domain' | 'subdomains', required: Scope of the target.
      - object
        - `names` string[]: The names of the brand/competitor
        - `url_groups` object[], required
          - `target` string, domain, required: The domain of the target
          - `scope` 'url' | 'path' | 'domain' | 'subdomains', required: Scope of the target.
  - `content_filter` object: Optional phrases used to include or exclude results based on their content.
    - `include` string[]: Only show results containing at least one of these exact phrases.
    - `exclude` string[]: Hide results containing any of these exact phrases.
  - `limit` integer: The number of web pages to return.
  - `order_by` 'relevance' | 'traffic': How to order the web pages.
  - `page_type` 'all_pages' | 'news': Whether to return all web pages or only news pages.
  - `publication_type` 'all' | 'published_once' | 'republished': Whether to return all pages, pages published once, or republished pages.
  - `date_from` string, date: The start of the publication-date range, in YYYY-MM-DD format. Requires `date_to`.
  - `date_to` string, date: The inclusive end of the publication-date range, in YYYY-MM-DD format. Requires `date_from`.
  - `platform` 'all' | 'blogs' | 'wordpress' | 'ecommerce' | 'cms' | 'message-boards' | 'wikis': The platform or technology used by the page.
  - `language` 'all' | 'en' | 'es' | 'ru' | 'zh-cn' | 'ja' | 'af' | 'sq' | 'ar' | 'bn' | 'bg' | 'zh-tw' | 'hr' | 'cs' | 'da' | 'nl' | 'et' | 'fa' | 'fi' | 'fr' | 'de' | 'el' | 'gu' | 'he' | 'hi' | 'hu' | 'id' | 'it' | 'kn' | 'ko' | 'lv' | 'lt' | 'mk' | 'ml' | 'mr' | 'ne' | 'no' | 'pa' | 'pl' | 'pt' | 'ro' | 'sk' | 'sl' | 'so' | 'sw' | 'sv' | 'tl' | 'ta' | 'te' | 'th' | 'tr' | 'uk' | 'ur' | 'vi': The language of the page.
  - `output` 'json' | 'csv' | 'xml' | 'php': The output format.

## Response `200`

OK

- BrandRadarWebPages
  - `pages` object[]
    - `content` string: An excerpt of the page content containing the mention.
    - `domain_rating` integer: The Domain Rating of the page's domain.
    - `referring_domains` integer, nullable: The number of unique domains linking to the page.
    - `title` string: The title of the page.
    - `traffic` number, float, nullable: The page's estimated monthly organic search traffic.
    - `traffic_value` number, float: The estimated monthly value of the page's organic search traffic, in USD.
    - `url` string, url: The URL of the page mentioning a requested brand or competitor.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `429`: Too Many Requests
- `500`: Internal Error

## Changes

- **2026-09-29** `58f0479d55c5`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/ahrefs/apis/ahrefs-api/changes/brand-radar/web-pages/post.md)

---

[API](https://skmtc.dev/ahrefs/apis/ahrefs-api.md) - [All operations](https://skmtc.dev/ahrefs/apis/ahrefs-api/llms.txt) - [OpenAPI document](https://skmtc.dev/ahrefs/apis/ahrefs-api/revisions/667fedfff126?raw)