# LLM Mentions(라이브)

**API:** Data API

**Endpoint:** `POST /v1/beta/dataforseo/ai_optimization/llm_mentions/search/live`

**Tags:** DataForSEO

어시스턴트가 타깃을 언급한 개별 답변입니다. `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 청구 기록을 따릅니다.

## Base URL

- `https://openapi.felo.ai`

## Authentication

- `FeloBearerAuth` (http bearer, bearer format Felo API Key)
- `FeloApiKey` (apiKey in header `X-API-Key`)

## Request body

Required: **yes**

### application/json

Schema:

```json
{
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "target": {
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "domain": {
              "type": "string",
              "description": "대상 도메인입니다. keyword를 지정하지 않으면 필수 필드입니다. domain 필드에는 최대 63자까지 지정할 수 있으며, 도메인은 https://와 www. 없이 지정해야 합니다."
            },
            "keyword": {
              "type": "string",
              "description": "대상 키워드입니다. domain을 지정하지 않으면 필수 필드입니다. keyword 필드에는 최대 250자까지 지정할 수 있습니다. 모든 %##이 디코딩됩니다(‘+’ 문자는 공백 문자로 디코딩됨). keyword에 “%” 문자를 사용하려면 “%25”로 지정하세요. keyword에 “+” 문자를 사용하려면 “%2B”로 지정하세요. DataForSEO API의 keyword 및 keywords 필드 규칙과 제한은 이 Help Center 문서에서 확인하세요."
            },
            "search_filter": {
              "type": "string",
              "description": "엔터티 검색 필터로, include 또는 exclude입니다. 기본값은 include입니다."
            },
            "search_scope": {
              "type": "array",
              "items": {
                "type": "string"
              },
              "description": "검색 범위입니다. 도메인 엔터티: any, sources, search_results. 키워드 엔터티: any, question, answer, brand_entities, fan_out_queries. 기본값: any."
            },
            "include_subdomains": {
              "type": "boolean",
              "description": "대상 도메인의 하위 도메인을 검색에 포함할지 여부를 나타냅니다. 선택 필드입니다. true로 설정하면 하위 도메인이 검색에 포함됩니다. 기본값: false."
            },
            "match_type": {
              "type": "string",
              "description": "타깃 키워드 일치 유형 지정한 키워드의 일치 방식을 정의합니다. 선택 필드 가능한 값: word_match - 지정한 시드 키워드와 일치하는 용어를 키 구문 앞, 뒤 또는 내부에 추가 단어가 포함된 상태로 전체 텍스트 검색합니다(예: \"light\"를 검색하면 \"light bulb\", \"light switch\" 결과가 반환됨). partial_match - 지정한 문자열 시퀀스를 포함하는 모든 항목을 찾는 부분 문자열 검색으로, 더 긴 단어 내부에 나타나는 경우도 포함합니다(예: \"light\"를 검색하면 \"lighting\", \"highlight\" 결과가 반환됨). 기본값: word_match"
            }
          },
          "oneOf": [
            {
              "required": [
                "domain"
              ]
            },
            {
              "required": [
                "keyword"
              ]
            }
          ]
        },
        "description": "대상 엔터티를 담은 객체 배열입니다. 필수 필드입니다. 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\"]}]"
      },
      "location_name": {
        "type": "string",
        "description": "검색 위치의 전체 이름입니다. 선택 필드입니다. 이 필드를 사용하면 location_code를 지정할 필요가 없습니다. 이 필드를 지정하지 않으면 location_code 값이 2840으로 기본 적용됩니다. 사용 가능한 검색 엔진 위치와 해당 location_name 목록은 https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages로 별도 요청해 받을 수 있습니다. 참고: chat_gpt 데이터는 미국에서만 사용할 수 있습니다."
      },
      "location_code": {
        "type": "integer",
        "description": "검색 위치 코드입니다. 선택 필드입니다. 이 필드를 사용하면 location_name을 지정할 필요가 없습니다. 사용 가능한 검색 엔진 위치와 해당 location_code 목록은 https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages로 별도 요청해 받을 수 있습니다. 기본값: 2840. 참고: chat_gpt 데이터는 2840에서만 사용할 수 있습니다."
      },
      "language_name": {
        "type": "string",
        "description": "검색 언어의 전체 이름입니다. 선택 필드입니다. 이 필드를 사용하면 language_code를 지정할 필요가 없습니다. 이 필드를 지정하지 않으면 language_code 값이 en으로 기본 적용됩니다. 사용 가능한 검색 엔진 언어와 해당 language_name 목록은 https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages로 별도 요청해 받을 수 있습니다. 참고: chat_gpt 데이터는 영어에서만 사용할 수 있습니다."
      },
      "language_code": {
        "type": "string",
        "description": "검색 언어 코드입니다. 선택 필드입니다. 이 필드를 사용하면 language_name을 지정할 필요가 없습니다. 사용 가능한 검색 엔진 언어와 해당 language_code 목록은 https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages로 별도 요청해 받을 수 있습니다. 기본값: en. 참고: chat_gpt 데이터는 en에서만 사용할 수 있습니다."
      },
      "platform": {
        "type": "string",
        "description": "대상 플랫폼입니다. 선택 필드입니다. 가능한 값: chat_gpt, google. 기본값: google. 참고: 반환되는 데이터는 선택한 플랫폼에 따라 달라집니다. 참고 #2: chat_gpt 데이터는 미국과 영어에서만 사용할 수 있습니다."
      },
      "filters": {
        "type": "array",
        "items": {},
        "description": "결과 필터링 매개변수 배열 선택 필드 한 번에 여러 필터를 추가할 수 있습니다(최대 8개). 조건 사이에 논리 연산자 and, or를 설정해야 합니다. 지원되는 연산자: =, , in, not_in, like, not_like, ilike, not_ilike, match, not_match like 및 not_like와 함께 % 연산자를 사용해 임의 길이의 문자열을 일치시킬 수 있습니다. 예: [\"ai_search_volume\",\">\",\"1000\"] 가능한 필터의 전체 목록은 여기에서 확인할 수 있습니다."
      },
      "order_by": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "description": "결과 정렬 규칙 선택 필드 filters 배열과 동일한 값을 사용해 결과를 정렬할 수 있습니다. 가능한 정렬 유형: asc - 결과를 오름차순으로 정렬합니다. desc - 결과를 내림차순으로 정렬합니다. 정렬 유형을 설정하려면 쉼표를 사용해야 합니다. 예: [\"ai_search_volume,desc\"] 참고로 단일 요청에서 정렬 규칙은 최대 세 개까지 설정할 수 있으며, 여러 정렬 규칙은 쉼표로 구분해야 합니다"
      },
      "offset": {
        "type": "integer",
        "description": "반환된 언급 데이터의 결과 배열에서의 오프셋 선택 필드 기본값: 0 예: 10 값을 지정하면 결과 배열의 처음 열 개 언급 객체를 건너뛰고 그다음 객체부터 데이터를 제공합니다. 참고: 최댓값은 9,000이며, 그 이상의 결과를 오프셋하려면 search_after_token을 사용하세요"
      },
      "search_after_token": {
        "type": "string",
        "description": "후속 요청용 토큰 선택 필드 각 요청의 응답에서 동일한 필드에 제공됩니다. 단일 요청으로 20,000개가 넘는 결과를 가져올 때 시간 초과를 피하려면 이 매개변수를 사용하세요. 응답 배열의 고유한 search_after_token 값을 지정하면 초기 작업의 후속 결과를 받을 수 있습니다. search_after_token 값은 후속 작업마다 고유합니다. 참고: 요청에 search_after_token을 지정한 경우 다른 모든 매개변수는 이전 요청과 동일해야 합니다"
      },
      "limit": {
        "type": "integer",
        "description": "반환되는 객체의 최대 수 선택 필드 기본값: 100 최댓값: 1000"
      },
      "tag": {
        "type": "string",
        "description": "사용자 정의 작업 식별자입니다. 선택 필드입니다. 최대 255자입니다. 이 매개변수를 사용해 작업을 식별하고 결과와 매칭할 수 있습니다. 지정한 tag 값은 응답의 data 객체에서 확인할 수 있습니다."
      }
    },
    "required": [
      "target"
    ]
  }
}
```

