Google Dataset Search naživo – pokročilé
DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Google Dataset Search naživo – pokročilé
Synchronně vrací datasety odpovídající dotazu ve vyhledávání Google Dataset Search. Vrací keyword, type, se_domain, location_code, language_code, check_url, datetime, spell, refinement_chips, item_types, items_count a items. advanced je výchozí volba; regular použijte, když záleží jen na pořadí, a html jen pro kontrolu, co parser vynechal. Zabaleno do obálky DataForSEO: data v tasks[0].result, výsledek v tasks[0].status_code – odmítnutý požadavek stále vrací HTTP 200.
Cenová reference
- Účtování: nahlášené náklady na odpověď.
- Referenční odhad požadavku: USD 0.02.
- Referenční multiplikátor zákazníka: 1.0. Neaplikujte jej znovu na zúčtovanou částku zákazníka.
Pouze referenční metadata, nikoli nabídka pro účet, garantovaná cena či limit utrácení. Kredity prostředků nejsou kredity Felo. Konečné účtování se řídí fakturačními záznamy Felo.
- Typ: array (object | null)[]
- depthTyp: integer | null
hloubka parsování
volitelné pole
počet výsledků v SERP
výchozí hodnota:
20maximální hodnota:
200
Váš účet bude účtován za každý SERP obsahující až 20 výsledků;nastavení hloubky nad 20 může vést k dodatečným poplatkům, pokud vyhledávač vrátí více než 20 výsledků;
pokud je zadaná hloubka vyšší než počet výsledků v odpovědi, rozdíl vám bude automaticky vrácen na zůstatek účtu.
- deviceTyp: string | null
typ zařízení
volitelné pole
vracet výsledky pro konkrétní typ zařízení
možná hodnota:
desktop - fileTyp: array string[] | null
_formats formáty souborů datové sady
volitelné pole
možné hodnoty:
other,archive,text,image,document,tabular - isTyp: boolean | null
_free určuje, zda jsou zobrazené datové sady zdarma
volitelné pole
možné hodnoty:
true,false - keywordTyp: string
klíčové slovo
povinné pole
do pole
keywordmůžete zadat až 700 znakůvšechny výskyty %## budou dekódovány (znak „+” bude dekódován jako mezera)
pokud potřebujete v
keywordpoužít znak „%”, zadejte jej jako „%25”;pokud potřebujete v
keywordpoužít znak „+”, zadejte jej jako „%2B”;
další informace o pravidlech a omezeních polí
keywordakeywordsv rozhraních API DataForSEO najdete v tomto článku Centra nápovědy - languageTyp: string | null
_code kód jazyka vyhledávače
volitelné pole, pokud nezadáte
language_namepokud toto pole použijete, nemusíte zadávat
language_namemožná hodnota:
en - languageTyp: string | null
_name úplný název jazyka vyhledávače
volitelné pole
pokud toto pole použijete, nemusíte zadávat
language_codemožná hodnota:
English - lastTyp: string | null
_updated poslední aktualizace datové sady
volitelné pole
možné hodnoty:
1m,1y,3y - osTyp: string | null
operační systém zařízení
volitelné pole
vyberte z následujících hodnot:
windows,macosvýchozí hodnota:
windows - tagTyp: string | null
identifikátor úlohy definovaný uživatelem
volitelné pole
limit znaků je 255
tento parametr můžete použít k identifikaci úlohy a jejímu spárování s výsledkem
zadanou hodnotu
tagnajdete v objektudataodpovědi - topicsTyp: array string[] | null
témata datové sady
volitelné pole
možné hodnoty:
humanities,social_sciences,life_sciences,agriculture,natural_sciences,geo,computer,architecture_and_urban_planning,engineering - usageTyp: string | null
_rights práva užívání datové sady
volitelné pole
možné hodnoty:
commercial,noncommercial
- Typ: object | null · Response36Afe1097B20_SerpGoogleDatasetSearchLiveAdvancedResponseInfo200
- Typ: number | null Formát: doublecost
celkové náklady na úlohy, USD
- Typ: integer | nullstatus
_code obecný kód stavu úplný seznam kódů odpovědí najdete zde
- Typ: string | nullstatus
_message obecná informační zpráva úplný seznam obecných informačních zpráv najdete zde
- Typ: array (object | null)[] | nulltasks
pole úloh
- Typ: object | null · Response36Afe1097B20_SerpGoogleDatasetSearchLiveAdvancedTaskInfo
- costTyp: number | null Formát: double
celkové náklady na úlohy, USD
- dataTyp: object | null
obsahuje stejné parametry, které jste zadali v požadavku POST
- propertyTyp: object | null
Name
- idTyp: string | null
identifikátor úlohy jedinečný identifikátor úlohy v našem systému ve formátu UUID
- pathTyp: array (string | null)[] | null
cesta URL
- resultTyp: array (object | null)[] | null
pole výsledků
- checkTyp: string | null
_url přímá adresa URL na výsledky vyhledávače
můžete ji použít k ověření, že jsme poskytli přesné výsledky - datetimeTyp: string | null
datum a čas přijetí výsledku
ve formátu UTC: „yyyy-mm-dd hh-mm-ss +00:00”
příklad:2019-11-15 12:57:46 +00:00 - itemTyp: array (string | null)[] | null
_types typy výsledků vyhledávání v SERP
obsahuje typy výsledků vyhledávání (items) nalezených v SERP.
možný typ položky:dataset - itemsTyp: array (object | null)[] | null
položky prvku
- areaTyp: array (string | null)[] | null
_covered seznam oblastí zahrnutých v datové sadě
například:Africa,Global - authorsTyp: array (object | null)[] | null
seznam autorů datové sady
- domainTyp: string | null
doména odkazu autora
- nameTyp: string | null
název autora datové sady
- typeTyp: string | null
typ prvku
- urlTyp: string | null
URL odkazu autora
- datasetTyp: object | null · Response36Afe1097B20_DatasetDescription
_description popis datové sady
- linksTyp: array (object | null)[] | null
odkazy uvedené v „dataset_description”
- descriptionTyp: string | null
popis prvku výsledků
- domainTyp: string | null
doména, na kterou odkaz vede
- snippetTyp: string | null
text vedle názvu odkazu
- titleTyp: string | null
název daného prvku odkazu
- typeTyp: string | null
typ prvku
- urlTyp: string | null
URL
- xpathTyp: string | null
XPath prvku
- textTyp: string | null
text popisu
- datasetTyp: string | null
_id ID datové sady
- datasetTyp: array (object | null)[] | null
_providers seznam institucí, které datovou sadu poskytly
- domainTyp: string | null
doména v SERP
- titleTyp: string | null
název prvku
- typeTyp: string | null
typ prvku
- urlTyp: string | null
URL vyhledávání s parametry upřesnění
- formatsTyp: array (object | null)[] | null
seznam formátů souborů datové sady
- formatTyp: string | null
typ formátu souboru datové sady
například:zip,html,csv - sizeTyp: integer | null Formát: int64
velikost souboru v bajtech
- typeTyp: string | null
typ prvku
- imageTyp: string | null
_url URL obrázku
URL vedoucí k obrázku na původním zdroji nebo v úložišti DataForSEO (pokud původní zdroj není dostupný) - licensesTyp: array (object | null)[] | null
seznam licencí vydaných k datové sadě
- domainTyp: string | null
doména v SERP
- titleTyp: string | null
název prvku
- typeTyp: string | null
typ prvku
- urlTyp: string | null
URL vyhledávání s parametry upřesnění
- linksTyp: array (object | null)[] | null
sitelinky
odkazy zobrazené pod některými výsledky vyhledávání Google Dataset
pokud žádné nejsou, rovná senull- descriptionTyp: string | null
popis prvku výsledků
- domainTyp: string | null
doména, na kterou odkaz vede
- snippetTyp: string | null
text vedle názvu odkazu
- titleTyp: string | null
název daného prvku odkazu
- typeTyp: string | null
typ prvku
- urlTyp: string | null
URL
- xpathTyp: string | null
XPath prvku
- periodTyp: object | null · Response36Afe1097B20_PeriodCovered
_covered období zahrnuté v datové sadě
- displayedTyp: string | null
_date období zobrazené v SERP
příklad:Mar 2, 2020 - Dec 9, 2022 - endTyp: string | null
_date datum a čas konce období
ve formátu UTC: „yyyy-mm-dd hh-mm-ss +00:00”
příklad:2022-12-09 02:00:00 +00:00 - startTyp: string | null
_date datum a čas začátku období
ve formátu UTC: „yyyy-mm-dd hh-mm-ss +00:00”
příklad:2020-03-02 02:00:00 +00:00
- positionTyp: string | null
zarovnání prvku v SERP
může nabývat následujících hodnot:left,right - rankTyp: integer | null
_absolute absolutní pořadí v SERP
absolutní pozice mezi všemi prvky v SERP - rankTyp: integer | null
_group pořadí skupiny v SERP
pozice ve skupině prvků se shodnými hodnotamitype
pozice prvků s jinými hodnotamitypese vrank_groupvynechávají - relatedTyp: string | null
_article odkaz na související článek
odkaz na publikovaný článek související s datovou sadou - scholarlyTyp: string | null
_articles _url URL odborných článků
odkaz na seznam odborných článků na Google Scholar
příklad:https://scholar.google.com/scholar?q=%2210.6084%20m9%20figshare%207427933%20v1%22 - scholarlyTyp: integer | null Formát: int64
_citations _count počet článků odkazujících na datovou sadu
- titleTyp: string | null
název prvku
- typeTyp: string | null
typ prvku
- uniqueTyp: string | null
_identifier digitální identifikátor objektu
jedinečný digitální identifikátor datové sady
příklad:https://doi.org/10.5061/dryad.hmgqnk9m3 - updatedTyp: string | null
_date datum a čas poslední aktualizace výsledku
ve formátu UTC: „yyyy-mm-dd hh-mm-ss +00:00”
příklad:2022-11-27 02:00:00 +00:00 - xpathTyp: string | null
- itemsTyp: integer | null Formát: int64
_count počet výsledků vrácených v poli
items - keywordTyp: string | null
klíčové slovo přijaté v poli POST
klíčové slovo se vrací s dekódovaným %## (znak plus '+' bude dekódován jako mezera) - languageTyp: string | null
_code kód jazyka v poli POST
- seTyp: string | null
_domain doména vyhledávače v poli POST
- seTyp: integer | null Formát: int64
_results _count celkový počet výsledků v SERP
- spellTyp: object | null · Response36Afe1097B20_SpellInfo
automatická oprava vyhledávače
pokud vyhledávač poskytl výsledky pro opravené klíčové slovo, uvedeme klíčové slovo opravené vyhledávačem a typ automatické opravy- keywordTyp: string | null
klíčové slovo získané v důsledku automatické opravy vyhledávače výsledky budou poskytnuty pro opravené klíčové slovo
- typeTyp: string | null
typ automatické opravy možné hodnoty: did_you_mean, showing_results_for, no_results_found_for, including_results_for poznámka: Yahoo a Yandex podporují pouze následující typ automatické opravy: including_results_for
- resultTyp: integer | null Formát: int64
_count počet prvků v poli result
- statusTyp: integer | null
_code stavový kód úlohy vygenerovaný DataForSEO; může být v následujícím rozsahu: 10000-60000 úplný seznam kódů odpovědí najdete zde
- statusTyp: string | null
_message informační zpráva úlohy úplný seznam obecných informačních zpráv najdete zde
- timeTyp: string | null
doba provedení, sekundy
- Typ: integer | null Formát: int64tasks
_count počet úloh v poli tasks
- Typ: integer | null Formát: int64tasks
_error počet úloh v poli tasks vrácených s chybou
- Typ: string | nulltime
celková doba provádění, sekundy
- Typ: string | nullversion
aktuální verze API
application/json - 400
Požadavek se nepodařilo zpracovat. Zkontrolujte parametry požadavku.
- 401
Je vyžadován platný API klíč Felo.
- 402
V požadavku nelze pokračovat, protože není splněn požadavek na fakturaci.
- 403
Účet nemá oprávnění tuto operaci provést.
- 429
Byl dosažen limit požadavků nebo útraty.
- 502
Služba nemohla požadavek dokončit.
- 503
API nebo fakturační služba je dočasně nedostupná.
- 504
Při zpracování požadavku vypršel časový limit služby.
- default
Chybová odpověď; odpovědi předávané přímo od upstream poskytovatele mohou používat formáty poskytovatele
application/json
curl https://openapi.felo.ai/v1/beta/dataforseo/serp/google/dataset_search/live/advanced \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"keyword": "water quality",
"last_updated": "1m",
"file_formats": [
"archive",
"image"
],
"usage_rights": "noncommercial",
"is_free": true,
"topics": [
"natural_sciences",
"geo"
]
}
]'
{
"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]"
}
]
}
]
}
]
}