v0.2.0-beta

OpenAPI 3.1.0

실시간 Google AI 모드 SERP

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/serp/google/ai_mode/live/advanced

실시간 Google AI 모드 SERP

쿼리에 대한 Google AI 모드 답변을 인용한 소스와 함께 동기식으로 반환합니다. keyword, type, se_domain, location_code, language_code, check_url, datetime, spell, refinement_chips, item_types, items_count, items를 반환합니다. advanced가 기본 선택입니다. 순위 목록만 필요하면 regular, 파서가 누락한 항목을 확인하려면 html을 선택하세요. DataForSEO 응답 봉투로 감싸집니다. 데이터는 tasks[0].result, 처리 결과는 tasks[0].status_code에 있으며, 거부된 요청도 HTTP 200을 반환합니다.

가격 참고

과금 기준: 응답에 보고된 비용.
참고 요청 추정치: USD 0.004.
참고 고객 배수: 1.0. 정산된 고객 금액에 다시 적용하지 마세요.

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

본문

application/json

유형: array (object | null)[]
- browser_screen_height
  유형: integer | null
  
  브라우저 화면 높이
  
  선택 필드
  
  특정 기기의 픽셀 순위를 계산하도록 사용자 지정 브라우저 화면 높이를 설정할 수 있습니다;
  
  다음 범위 내에서 지정할 수 있습니다: 240-9999;
  
  기본적으로 이 매개변수는 다음과 같이 설정됩니다:
  
  1080 — desktop;
  
  640 — mobile(android);
  
  812 — mobile(iOS);
  
  참고: 이 매개변수를 사용하려면 calculate_rectangles를 true로 설정하세요
- browser_screen_resolution_ratio
  유형: integer | null
  
  브라우저 화면 해상도 비율
  
  선택 필드
  
  특정 기기의 픽셀 순위를 계산하도록 사용자 지정 브라우저 화면 해상도 비율을 설정할 수 있습니다;
  
  다음 범위 내에서 지정할 수 있습니다: 0.5-3;
  
  기본적으로 이 매개변수는 다음과 같이 설정됩니다:
  
  1 — desktop;
  
  3 — mobile(android);
  
  3 — mobile(iOS);
  
  참고: 이 매개변수를 사용하려면 calculate_rectangles를 true로 설정하세요
- browser_screen_width
  유형: integer | null 형식: int64
  
  브라우저 화면 너비
  
  선택 필드
  
  특정 기기의 픽셀 순위를 계산하도록 사용자 지정 브라우저 화면 너비를 설정할 수 있습니다;
  
  다음 범위 내에서 지정할 수 있습니다: 240-9999;
  
  기본적으로 이 매개변수는 다음과 같이 설정됩니다:
  
  1920 — desktop;
  
  360 — mobile(android);
  
  375 — mobile(iOS);
  
  참고: 이 매개변수를 사용하려면 calculate_rectangles를 true로 설정하세요
- calculate_rectangles
  유형: boolean | null
  
  고급 결과에서 SERP 요소의 픽셀 순위 계산
  
  선택 필드
  
  픽셀 순위는 결과 스니펫과 화면 왼쪽 위 모서리 사이의 거리를 의미합니다;
  
  자세한 내용은 Help Center에서 확인하세요>>
  
  기본적으로 이 매개변수는 false로 설정됩니다
  
  참고: true로 설정하면 작업당 요금이 2배가 됩니다
- device
  유형: string | null
  
  기기 유형
  
  선택 필드
  
  특정 기기 유형의 결과 반환
  
  다음 값 중에서 선택하세요:desktop, mobile
  
  기본값: desktop
