개요 추이 - 언급

API + MCP

GET/v3/brand-radar/mentions-history

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

쿼리 매개변수

wherestring

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

date_tostring (date)

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

date_fromstring (date)필수

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

countrystring

두 자리 국가 코드(ISO 3166-1 alpha-2)의 쉼표로 구분된 목록입니다.

허용되는 값:adaeafagaialamaoarasatauawazbabbbdbebfbgbhbibjbnbobrbsbtbwbybzcacdcfcgchcickclcmcncocrcucvcyczdedjdkdmdodzeceeegesetfifjfmfofrgagbgdgegfggghgiglgmgngpgqgrgtgugyhkhnhrhthuidieiliminiqisitjejmjojpkekgkhkiknkrkwkykzlalblclilklsltlulvlymamcmdmemgmkmlmmmnmqmrmsmtmumvmwmxmymznancnengninlnonpnrnunzompapepfpgphpkplpnprpsptpyqarerorsrurwsasbscsesgshsiskslsmsnsosrstsvtdtgthtjtktltmtntotrtttwtzuaugusuyuzvcvevgvivnvuwsyeytzazmzw

report_idstring

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

promptsstring

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

허용되는 값:ahrefscustom

data_sourcestring필수

쉼표로 구분된 챗봇 모델 목록입니다. Google 키워드 모델(google_ai_overviews_keywords, google_ai_mode_keywords)은 서로 간에 또는 다른 모델과 함께 사용할 수 없습니다.

허용되는 값:chatgptgoogle_ai_overviewsgoogle_ai_modegeminiperplexitycopilotgrokgoogle_ai_overviews_keywordsgoogle_ai_mode_keywords

Example:chatgpt,perplexity

marketstring

브랜드의 틈새 시장을 쉼표로 구분한 목록입니다. 2026-05-18에 사용 중단(Deprecated)되었으며, 이 날짜 이후 곧 이 매개변수는 효력을 잃게 됩니다.

brandstring필수

검색할 브랜드입니다.

outputstring

출력 형식입니다.

허용되는 값:jsoncsvxmlphp

응답

metricsarray<object>

datestring (date)

mentionsinteger

브랜드를 언급한 응답에서 추정한 언급 수입니다.