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/search/live

LLM Mentions(라이브)

어시스턴트가 타깃을 언급한 개별 답변입니다. total_count, current_offset, search_after_token, items를 반환합니다. 처음 몇 페이지를 넘으면 offset이 아니라 토큰으로 페이지를 넘기세요. ⚠️ 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_aggregated_metrics_live를 사용하세요.

요금 참고 정보

계량 방식: 보고된 응답 비용.
참고 요청 추정치: USD 0.701.
참고 고객 배수: 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
  
  search_filter
  유형: string
  
  엔터티 검색 필터로, include 또는 exclude입니다. 기본값은 include입니다.
  
  search_scope
  유형: array string[]
  
  검색 범위입니다. 도메인 엔터티: any, sources, search_results. 키워드 엔터티: any, question, answer, brand_entities, fan_out_queries. 기본값: any.
- filters
  유형: array
  
  결과 필터링 매개변수 배열 선택 필드 한 번에 여러 필터를 추가할 수 있습니다(최대 8개). 조건 사이에 논리 연산자 and, or를 설정해야 합니다. 지원되는 연산자: =, , in, not_in, like, not_like, ilike, not_ilike, match, not_match like 및 not_like와 함께 % 연산자를 사용해 임의 길이의 문자열을 일치시킬 수 있습니다. 예: ["ai_search_volume",">","1000"] 가능한 필터의 전체 목록은 여기에서 확인할 수 있습니다.
- 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 데이터는 영어에서만 사용할 수 있습니다.
- limit
  유형: integer
  
  반환되는 객체의 최대 수 선택 필드 기본값: 100 최댓값: 1000
- 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 데이터는 미국에서만 사용할 수 있습니다.
- offset
  유형: integer
  
  반환된 언급 데이터의 결과 배열에서의 오프셋 선택 필드 기본값: 0 예: 10 값을 지정하면 결과 배열의 처음 열 개 언급 객체를 건너뛰고 그다음 객체부터 데이터를 제공합니다. 참고: 최댓값은 9,000이며, 그 이상의 결과를 오프셋하려면 search_after_token을 사용하세요
- order_by
  유형: array string[]
  
  결과 정렬 규칙 선택 필드 filters 배열과 동일한 값을 사용해 결과를 정렬할 수 있습니다. 가능한 정렬 유형: asc - 결과를 오름차순으로 정렬합니다. desc - 결과를 내림차순으로 정렬합니다. 정렬 유형을 설정하려면 쉼표를 사용해야 합니다. 예: ["ai_search_volume,desc"] 참고로 단일 요청에서 정렬 규칙은 최대 세 개까지 설정할 수 있으며, 여러 정렬 규칙은 쉼표로 구분해야 합니다
- platform
  유형: string
  
  대상 플랫폼입니다. 선택 필드입니다. 가능한 값: chat_gpt, google. 기본값: google. 참고: 반환되는 데이터는 선택한 플랫폼에 따라 달라집니다. 참고 #2: chat_gpt 데이터는 미국과 영어에서만 사용할 수 있습니다.
- search_after_token
  유형: string
  
  후속 요청용 토큰 선택 필드 각 요청의 응답에서 동일한 필드에 제공됩니다. 단일 요청으로 20,000개가 넘는 결과를 가져올 때 시간 초과를 피하려면 이 매개변수를 사용하세요. 응답 배열의 고유한 search_after_token 값을 지정하면 초기 작업의 후속 결과를 받을 수 있습니다. search_after_token 값은 후속 작업마다 고유합니다. 참고: 요청에 search_after_token을 지정한 경우 다른 모든 매개변수는 이전 요청과 동일해야 합니다
- 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.current_offset
유형: integer

items 배열에서 생략된 언급 객체 수

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

관련 언급 데이터를 포함합니다

tasks.result.items_count
유형: integer

items 배열에 반환된 결과 수

tasks.result.items.ai_search_volume
유형: integer

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

tasks.result.items.answer
유형: string

마크다운 형식의 관련 답변 결과 콘텐츠를 마크다운 마크업 언어로 포맷한 것입니다

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

브랜드 엔터티 배열 응답에 언급된 브랜드 정보를 포함합니다

tasks.result.items.brand_entities.category
유형: string

브랜드 카테고리

tasks.result.items.brand_entities.position
유형: integer

결과 내 위치

tasks.result.items.brand_entities.title
유형: string

브랜드 이름

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

팬아웃 쿼리 배열 보다 종합적인 응답을 제공하기 위해 기본 쿼리에서 파생된 관련 검색 쿼리를 포함합니다

tasks.result.items.first_response_at
유형: string

응답 데이터가 처음 기록된 날짜와 시간(UTC 형식: “yyyy-mm-dd hh-mm-ss +00:00”) 예: 2025-10-21 06:25:30 +00:00

tasks.result.items.language_code
유형: string

POST 배열의 언어 코드

tasks.result.items.last_response_at
유형: string

응답 데이터가 마지막으로 업데이트된 날짜와 시간(UTC 형식: “yyyy-mm-dd hh-mm-ss +00:00”) 예: 2025-10-21 06:25:30 +00:00

tasks.result.items.location_code
유형: integer

POST 배열의 위치 코드

tasks.result.items.model_name
유형: string

데이터를 가져온 AI 모델 이름 참고: google 플랫폼 유형의 경우 값은 항상 google_ai_overview입니다

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