- keyword
  유형: string
  
  키워드
  
  필수 필드
  
  keyword 필드에는 최대 700자를 지정할 수 있습니다
  
  모든 %##는 디코딩됩니다(‘+’ 문자는 공백 문자로 디코딩됩니다)
  
  keyword에 “%” 문자를 사용해야 하면 “%25”로 지정하세요;
  
  keyword에 “+” 문자를 사용해야 하면 “%2B”로 지정하세요
  
  DataForSEO API의 keyword 및 keywords 필드 규칙과 제한은 이 Help Center 문서에서 자세히 확인하세요
- language_code
  유형: string
  
  검색 엔진 언어 코드
  
  language_name을 지정하지 않으면 필수 필드;
  
  이 필드를 사용하면 language_name을 지정할 필요가 없습니다;
  
  사용 가능한 언어와 해당 language_code 목록은 https://api.dataforseo.com/v3/serp/google/ai_mode/languages로 별도 요청해 받을 수 있습니다
- language_name
  유형: string
  
  검색 엔진 언어의 전체 이름
  
  language_code를 지정하지 않으면 필수 필드;
  
  이 필드를 사용하면 language_code를 지정할 필요가 없습니다;
  
  사용 가능한 언어와 해당 language_name 목록은 https://api.dataforseo.com/v3/serp/google/ai_mode/languages로 별도 요청해 받을 수 있습니다;
- location_code
  유형: integer
  
  검색 엔진 위치 코드
  
  location_name 또는 location_coordinate를 지정하지 않으면 필수 필드
  
  이 필드를 사용하면 location_name 또는 location_coordinate를 지정할 필요가 없습니다
  
  사용 가능한 위치와 해당 location_code 목록은 https://api.dataforseo.com/v3/serp/google/locations에 별도 요청해 받을 수 있습니다
  
  참고: AI 모드가 현재 제공되는 국가 목록은 Google Search Help에서 확인하세요
- location_coordinate
  유형: string
  
  위치의 GPS 좌표
  
  location_name 또는 location_code를 지정하지 않으면 필수 필드
  
  이 필드를 사용하면 location_name 또는 location_code를 지정할 필요가 없습니다
  
  location_coordinate 매개변수는 "latitude,longitude,zoom" 형식으로 지정해야 합니다
  
  "zoom"을 지정하지 않으면 9z가 기본값으로 적용됩니다
  
  "latitude"와 "longitude"의 최대 소수 자릿수: 7
  
  "zoom"의 최솟값: 4z
  
  "zoom"의 최댓값: 18z
  
  예:
  
  52.6178549,-155.352142,18z
- location_name
  유형: string
  
  검색 엔진 위치의 전체 이름
  
  location_code 또는 location_coordinate를 지정하지 않으면 필수 필드
  
  이 필드를 사용하면 location_code 또는 location_coordinate를 지정할 필요가 없습니다
  
  사용 가능한 위치와 해당 location_name 목록은 https://api.dataforseo.com/v3/serp/google/locations에 별도 요청해 받을 수 있습니다
  
  참고: AI 모드가 현재 제공되는 국가 목록은 Google Search Help에서 확인하세요
- os
  유형: string | null
  
  기기 운영 체제
  
  선택 필드
  
  desktop을 device 필드에 지정하면 다음 값 중에서 선택하세요: windows, macos
  
  기본값: windows
  
  mobile을 device 필드에 지정하면 다음 값 중에서 선택하세요: android, ios
  
  기본값: android
- tag
  유형: string | null
  
  사용자 정의 작업 식별자
  
  선택 필드
  
  최대 255자
  
  이 매개변수를 사용해 작업을 식별하고 결과와 매칭할 수 있습니다
  
  지정한 tag 값은 응답의 data 객체에서 확인할 수 있습니다

응답

200
유형: object | null · Response36Afe1097B20_SerpGoogleAiModeLiveAdvancedResponseInfo
cost
유형: number | null 형식: double

전체 작업 비용, USD

status_code
유형: integer | null

일반 상태 코드입니다. 응답 코드 전체 목록은 여기에서 확인할 수 있습니다.

status_message
유형: string | null

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

tasks
유형: array (object | null)[] | null

