v0.2.0-beta

OpenAPI 3.1.0

LLM Mentions 집계 지표(라이브)

Felo API Support

MIT

서버

https://openapi.felo.ai

클라이언트 라이브러리

Shell Curl

DataForSEO

SEO, search-engine results, keyword research, backlinks and AI visibility data.

DataForSEO 작업

post/v1/beta/dataforseo/ai_optimization/llm_mentions/aggregated_metrics/live

LLM Mentions 집계 지표(라이브)

어시스턴트가 타깃을 언급하는 빈도를 개별 답변이 아닌 합계로 보여줍니다: total과 items. ⚠️ target은 객체 배열이며, 각 항목은 {"domain": "..."} 또는 {"keyword": "..."}입니다. 문자열을 그대로 전달하면 유형이 잘못되었다는 이유로 거부되고, 문자열 배열을 전달하면 'Each target item must be an object'가 반환됩니다. 필터 필드는 get_dataforseo_ai_llm_mentions_available_filters에서 가져옵니다. DataForSEO의 봉투 구조로 감싸집니다. 데이터는 tasks[0].result, 결과 상태는 tasks[0].status_code에 있으며, 거부된 요청도 HTTP 200을 반환합니다. 가시성을 보여주는 핵심 수치입니다. post_dataforseo_ai_llm_mentions_search_live는 그 뒤의 답변을 보여주고, post_dataforseo_ai_llm_mentions_cross_metrics_live는 여러 타깃을 한 번에 비교합니다.

요금 참고 정보

계량 방식: 보고된 응답 비용.
참고 요청 추정치: USD 0.101.
참고 고객 배수: 1.0. 정산된 고객 금액에 다시 적용하지 마세요.

참고용 메타데이터일 뿐이며, 계정 견적이나 보장된 가격 또는 지출 한도가 아닙니다. 리소스 크레딧은 Felo 크레딧이 아닙니다. 최종 청구는 Felo 청구 기록을 따릅니다.

본문

필수

application/json

유형: array object[]
- target
  유형: array object[]
  필수
  
  대상 엔터티를 담은 객체 배열입니다. 필수 필드입니다. target 필드에는 엔터티(객체)를 최대 10개까지 지정할 수 있습니다. 대상 엔터티 하나에는 도메인 하나 또는 키워드 하나와 관련 매개변수를 담을 수 있습니다. 예: 도메인 엔터티가 있는 target 배열 [{"domain": "en.wikipedia.org", "search_filter": "exclude"}] / 키워드 엔터티가 있는 target 배열 [{"keyword": "bmw", "search_scope": ["question"], "match_type ": "partial_match"}] / 여러 엔터티가 있는 target 배열 [{"domain": "en.wikipedia.org", "search_filter": "exclude"}, {"keyword": "bmw", "match_type ": "partial_match", "search_scope": ["answer"]}]
  
  domain
  유형: string
  필수
  
  대상 도메인입니다. keyword를 지정하지 않으면 필수 필드입니다. domain 필드에는 최대 63자까지 지정할 수 있으며, 도메인은 https://와 www. 없이 지정해야 합니다.
  
  include_subdomains
  유형: boolean
  
  대상 도메인의 하위 도메인을 검색에 포함할지 여부를 나타냅니다. 선택 필드입니다. true로 설정하면 하위 도메인이 검색에 포함됩니다. 기본값: false.
  
  keyword
  유형: string
  
  대상 키워드입니다. domain을 지정하지 않으면 필수 필드입니다. keyword 필드에는 최대 250자까지 지정할 수 있습니다. 모든 %##이 디코딩됩니다(‘+’ 문자는 공백 문자로 디코딩됨). keyword에 “%” 문자를 사용하려면 “%25”로 지정하세요. keyword에 “+” 문자를 사용하려면 “%2B”로 지정하세요. DataForSEO API의 keyword 및 keywords 필드 규칙과 제한은 이 Help Center 문서에서 확인하세요.
  
  match_type
  유형: string
  
  대상 키워드 일치 유형입니다. 선택 필드입니다. word_match - 지정한 시드 키워드와 일치하는 용어를 전문 검색하며, 키 구문 앞, 뒤 또는 내부에 추가 단어가 포함된 경우도 찾습니다(예: “light”를 검색하면 “light bulb”, “light switch” 결과가 반환됨). partial_match - 지정한 문자열 시퀀스를 포함하는 모든 인스턴스를 찾는 부분 문자열 검색이며, 더 긴 단어 내부에 나타나는 경우도 포함합니다(예: “light”를 검색하면 “lighting”, “highlight” 결과가 반환됨). 가능한 값: word_match, partial_match. 기본값: word_match.
  
  search_filter
  유형: string
  
  엔터티 검색 필터로, include 또는 exclude입니다. 기본값은 include입니다.
  
  search_scope
  유형: array string[]
  
  검색 범위입니다. 도메인 엔터티: any, sources, search_results. 키워드 엔터티: any, question, answer, brand_entities, fan_out_queries. 기본값: any.
