DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Live: Google Organic SERP avanzato
Restituisce in modo sincrono i risultati classificati per una keyword su Google. Restituisce keyword, type, se_domain, location_code, language_code, check_url, datetime, spell, refinement_chips, item_types, items_count e items. advanced è la scelta predefinita; usa regular quando conta solo l'elenco classificato e html solo per verificare cosa ha scartato il parser. Incapsulato nella struttura DataForSEO: dati in tasks[0].result, esito in tasks[0].status_code – una richiesta rifiutata restituisce comunque HTTP 200.
Riferimento prezzi
- Misurazione: costo della risposta comunicato.
- Stima di riferimento per richiesta: USD 0.0175.
- Moltiplicatore di riferimento per il cliente: 1.0. Non applicarlo di nuovo a un importo già addebitato al cliente.
Solo metadati di riferimento, non un preventivo dell'account, né un prezzo garantito o un limite di spesa. I crediti delle risorse non sono crediti Felo. Gli addebiti finali seguono le registrazioni di fatturazione Felo.
- Tipo: array (object | null)[]
- browserTipo: integer | null
_screen _height altezza dello schermo del browser campo facoltativo è possibile impostare un'altezza personalizzata dello schermo del browser per calcolare il posizionamento in pixel per un dispositivo specifico; può essere specificata nel seguente intervallo: 240-9999; per impostazione predefinita, il parametro è impostato su: 1080 per desktop; 640 per mobile su android; 812 per mobile su iOS; Nota: per usare questo parametro, impostare calculate_rectangles su true
- browserTipo: integer | null
_screen _resolution _ratio rapporto di risoluzione dello schermo del browser campo facoltativo è possibile impostare un rapporto di risoluzione personalizzato dello schermo del browser per calcolare il posizionamento in pixel per un dispositivo specifico; può essere specificato nel seguente intervallo: 0.5-3; per impostazione predefinita, il parametro è impostato su: 1 per desktop; 3 per mobile su android; 3 per mobile su iOS; Nota: per usare questo parametro, impostare calculate_rectangles su true
- browserTipo: integer | null Formato: int64
_screen _width larghezza dello schermo del browser campo facoltativo è possibile impostare una larghezza personalizzata dello schermo del browser per calcolare il posizionamento in pixel per un dispositivo specifico; può essere specificata nel seguente intervallo: 240-9999; per impostazione predefinita, il parametro è impostato su: 1920 per desktop; 360 per mobile su android; 375 per mobile su iOS; Nota: per usare questo parametro, impostare calculate_rectangles su true
- calculateTipo: boolean | null
_rectangles calcola il posizionamento in pixel per gli elementi SERP nei risultati avanzati campo facoltativo il posizionamento in pixel indica la distanza tra lo snippet del risultato e l'angolo in alto a sinistra dello schermo; Visita il Help Center per saperne di più>> per impostazione predefinita, il parametro è impostato su false; Nota: per l'uso di questo parametro verranno addebitati 0,002 $ in più
- depthTipo: integer | null
profondità di parsing campo facoltativo numero di risultati nella SERP valore predefinito: 10 valore massimo: 200 L'account viene fatturato per ogni SERP contenente fino a 10 risultati; un'impostazione della profondità superiore a 10 può comportare costi aggiuntivi se il motore di ricerca restituisce più di 10 risultati; il costo può essere calcolato nella pagina Pricing.
- deviceTipo: string | null
tipo di dispositivo campo facoltativo restituisce i risultati per un tipo di dispositivo specifico può assumere i valori: desktop, mobile valore predefinito: desktop
- findTipo: array string[] | null
_targets _in tipi di elemento SERP da controllare per i target campo facoltativo per abilitare questo parametro, deve essere abilitato anche stop_crawl_on_match specifica quali tipi di elemento SERP devono essere controllati per le corrispondenze dei target se non specificato, vengono controllati per i target tutti gli elementi di primo livello con i campi url e domain valori possibili: organic, paid, local_pack, featured_snippet, events, google_flights, images, jobs, knowledge_graph, local_service, map, scholarly_articles, third_party_reviews, twitter Nota: non può contenere gli stessi tipi di elemento di ignore_targets_in esempio: "find_targets_in": ["organic", "featured_snippet"] scopri di più su questo parametro nel nostro Help Center
- groupTipo: boolean | null
_organic _results visualizza i risultati correlati campo facoltativo se impostato su true, l'elemento related_result nella risposta verrà fornito come snippet del risultato organico principale; se impostato su false, l'elemento related_result verrà fornito come risultato organico separato; valore predefinito: true
- ignoreTipo: array string[] | null
_targets _in tipi di elemento SERP da escludere dalla ricerca dei target campo facoltativo per abilitare questo parametro, deve essere abilitato anche stop_crawl_on_match specifica quali tipi di elemento SERP devono essere esclusi durante la ricerca delle corrispondenze dei target valori possibili: organic, paid, local_pack, featured_snippet, events, google_flights, images, jobs, knowledge_graph, local_service, map, scholarly_articles, third_party_reviews, twitter Nota: non può contenere gli stessi tipi di elemento di find_targets_in esempio: "ignore_targets_in": ["paid", "images"] scopri di più su questo parametro nel nostro Help Center
- keywordTipo: string
keyword campo obbligatorio è possibile specificare fino a 700 caratteri nel campo keyword tutti i %## verranno decodificati (inoltre il carattere ‘+’ verrà decodificato in uno spazio) se è necessario usare il carattere “%” per il keyword, specificarlo come “%25”; se è necessario usare il carattere “+” per il keyword, specificarlo come “%2B”; se questo campo contiene parametri come ‘allinanchor:’, ‘allintext:’, ‘allintitle:’, ‘allinurl:’, ‘cache:’, ‘define:’, ‘definition:’, ‘filetype:’, ‘id:’, ‘inanchor:’, ‘info:’, ‘intext:’, ‘intitle:’, ‘inurl:’, ‘link:’, ‘site:’, il costo per attività verrà moltiplicato per 5 scopri di più sulle regole e limitazioni dei campi keyword e keywords nelle API DataForSEO in questo articolo del Help Center
- languageTipo: string | null
_code codice lingua del motore di ricerca campo facoltativo se si specifica language_name se si usa questo campo, non è necessario specificare language_name è possibile ricevere l'elenco delle lingue disponibili del motore di ricerca con il relativo language_code effettuando una richiesta separata a https://api.dataforseo.com/v3/serp/google/languages esempio: en
- languageTipo: string | null
_name nome completo della lingua del motore di ricerca campo facoltativo se si specifica language_code se si usa questo campo, non è necessario specificare language_code è possibile ricevere l'elenco delle lingue disponibili del motore di ricerca con il relativo language_name effettuando una richiesta separata a https://api.dataforseo.com/v3/serp/google/languages esempio: English
- loadTipo: boolean | null
_async _ai _overview carica ai_overview in modo asincrono campo facoltativo impostare su true per ottenere elementi ai_overview nei SERP anche se vengono caricati in modo asincrono; se impostato su false, si otterranno elementi ai_overview solo dalla cache; valore predefinito: false Nota: per l'uso di questo parametro verranno addebitati 0,002 $ in più; se l'elemento è assente o contiene "asynchronous_ai_overview": false, tutti i costi aggiuntivi verranno restituiti al saldo dell'account
- locationTipo: integer | null
_code codice posizione del motore di ricerca campo obbligatorio se non si specifica location_name o location_coordinate se si usa questo campo, non è necessario specificare location_name o location_coordinate è possibile ricevere l'elenco delle posizioni disponibili dei motori di ricerca con il relativo location_code effettuando una richiesta separata a https://api.dataforseo.com/v3/serp/google/locations esempio: 2840
- locationTipo: string | null
_coordinate coordinate GPS di una posizione campo facoltativo se si specifica location_name o location_code se si usa questo campo, non è necessario specificare location_name o location_code il parametro location_coordinate deve essere specificato nel formato "latitude,longitude,radius" il numero massimo di cifre decimali per "latitude" e "longitude": 7 il valore minimo per "radius": 199 (mm) il valore massimo per "radius": 199999 (mm) esempio: 53.476225,-2.243572,200
- locationTipo: string | null
_name nome completo della posizione del motore di ricerca campo obbligatorio se non si specifica location_code o location_coordinate se si usa questo campo, non è necessario specificare location_code o location_coordinate è possibile ricevere l'elenco delle posizioni disponibili del motore di ricerca con il relativo location_name effettuando una richiesta separata a https://api.dataforseo.com/v3/serp/google/locations esempio: London,England,United Kingdom
- matchTipo: string | null
_type tipo di corrispondenza del target campo obbligatorio se si specifica stop_crawl_on_match tipo di corrispondenza per match_value valori possibili: domain – dominio o sottodominio specifico with_subdomains – dominio principale e sottodomini wildcard – modello jolly
- matchTipo: string | null
_value dominio, sottodominio o valore jolly di destinazione campo obbligatorio se si specifica stop_crawl_on_match specificare un dominio, un sottodominio o un valore jolly di destinazione; Nota: il dominio o il sottodominio devono essere specificati senza protocollo di richiesta; esempio: "match_value": "dataforseo.com", "match_value": "/blog/post-*"
- maxTipo: integer | null
_crawl _pages limite di crawl delle pagine campo facoltativo numero di pagine di risultati di ricerca da scansionare valore massimo: 100 Nota: verrà addebitato un costo per ogni pagina scansionata (10 risultati organici per pagina); scopri di più sui prezzi nella nostra pagina Pricing; Nota n. 2: i parametri max_crawl_pages e depth si completano a vicenda; scopri di più nel nostro Help Center
- osTipo: string | null
sistema operativo del dispositivo campo facoltativo se si specifica desktop nel campo device, scegliere tra i seguenti valori: windows, macos valore predefinito: windows se si specifica mobile nel campo device, scegliere tra i seguenti valori: android, ios valore predefinito: android
- peopleTipo: integer | null
_also _ask _click _depth clic sull'elemento corrispondente campo facoltativo specificare la profondità di clic sull'elemento people_also_ask per ottenere elementi people_also_ask_element aggiuntivi; Nota: all'account verranno addebitati 0,00015 $ in più per ogni clic; se l'elemento è assente o eseguiamo meno clic di quelli specificati, tutti i costi aggiuntivi verranno restituiti al saldo dell'account valori possibili: da 1 a 4
- removeTipo: array string[] | null
_from _url rimuovi parametri specifici dagli URL campo facoltativo usando questo campo, è possibile specificare fino a 10 parametri da rimuovere dagli URL nel risultato esempio: "remove_from_url": ["srsltid"] Nota: se il campo target è specificato, i parametri URL specificati verranno rimossi prima della ricerca
- seTipo: string | null
_domain dominio del motore di ricerca campo facoltativo scegliamo automaticamente il dominio del motore di ricerca pertinente in base alla località e alla lingua specificate tuttavia, è possibile impostare un dominio del motore di ricerca personalizzato in questo campo esempio: google.co.uk, google.com.au, google.de ecc.
- searchTipo: string | null
_param parametri aggiuntivi della query di ricerca campo facoltativo ottieni l'elenco dei parametri disponibili e ulteriori dettagli qui Nota: i seguenti parametri del motore di ricerca non sono supportati e verranno automaticamente annullati se specificati: lr, cr, as_qdr, as_sitesearch, as_occt, as_filetype.
- stopTipo: array (object | null)[] | null
_crawl _on _match array di obiettivi su cui interrompere la scansione campo opzionale se specificato, la risposta conterrà i risultati SERP fino al match_value specificato incluso; puoi specificare fino a 10 valori di obiettivo in questo array esempio: "stop_crawl_on_match":[{"match_value":"dataforseo.com","match_type":"with_subdomains"}] scopri di più su questo parametro nel nostro Centro assistenza - https://dataforseo.com/help-center/using-the-stop_crawl_on_match-parameter-in-serp-api Il tuo account verrà fatturato per ogni SERP scansionata tramite gli obiettivi specificati
- matchTipo: string | null
_type tipo di corrispondenza dell'obiettivo campo obbligatorio se stop_crawl_on_match è specificato; tipo di corrispondenza per il match_value valori possibili: domain, with_subdomains, wildcard
- matchTipo: string | null
_value dominio o valore wildcard dell'obiettivo campo obbligatorio se stop_crawl_on_match è specificato; specifica un dominio o un valore wildcard; Nota: il nome di dominio deve essere specificato senza protocollo di richiesta; esempio: dataforseo.com
- tagTipo: string | null
Identificatore dell'attività definito dall'utente. Campo facoltativo. Il limite di caratteri è 255. È possibile usare questo parametro per identificare l'attività e associarla al risultato. Il valore tag specificato è disponibile nell'oggetto data della risposta.
- targetTipo: string | null
dominio, sottodominio o pagina web di destinazione per cui ottenere i risultati campo facoltativo un dominio o un sottodominio deve essere specificato senza https:// e www. nota che i risultati delle attività specifiche per target includeranno solo elementi SERP che contengono una stringa URL; è anche possibile usare un carattere jolly (‘’) per specificare il modello di ricerca nella SERP e restringere i risultati; esempi: example.com - restituisce i risultati per la pagina iniziale del sito web con URL come https://example.com, https://www.example.com/ o https://example.com/; example.com - restituisce i risultati per il dominio, incluse tutte le sue pagine; example.com - restituisce i risultati per l'intero dominio, incluse tutte le sue pagine e i sottodomini; example.com - restituisce i risultati per la pagina iniziale indipendentemente dal sottodominio, ad esempio https://en.example.com; example.com/example-page - restituisce i risultati per l'URL esatto; example.com/example-page - restituisce i risultati per tutti gli URL del dominio che iniziano con la stringa specificata
- targetTipo: string | null
_search _mode modalità di corrispondenza dei target campo facoltativo per abilitare questo parametro, deve essere abilitato anche stop_crawl_on_match definisce come deve interrompersi la scansione quando in stop_crawl_on_match sono specificati più target valori possibili: all, any all – la scansione si interrompe solo quando tutti i target specificati sono stati trovati any – la scansione si interrompe quando viene trovato un singolo target valore predefinito: any scopri di più su questo parametro nel nostro Help Center
- urlTipo: string | null
URL diretto della query di ricerca campo facoltativo è possibile specificare un URL diretto e lo suddivideremo nei campi necessari. Tenere presente che questo metodo è il più difficile da elaborare per la nostra API e richiede anche di specificare la lingua e la località esatte nell'URL. Nella maggior parte dei casi non consigliamo di usare questo metodo. esempio: https://www.google.co.uk/search?q=%20rank%20tracker%20api&hl=en&gl=GB&uule=w+CAIQIFISCXXeIa8LoNhHEZkq1d1aOpZS Nota: i seguenti parametri del motore di ricerca non sono supportati e verranno automaticamente annullati se specificati: lr, cr, as_qdr, as_sitesearch, as_occt, as_filetype.
- Tipo: object | null · Response36Afe1097B20_SerpGoogleOrganicLiveAdvancedResponseInfo200
- Tipo: number | null Formato: doublecost
Costo totale delle attività, USD
- Tipo: integer | nullstatus
_code codice di stato generale l'elenco completo dei codici di risposta è disponibile qui
- Tipo: string | nullstatus
_message messaggio informativo generale l'elenco completo dei messaggi informativi generali è disponibile qui
- Tipo: array (object | null)[] | nulltasks
Array di attività
- Tipo: object | null · Response36Afe1097B20_SerpGoogleOrganicLiveAdvancedTaskInfo
- costTipo: number | null Formato: double
Costo totale delle attività, USD
- dataTipo: object | null
Contiene gli stessi parametri specificati nella richiesta POST
- propertyTipo: object | null
Name
- idTipo: string | null
identificatore dell'attività identificatore univoco dell'attività nel nostro sistema in formato UUID
- pathTipo: array (string | null)[] | null
Percorso URL
- resultTipo: array (object | null)[] | null
Array di risultati
- checkTipo: string | null
_url URL diretto ai risultati del motore di ricerca. Consente di verificare che abbiamo fornito risultati esatti
- datetimeTipo: string | null
data e ora in cui il risultato è stato ricevuto nel formato UTC: “yyyy-mm-dd hh-mm-ss +00:00” esempio: 2019-11-15 12:57:46 +00:00
- itemTipo: array (string | null)[] | null
_types tipi di risultati di ricerca nella SERP contiene i tipi di risultati di ricerca (items) trovati nella SERP. Tipi di elemento possibili: 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
- itemsTipo: array (object | null)[] | null
voci dell'elemento
- pageTipo: integer | null
numero di pagina dei risultati di ricerca
indica il numero della pagina SERP in cui si trova l'elemento - positionTipo: string | null
l'allineamento dell'elemento nella SERP
può assumere i seguenti valori:left,right - rectangleTipo: object | null · Response36Afe1097B20_AiModeRectangleInfo
parametri del rettangolo
contiene le coordinate cartesiane e le dimensioni in pixel dello snippet del risultato nella SERP
è uguale anullsecalculate_rectanglesnella richiesta POST non è impostato sutrue- heightTipo: number | null Formato: double
altezza dell'elemento in pixel
- widthTipo: number | null Formato: double
larghezza dell'elemento in pixel
- xTipo: number | null Formato: double
coordinata sull'asse x la coordinata sull'asse x dell'angolo superiore sinistro dello snippet del risultato, con l'angolo superiore sinistro dello schermo come origine
- yTipo: number | null Formato: double
coordinata sull'asse y la coordinata sull'asse y dell'angolo superiore sinistro dello snippet del risultato, con l'angolo superiore sinistro dello schermo come origine
- typeTipo: string | null
tipo di elemento
- xpathTipo: string | null
l'XPath dell'elemento
- itemsTipo: integer | null Formato: int64
_count Il numero di risultati restituiti nell'array items
- keywordTipo: string | null
Keyword ricevuta in un array POST. La keyword viene restituita con %## decodificato (il carattere più '+' viene decodificato in uno spazio)
- languageTipo: string | null
_code Codice lingua in un array POST
- locationTipo: integer | null
_code Codice posizione in un array POST
- pagesTipo: integer | null Formato: int64
_count Pagine totali di risultati di ricerca recuperate. Numero totale di SERP recuperate nel risultato
- refinementTipo: object | null · Response36Afe1097B20_RefinementChipsInfo
_chips Chip di perfezionamento della ricerca
- itemsTipo: array (object | null)[] | null
voci dell'elemento
- domainTipo: string | null
dominio nella SERP
- optionsTipo: array (object | null)[] | null
ulteriori opzioni di affinamento della ricerca
- domainTipo: string | null
dominio nella SERP
- titleTipo: string | null
titolo dell'elemento
- typeTipo: string | null
tipo di elemento
- urlTipo: string | null
URL di ricerca con parametri di affinamento
- titleTipo: string | null
titolo dell'elemento
- typeTipo: string | null
tipo di elemento
- urlTipo: string | null
URL di ricerca con parametri di affinamento
- typeTipo: string | null
tipo di elemento
- xpathTipo: string | null
l'XPath dell'elemento
- seTipo: string | null
_domain dominio del motore di ricerca in un array POST
- seTipo: integer | null Formato: int64
_results _count numero totale di risultati nella SERP
- spellTipo: object | null · Response36Afe1097B20_SpellInfo
correzione automatica del motore di ricerca se il motore di ricerca ha fornito risultati per una keyword corretta, indichiamo la keyword corretta dal motore di ricerca e il tipo di correzione automatica
- keywordTipo: string | null
keyword ottenuta a seguito della correzione automatica del motore di ricerca i risultati saranno forniti per la keyword corretta
- typeTipo: string | null
tipo di correzione automatica valori possibili: did_you_mean, showing_results_for, no_results_found_for, including_results_for nota: Yahoo e Yandex supportano solo il seguente tipo di correzione automatica: including_results_for
- typeTipo: string | null
tipo di elemento
- resultTipo: integer | null Formato: int64
_count Numero di elementi nell'array dei risultati
- statusTipo: integer | null
_code codice di stato dell'attività generato da DataForSEO, può essere compreso nell'intervallo: 10000-60000 l'elenco completo dei codici di risposta è disponibile qui
- statusTipo: string | null
_message messaggio informativo dell'attività l'elenco completo dei messaggi informativi generali è disponibile qui
- timeTipo: string | null
Tempo di esecuzione in secondi
- Tipo: integer | null Formato: int64tasks
_count Il numero di attività nell'array tasks
- Tipo: integer | null Formato: int64tasks
_error Il numero di attività nell'array tasks restituite con un errore
- Tipo: string | nulltime
tempo di esecuzione totale, secondi
- Tipo: string | nullversion
La versione corrente dell'API
application/json - 400
Impossibile elaborare la richiesta. Controlla i parametri della richiesta.
- 401
È richiesta una chiave API Felo valida.
- 402
Impossibile procedere con la richiesta perché non è soddisfatto un requisito di fatturazione.
- 403
L'account non è autorizzato a eseguire questa operazione.
- 429
È stato raggiunto un limite di richieste o di spesa.
- 502
Il servizio non è riuscito a completare la richiesta.
- 503
L'API o il servizio di fatturazione è temporaneamente non disponibile.
- 504
Si è verificato un timeout durante l'elaborazione della richiesta.
- default
Risposta di errore; le risposte passthrough upstream possono usare formati del provider
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]"
}
]
}
]
}
]
}