월간 AI 검색량 비율 특정 연도 및 월의 AI 검색량 비율을 담은 객체 배열

tasks.result.items.monthly_searches.month
유형: integer

월

tasks.result.items.monthly_searches.search_volume
유형: integer

특정 연도 및 월의 AI 검색량 비율 이 지표에 대한 자세한 내용은 여기에서 확인하세요

tasks.result.items.monthly_searches.year
유형: integer

연도

tasks.result.items.platform
유형: string

POST 배열로 전달되는 플랫폼

tasks.result.items.question
유형: string

관련 질문

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

검색 결과 배열 모델이 정보를 조회할 때 검색한 모든 웹 검색 출력으로, 중복 및 사용되지 않은 항목을 포함합니다

tasks.result.items.search_results.breadcrumb
유형: string

브레드크럼

tasks.result.items.search_results.description
유형: string

결과 설명

tasks.result.items.search_results.domain
유형: string

결과 도메인

tasks.result.items.search_results.position
유형: integer

결과 내 위치

tasks.result.items.search_results.publication_date
유형: string

결과가 게시된 날짜와 시간(형식: “year-month-date:minutes:UTC_difference_hours:UTC_difference_minutes”) 예: 2019-11-15 12:57:46 +00:00

tasks.result.items.search_results.title
유형: string

결과 제목

tasks.result.items.search_results.url
유형: string

결과 URL

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

소스 배열 모델이 최종 답변에서 인용하거나 참고한 소스

tasks.result.items.sources.domain
유형: string

소스 도메인

tasks.result.items.sources.markdown
유형: string

요소의 콘텐츠(마크다운 형식) 결과 콘텐츠를 마크다운 마크업 언어로 포맷한 것입니다

tasks.result.items.sources.position
유형: integer

결과 내 위치

tasks.result.items.sources.publication_date
유형: string

결과가 게시된 날짜와 시간(형식: “year-month-date:minutes:UTC_difference_hours:UTC_difference_minutes”) 예: 2019-11-15 12:57:46 +00:00

tasks.result.items.sources.snippet
유형: string

소스 설명

tasks.result.items.sources.source_name
유형: string

소스 이름

tasks.result.items.sources.thumbnail
유형: string

소스 썸네일

tasks.result.items.sources.title
유형: string

소스 제목

tasks.result.items.sources.url
유형: string

소스 URL

tasks.result.search_after_token
유형: string

후속 요청용 토큰 새 작업을 설정할 때 고유한 search_after_token을 지정하면 초기 작업의 후속 결과를 받을 수 있습니다. search_after_token 값은 후속 작업마다 고유합니다

tasks.result.total_count
유형: integer

요청과 관련된 총 결과 수

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/search/live

curl https://openapi.felo.ai/v1/beta/dataforseo/ai_optimization/llm_mentions/search/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "target": [
      {}
    ],
    "location_name": "",
    "location_code": 1,
    "language_name": "",
    "language_code": "",
    "platform": "",
    "filters": [],
    "order_by": [
      ""
    ],
    "offset": 1,
    "search_after_token": "",
    "limit": 1,
    "tag": ""
  }
]'

스키마 표시

{
  "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_count": 1,
  "tasks.result.current_offset": 1,
  "tasks.result.search_after_token": "string",
  "tasks.result.items_count": 1,
  "tasks.result.items": [
    "string"
  ],
  "tasks.result.items.platform": "string",
  "tasks.result.items.model_name": "string",
  "tasks.result.items.location_code": 1,
  "tasks.result.items.language_code": "string",
  "tasks.result.items.question": "string",
  "tasks.result.items.answer": "string",
  "tasks.result.items.sources": [
    "string"
  ],
  "tasks.result.items.sources.snippet": "string",
  "tasks.result.items.sources.source_name": "string",
  "tasks.result.items.sources.thumbnail": "string",
  "tasks.result.items.sources.markdown": "string",
  "tasks.result.items.sources.position": 1,
  "tasks.result.items.sources.title": "string",
  "tasks.result.items.sources.domain": "string",
  "tasks.result.items.sources.url": "string",
  "tasks.result.items.sources.publication_date": "string",
  "tasks.result.items.search_results": [
    "string"
  ],
  "tasks.result.items.search_results.description": "string",
  "tasks.result.items.search_results.breadcrumb": "string",
  "tasks.result.items.search_results.position": 1,
  "tasks.result.items.search_results.title": "string",
  "tasks.result.items.search_results.domain": "string",
  "tasks.result.items.search_results.url": "string",
  "tasks.result.items.search_results.publication_date": "string",
  "tasks.result.items.ai_search_volume": 1,
  "tasks.result.items.monthly_searches": [
    "string"
  ],
  "tasks.result.items.monthly_searches.year": 1,
  "tasks.result.items.monthly_searches.month": 1,
  "tasks.result.items.monthly_searches.search_volume": 1,
  "tasks.result.items.first_response_at": "string",
  "tasks.result.items.last_response_at": "string",
  "tasks.result.items.brand_entities": [
    "string"
  ],
  "tasks.result.items.brand_entities.position": 1,
  "tasks.result.items.brand_entities.title": "string",
  "tasks.result.items.brand_entities.category": "string",
  "tasks.result.items.fan_out_queries": [
    "string"
  ]
}

성공 응답

도움이 필요하신가요?

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

LLM Mentions(라이브)

인증Required

DataForSEO

LLM Mentions(라이브)

요금 참고 정보

도움이 필요하신가요?