- initial_dataset_filters
  유형: array
  
  집계 전에 적용되는 필터 표현식 배열입니다. 선택 필드입니다. 이 배열을 사용하면 집계 전에 원시 멘션 데이터베이스에 적용되는 표현식을 필터링하여 결과에 기여하는 행을 제한할 수 있습니다. 필터는 한 번에 여러 개를 추가할 수 있으며(최대 8개), 조건 사이에 and 또는 or 논리 연산자를 설정해야 합니다. 지원되는 연산자: =, , in, not_in, like, not_like, ilike, not_ilike, match, not_match. like 및 not_like와 함께 % 연산자를 사용하면 0개 이상의 문자로 이루어진 문자열을 일치시킬 수 있습니다. 예: ["ai_search_volume",">","1000"]. 가능한 필터 전체 목록은 여기에서 확인할 수 있습니다. 초기 데이터 세트 필터에 대한 자세한 내용은 이 Help Center 문서를 참고하세요.
- internal_list_limit
  유형: integer
  
  내부 배열의 최대 요소 수입니다. 선택 필드입니다. 이 필드를 사용하면 다음 배열의 요소 수를 제한할 수 있습니다: sources_domain, search_results_domain. 최솟값: 1, 최댓값: 20, 기본값: 10.
- language_code
  유형: string
  
  검색 언어 코드입니다. 선택 필드입니다. 이 필드를 사용하면 language_name을 지정할 필요가 없습니다. 사용 가능한 검색 엔진 언어와 해당 language_code 목록은 https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages로 별도 요청해 받을 수 있습니다. 기본값: en. 참고: chat_gpt 데이터는 en에서만 사용할 수 있습니다.
- language_name
  유형: string
  
  검색 언어의 전체 이름입니다. 선택 필드입니다. 이 필드를 사용하면 language_code를 지정할 필요가 없습니다. 이 필드를 지정하지 않으면 language_code 값이 en으로 기본 적용됩니다. 사용 가능한 검색 엔진 언어와 해당 language_name 목록은 https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages로 별도 요청해 받을 수 있습니다. 참고: chat_gpt 데이터는 영어에서만 사용할 수 있습니다.
- location_code
  유형: integer
  
  검색 위치 코드입니다. 선택 필드입니다. 이 필드를 사용하면 location_name을 지정할 필요가 없습니다. 사용 가능한 검색 엔진 위치와 해당 location_code 목록은 https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages로 별도 요청해 받을 수 있습니다. 기본값: 2840. 참고: chat_gpt 데이터는 2840에서만 사용할 수 있습니다.
- location_name
  유형: string
  
  검색 위치의 전체 이름입니다. 선택 필드입니다. 이 필드를 사용하면 location_code를 지정할 필요가 없습니다. 이 필드를 지정하지 않으면 location_code 값이 2840으로 기본 적용됩니다. 사용 가능한 검색 엔진 위치와 해당 location_name 목록은 https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages로 별도 요청해 받을 수 있습니다. 참고: chat_gpt 데이터는 미국에서만 사용할 수 있습니다.
- platform
  유형: string
  
  대상 플랫폼입니다. 선택 필드입니다. 가능한 값: chat_gpt, google. 기본값: google. 참고: 반환되는 데이터는 선택한 플랫폼에 따라 달라집니다. 참고 #2: chat_gpt 데이터는 미국과 영어에서만 사용할 수 있습니다.
- tag
  유형: string
  
  사용자 정의 작업 식별자입니다. 선택 필드입니다. 최대 255자입니다. 이 매개변수를 사용해 작업을 식별하고 결과와 매칭할 수 있습니다. 지정한 tag 값은 응답의 data 객체에서 확인할 수 있습니다.

응답

200
유형: object

성공 응답
cost
유형: number

전체 작업 비용, USD

status_code
유형: integer

일반 상태 코드입니다. 응답 코드 전체 목록은 여기에서 확인할 수 있습니다. 참고: 관련 예외 또는 오류 조건을 처리하는 시스템을 반드시 설계할 것을 강력히 권장합니다.

