DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Content Analysis: riepilogo
Vista aggregata di ogni citazione di una keyword nell'indice del web. Restituisce total_count, rank, top_domains (ciascuno con domain e count), sentiment_connotations (anger, happiness, love, sadness, share, fun), connotation_types (positive, negative, neutral), text_categories, page_categories, page_types, countries e languages. Questo è il nodo della famiglia Content Analysis: post_dataforseo_content_sentiment_analysis_live restituisce solo i due blocchi di connotazione già inclusi qui, quindi conviene chiamare questo, a meno che si voglia specificamente il payload più piccolo. Per le singole pagine citanti anziché i totali usare post_dataforseo_content_search_live; per lo stesso aggregato nel tempo, post_dataforseo_content_phrase_trends_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)[]
- initialTipo: array (object | null)[] | null
_dataset _filters parametri di filtro del dataset iniziale
campo facoltativo
parametri di filtro iniziali applicati ai campi dell'endpoint Search
è 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,has,has_not
con l'operatore%inlikeenot_likeè possibile trovare corrispondenze con qualsiasi stringa di zero o più caratteri
esempio:["domain","<>", "logitech.com"][["domain","<>","logitech.com"],"and",["content_info.connotation_types.negative",">",1000]][["domain","<>","logitech.com"]],
"and",
[["content_info.connotation_types.negative",">",1000],
"or",["content_info.text_category","has",10994]]]
per ulteriori informazioni sui filtri, fare riferimento a Content Analysis API - Filters
scopri di più sui filtri del dataset iniziale in questo articolo del Help Center.Oggetto vuoto - internalTipo: integer | null
_list _limit numero massimo di elementi negli array interni
campo facoltativo
è possibile usare questo campo per limitare il numero di elementi nei seguenti array:top_domainstext_categoriespage_categoriescountrieslanguages
valore predefinito:1
valore massimo:20 - 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": {
"snippet": ""logitech mouse"",
"main_title": "sale"
}- propertyTipo: string | null
Name
- 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" - positiveTipo: number | null
_connotation _threshold soglia di connotazione positiva
campo facoltativo
specificata come soglia dell'indice di probabilità per il sentiment positivo relativo al contenuto della citazione
se si specifica questo campo, l'oggettoconnotation_typesnella risposta conterrà solo i dati delle citazioni con probabilità di sentimentpositivemaggiore o uguale al valore specificato
valori possibili: da0a1
valore predefinito:0.4 - rankTipo: string | null
_scale definisce la scala utilizzata per calcolare e visualizzare i valori
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
- sentimentsTipo: number | null
_connotation _threshold soglia di connotazione del sentiment
campo facoltativo
specificata come soglia dell'indice di probabilità per le connotazioni del sentiment relative al contenuto della citazione
se si specifica questo campo, l'oggettosentiment_connotationsnella risposta conterrà solo i dati delle citazioni in cui
la probabilità per ciascun sentiment è maggiore o uguale al valore specificato
valori possibili: da0a1
valore predefinito:0.4 - 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_ContentAnalysisSummaryLiveResponseInfo200
- 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_ContentAnalysisSummaryLiveTaskInfo
- 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
- connotationTipo: object | null
_types tipi di connotazione
contiene i tipi di sentiment (polarità del sentiment) relativi alla citazione della keyword e il numero di citazioni per ogni tipo di sentiment
tipi di connotazione del sentiment possibili:positive,negative,neutral- propertyTipo: integer | null Formato: int64
Name Signed 64-bit integers (long type).
- countriesTipo: object | null
- propertyTipo: integer | null Formato: int64
Name Signed 64-bit integers (long type).
- languagesTipo: object | null
- propertyTipo: integer | null Formato: int64
Name Signed 64-bit integers (long type).
- pageTipo: array (object | null)[] | null
_categories - categoryTipo: array (integer | null)[] | null
- countTipo: integer | null Formato: int64
Signed 64-bit integers (long type).
- pageTipo: object | null
_types tipi di pagina
contiene i tipi di pagina e il numero di citazioni per ciascun tipo di pagina- propertyTipo: integer | null Formato: int64
Name Signed 64-bit integers (long type).
- rankTipo: integer | null
posizione di tutti gli URL che citano la
keyword
somma normalizzata delle posizioni di tutti gli URL che citano lakeyworddi destinazione - sentimentTipo: object | null
_connotations connotazioni del sentiment
contiene i sentiment (reazioni emotive) relativi alla citazione della keyword di destinazione e il numero di citazioni per ogni sentiment
possibili connotazioni del sentiment:anger,happiness,love,sadness,share,fun- propertyTipo: integer | null Formato: int64
Name Signed 64-bit integers (long type).
- textTipo: array (object | null)[] | null
_categories - categoryTipo: array (integer | null)[] | null
- countTipo: integer | null Formato: int64
Signed 64-bit integers (long type).
- topTipo: array (object | null)[] | null
_domains domini principali che citano la keyword di destinazione
contiene oggetti con i domini principali che citano la keyword di destinazione e il numero di citazioni per ogni dominio- countTipo: integer | null Formato: int64
Signed 64-bit integers (long type).
- domainTipo: string | null
- totalTipo: integer | null Formato: int64
_count quantità totale di risultati nel nostro database pertinenti alla tua richiesta
- 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/content_analysis/summary/live \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"keyword": "logitech",
"page_type": [
"ecommerce",
"news",
"blogs",
"message-boards",
"organization"
],
"internal_list_limit": 8,
"positive_connotation_threshold": 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": [
{
"type": null,
"total_count": null,
"rank": null,
"top_domains": [
{
"domain": null,
"count": null
}
],
"sentiment_connotations": null,
"connotation_types": null,
"text_categories": [
{
"category": [
"[Max Depth Exceeded]"
],
"count": null
}
],
"page_categories": [
{
"category": [
"[Max Depth Exceeded]"
],
"count": null
}
],
"page_types": null,
"countries": null,
"languages": null
}
]
}
]
}