DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Snímek obrazovky stránky SERP API
Vrací vykreslený snímek obrazovky stránky výsledků vyhledávání Google. Vrací keyword, type, se_domain, location_code, language_code, check_url, datetime, spell, refinement_chips, item_types, items_count a items. 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. Znovu jej neaplikujte na již 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)[]
- browserTyp: string | null
_preset předvolba rozlišení prohlížeče
volitelné pole
předvolba prohlížeče spojená s určitým typem zařízení
může nabývat následujících hodnot:desktop,tablet,mobile
Poznámka: ve výchozím nastavení předvolba prohlížeče odpovídá typu zařízení zadanému v požadavku POST - browserTyp: integer | null
_screen _height výška rozlišení prohlížeče
volitelné pole
lze zadat v následujícím rozsahu:240-9999
výchozí hodnota prodesktop: 1080
výchozí hodnota promobile: 844
výchozí hodnota protable: 1366 - browserTyp: number | null
_screen _scale _factor faktor měřítka prohlížeče
volitelné pole
lze zadat v následujícím rozsahu:0.5-3
výchozí hodnota prodesktop: 1
výchozí hodnota promobile: 3
výchozí hodnota protable: 2 - browserTyp: integer | null Formát: int64
_screen _width šířka rozlišení prohlížeče
volitelné pole
lze zadat v následujícím rozsahu:240-9999
výchozí hodnota prodesktop: 1920
výchozí hodnota promobile: 390
výchozí hodnota protable: 1024 - pageTyp: integer | null
počet stránek SERP
volitelné pole
pokuddepthv odpovídajícím požadavku POST úlohy překračuje 10 výsledků (nebo 1 stránku SERP), zadejte počet stránek SERP pro snímky obrazovky;
výchozí hodnota:1 - taskTyp: string
_id
- Typ: object | null · Response36Afe1097B20_SerpScreenshotResponseInfo200
- 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_SerpScreenshotTaskInfo
- 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ů
- itemsTyp: array (object | null)[] | null
pole položek
- imageTyp: string | null
snímek obrazovky požadované stránky
adresa URL snímku obrazovky stránky v úložišti DataForSEO
poznámka: snímek obrazovky uložený v úložišti DataForSEO zůstává dostupný pouze jeden den po odeslání požadavku
- itemsTyp: integer | null Formát: int64
_count počet položek v poli výsledků
- 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/screenshot \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"task_id": "06211235-0696-0139-1000-36727fbd3c90",
"browser_screen_scale_factor": 0.5
}
]'
{
"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": [
{
"items_count": null,
"items": [
{
"image": null
}
]
}
]
}
]
}