status_message
유형: string

일반 정보 메시지입니다. 일반 정보 메시지 전체 목록은 여기에서 확인할 수 있습니다.

tasks
유형: array string[]

작업 배열

tasks_count
유형: integer

tasks 배열의 작업 수

tasks_error
유형: integer

오류와 함께 반환된 tasks 배열의 작업 수

tasks.cost
유형: number

작업 비용, USD

tasks.data
유형: object

POST 요청에 지정한 것과 동일한 매개변수를 포함합니다

tasks.id
유형: string

작업 식별자. 시스템 내 고유 작업 식별자(UUID 형식)입니다.

tasks.path
유형: array string[]

URL 경로

tasks.result
유형: array string[]

결과 배열

tasks.result_count
유형: integer

result 배열의 요소 수

tasks.result.items
유형: array string[]

발견된 각 상위 페이지의 상세 멘션 지표를 담은 개별 페이지 결과 배열이며, 이 경우 null입니다.

tasks.result.total
유형: object

집계된 멘션 지표 요약입니다. 발견된 모든 도메인에 걸친 전체 LLM 멘션 지표를 다양한 차원으로 그룹화한 요약을 포함합니다.

tasks.result.total.brand_entities_category
유형: array string[]

대상과 관련된 브랜드 엔터티 데이터입니다. LLM 쿼리와 관련해 검색 결과에 나타나는 브랜드 엔터티 카테고리 데이터를 담은 객체 배열입니다.

tasks.result.total.brand_entities_category.ai_search_volume
유형: integer

키워드의 현재 AI 검색량 비율입니다. 이 지표에 대한 자세한 내용은 여기에서 확인하세요.

tasks.result.total.brand_entities_category.impressions
유형: integer

키워드의 현재 AI 노출 비율입니다.

tasks.result.total.brand_entities_category.key
유형: string

그룹화 식별자입니다. 그룹화 차원의 특정 식별자이며, 이 경우 필드에는 발견된 브랜드 엔터티 카테고리가 표시됩니다.

tasks.result.total.brand_entities_category.mentions
유형: integer

총 LLM 멘션 수입니다. 대상 키워드 또는 도메인이 특정 도메인과 관련해 언급된 횟수입니다.

tasks.result.total.brand_entities_category.type
유형: string

요소 유형 = 'group_element'

tasks.result.total.brand_entities_title
유형: array string[]

대상과 관련된 브랜드 엔터티 데이터입니다. LLM 쿼리와 관련해 검색 결과에 나타나는 브랜드 엔터티 제목 데이터를 담은 객체 배열입니다.

tasks.result.total.brand_entities_title.ai_search_volume
유형: integer

키워드의 현재 AI 검색량 비율입니다. 이 지표에 대한 자세한 내용은 여기에서 확인하세요.

tasks.result.total.brand_entities_title.impressions
유형: integer

키워드의 현재 AI 노출 비율입니다.

tasks.result.total.brand_entities_title.key
유형: string

그룹화 식별자입니다. 그룹화 차원의 특정 식별자이며, 이 경우 필드에는 발견된 브랜드 엔터티 제목이 표시됩니다.

tasks.result.total.brand_entities_title.mentions
유형: integer

총 LLM 멘션 수입니다. 대상 키워드 또는 도메인이 특정 도메인과 관련해 언급된 횟수입니다.

tasks.result.total.brand_entities_title.type
유형: string

요소 유형 = 'group_element'

tasks.result.total.language
유형: array string[]

언어 기반 그룹화입니다. 콘텐츠 언어별로 구분된 멘션 지표를 담은 객체 배열입니다.

tasks.result.total.language.ai_search_volume
유형: integer

키워드의 현재 AI 검색량 비율입니다. 이 지표에 대한 자세한 내용은 여기에서 확인하세요.

tasks.result.total.language.impressions
유형: integer

키워드의 현재 AI 노출 비율입니다.

tasks.result.total.language.key
유형: string

그룹화 식별자입니다. 그룹화 차원의 특정 식별자입니다.

tasks.result.total.language.mentions
유형: integer

총 LLM 멘션 수입니다. 대상 키워드 또는 도메인이 이 특정 그룹화 키와 관련해 언급된 횟수입니다.

tasks.result.total.language.type
유형: string

요소 유형 = 'group_element'

tasks.result.total.location
유형: array string[]

위치 기반 그룹화입니다. 지리적 위치별로 구분된 멘션 지표를 담은 객체 배열입니다.