작업 배열

유형: object | null · Response36Afe1097B20_SerpGoogleAiModeLiveAdvancedTaskInfo
cost
유형: number | null 형식: double

전체 작업 비용, USD

data
유형: object | null

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

propertyName
유형: object | null
id
유형: string | null

작업 식별자 시스템 내 고유 작업 식별자(UUID 형식)

path
유형: array (string | null)[] | null

URL 경로

result
유형: array (object | null)[] | null

결과 배열

check_url
유형: string | null

검색 엔진 결과로의 직접 URL
이 URL로 우리가 정확한 결과를 제공했는지 확인할 수 있습니다

datetime
유형: string | null

결과를 받은 날짜와 시간
UTC 형식: “yyyy-mm-dd hh-mm-ss +00:00”
예:
2019-11-15 12:57:46 +00:00

item_types
유형: array (string | null)[] | null

SERP의 검색 결과 유형
SERP에서 발견된 검색 결과 유형(items)을 포함합니다.
가능한 항목 유형:
ai_overview

items
유형: array (object | null)[] | null

요소의 항목

items
유형: array (object | null)[] | null

요소에 있는 항목

position
유형: string | null

SERP에서 요소의 정렬
다음 값을 사용할 수 있습니다:
left, right

type
유형: string | null

요소 유형

markdown
유형: string | null

markdown 형식의 요소 콘텐츠
markdown 마크업 언어로 서식이 지정된 ai_overview의 텍스트

page
유형: integer | null

SERP 페이지
요소가 순위를 차지하는 SERP 페이지

position
유형: string | null

SERP에서 요소의 정렬
다음 값을 사용할 수 있습니다:
left, right

rank_absolute
유형: integer | null

SERP 절대 순위
SERP의 모든 요소 중 절대 위치

rank_group
유형: integer | null

SERP 그룹 순위
type 값이 동일한 요소 그룹 내의 위치
type 값이 다른 요소의 위치는 rank_group에서 제외됩니다

rectangle
유형: object | null · Response36Afe1097B20_AiModeRectangleInfo

직사각형 매개변수
SERP에서 결과 스니펫의 직교 좌표와 픽셀 크기를 포함합니다
POST 요청의 calculate_rectangles가 true로 설정되지 않은 경우 null입니다

height
유형: number | null 형식: double

요소의 높이(픽셀)

width
유형: number | null 형식: double

요소의 너비(픽셀)

x
유형: number | null 형식: double

x축 좌표 결과 스니펫 왼쪽 위 모서리의 x축 좌표이며, 화면 왼쪽 위 모서리가 원점입니다

y
유형: number | null 형식: double

y축 좌표 결과 스니펫 왼쪽 위 모서리의 y축 좌표이며, 화면 왼쪽 위 모서리가 원점입니다

references
유형: array (object | null)[] | null

항목과 관련된 추가 참조
ai_overview를 생성하는 데 사용되었을 수 있는 웹페이지에 대한 참조를 포함합니다

domain
유형: string | null

참조의 도메인 이름

position
유형: string | null

SERP에서 요소의 정렬
다음 값을 사용할 수 있습니다:
left, right

source
유형: string | null

참조 출처 이름 또는 제목

text
유형: string | null

구성 요소의 텍스트

title
유형: string | null

링크 앵커 텍스트

type
유형: string | null

요소 유형

url
유형: string | null

링크 URL

type
유형: string | null

요소 유형

xpath
유형: string | null

요소의 XPath

items_count
유형: integer | null 형식: int64

items 배열에서 반환된 결과 수

keyword
유형: string | null

POST 배열에서 받은 키워드
키워드는 %##가 디코딩된 상태로 반환됩니다('+' 기호가 공백 문자로 디코딩됨)

language_code
유형: string | null

POST 배열의 언어 코드

location_code
유형: integer | null

POST 배열의 위치 코드

