Odpytuje silnik odpowiedzi AI pod kątem widoczności w GEO/AEO.
Oxylabs
AI-assisted web search.
Odpytuje silnik odpowiedzi AI pod kątem widoczności w GEO/AEO.
Uruchamia synchroniczne wyszukiwanie wspomagane przez AI ze źródłem google_search lub google_ai_mode i pozostałymi udokumentowanymi polami żądania. Ten endpoint nie przyjmuje chatgpt, gemini ani perplexity jako źródeł synchronicznych.
Cennik referencyjny
- Rozliczanie: stała podstawa kosztu za udane żądanie.
- Szacunek referencyjny dla żądania: USD 0.00145.
- Referencyjny mnożnik klienta: 1.45. Nie stosuj go ponownie do rozliczonej kwoty klienta.
Wyłącznie metadane referencyjne, a nie wycena konta, gwarantowana cena lub limit wydatków. Kredyty zasobów nie są kredytami Felo. Ostateczne obciążenia są zgodne z zapisami rozliczeniowymi Felo.
Treść przekazywana bez zmian dla silników odpowiedzi Google. source wybiera silnik; query, render, parse i geo_location to parametry oczekiwane przez źródła Google. Dodatkowe parametry upstream są przekazywane bez zmian.
- Typ: string enumsourcewymagane
Silnik odpowiedzi Google AI do zapytania.
google_searchzwraca Google AI Overviews;google_ai_modezwraca Google AI Mode. W przypadku ChatGPT/Gemini/Perplexity użyj zamiast tego asynchronicznego endpointupost_oxylabs_llm.wartości- google
_search - google
_ai _mode
- Typ: stringgeo
_location Lokalizacja geograficzna zapytania na poziomie kraju, np. "United States".
- Typ: booleanparse
Zwraca uporządkowane, przetworzone wyniki zamiast surowego wyniku. Zalecane dla każdego źródła.
- Typ: stringquery
Zapytanie wyszukiwania. Wymagane dla
google_searchigoogle_ai_mode. - enumrenderconst:html
Dla
google_searchigoogle_ai_modeustaw wartość "html", aby wyrenderować stronę przed przetworzeniem.wartości- html
- Typ: anythingproperty
Name
- Typ: object200
Zapytanie zakończone powodzeniem.
results[]zawiera jeden wynik na zapytanie. Przetworzony kształt wewnątrzcontentzależy od źródła (zobacz opisy właściwości); poniższy przykład pokazuje kształtgoogle_search(Google AI Overviews).- Typ: array object[]results
Jeden wpis na zapytanie. Pojedyncze zapytanie Realtime zwraca dokładnie jeden wynik, który jest jednostką rozliczeniową.
- contentTyp: object
Przetworzony ładunek odpowiedzi. Struktura zależy od źródła Google:
google_search→content.results.ai_overviews[]zanswer_textireferences[]{source, url}(pokazano poniżej).google_ai_mode→content.citations[]{text, urls[]}.
- resultsTyp: object
Kontener przetworzonych wyników typu Google.
- aiTyp: array object[]
_overviews Google AI Overviews zwrócone dla zapytania.
- answerTyp: array object[]
_text Odpowiedź wygenerowana przez AI, podzielona na fragmenty, które mogą zawierać odwołania w treści.
- fragmentsTyp: array object[]
- referencesTyp: array
- referencesTyp: array object[]
Źródła cytowane w tym przeglądzie.
- sourceTyp: string
- urlTyp: string
application/json - 400
Nie można przetworzyć żądania. Sprawdź parametry żądania.
- 401
Wymagany jest prawidłowy klucz API Felo.
- 402
Nie można kontynuować żądania, ponieważ nie spełniono wymogu rozliczeniowego.
- 403
Konto nie ma uprawnień do wykonania tej operacji.
- 429
Osiągnięto limit żądań lub wydatków.
- 502
Usługa nie mogła ukończyć żądania.
- 503
API lub usługa rozliczeniowa jest tymczasowo niedostępna.
- 504
Upłynął limit czasu usługi podczas przetwarzania żądania.
- default
Odpowiedź błędu; odpowiedzi przekazywane bezpośrednio od dostawcy upstream mogą używać formatów dostawcy
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"
}
]
}
]
}
}
}
]
}