tasks.result.total.location.ai_search_volume
유형: integer

키워드의 현재 AI 검색량 비율입니다. 이 지표에 대한 자세한 내용은 여기에서 확인하세요.

tasks.result.total.location.impressions
유형: integer

키워드의 현재 AI 노출 비율입니다.

tasks.result.total.location.key
유형: string

그룹화 식별자입니다. 그룹화 차원의 특정 식별자입니다.

tasks.result.total.location.mentions
유형: integer

총 LLM 멘션 수입니다. 대상 키워드 또는 도메인이 이 특정 그룹화 키와 관련해 언급된 횟수입니다.

tasks.result.total.location.type
유형: string

요소 유형 = 'group_element'

tasks.result.total.platform
유형: array string[]

플랫폼 기반 그룹화입니다. AI 플랫폼별로 구분된 멘션 지표를 담은 그룹 요소 배열입니다.

tasks.result.total.platform.ai_search_volume
유형: integer

키워드의 현재 AI 검색량 비율입니다. 이 지표에 대한 자세한 내용은 여기에서 확인하세요.

tasks.result.total.platform.impressions
유형: integer

키워드의 현재 AI 노출 비율입니다.

tasks.result.total.platform.key
유형: string

그룹화 식별자입니다. 그룹화 차원의 특정 식별자입니다.

tasks.result.total.platform.mentions
유형: integer

총 LLM 멘션 수입니다. 대상 키워드 또는 도메인이 이 특정 그룹화 키와 관련해 언급된 횟수입니다.

tasks.result.total.platform.type
유형: string

요소 유형 = 'group_element'

tasks.result.total.search_results_domain
유형: array string[]

대상과 관련된 상위 검색 결과 도메인입니다. LLM 쿼리와 관련해 검색 결과에 나타나는 상위 도메인 데이터를 담은 객체 배열입니다.

tasks.result.total.search_results_domain.ai_search_volume
유형: integer

키워드의 현재 AI 검색량 비율입니다. 이 지표에 대한 자세한 내용은 여기에서 확인하세요.

tasks.result.total.search_results_domain.impressions
유형: integer

키워드의 현재 AI 노출 비율입니다.

tasks.result.total.search_results_domain.key
유형: string

그룹화 식별자입니다. 그룹화 차원의 특정 식별자이며, 이 경우 필드에는 발견된 도메인 이름이 표시됩니다.

tasks.result.total.search_results_domain.mentions
유형: integer

총 LLM 멘션 수입니다. 대상 키워드 또는 도메인이 특정 도메인과 관련해 언급된 횟수입니다.

tasks.result.total.search_results_domain.type
유형: string

요소 유형 = 'group_element'

tasks.result.total.sources_domain
유형: array string[]

대상과 관련된 상위 소스 도메인입니다. LLM 응답에서 소스로 인용되는 상위 도메인 데이터를 담은 객체 배열입니다.

tasks.result.total.sources_domain.ai_search_volume
유형: integer

키워드의 현재 AI 검색량 비율입니다. 이 지표에 대한 자세한 내용은 여기에서 확인하세요.

tasks.result.total.sources_domain.impressions
유형: integer

키워드의 현재 AI 노출 비율입니다.

tasks.result.total.sources_domain.key
유형: string

그룹화 식별자입니다. 그룹화 차원의 특정 식별자이며, 이 경우 필드에는 발견된 도메인 이름이 표시됩니다.

tasks.result.total.sources_domain.mentions
유형: integer

총 LLM 멘션 수입니다. 대상 키워드 또는 도메인이 특정 도메인과 관련해 언급된 횟수입니다.

tasks.result.total.sources_domain.type
유형: string

요소 유형 = 'group_element'

tasks.status_code
유형: integer

DataForSEO가 생성한 작업의 상태 코드로, 10000-60000 범위일 수 있습니다. 응답 코드 전체 목록은 여기에서 확인할 수 있습니다.

tasks.status_message
유형: string

작업의 정보 메시지입니다. 일반 정보 메시지 전체 목록은 여기에서 확인할 수 있습니다.

tasks.time
유형: string

실행 시간, 초

time
유형: string

실행 시간, 초

version
유형: string

API의 현재 버전
application/json
400

요청을 처리할 수 없습니다. 요청 매개변수를 확인하세요.
401

유효한 Felo API 키가 필요합니다.
402

청구 요건이 충족되지 않아 요청을 진행할 수 없습니다.
403

