DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
Content Analysis: trend per frase
Le metriche di riepilogo per una keyword, ripetute per periodo. Ogni voce contiene una date oltre a 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. date_from, date_to e date_group (day, week, month) impostano intervallo e granularità. Serve a vedere se le menzioni di una frase aumentano o calano; per un singolo istante usare post_dataforseo_content_summary_live. Per seguire un'intera categoria di prodotto anziché una frase, usare post_dataforseo_content_category_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)[]
- dateTipo: string
_from data di inizio dell'intervallo di tempo
campo obbligatorio
formato data:"yyyy-mm-dd"
esempio:"2019-01-15" - dateTipo: string | null
_group intervallo di tempo usato per raggruppare i risultati
campo facoltativo
valore predefinito:month
valori possibili:day,week,month - dateTipo: string | null
_to data di fine dell'intervallo di tempo
campo facoltativo
se non si specifica questo campo, per impostazione predefinita viene usata la data odierna
formato data:"yyyy-mm-dd"
esempio:"2019-01-15" - 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,match,not_match
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": {<br>"snippet": "\"logitech mouse\"",<br>"main_title": "sale"<br>}- 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" - 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
- searchTipo: string | null
_mode tipo di raggruppamento dei risultati
campo facoltativo
tipi di raggruppamento possibili:as_is- restituisce i dati su tutte le citazioni per lakeyworddi destinazioneone_per_domain- restituisce i dati su 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_ContentAnalysisPhraseTrendsLiveResponseInfo200
- 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_ContentAnalysisPhraseTrendsLiveTaskInfo
- 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 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).
- dateTipo: string | null
data per cui vengono forniti i dati
- 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 per la data specificata - 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
connotazioni possibili:"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 numero 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/phrase_trends/live \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"keyword": "logitech",
"search_mode": "as_is",
"date_from": "2022-09-01",
"date_group": "month"
}
]'
{
"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,
"date": 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
}
]
}
]
}