DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Google Organic SERP Advanced na żywo
Synchronicznie zwraca wyniki pozycjonowane dla słowa kluczowego w Google. Zwraca keyword, type, se_domain, location_code, language_code, check_url, datetime, spell, refinement_chips, item_types, items_count i items. advanced to domyślny wybór; wybierz regular, gdy liczy się tylko lista rankingowa, a html tylko po to, by sprawdzić, co pominął parser. Opakowane w kopertę DataForSEO: dane w tasks[0].result, wynik w tasks[0].status_code — odrzucone żądanie nadal zwraca HTTP 200.
Cennik referencyjny
- Rozliczanie: zgłoszony koszt odpowiedzi.
- Szacunek referencyjny dla żądania: USD 0.0175.
- Referencyjny mnożnik klienta: 1.0. 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.
- Typ: array (object | null)[]
- browserTyp: integer | null
_screen _height wysokość ekranu przeglądarki pole opcjonalne możesz ustawić niestandardową wysokość ekranu przeglądarki, aby obliczyć pozycje pikselowe dla konkretnego urządzenia; można ją podać w następującym zakresie: 240-9999; domyślnie parametr ma wartość: 1080 dla desktop; 640 dla mobile na systemie android; 812 dla mobile na iOS; Uwaga: aby użyć tego parametru, ustaw calculate_rectangles na true
- browserTyp: integer | null
_screen _resolution _ratio współczynnik rozdzielczości ekranu przeglądarki pole opcjonalne możesz ustawić niestandardowy współczynnik rozdzielczości ekranu przeglądarki, aby obliczyć pozycje pikselowe dla konkretnego urządzenia; można go podać w następującym zakresie: 0.5-3; domyślnie parametr ma wartość: 1 dla desktop; 3 dla mobile na systemie android; 3 dla mobile na iOS; Uwaga: aby użyć tego parametru, ustaw calculate_rectangles na true
- browserTyp: integer | null Format: int64
_screen _width szerokość ekranu przeglądarki pole opcjonalne możesz ustawić niestandardową szerokość ekranu przeglądarki, aby obliczyć pozycje pikselowe dla konkretnego urządzenia; można ją podać w następującym zakresie: 240-9999; domyślnie parametr ma wartość: 1920 dla desktop; 360 dla mobile na systemie android; 375 dla mobile na iOS; Uwaga: aby użyć tego parametru, ustaw calculate_rectangles na true
- calculateTyp: boolean | null
_rectangles obliczaj pozycje pikselowe elementów SERP w wynikach zaawansowanych pole opcjonalne pozycja pikselowa to odległość między fragmentem wyniku a lewym górnym rogiem ekranu; Odwiedź Centrum pomocy, aby dowiedzieć się więcej>> domyślnie parametr ma wartość false; Uwaga: za użycie tego parametru zostanie naliczona dodatkowa opłata $0.002
- depthTyp: integer | null
głębokość parsowania pole opcjonalne liczba wyników w SERP wartość domyślna: 10 wartość maksymalna: 200 Twoje konto zostanie obciążone za każdy SERP zawierający do 10 wyników; Ustawienie głębokości powyżej 10 może wiązać się z dodatkowymi opłatami, jeśli wyszukiwarka zwróci więcej niż 10 wyników; Koszt można obliczyć na stronie Cennik.
- deviceTyp: string | null
typ urządzenia pole opcjonalne zwracaj wyniki dla określonego typu urządzenia może przyjmować wartości: desktop, mobile wartość domyślna: desktop
- findTyp: array string[] | null
_targets _in typy elementów SERP do sprawdzania pod kątem celów pole opcjonalne aby włączyć ten parametr, należy również włączyć stop_crawl_on_match określa, które typy elementów SERP mają być sprawdzane pod kątem dopasowań celów jeśli nie podano, wszystkie elementy pierwszego poziomu z polami url i domain są sprawdzane pod kątem celów możliwe wartości: organic, paid, local_pack, featured_snippet, events, google_flights, images, jobs, knowledge_graph, local_service, map, scholarly_articles, third_party_reviews, twitter Uwaga: nie może zawierać tych samych typów elementów co ignore_targets_in przykład: "find_targets_in": ["organic", "featured_snippet"] więcej o tym parametrze w naszym Centrum pomocy
- groupTyp: boolean | null
_organic _results wyświetlaj powiązane wyniki pole opcjonalne jeśli ustawione na true, element related_result w odpowiedzi zostanie podany jako fragment nadrzędnego wyniku organicznego; jeśli ustawione na false, element related_result zostanie podany jako osobny wynik organiczny; wartość domyślna: true
- ignoreTyp: array string[] | null
_targets _in typy elementów SERP wykluczane z wyszukiwania celów pole opcjonalne aby włączyć ten parametr, należy również włączyć stop_crawl_on_match określa, które typy elementów SERP mają być wykluczone podczas wyszukiwania dopasowań celów możliwe wartości: organic, paid, local_pack, featured_snippet, events, google_flights, images, jobs, knowledge_graph, local_service, map, scholarly_articles, third_party_reviews, twitter Uwaga: nie może zawierać tych samych typów elementów co find_targets_in przykład: "ignore_targets_in": ["paid", "images"] więcej o tym parametrze w naszym Centrum pomocy
- keywordTyp: string
słowo kluczowe pole wymagane w polu keyword możesz podać do 700 znaków wszystkie ciągi %## zostaną zdekodowane (znak „+” zostanie zdekodowany jako spacja) jeśli potrzebujesz użyć znaku „%” w polu keyword, podaj go jako „%25”; jeśli potrzebujesz użyć znaku „+” w polu keyword, podaj go jako „%2B”; jeśli to pole zawiera parametry takie jak „allinanchor:”, „allintext:”, „allintitle:”, „allinurl:”, „cache:”, „define:”, „definition:”, „filetype:”, „id:”, „inanchor:”, „info:”, „intext:”, „intitle:”, „inurl:”, „link:”, „site:”, opłata za zadanie zostanie pomnożona przez 5 więcej o zasadach i ograniczeniach pól keyword i keywords w interfejsach API DataForSEO znajdziesz w tym artykule Centrum pomocy
- languageTyp: string | null
_code kod języka wyszukiwarki pole opcjonalne, jeśli podasz language_name jeśli używasz tego pola, nie musisz podawać language_name listę dostępnych języków wyszukiwarki wraz z ich language_code można uzyskać, wysyłając osobne żądanie do https://api.dataforseo.com/v3/serp/google/languages przykład: en
- languageTyp: string | null
_name pełna nazwa języka wyszukiwarki pole opcjonalne, jeśli podasz language_code jeśli używasz tego pola, nie musisz podawać language_code listę dostępnych języków wyszukiwarki wraz z ich language_name można uzyskać, wysyłając osobne żądanie do https://api.dataforseo.com/v3/serp/google/languages przykład: English
- loadTyp: boolean | null
_async _ai _overview wczytuj asynchroniczny przegląd AI pole opcjonalne ustaw na true, aby uzyskiwać elementy ai_overview w SERP nawet jeśli są wczytywane asynchronicznie; po ustawieniu na false otrzymasz elementy ai_overview tylko z pamięci podręcznej; wartość domyślna: false Uwaga: za użycie tego parametru zostanie naliczona dodatkowa opłata $0.002; jeśli element jest nieobecny lub zawiera "asynchronous_ai_overview": false, wszystkie dodatkowe opłaty zostaną zwrócone na saldo Twojego konta
- locationTyp: integer | null
_code kod lokalizacji wyszukiwarki pole wymagane, jeśli nie podasz location_name lub location_coordinate jeśli używasz tego pola, nie musisz podawać location_name lub location_coordinate listę dostępnych lokalizacji wyszukiwarek wraz z ich location_code można uzyskać, wysyłając osobne żądanie do https://api.dataforseo.com/v3/serp/google/locations przykład: 2840
- locationTyp: string | null
_coordinate współrzędne GPS lokalizacji pole opcjonalne, jeśli podasz location_name lub location_code jeśli używasz tego pola, nie musisz podawać location_name lub location_code parametr location_coordinate należy podać w formacie "latitude,longitude,radius" maksymalna liczba cyfr po przecinku dla "latitude" i "longitude": 7 minimalna wartość dla "radius": 199 (mm) maksymalna wartość dla "radius": 199999 (mm) przykład: 53.476225,-2.243572,200
- locationTyp: string | null
_name pełna nazwa lokalizacji wyszukiwarki pole wymagane, jeśli nie podasz location_code lub location_coordinate jeśli używasz tego pola, nie musisz podawać location_code lub location_coordinate listę dostępnych lokalizacji wyszukiwarki wraz z ich location_name można uzyskać, wysyłając osobne żądanie do https://api.dataforseo.com/v3/serp/google/locations przykład: London,England,United Kingdom
- matchTyp: string | null
_type typ dopasowania celu pole wymagane, jeśli podano stop_crawl_on_match typ dopasowania dla match_value możliwe wartości: domain – konkretna domena lub subdomena with_subdomains – domena główna i subdomeny wildcard – wzorzec wieloznaczny
- matchTyp: string | null
_value docelowa domena, subdomena lub wartość wieloznaczna pole wymagane, jeśli podano stop_crawl_on_match podaj docelową domenę, subdomenę lub wartość wieloznaczną; Uwaga: domenę lub subdomenę należy podać bez protokołu żądania; przykład: "match_value": "dataforseo.com", "match_value": "/blog/post-*"
- maxTyp: integer | null
_crawl _pages limit indeksowania stron pole opcjonalne liczba stron wyników wyszukiwania do indeksowania wartość maksymalna: 100 Uwaga: za każdą zindeksowaną stronę zostanie naliczona opłata (10 wyników organicznych na stronę); więcej o cenniku na stronie Cennik; Uwaga#2: parametry max_crawl_pages i depth uzupełniają się; więcej informacji w naszym Centrum pomocy
- osTyp: string | null
system operacyjny urządzenia pole opcjonalne jeśli w polu device podasz desktop, wybierz spośród następujących wartości: windows, macos wartość domyślna: windows jeśli w polu device podasz mobile, wybierz spośród następujących wartości: android, ios wartość domyślna: android
- peopleTyp: integer | null
_also _ask _click _depth kliknięcia w odpowiedni element pole opcjonalne podaj głębokość kliknięć w elemencie people_also_ask, aby uzyskać dodatkowe elementy people_also_ask_element; Uwaga: Twoje konto zostanie obciążone dodatkową kwotą $0.00015 za każde kliknięcie; jeśli element jest nieobecny lub wykonamy mniej kliknięć niż podano, wszystkie dodatkowe opłaty zostaną zwrócone na saldo Twojego konta możliwe wartości: od 1 do 4
- removeTyp: array string[] | null
_from _url usuwanie określonych parametrów z adresów URL pole opcjonalne za pomocą tego pola możesz podać do 10 parametrów do usunięcia z adresów URL w wyniku przykład: "remove_from_url": ["srsltid"] Uwaga: jeśli podano pole target, podane parametry URL zostaną usunięte przed wyszukiwaniem
- seTyp: string | null
_domain domena wyszukiwarki pole opcjonalne odpowiednią domenę wyszukiwarki wybieramy automatycznie na podstawie podanej lokalizacji i języka możesz jednak ustawić niestandardową domenę wyszukiwarki w tym polu przykład: google.co.uk, google.com.au, google.de itd.
- searchTyp: string | null
_param dodatkowe parametry zapytania wyszukiwania pole opcjonalne listę dostępnych parametrów i dodatkowe szczegóły znajdziesz tutaj Uwaga: następujące parametry wyszukiwarki nie są obsługiwane i zostaną automatycznie wyłączone, jeśli zostaną podane: lr, cr, as_qdr, as_sitesearch, as_occt, as_filetype.
- stopTyp: array (object | null)[] | null
_crawl _on _match tablica celów do zatrzymania indeksowania pole opcjonalne jeśli zostanie podana, odpowiedź będzie zawierać wyniki SERP do wskazanego match_value włącznie; w tej tablicy możesz podać do 10 wartości docelowych przykład: "stop_crawl_on_match":[{"match_value":"dataforseo.com","match_type":"with_subdomains"}] więcej o tym parametrze przeczytasz w naszym Centrum pomocy — https://dataforseo.com/help-center/using-the-stop_crawl_on_match-parameter-in-serp-api Twoje konto zostanie obciążone za każdy SERP przeszukany przez wskazane cele
- matchTyp: string | null
_type typ dopasowania celu pole wymagane, jeśli podano stop_crawl_on_match; typ dopasowania dla match_value możliwe wartości: domain, with_subdomains, wildcard
- matchTyp: string | null
_value domena docelowa lub wartość wieloznaczna pole wymagane, jeśli podano stop_crawl_on_match; podaj domenę docelową lub wartość wieloznaczną; Uwaga: nazwę domeny należy podać bez protokołu żądania; przykład: dataforseo.com
- tagTyp: string | null
Identyfikator zadania zdefiniowany przez użytkownika. Pole opcjonalne. Limit znaków wynosi 255. Za pomocą tego parametru możesz zidentyfikować zadanie i dopasować je do wyniku. Podaną wartość tag znajdziesz w obiekcie data odpowiedzi.
- targetTyp: string | null
docelowa domena, subdomena lub strona internetowa, dla której mają zostać pobrane wyniki pole opcjonalne domenę lub subdomenę należy podać bez https:// i www. pamiętaj, że wyniki zadań dotyczących target będą zawierać tylko elementy SERP zawierające ciąg url; możesz też użyć znaku wieloznacznego (‘’) do określenia wzorca wyszukiwania w SERP i zawężenia wyników; przykłady: example.com - zwraca wyniki dla strony głównej witryny z adresami URL, takimi jak https://example.com, https://www.example.com/ lub https://example.com/; example.com - zwraca wyniki dla domeny, w tym wszystkie jej strony; example.com - zwraca wyniki dla całej domeny, w tym wszystkich jej stron i subdomen; example.com - zwraca wyniki dla strony głównej niezależnie od subdomeny, np. https://en.example.com; example.com/example-page - zwraca wyniki dla dokładnie tego adresu URL; example.com/example-page - zwraca wyniki dla wszystkich adresów URL domeny rozpoczynających się od podanego ciągu
- targetTyp: string | null
_search _mode tryb dopasowywania celów pole opcjonalne aby włączyć ten parametr, należy również włączyć stop_crawl_on_match określa, jak indeksowanie ma się zatrzymać, gdy w stop_crawl_on_match podano wiele celów możliwe wartości: all, any all – indeksowanie zatrzymuje się dopiero po znalezieniu wszystkich podanych celów any – indeksowanie zatrzymuje się po znalezieniu dowolnego pojedynczego celu wartość domyślna: any więcej o tym parametrze w naszym Centrum pomocy
- urlTyp: string | null
bezpośredni URL zapytania wyszukiwania pole opcjonalne możesz podać bezpośredni URL, a my rozłożymy go na odpowiednie pola. Pamiętaj, że ta metoda jest najtrudniejsza do przetworzenia przez nasze API i wymaga podania dokładnego języka oraz lokalizacji w URL. W większości przypadków nie zalecamy jej stosowania. przykład: https://www.google.co.uk/search?q=%20rank%20tracker%20api&hl=en&gl=GB&uule=w+CAIQIFISCXXeIa8LoNhHEZkq1d1aOpZS Uwaga: następujące parametry wyszukiwarki nie są obsługiwane i zostaną automatycznie wyłączone, jeśli zostaną podane: lr, cr, as_qdr, as_sitesearch, as_occt, as_filetype.
- Typ: object | null · Response36Afe1097B20_SerpGoogleOrganicLiveAdvancedResponseInfo200
- Typ: number | null Format: doublecost
łączny koszt zadań, USD
- Typ: integer | nullstatus
_code ogólny kod statusu pełną listę kodów odpowiedzi znajdziesz tutaj
- Typ: string | nullstatus
_message ogólny komunikat informacyjny pełną listę ogólnych komunikatów informacyjnych znajdziesz tutaj
- Typ: array (object | null)[] | nulltasks
tablica zadań
- Typ: object | null · Response36Afe1097B20_SerpGoogleOrganicLiveAdvancedTaskInfo
- costTyp: number | null Format: double
łączny koszt zadań, USD
- dataTyp: object | null
zawiera te same parametry, które podano w żądaniu POST
- propertyTyp: object | null
Name
- idTyp: string | null
identyfikator zadania unikalny identyfikator zadania w naszym systemie w formacie UUID
- pathTyp: array (string | null)[] | null
ścieżka URL
- resultTyp: array (object | null)[] | null
tablica wyników
- checkTyp: string | null
_url bezpośredni URL do wyników wyszukiwania. Możesz go użyć, aby upewnić się, że udostępniliśmy dokładne wyniki
- datetimeTyp: string | null
data i godzina otrzymania wyniku w formacie UTC: „yyyy-mm-dd hh-mm-ss +00:00”, przykład: 2019-11-15 12:57:46 +00:00
- itemTyp: array (string | null)[] | null
_types typy wyników wyszukiwania w SERP zawiera typy wyników wyszukiwania (items) znalezionych w SERP. możliwe typy pozycji: answer_box, app, carousel, multi_carousel, featured_snippet, google_flights, google_reviews, third_party_reviews, images, jobs, knowledge_graph, local_pack, hotels_pack, map, organic, paid, people_also_ask, related_searches, people_also_search, shopping, top_stories, twitter, video, events, recipes, top_sights, scholarly_articles, popular_products, questions_and_answers, find_results_on, stocks_box, commercial_units, local_services, google_hotels, math_solver, currency_box, product_considerations, short_videos, refine_products, perspectives, discussions_and_forums, compare_sites, ai_overview
- itemsTyp: array (object | null)[] | null
pozycje elementu
- pageTyp: integer | null
numer strony wyników wyszukiwania
wskazuje numer strony SERP, na której znajduje się element - positionTyp: string | null
wyrównanie elementu w SERP
może przyjmować następujące wartości:left,right - rectangleTyp: object | null · Response36Afe1097B20_AiModeRectangleInfo
parametry prostokąta
zawiera współrzędne kartezjańskie i wymiary pikselowe fragmentu wyniku w SERP
równa sięnull, jeślicalculate_rectanglesw żądaniu POST nie ma wartościtrue- heightTyp: number | null Format: double
wysokość elementu w pikselach
- widthTyp: number | null Format: double
szerokość elementu w pikselach
- xTyp: number | null Format: double
współrzędna osi x współrzędna osi x lewego górnego rogu fragmentu wyniku, gdzie początkiem układu jest lewy górny róg ekranu
- yTyp: number | null Format: double
współrzędna osi y współrzędna osi y lewego górnego rogu fragmentu wyniku, gdzie początkiem układu jest lewy górny róg ekranu
- typeTyp: string | null
typ elementu
- xpathTyp: string | null
XPath elementu
- itemsTyp: integer | null Format: int64
_count Liczba wyników zwróconych w tablicy items.
- keywordTyp: string | null
słowo kluczowe otrzymane w tablicy POST słowo kluczowe jest zwracane z zdekodowanym %## (znak „+” zostanie zdekodowany do znaku spacji)
- languageTyp: string | null
_code Kod języka w tablicy POST.
- locationTyp: integer | null
_code Kod lokalizacji w tablicy POST.
- pagesTyp: integer | null Format: int64
_count łączna liczba pobranych stron wyników wyszukiwania łączna liczba pobranych SERP w wyniku
- refinementTyp: object | null · Response36Afe1097B20_RefinementChipsInfo
_chips żetony uściślania wyszukiwania
- itemsTyp: array (object | null)[] | null
pozycje elementu
- domainTyp: string | null
domena w SERP
- optionsTyp: array (object | null)[] | null
dalsze opcje zawężania wyszukiwania
- domainTyp: string | null
domena w SERP
- titleTyp: string | null
tytuł elementu
- typeTyp: string | null
typ elementu
- urlTyp: string | null
adres URL wyszukiwania z parametrami zawężającymi
- titleTyp: string | null
tytuł elementu
- typeTyp: string | null
typ elementu
- urlTyp: string | null
adres URL wyszukiwania z parametrami zawężającymi
- typeTyp: string | null
typ elementu
- xpathTyp: string | null
XPath elementu
- seTyp: string | null
_domain domena wyszukiwarki w tablicy POST
- seTyp: integer | null Format: int64
_results _count łączna liczba wyników w SERP
- spellTyp: object | null · Response36Afe1097B20_SpellInfo
autokorekta wyszukiwarki. Jeśli wyszukiwarka zwróciła wyniki dla poprawionego słowa kluczowego, podamy słowo kluczowe poprawione przez wyszukiwarkę oraz typ autokorekty
- keywordTyp: string | null
słowo kluczowe uzyskane w wyniku autokorekty wyszukiwarki wyniki zostaną udostępnione dla poprawionego słowa kluczowego
- typeTyp: string | null
typ autokorekty możliwe wartości: did_you_mean, showing_results_for, no_results_found_for, including_results_for uwaga: Yahoo i Yandex obsługują tylko następujący typ autokorekty: including_results_for
- typeTyp: string | null
typ elementu
- resultTyp: integer | null Format: int64
_count liczba elementów w tablicy result
- statusTyp: integer | null
_code kod statusu zadania wygenerowany przez DataForSEO; może mieścić się w następującym zakresie: 10000-60000 pełną listę kodów odpowiedzi znajdziesz tutaj
- statusTyp: string | null
_message komunikat informacyjny zadania pełną listę ogólnych komunikatów informacyjnych znajdziesz tutaj
- timeTyp: string | null
czas wykonania, sekundy
- Typ: integer | null Format: int64tasks
_count liczba zadań w tablicy tasks
- Typ: integer | null Format: int64tasks
_error liczba zadań w tablicy tasks zwróconych z błędem
- Typ: string | nulltime
łączny czas wykonania, sekundy
- Typ: string | nullversion
bieżąca wersja interfejsu API
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/dataforseo/serp/google/organic/live/advanced \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"language_code": "en",
"location_code": 2840,
"keyword": "albert einstein",
"calculate_rectangles": true
}
]'
{
"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,
"pages_count": null,
"items_count": null,
"items": [
{
"type": null,
"page": null,
"position": null,
"xpath": null,
"rectangle": "[Max Depth Exceeded]"
}
]
}
]
}
]
}