이 계정에는 이 작업을 수행할 권한이 없습니다.
429

요청 또는 지출 한도에 도달했습니다.
502

서비스가 요청을 완료할 수 없습니다.
503

API 또는 청구 서비스를 일시적으로 사용할 수 없습니다.
504

요청을 처리하는 동안 서비스 시간이 초과되었습니다.
default

오류 응답. 업스트림 패스스루 응답은 공급자 형식을 사용할 수 있습니다.

application/json

post/v1/beta/dataforseo/ai_optimization/llm_mentions/aggregated_metrics/live

curl https://openapi.felo.ai/v1/beta/dataforseo/ai_optimization/llm_mentions/aggregated_metrics/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "target": [
      {
        "domain": "en.wikipedia.org"
      }
    ]
  }
]'

스키마 표시

{
  "version": "string",
  "status_code": 1,
  "status_message": "string",
  "time": "string",
  "cost": 1,
  "tasks_count": 1,
  "tasks_error": 1,
  "tasks": [
    "string"
  ],
  "tasks.id": "string",
  "tasks.status_code": 1,
  "tasks.status_message": "string",
  "tasks.time": "string",
  "tasks.cost": 1,
  "tasks.result_count": 1,
  "tasks.path": [
    "string"
  ],
  "tasks.data": {},
  "tasks.result": [
    "string"
  ],
  "tasks.result.total": {},
  "tasks.result.total.location": [
    "string"
  ],
  "tasks.result.total.location.type": "string",
  "tasks.result.total.location.key": "string",
  "tasks.result.total.location.mentions": 1,
  "tasks.result.total.location.ai_search_volume": 1,
  "tasks.result.total.location.impressions": 1,
  "tasks.result.total.language": [
    "string"
  ],
  "tasks.result.total.language.type": "string",
  "tasks.result.total.language.key": "string",
  "tasks.result.total.language.mentions": 1,
  "tasks.result.total.language.ai_search_volume": 1,
  "tasks.result.total.language.impressions": 1,
  "tasks.result.total.platform": [
    "string"
  ],
  "tasks.result.total.platform.type": "string",
  "tasks.result.total.platform.key": "string",
  "tasks.result.total.platform.mentions": 1,
  "tasks.result.total.platform.ai_search_volume": 1,
  "tasks.result.total.platform.impressions": 1,
  "tasks.result.total.sources_domain": [
    "string"
  ],
  "tasks.result.total.sources_domain.type": "string",
  "tasks.result.total.sources_domain.key": "string",
  "tasks.result.total.sources_domain.mentions": 1,
  "tasks.result.total.sources_domain.ai_search_volume": 1,
  "tasks.result.total.sources_domain.impressions": 1,
  "tasks.result.total.search_results_domain": [
    "string"
  ],
  "tasks.result.total.search_results_domain.type": "string",
  "tasks.result.total.search_results_domain.key": "string",
  "tasks.result.total.search_results_domain.mentions": 1,
  "tasks.result.total.search_results_domain.ai_search_volume": 1,
  "tasks.result.total.search_results_domain.impressions": 1,
  "tasks.result.total.brand_entities_title": [
    "string"
  ],
  "tasks.result.total.brand_entities_title.type": "string",
  "tasks.result.total.brand_entities_title.key": "string",
  "tasks.result.total.brand_entities_title.mentions": 1,
  "tasks.result.total.brand_entities_title.ai_search_volume": 1,
  "tasks.result.total.brand_entities_title.impressions": 1,
  "tasks.result.total.brand_entities_category": [
    "string"
  ],
  "tasks.result.total.brand_entities_category.type": "string",
  "tasks.result.total.brand_entities_category.key": "string",
  "tasks.result.total.brand_entities_category.mentions": 1,
  "tasks.result.total.brand_entities_category.ai_search_volume": 1,
  "tasks.result.total.brand_entities_category.impressions": 1,
  "tasks.result.items": [
    "string"
  ]
}

성공 응답

도움이 필요하신가요?

API, 결제, 계정 관련 문의는 지원에서 안내해 드립니다.
Discord에서 Felo 개발자와 대화해 보세요.
변경 내역을 확인해 보세요.
대량 구매 가격이나 구매 관련 도움이 필요하신가요? 영업팀 문의.
LLM으로 구축 중이신가요? llms.txt를 읽어 보세요.

LLM Mentions 집계 지표(라이브)

인증Required

DataForSEO

LLM Mentions 집계 지표(라이브)

요금 참고 정보

도움이 필요하신가요?