## Responses

### 200 — 성공 응답

Headers:
- `X-Request-Id` (string) — Felo 지원팀에 문의할 때 포함할 요청 식별자입니다.

**application/json**

Schema: object

```json
{
  "type": "object",
  "properties": {
    "version": {
      "type": "string",
      "description": "API의 현재 버전"
    },
    "status_code": {
      "type": "integer",
      "description": "일반 상태 코드입니다. 응답 코드 전체 목록은 여기에서 확인할 수 있습니다. 참고: 관련 예외 또는 오류 조건을 처리하는 시스템을 반드시 설계할 것을 강력히 권장합니다."
    },
    "status_message": {
      "type": "string",
      "description": "일반 정보 메시지입니다. 일반 정보 메시지 전체 목록은 여기에서 확인할 수 있습니다."
    },
    "time": {
      "type": "string",
      "description": "실행 시간, 초"
    },
    "cost": {
      "type": "number",
      "description": "전체 작업 비용, USD"
    },
    "tasks_count": {
      "type": "integer",
      "description": "tasks 배열의 작업 수"
    },
    "tasks_error": {
      "type": "integer",
      "description": "오류와 함께 반환된 tasks 배열의 작업 수"
    },
    "tasks": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "작업 배열"
    },
    "tasks.id": {
      "type": "string",
      "description": "작업 식별자. 시스템 내 고유 작업 식별자(UUID 형식)입니다."
    },
    "tasks.status_code": {
      "type": "integer",
      "description": "DataForSEO가 생성한 작업의 상태 코드로, 10000-60000 범위일 수 있습니다. 응답 코드 전체 목록은 여기에서 확인할 수 있습니다."
    },
    "tasks.status_message": {
      "type": "string",
      "description": "작업의 정보 메시지입니다. 일반 정보 메시지 전체 목록은 여기에서 확인할 수 있습니다."
    },
    "tasks.time": {
      "type": "string",
      "description": "실행 시간, 초"
    },
    "tasks.cost": {
      "type": "number",
      "description": "작업 비용, USD"
    },
    "tasks.result_count": {
      "type": "integer",
      "description": "result 배열의 요소 수"
    },
    "tasks.path": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "URL 경로"
    },
    "tasks.data": {
      "type": "object",
      "description": "POST 요청에 지정한 것과 동일한 매개변수를 포함합니다"
    },
    "tasks.result": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "결과 배열"
    },
    "tasks.result.total_count": {
      "type": "integer",
      "description": "요청과 관련된 총 결과 수"
    },
    "tasks.result.current_offset": {
      "type": "integer",
      "description": "items 배열에서 생략된 언급 객체 수"
    },
    "tasks.result.search_after_token": {
      "type": "string",
      "description": "후속 요청용 토큰 새 작업을 설정할 때 고유한 search_after_token을 지정하면 초기 작업의 후속 결과를 받을 수 있습니다. search_after_token 값은 후속 작업마다 고유합니다"
    },
    "tasks.result.items_count": {
      "type": "integer",
      "description": "items 배열에 반환된 결과 수"
    },
    "tasks.result.items": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "관련 언급 데이터를 포함합니다"
    },
    "tasks.result.items.platform": {
      "type": "string",
      "description": "POST 배열로 전달되는 플랫폼"
    },
    "tasks.result.items.model_name": {
      "type": "string",
      "description": "데이터를 가져온 AI 모델 이름 참고: google 플랫폼 유형의 경우 값은 항상 google_ai_overview입니다"
    },
    "tasks.result.items.location_code": {
      "type": "integer",
      "description": "POST 배열의 위치 코드"
    },
    "tasks.result.items.language_code": {
      "type": "string",
      "description": "POST 배열의 언어 코드"
    },
    "tasks.result.items.question": {
      "type": "string",
      "description": "관련 질문"
    },
    "tasks.result.items.answer": {
      "type": "string",
      "description": "마크다운 형식의 관련 답변 결과 콘텐츠를 마크다운 마크업 언어로 포맷한 것입니다"
    },
    "tasks.result.items.sources": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "소스 배열 모델이 최종 답변에서 인용하거나 참고한 소스"
    },
    "tasks.result.items.sources.snippet": {
      "type": "string",
      "description": "소스 설명"
    },
    "tasks.result.items.sources.source_name": {
      "type": "string",
      "description": "소스 이름"
    },
    "tasks.result.items.sources.thumbnail": {
      "type": "string",
      "description": "소스 썸네일"
    },
    "tasks.result.items.sources.markdown": {
      "type": "string",
      "description": "요소의 콘텐츠(마크다운 형식) 결과 콘텐츠를 마크다운 마크업 언어로 포맷한 것입니다"
    },
    "tasks.result.items.sources.position": {
      "type": "integer",
      "description": "결과 내 위치"
    },
    "tasks.result.items.sources.title": {
      "type": "string",
      "description": "소스 제목"
    },
    "tasks.result.items.sources.domain": {
      "type": "string",
      "description": "소스 도메인"
    },
    "tasks.result.items.sources.url": {
      "type": "string",
      "description": "소스 URL"
    },
    "tasks.result.items.sources.publication_date": {
      "type": "string",
      "description": "결과가 게시된 날짜와 시간(형식: “year-month-date:minutes:UTC_difference_hours:UTC_difference_minutes”) 예: 2019-11-15 12:57:46 +00:00"
    },
    "tasks.result.items.search_results": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "검색 결과 배열 모델이 정보를 조회할 때 검색한 모든 웹 검색 출력으로, 중복 및 사용되지 않은 항목을 포함합니다"
    },
    "tasks.result.items.search_results.description": {
      "type": "string",
      "description": "결과 설명"
    },
    "tasks.result.items.search_results.breadcrumb": {
      "type": "string",
      "description": "브레드크럼"
    },
    "tasks.result.items.search_results.position": {
      "type": "integer",
      "description": "결과 내 위치"
    },
    "tasks.result.items.search_results.title": {
      "type": "string",
      "description": "결과 제목"
    },
    "tasks.result.items.search_results.domain": {
      "type": "string",
      "description": "결과 도메인"
    },
    "tasks.result.items.search_results.url": {
      "type": "string",
      "description": "결과 URL"
    },
    "tasks.result.items.search_results.publication_date": {
      "type": "string",
      "description": "결과가 게시된 날짜와 시간(형식: “year-month-date:minutes:UTC_difference_hours:UTC_difference_minutes”) 예: 2019-11-15 12:57:46 +00:00"
    },
    "tasks.result.items.ai_search_volume": {
      "type": "integer",
      "description": "키워드의 현재 AI 검색량 비율입니다. 이 지표에 대한 자세한 내용은 여기에서 확인하세요."
    },
    "tasks.result.items.monthly_searches": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "월간 AI 검색량 비율 특정 연도 및 월의 AI 검색량 비율을 담은 객체 배열"
    },
    "tasks.result.items.monthly_searches.year": {
      "type": "integer",
      "description": "연도"
    },
    "tasks.result.items.monthly_searches.month": {
      "type": "integer",
      "description": "월"
    },
    "tasks.result.items.monthly_searches.search_volume": {
      "type": "integer",
      "description": "특정 연도 및 월의 AI 검색량 비율 이 지표에 대한 자세한 내용은 여기에서 확인하세요"
    },
    "tasks.result.items.first_response_at": {
      "type": "string",
      "description": "응답 데이터가 처음 기록된 날짜와 시간(UTC 형식: “yyyy-mm-dd hh-mm-ss +00:00”) 예: 2025-10-21 06:25:30 +00:00"
    },
    "tasks.result.items.last_response_at": {
      "type": "string",
      "description": "응답 데이터가 마지막으로 업데이트된 날짜와 시간(UTC 형식: “yyyy-mm-dd hh-mm-ss +00:00”) 예: 2025-10-21 06:25:30 +00:00"
    },
    "tasks.result.items.brand_entities": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "브랜드 엔터티 배열 응답에 언급된 브랜드 정보를 포함합니다"
    },
    "tasks.result.items.brand_entities.position": {
      "type": "integer",
      "description": "결과 내 위치"
    },
    "tasks.result.items.brand_entities.title": {
      "type": "string",
      "description": "브랜드 이름"
    },
    "tasks.result.items.brand_entities.category": {
      "type": "string",
      "description": "브랜드 카테고리"
    },
    "tasks.result.items.fan_out_queries": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "팬아웃 쿼리 배열 보다 종합적인 응답을 제공하기 위해 기본 쿼리에서 파생된 관련 검색 쿼리를 포함합니다"
    }
  }
}
```

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

### 401 — 유효한 Felo API 키가 필요합니다.

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

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

### 429 — 요청 또는 지출 한도에 도달했습니다.

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

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

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

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

**application/json**

Schema:

```json
{}
```