Oxylabs
AI-assisted web search.
GEO/AEO 가시성을 위해 AI 답변 엔진에 쿼리합니다.
source google_search 또는 google_ai_mode와 기타 문서화된 요청 필드를 사용해 동기식 AI 지원 검색을 실행합니다. 이 엔드포인트는 chatgpt, gemini, perplexity를 동기 소스로 허용하지 않습니다.
가격 참고
- 과금 기준: 성공한 요청당 고정 원가 기준.
- 참고 요청 추정치: USD 0.00145.
- 참고 고객 배수: 1.45. 정산된 고객 금액에 다시 적용하지 마세요.
참고용 메타데이터일 뿐이며, 계정 견적 또는 보장된 가격 또는 지출 한도가 아닙니다. 리소스 크레딧은 Felo 크레딧이 아닙니다. 최종 청구는 Felo 청구 기록을 따릅니다.
Google 답변 엔진용 패스스루 본문입니다. source가 엔진을 선택하며, query, render, parse, geo_location은 Google 소스가 기대하는 매개변수입니다. 추가 업스트림 매개변수는 그대로 전달됩니다.
- 유형: string 열거형source필수
쿼리할 Google AI 답변 엔진입니다.
google_search는 Google AI Overviews를,google_ai_mode는 Google AI Mode를 반환합니다. ChatGPT/Gemini/Perplexity에는 대신 비동기 엔드포인트post_oxylabs_llm을 사용하세요.값- google
_search - google
_ai _mode
- 유형: stringgeo
_location 쿼리의 국가 수준 지리적 위치입니다(예: "United States").
- 유형: booleanparse
원시 출력 대신 구조화된 파싱 결과를 반환합니다. 모든 소스에 권장됩니다.
- 유형: stringquery
검색 쿼리입니다.
google_search및google_ai_mode에 필요합니다. - 열거형render상수:html
google_search및google_ai_mode의 경우 파싱 전에 페이지를 렌더링하려면 "html"로 설정하세요.값- html
- 유형: anythingproperty
Name
- 유형: object200
쿼리가 성공적으로 완료되었습니다.
results[]에는 쿼리당 결과 하나가 들어 있습니다.content내부의 파싱된 형태는 소스에 따라 다릅니다(속성 설명 참조). 아래 예시는google_search(Google AI 개요) 형태입니다.- 유형: array object[]results
쿼리당 하나의 항목입니다. Realtime 단일 쿼리는 과금 단위인 결과 하나를 정확히 반환합니다.
- content유형: object
파싱된 답변 페이로드입니다. 구조는 Google 소스에 따라 다릅니다:
google_search→content.results.ai_overviews[];answer_text및references[]{source, url}(아래 참조).google_ai_mode→content.citations[]{text, urls[]}.
- results유형: object
Google 유형의 파싱된 결과 컨테이너입니다.
- ai유형: array object[]
_overviews 쿼리에 대해 반환된 Google AI Overviews입니다.
- answer유형: array object[]
_text AI가 생성한 답변으로, 인라인 참조를 포함할 수 있는 조각으로 분할됩니다.
- fragments유형: array object[]
- references유형: array
- references유형: array object[]
이 개요에 인용된 소스입니다.
- source유형: string
- url유형: string
application/json - 400
요청을 처리할 수 없습니다. 요청 매개변수를 확인하세요.
- 401
유효한 Felo API 키가 필요합니다.
- 402
청구 요건이 충족되지 않아 요청을 진행할 수 없습니다.
- 403
이 계정에는 이 작업을 수행할 권한이 없습니다.
- 429
요청 또는 지출 한도에 도달했습니다.
- 502
서비스가 요청을 완료할 수 없습니다.
- 503
API 또는 청구 서비스를 일시적으로 사용할 수 없습니다.
- 504
요청을 처리하는 동안 서비스 시간이 초과되었습니다.
- default
오류 응답. 업스트림 패스스루 응답은 공급자 형식을 사용할 수 있습니다.
application/json
curl https://openapi.felo.ai/v1/beta/oxylabs/ai-search \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '{
"source": "google_search",
"query": "best noise cancelling headphones 2026",
"parse": true,
"render": "html",
"geo_location": "United States"
}'
{
"results": [
{
"content": {
"results": {
"ai_overviews": [
{
"answer_text": [
{
"fragments": [
{
"references": "[Max Depth Exceeded]"
}
]
}
],
"references": [
{
"source": "string",
"url": "string"
}
]
}
]
}
}
}
]
}