Docs
문서 검색...⌘K

개요 추이 - 검색 점유율

API + MCP
POST/v3/brand-radar/sov-history

이 엔드포인트로 보내는 요청은 prompts 매개변수에 따라 API 유닛을 소모합니다. 사용자 정의 프롬프트 데이터만 반환하는 요청은 무료이며, Ahrefs 프롬프트 데이터를 포함하는 요청에는 스탠다드 API 유닛 요금이 적용됩니다.

요청 본문

whereobject

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

cited_domain: 응답을 생성하는 데 사용된 페이지의 도메인입니다.
type: domain

cited_domain_subdomains: 응답을 생성하는 데 사용된 페이지의 도메인입니다. 지정한 도메인의 모든 하위 도메인도 일치합니다.
type: string

cited_url_exact: 응답을 생성하는 데 사용된 페이지의 URL입니다.
type: string

cited_url_prefix: 응답을 생성하는 데 사용된 페이지의 URL입니다. 이 접두사로 시작하는 모든 URL이 일치합니다.
type: string

question: 사용자가 한 질문입니다.
type: string

response (10 units): 모델의 응답입니다.
type: string

search_queries: 챗봇이 응답에 대한 정보를 찾기 위해 사용한 검색어입니다. 참고: data_sourcechatgpt 또는 perplexity가 포함되지 않으면 이 필드는 항상 비어 있습니다.
type: string

topic: 쿼리의 주제입니다.
type: string

tags_filterobject

프롬프트 태그에 대한 필터 표현식입니다. report_id가 필요합니다. 다음 제한 사항과 함께 필터 문법을 사용합니다: 유효한 필드 이름은 "tag"뿐이며, 유효한 연산자는 "eq", "neq", "substring", "isubstring", "phrase_match", "iphrase_match", "prefix", "suffix", "empty"뿐입니다. and, or의 최대 중첩 깊이는 2입니다. 예: {"or": [{"field": "tag", "is": ["eq", "branded"]}, {"field": "tag", "is": ["eq", "competitor"]}]}.

date_tostring

YYYY-MM-DD 형식의 이력 기간 종료일.

date_fromstringRequired

YYYY-MM-DD 형식의 이력 기간 시작일.

countryarray<string>

두 글자 국가 코드(ISO 3166-1 alpha-2) 목록입니다.

Allowed values:adaeafagaialamaoarasatauawazbabbbdbebfbgbhbibjbnbobrbsbtbwbybzcacdcfcgchcickclcmcncocrcucvcyczdedjdkdmdodzeceeegesetfifjfmfofrgagbgdgegfggghgiglgmgngpgqgrgtgugyhkhnhrhthuidieiliminiqisitjejmjojpkekgkhkiknkrkwkykzlalblclilklsltlulvlymamcmdmemgmkmlmmmnmqmrmsmtmumvmwmxmymznancnengninlnonpnrnunzompapepfpgphpkplpnprpsptpyqarerorsrurwsasbscsesgshsiskslsmsnsosrstsvtdtgthtjtktltmtntotrtttwtzuaugusuyuzvcvevgvivnvuwsyeytzazmzw
report_idstring

사용할 보고서의 ID입니다. 값을 지정하면 다른 매개변수(브랜드, 경쟁사, 시장, 국가, 필터)는 보고서에서 가져옵니다. 국가 또는 필터를 제공하면 보고서의 값을 덮어씁니다. Ahrefs의 브랜드 레이더 보고서 URL에서 확인할 수 있습니다: https://app.ahrefs.com/brand-radar/reports/#report_id#/...

promptsstring

사용할 프롬프트 유형입니다. 지정하지 않으면 둘 다 사용됩니다. 사용자 정의 프롬프트를 사용하려면 report_id를 제공해야 합니다.

Allowed values:ahrefscustom
data_sourcearray<string>Required

챗봇 모델 목록입니다. Google 모델(google_ai_overviews, google_ai_mode)은 서로 또는 Google 이외 모델과 함께 사용할 수 없습니다.

Allowed values:google_ai_overviewsgoogle_ai_modechatgptgeminiperplexitycopilotgrok
marketarray<string>

브랜드의 틈새 시장 목록입니다.

competitorsarray<object>

검색할 경쟁사 이름과 웹사이트 목록입니다.

At least one of names or url_groups is required
namesarray<string>

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

Example:["ahrefs","ahrefs seo"]
url_groupsarray<object>
targetstringrequired

대상의 도메인입니다.

Example:ahrefs.com
scopestringrequired

대상의 범위입니다.

Allowed values:urlpathdomainsubdomains
brandsarray<object>

검색할 브랜드 이름과 웹사이트 목록입니다.

At least one of names or url_groups is required
namesarray<string>

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

Example:["ahrefs","ahrefs seo"]
url_groupsarray<object>
targetstringrequired

대상의 도메인입니다.

Example:ahrefs.com
scopestringrequired

대상의 범위입니다.

Allowed values:urlpathdomainsubdomains
outputstring

출력 형식입니다.

Allowed values:jsonphp

응답

metricsarray<object>
datestring
share_of_voicearray<object>

(브랜드당 1개 단위) 브랜드의 추정 점유율(Share of Voice)입니다.