Docs
문서 검색...⌘K

웹 페이지

API + MCP엔터프라이즈 전용
POST/v3/brand-radar/web-pages

요청한 브랜드 또는 경쟁사가 언급된 웹 페이지를 반환합니다. 브랜드 언급은 Ahrefs 웹 인덱스의 페이지 제목과 콘텐츠를 기준으로 매칭됩니다.

요청 본문

selectarray<string>Required

반환할 필드 목록입니다.

Example:["field_a","field_b"]
whereobject

필터 표현식입니다. 다음 열 식별자가 인식됩니다(이는 select 매개변수에서 인식되는 식별자와 다릅니다).

report_idstring

사용할 보고서의 ID입니다. ID가 제공되면 다른 파라미터(brand, competitors, market, country, filters)는 보고서에서 가져옵니다. country 또는 filters가 제공되면 보고서의 값을 덮어씁니다. Ahrefs의 브랜드 레이더 보고서 URL에서 확인할 수 있습니다: https://app.ahrefs.com/brand-radar/reports/#report_id#/...

brandsarray<object>

웹페이지에서 언급을 찾을 브랜드 이름 및 웹사이트 목록입니다.

Default:[]
At least one of names or url_groups is required
namesarray<string>

브랜드/경쟁사 이름입니다.

Example:["ahrefs","ahrefs seo"]
url_groupsarray<object>
targetstring (domain)required

대상의 도메인입니다.

Example:ahrefs.com
scopestringrequired

대상의 범위입니다.

허용되는 값:urlpathdomainsubdomains
competitorsarray<object>

웹페이지에서 언급을 찾을 경쟁사 이름 및 웹사이트 목록입니다.

Default:[]
At least one of names or url_groups is required
namesarray<string>

브랜드/경쟁사 이름입니다.

Example:["ahrefs","ahrefs seo"]
url_groupsarray<object>
targetstring (domain)required

대상의 도메인입니다.

Example:ahrefs.com
scopestringrequired

대상의 범위입니다.

허용되는 값:urlpathdomainsubdomains
content_filterobject

콘텐츠에 따라 결과를 포함하거나 제외하는 데 사용되는 선택적 문구입니다.

includearray<string>

다음의 정확히 일치하는 문구 중 하나 이상을 포함하는 결과만 표시합니다.

excludearray<string>

다음의 정확히 일치하는 문구 중 하나라도 포함하는 결과를 숨깁니다.

limitinteger

반환할 웹페이지 수입니다.

Default:1000
order_bystring

웹페이지를 정렬하는 방법입니다.

허용되는 값:relevancetraffic
Default:relevance
page_typestring

전체 웹페이지를 반환할지, 뉴스 페이지만 반환할지 여부입니다.

허용되는 값:all_pagesnews
Default:all_pages
publication_typestring

전체 페이지, 1회 게시된 페이지 또는 재게시된 페이지를 반환할지 여부입니다.

허용되는 값:allpublished_oncerepublished
Default:all
date_fromstring (date)

게시일 범위의 시작일로, YYYY-MM-DD 형식입니다. date_to가 필요합니다.

date_tostring (date)

게시일 범위의 종료일(포함)로, YYYY-MM-DD 형식입니다. date_from이 필요합니다.

platformstring

페이지에 사용된 플랫폼 또는 기술입니다.

허용되는 값:allblogswordpressecommercecmsmessage-boardswikis
Default:all
languagestring

페이지의 언어입니다.

허용되는 값:allenesruzh-cnjaafsqarbnbgzh-twhrcsda…
Default:all
outputstring

출력 형식입니다.

허용되는 값:jsoncsvxmlphp

응답

pagesarray<object>
contentstring

언급이 포함된 페이지 콘텐츠 발췌문입니다.

domain_ratinginteger

페이지 도메인의 도메인 등급입니다.

referring_domainsinteger or null

페이지에 링크를 건 고유 도메인 수입니다.

titlestring

페이지 제목입니다.

trafficnumber (float) or null

페이지의 월간 추정 자연 검색 트래픽입니다.

traffic_valuenumber (float)

페이지의 자연 검색 트래픽에 대한 월간 추정 가치(USD)입니다.

urlstring (url)

요청한 브랜드 또는 경쟁사가 언급된 페이지의 URL입니다.