refinement_chips
유형: object | null · Response36Afe1097B20_RefinementChipsInfo

검색 세분화 칩
이 경우 값은 null입니다

items
유형: array (object | null)[] | null

요소의 항목

domain
유형: string | null

SERP 내 도메인

options
유형: array (object | null)[] | null

추가 검색 세분화 옵션

domain
유형: string | null

SERP 내 도메인

title
유형: string | null

요소의 제목

type
유형: string | null

요소 유형

url
유형: string | null

필터 매개변수가 포함된 검색 URL

title
유형: string | null

요소의 제목

type
유형: string | null

요소 유형

url
유형: string | null

필터 매개변수가 포함된 검색 URL

type
유형: string | null

요소 유형

xpath
유형: string | null

요소의 XPath

se_domain
유형: string | null

POST 배열의 검색 엔진 도메인

se_results_count
유형: integer | null 형식: int64

SERP의 총 결과 수

spell
유형: object | null · Response36Afe1097B20_SpellInfo

검색 엔진의 자동 교정
검색 엔진이 교정된 키워드에 대한 결과를 제공한 경우, 검색 엔진이 교정한 키워드와 자동 교정 유형을 명시합니다;
이 경우 값은 null입니다

keyword
유형: string | null

검색 엔진 자동 교정 결과로 얻은 키워드 교정된 키워드에 대한 결과가 제공됩니다

type
유형: string | null

자동 교정 유형 가능한 값: did_you_mean, showing_results_for, no_results_found_for, including_results_for 참고: Yahoo와 Yandex는 다음 자동 교정 유형만 지원합니다. including_results_for

type
유형: string | null

요소 유형

result_count
유형: integer | null 형식: int64

result 배열의 요소 수

status_code
유형: integer | null

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

status_message
유형: string | null

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

time
유형: string | null

실행 시간, 초

tasks_count
유형: integer | null 형식: int64

tasks 배열의 작업 수

tasks_error
유형: integer | null 형식: int64

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

time
유형: string | null

총 실행 시간(초)

version
유형: string | null

API의 현재 버전
application/json
400

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

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

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

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

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

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

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

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

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

application/json

post/v1/beta/dataforseo/serp/google/ai_mode/live/advanced

curl https://openapi.felo.ai/v1/beta/dataforseo/serp/google/ai_mode/live/advanced \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "language_code": "en",
    "location_code": 2840,
    "keyword": "what is google ai mode"
  }
]'

스키마 표시

{
  "version": null,
  "status_code": null,
  "status_message": null,
  "time": null,
  "cost": null,
  "tasks_count": null,
  "tasks_error": null,
  "tasks": [
    {
      "id": null,
      "status_code": null,
      "status_message": null,
      "time": null,
      "cost": null,
      "result_count": null,
      "path": [
        null
      ],
      "data": null,
      "result": [
        {
          "keyword": null,
          "type": null,
          "se_domain": null,
          "location_code": null,
          "language_code": null,
          "check_url": null,
          "datetime": null,
          "spell": {
            "keyword": null,
            "type": null
          },
          "refinement_chips": {
            "type": null,
            "xpath": null,
            "items": [
              "[Max Depth Exceeded]"
            ]
          },
          "item_types": [
            null
          ],
          "se_results_count": null,
          "items_count": null,
          "items": [
            {
              "type": null,
              "rank_group": null,
              "rank_absolute": null,
              "page": null,
              "position": null,
              "xpath": null,
              "markdown": null,
              "items": [
                "[Max Depth Exceeded]"
              ],
              "references": [
                "[Max Depth Exceeded]"
              ],
              "rectangle": "[Max Depth Exceeded]"
            }
          ]
        }
      ]
    }
  ]
}

작업 성공

도움이 필요하신가요?

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

실시간 Google AI 모드 SERP

인증Required

DataForSEO

실시간 Google AI 모드 SERP

가격 참고

도움이 필요하신가요?