DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Content Analysis: ricerca
Elenca le singole pagine che citano una keyword, anziché i totali. Ogni voce contiene url, domain, main_domain, url_rank, domain_rank, spam_score, fetch_time, country, language, score e page_category, oltre a total_count e items_count. filters accetta i campi elencati da get_dataforseo_content_available_filters. Per conteggi e distribuzioni anziché pagine, usare post_dataforseo_content_summary_live.
Riferimento prezzi
- Misurazione: costo della risposta riportato.
- Stima di riferimento per richiesta: USD 0.0276.
- Moltiplicatore cliente di riferimento: 1.0. Non applicarlo di nuovo a un importo cliente già addebitato.
Solo metadati di riferimento, non un preventivo dell'account né un prezzo o un limite di spesa garantito. I crediti delle risorse non sono crediti Felo. Gli addebiti finali seguono le registrazioni di fatturazione Felo.
- Tipo: array (object | null)[]
- filtersTipo: array (object | null)[] | null
array di parametri di filtro dei risultati
campo facoltativo
è possibile aggiungere più filtri contemporaneamente (massimo 8 filtri)
tra le condizioni impostare un operatore logicoandoor
sono supportati i seguenti operatori:regex,not_regex,<,<=,>,>=,=,<>,in,not_in,like,not_like,match,not_match
con l'operatore%inlikeenot_likeè possibile trovare corrispondenze con qualsiasi stringa di zero o più caratteri
esempio:["country","=", "US"][["domain_rank",">",800],"and",["content_info.connotation_types.negative",">",0.9]][["domain_rank",">",800],
"and",
[["page_types","has","ecommerce"],
"or",["content_info.text_category","has",10994]]]
per ulteriori informazioni sui filtri, fare riferimento a Content Analysis API - FiltersOggetto vuoto - keywordTipo: string
keyword di destinazione
campo obbligatorio
codifica UTF-8
le keyword vengono convertite in minuscolo;
Nota: per trovare una frase esatta invece di una singola keyword, usare doppi apici e barre rovesciate;
esempio:"keyword": "\"tesla palo alto\""scopri di più su regole e limiti dei campi
keywordekeywordsnelle API DataForSEO in questo articolo del Help Center - keywordTipo: object | null
_fields campi delle keyword di destinazione e keyword di destinazione
campo facoltativo
usare questo parametro per filtrare il dataset in base alle keyword che determinati campi devono contenere;
campi specificabili:title,main_title,previous_title,snippet
è possibile indicare più campi;
Nota: per trovare una frase esatta invece di una singola keyword, usare doppi apici e barre rovesciate;
esempio:"keyword_fields": {<br>"snippet": "\"logitech mouse\"",<br>"main_title": "sale"<br>}"- propertyTipo: string | null
Name
- limitTipo: integer | null
il numero massimo di citazioni restituite
campo facoltativo
valore predefinito:100
valore massimo:1000 - offsetTipo: integer | null
offset nell'array dei risultati delle citazioni restituite
campo facoltativo
valore predefinito:0
se si specifica il valore10, le prime dieci citazioni nell'array dei risultati vengono saltate e i dati vengono forniti per le citazioni successive
Nota: si consiglia di usare questo parametro solo per recuperare fino a 10.000 risultati
per recuperare oltre 10.000 risultati, usare inveceoffset_token. - offsetTipo: string | null
_token token di offset per le richieste successive
campo facoltativo
fornito nell'identico campo della risposta a ogni richiesta;
usare questo parametro per evitare timeout durante il recupero di oltre 10.000 risultati in un'unica richiesta;
specificando il valore univocooffset_tokendall'array della risposta, si ottengono i risultati successivi dell'attività iniziale;
i valori dioffset_tokensono univoci per ogni attività successiva
Nota: seoffset_tokenè specificato nella richiesta, tutti gli altri parametri trannelimitnon vengono considerati durante l'elaborazione di un'attività
scopri di più su questo parametro nel nostro Help Center - orderTipo: array string[] | null
_by regole di ordinamento dei risultati
campo facoltativo
è possibile usare gli stessi valori dell'arrayfiltersper ordinare i risultati
tipi di ordinamento possibili:asc- i risultati vengono ordinati in ordine crescentedesc- i risultati vengono ordinati in ordine decrescente
il tipo di ordinamento si imposta con una virgola
esempio:["content_info.sentiment_connotations.anger,desc"]
regola predefinita:["content_info.sentiment_connotations.anger,desc"]
nota: è possibile impostare al massimo tre regole di ordinamento per richiesta
per separare più regole di ordinamento usare una virgola
esempio:["content_info.sentiment_connotations.anger,desc","keyword_data.keyword_info.cpc,desc"] - pageTipo: array string[] | null
_type tipi di pagina di destinazione
campo facoltativo
usare questo parametro per filtrare il dataset per tipi di pagina
valori possibili:"ecommerce","news","blogs","message-boards","organization" - rankTipo: string | null
_scale definisce la scala utilizzata per calcolare e visualizzare i valori
domain_rankeurl_rank
campo facoltativocon questo parametro si sceglie se i valori di rank vengono presentati su una scala 0–100 o 0–1000
valori possibili:
one_hundred— i valori di rank vengono visualizzati su una scala 0–100one_thousand— i valori di rank vengono visualizzati su una scala 0–1000valore predefinito:
one_thousandscopri di più sul funzionamento di questo parametro in questo articolo del Help Center
- searchTipo: string | null
_mode tipo di raggruppamento dei risultati
campo facoltativo
tipi di raggruppamento possibili:as_is- restituisce tutte le citazioni per lakeyworddi destinazioneone_per_domain- restituisce una citazione dellakeywordper dominio
valore predefinito:as_is - tagTipo: string | null
identificatore dell'attività definito dall'utente
campo facoltativo
il limite di caratteri è 255
puoi usare questo parametro per identificare l'attività e associarla al risultato
il valoretagspecificato si trova nell'oggettodatadella risposta
- Tipo: object | null · Response36Afe1097B20_ContentAnalysisSearchLiveResponseInfo200
- 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_ContentAnalysisSearchLiveTaskInfo
- 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
- itemsTipo: array (object | null)[] | null
contiene citazioni e dati correlati
- contentTipo: object | null · Response36Afe1097B20_AnalysisContentInfo
_info contiene dati sulle citazioni dall'
urlspecificato- authorTipo: string | null
autore del contenuto
- connotationTipo: object | null
_types tipi di connotazione
contiene i tipi di sentiment (polarità del sentiment) correlati alla citazione data e l'indice di probabilità per ciascun tipo di sentiment
tipi di connotazione possibili:positive,negative,neutral- propertyTipo: integer | null Formato: int64
Name Signed 64-bit integers (long type).
- contentTipo: integer | null
_quality _score punteggio di qualità del contenuto
questo valore è calcolato in base al numero di parole, frasi e caratteri contenuti nel contenuto - contentTipo: string | null
_type tipo di contenuto
esempio:page_content,comment - dateTipo: string | null
_published data e ora di pubblicazione del contenuto
nel formato UTC: "yyyy-mm-dd hh-mm-ss +00:00"
esempio:2017-01-24 13:20:59 +00:00 - groupTipo: string | null
_date data e ora del gruppo di citazioni
indica la data di pubblicazione del contenuto o la data e ora in cui il nostro crawler ha visitato la pagina per la prima volta;
questo campo può essere usato per raggruppare le citazioni per data e visualizzare le tendenze delle citazioni;
data e ora sono fornite nel formato UTC: "yyyy-mm-dd hh-mm-ss +00:00"
esempio:2017-01-24 13:20:59 +00:00 - highlightedTipo: string | null
_text testo evidenziato dallo
snippet - languageTipo: string | null
- levelTipo: integer | null
livello di intestazione di
title
indica il livello del tag h da1(superiore) a6(inferiore) - mainTipo: string | null
_title titolo della pagina
- previousTipo: string | null
_title titolo del blocco di contenuto precedente
- ratingTipo: object | null · Response36Afe1097B20_ContententRatingInfo
valutazione del contenuto
valutazione relativa acontent_info- maxTipo: number | null Formato: double
_rating _value valore massimo per il nome della valutazione
- nameTipo: string | null
nome della valutazione qui puoi trovare i seguenti elementi: Max5, Percents, CustomMax
- ratingTipo: integer | null Formato: int64
_count numero di voti
- ratingTipo: number | null Formato: double
_value il valore della valutazione
- relativeTipo: number | null Formato: double
_rating valutazione relativa
- semanticTipo: string | null
_location posizione semantica
indica l'elemento semantico HTML in cui si trova la citazione della keyword di destinazione
esempio:article,header - sentimentTipo: object | null
_connotations connotazioni del sentiment
contiene i sentiment (reazioni emotive) correlati alla citazione data e l'indice di probabilità per ciascun sentiment
connotazioni del sentiment possibili:anger,happiness,love,sadness,share,fun- propertyTipo: integer | null Formato: int64
Name Signed 64-bit integers (long type).
- snippetTipo: string | null
snippet del contenuto
- snippetTipo: integer | null
_length lunghezza in caratteri dello snippet
- socialTipo: array (object | null)[] | null
_metrics metriche di engagement sui social media
dati sulle interazioni sui social media associate ai contenuti, basati sugli embed dei siti web sviluppati e supportati dalle piattaforme social- likeTipo: integer | null Formato: int64
_count numero di like
- typeTipo: string | null
tipo di elemento
- textTipo: array integer[] | null
_category - titleTipo: string | null
titolo del risultato
- countryTipo: string | null
- domainTipo: string | null
nome del dominio
- domainTipo: integer | null
_rank posizione del
domain
questo valore si basa sui dati dei backlink per il dominio specificato dal DataForSEO Backlink Index;domain_rankviene calcolato in base al metodo di ranking dei nodi in un database collegato, un principio usato nell'algoritmo originale di Google PageRank
scopri di più sulla metrica e su come viene calcolata in questo articolo del Help Center - fetchTipo: string | null
_time data e ora in cui il nostro crawler ha visitato la pagina
in formato UTC: “yyyy-mm-dd hh-mm-ss +00:00”
esempio:2017-01-24 13:20:59 +00:00 - languageTipo: string | null
- mainTipo: string | null
_domain dominio principale
- pageTipo: array integer[] | null
_category - pageTipo: array string[] | null
_types tipi di pagina
- ratingsTipo: array (object | null)[] | null
valutazioni trovate nella pagina
tutte le valutazioni trovate nella pagina in base ai microdati- maxTipo: number | null Formato: double
_rating _value valore massimo per il nome della valutazione
- nameTipo: string | null
nome della valutazione qui puoi trovare i seguenti elementi: Max5, Percents, CustomMax
- ratingTipo: integer | null Formato: int64
_count numero di voti
- ratingTipo: number | null Formato: double
_value il valore della valutazione
- relativeTipo: number | null Formato: double
_rating valutazione relativa
- scoreTipo: number | null
punteggio di prominenza della citazione
questo valore si basa suurl_rank,domain_rank, presenza dikeywordintitle,main_title,url,snippet
maggiore è il valore discore, più preziosa è la citazione correlata - socialTipo: array (object | null)[] | null
_metrics metriche di engagement sui social media
dati sulle interazioni sui social media associate ai contenuti, basati sugli embed dei siti web sviluppati e supportati dalle piattaforme social- likeTipo: integer | null Formato: int64
_count numero di like
- typeTipo: string | null
tipo di elemento
- spamTipo: integer | null
_score - typeTipo: string | null
tipo di elemento
- urlTipo: string | null
URL in cui è stata trovata la citazione
- urlTipo: integer | null
_rank posizione dell'
url
questo valore si basa sui dati dei backlink per l'URL specificato dal DataForSEO Backlink Index;url_rankviene calcolato in base al metodo di ranking dei nodi in un database collegato, un principio usato nell'algoritmo originale di Google PageRank
scopri di più sulla metrica e su come viene calcolata in questo articolo del Help Center
- itemsTipo: integer | null Formato: int64
_count il numero di risultati restituiti nell'array
items - offsetTipo: string | null
_token token di offset per le richieste successive
puoi usare la stringa fornita in questo campo per ottenere i risultati successivi dell'attività iniziale;
nota: i valori dioffset_tokensono univoci per ogni attività successiva - totalTipo: integer | null Formato: int64
_count quantità totale di risultati nel nostro database pertinenti alla tua richiesta
- 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/content_analysis/search/live \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"keyword_fields": {
"snippet": "logitech"
},
"keyword": "logitech",
"page_type": [
"ecommerce",
"news",
"blogs",
"message-boards",
"organization"
],
"search_mode": "as_is",
"filters": [
"main_domain",
"=",
"reviewfinder.ca"
],
"order_by": [
"content_info.sentiment_connotations.anger,desc"
],
"limit": 10
}
]'
{
"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": [
{
"offset_token": null,
"total_count": null,
"items_count": null,
"items": [
{
"type": null,
"url": null,
"domain": null,
"main_domain": null,
"url_rank": null,
"spam_score": null,
"domain_rank": null,
"fetch_time": null,
"country": null,
"language": null,
"score": null,
"page_category": [
"[Max Depth Exceeded]"
],
"page_types": [
"[Max Depth Exceeded]"
],
"ratings": [
"[Max Depth Exceeded]"
],
"social_metrics": [
"[Max Depth Exceeded]"
],
"content_info": "[Max Depth Exceeded]"
}
]
}
]
}
]
}