Google Dataset Info na żywo — wersja zaawansowana
DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Google Dataset Info na żywo — wersja zaawansowana
Synchronicznie zwraca rekord jednego zbioru danych z wyszukiwarki Google Dataset Search. Zwraca keyword, type, se_domain, location_code, language_code, check_url, datetime, spell, refinement_chips, item_types, items_count i items. advanced jest domyślnym wyborem; 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.02.
- 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)[]
- datasetTyp: string
_id identyfikator zestawu danych
pole wymagane
identyfikator zestawu danych znajdziesz w adresie URL zestawu danych lub w elemencie
datasetwyników Google Dataset Searchprzykład:
L2cvMTFqbl85ZHN6MQ== - deviceTyp: string | null
typ urządzenia
pole opcjonalne
zwracaj wyniki dla określonego typu urządzenia
możliwa wartość:
desktop - languageTyp: string | null
_code kod języka wyszukiwarki
pole opcjonalne
jeśli używasz tego pola, nie musisz podawać
language_namemożliwa wartość:
en - languageTyp: string | null
_name pełna nazwa języka wyszukiwarki
pole opcjonalne
jeśli używasz tego pola, nie musisz podawać
language_codemożliwa wartość:
English - osTyp: string | null
system operacyjny urządzenia
pole opcjonalne
możliwe wartości:
windows,macoswartość domyślna:
windows - tagTyp: string | null
identyfikator zadania zdefiniowany przez użytkownika
pole opcjonalne
limit znaków to 255
możesz użyć tego parametru, aby zidentyfikować zadanie i dopasować je do wyniku
podaną wartość
tagznajdziesz w obiekciedataodpowiedzi
- Typ: object | null · Response36Afe1097B20_SerpGoogleDatasetInfoLiveAdvancedResponseInfo200
- 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_SerpGoogleDatasetInfoLiveAdvancedTaskInfo
- 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 adres URL do wyników wyszukiwarki
możesz go użyć, aby upewnić się, że dostarczyliś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żliwy typ pozycji:dataset - itemsTyp: array (object | null)[] | null
elementy wyników wyszukiwania znalezione w SERP
- areaTyp: array (string | null)[] | null
_covered lista obszarów objętych zestawem danych
na przykład:Africa,Global - authorsTyp: array (object | null)[] | null
lista autorów zestawu danych
- domainTyp: string | null
domena linku autora
- nameTyp: string | null
nazwa autora zbioru danych
- typeTyp: string | null
typ elementu
- urlTyp: string | null
URL linku autora
- datasetTyp: object | null · Response36Afe1097B20_DatasetDescription
_description opis zestawu danych
- linksTyp: array (object | null)[] | null
linki występujące w „dataset_description”
- descriptionTyp: string | null
opis elementu wyników
- domainTyp: string | null
domena, do której prowadzi link
- snippetTyp: string | null
tekst obok tytułu linku
- titleTyp: string | null
tytuł danego elementu linku
- typeTyp: string | null
typ elementu
- urlTyp: string | null
URL
- xpathTyp: string | null
XPath elementu
- textTyp: string | null
tekst opisu
- datasetTyp: string | null
_id identyfikator zestawu danych
- datasetTyp: array (object | null)[] | null
_providers lista instytucji, które udostępniły zestaw danych
- 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
- formatsTyp: array (object | null)[] | null
lista formatów plików zestawu danych
- formatTyp: string | null
typ formatu pliku zestawu danych
na przykład:zip,html,csv - sizeTyp: integer | null Format: int64
rozmiar pliku w bajtach
- typeTyp: string | null
typ elementu
- imageTyp: string | null
_url URL obrazu
adres URL prowadzący do obrazu w zasobie źródłowym lub w pamięci DataForSEO (gdy oryginalne źródło jest niedostępne) - licensesTyp: array (object | null)[] | null
lista licencji udzielonych zestawowi danych
- 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
- linksTyp: array (object | null)[] | null
sitelinki
linki wyświetlane pod niektórymi wynikami wyszukiwania Google Dataset
jeśli ich nie ma, równa sięnull- descriptionTyp: string | null
opis elementu wyników
- domainTyp: string | null
domena, do której prowadzi link
- snippetTyp: string | null
tekst obok tytułu linku
- titleTyp: string | null
tytuł danego elementu linku
- typeTyp: string | null
typ elementu
- urlTyp: string | null
URL
- xpathTyp: string | null
XPath elementu
- periodTyp: object | null · Response36Afe1097B20_PeriodCovered
_covered okres objęty zestawem danych
- displayedTyp: string | null
_date okres wyświetlany w SERP
przykład:Mar 2, 2020 - Dec 9, 2022 - endTyp: string | null
_date data i godzina zakończenia okresu
w formacie UTC: „yyyy-mm-dd hh-mm-ss +00:00”
przykład:2022-12-09 02:00:00 +00:00 - startTyp: string | null
_date data i godzina rozpoczęcia okresu
w formacie UTC: „yyyy-mm-dd hh-mm-ss +00:00”
przykład:2020-03-02 02:00:00 +00:00
- positionTyp: string | null
wyrównanie elementu w SERP
może przyjmować następujące wartości:left,right - rankTyp: integer | null
_absolute pozycja bezwzględna w SERP
bezwzględna pozycja wśród wszystkich elementów w SERP - rankTyp: integer | null
_group ranking grupy w SERP
pozycja w grupie elementów o identycznych wartościachtype
pozycje elementów o innych wartościachtypesą pomijane wrank_group - relatedTyp: string | null
_article link do powiązanego artykułu
link do opublikowanego artykułu powiązanego z zestawem danych - scholarlyTyp: string | null
_articles _url adres URL artykułów naukowych
link do listy artykułów naukowych w Google Scholar
przykład:https://scholar.google.com/scholar?q=%2210.6084%20m9%20figshare%207427933%20v1%22 - scholarlyTyp: integer | null Format: int64
_citations _count liczba artykułów odwołujących się do zestawu danych
- titleTyp: string | null
tytuł elementu
- typeTyp: string | null
typ elementu
- uniqueTyp: string | null
_identifier cyfrowy identyfikator obiektu
unikalny cyfrowy identyfikator zestawu danych
przykład:https://doi.org/10.5061/dryad.hmgqnk9m3 - updatedTyp: string | null
_date data i godzina ostatniej aktualizacji wyniku
w formacie UTC: „yyyy-mm-dd hh-mm-ss +00:00”
przykład:2022-11-27 02:00:00 +00:00 - xpathTyp: string | null
- 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 plus '+' zostanie zdekodowany jako spacja) - languageTyp: string | null
_code kod języka w tablicy POST
- 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, podajemy 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
- 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/dataset_info/live/advanced \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"dataset_id": "L2cvMTFqbl85ZHN6MQ=="
}
]'
{
"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,
"se_domain": null,
"language_code": null,
"check_url": null,
"datetime": null,
"spell": {
"keyword": null,
"type": null
},
"item_types": [
null
],
"se_results_count": null,
"items_count": null,
"items": [
{
"type": null,
"rank_group": null,
"rank_absolute": null,
"position": null,
"xpath": null,
"dataset_id": null,
"title": null,
"image_url": null,
"scholarly_citations_count": null,
"scholarly_articles_url": null,
"unique_identifier": null,
"related_article": null,
"links": [
"[Max Depth Exceeded]"
],
"dataset_providers": [
"[Max Depth Exceeded]"
],
"formats": [
"[Max Depth Exceeded]"
],
"authors": [
"[Max Depth Exceeded]"
],
"licenses": [
"[Max Depth Exceeded]"
],
"updated_date": null,
"area_covered": [
"[Max Depth Exceeded]"
],
"period_covered": "[Max Depth Exceeded]",
"dataset_description": "[Max Depth Exceeded]"
}
]
}
]
}
]
}