v0.2.0-beta

OpenAPI 3.1.0

Impostare le attività live ‘DataForSEO Trends Demography’

Felo API Support

MIT

Server

https://openapi.felo.ai

Librerie client

Shell Curl

DataForSEO

SEO, search-engine results, keyword research, backlinks and AI visibility data.

DataForSEO Operazioni

post/v1/beta/dataforseo/keywords_data/dataforseo_trends/demography/live

Impostare le attività live ‘DataForSEO Trends Demography’

Il pubblico Google Trends dietro una keyword: suddivisioni per età e genere sulla stessa finestra usata da post_dataforseo_keywords_trends_explore_live, con gli stessi argomenti type e data. Incapsulato nella struttura DataForSEO: dati in tasks[0].result, esito in tasks[0].status_code; una richiesta rifiutata restituisce comunque HTTP 200. Economico come il suo gemello. Per il dove invece del chi, usa post_dataforseo_keywords_trends_subregion_interests_live.

Riferimento prezzi

Misurazione: costo della risposta comunicato.
Stima di riferimento per richiesta: USD 0.0024.
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.

Corpo

application/json

Tipo: array (object | null)[]
- date_from
  Tipo: string | null
  
  data di inizio dell'intervallo di tempo
  campo facoltativo
  se non specifichi questo campo, verranno usati per impostazione predefinita il giorno e il mese correnti dell'anno precedente
  valore minimo per il tipo web: 2004-01-01
  valore minimo per altri tipi: 2008-01-01
  formato data: "yyyy-mm-dd"
  esempio:
  "2019-01-15"
- date_to
  Tipo: string | null
  
  data di fine dell'intervallo di tempo
  campo facoltativo
  se non specifichi questo campo, verrà usata la data odierna per impostazione predefinita
  formato data: "yyyy-mm-dd"
  esempio:
  "2019-01-15"
- keywords
  Tipo: array string[]
  
  keywords
  campo obbligatorio
  numero massimo di keywords specificabili: 5
  evitare simboli e caratteri speciali (ad es. simboli UTF, emoji);
  specificando caratteri non latini, si otterranno dati per i paesi in cui vengono usati
  
  scopri di più su regole e limitazioni dei campi keyword e keywords nelle API DataForSEO in questo articolo del Help Center
- location_code
  Tipo: integer | null
  
  codice località del motore di ricerca
  campo facoltativo
  se non si usa questo campo, si riceveranno risultati globali
  se si usa questo campo, non è necessario specificare location_name
  è possibile ricevere l'elenco delle località disponibili dei motori di ricerca con il relativo location_code effettuando una richiesta separata a https://api.dataforseo.com/v3/keywords_data/dataforseo_trends/locations
  nota che i dati verranno forniti per il paese a cui appartiene il location_code specificato;
  esempio:
  2840
- location_name
  Tipo: string | null
  
  nome completo della località del motore di ricerca
  campo facoltativo
  se non si usa questo campo, si riceveranno risultati globali
  se si usa questo campo, non è necessario specificare location_code
  è possibile ricevere l'elenco delle località disponibili del motore di ricerca con il relativo location_name effettuando una richiesta separata a https://api.dataforseo.com/v3/keywords_data/dataforseo_trends/locations
  nota che i dati verranno forniti per il paese a cui appartiene il location_name specificato;
  esempio:
  United Kingdom
- tag
  Tipo: 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 valore tag specificato si trova nell'oggetto data della risposta
- time_range
  Tipo: string | null
  
  intervalli temporali preimpostati
  campo facoltativo
  se si specificano i parametri date_from o date_to, questo campo viene ignorato durante l'impostazione di un'attività
  possibili valori per tutti i parametri type:
  past_4_hours, past_day, past_7_days, past_30_days, past_90_days, past_12_months, past_5_years
- type
  Tipo: string | null
  
  tipo di elemento

Risposte

200
Tipo: object | null · Response36Afe1097B20_KeywordsDataDataforseoTrendsDemographyLiveResponseInfo
cost
Tipo: number | null Formato: double

Costo totale delle attività, USD

status_code
Tipo: integer | null

codice di stato generale l'elenco completo dei codici di risposta è disponibile qui

status_message
Tipo: string | null

messaggio informativo generale l'elenco completo dei messaggi informativi generali è disponibile qui

tasks
Tipo: array (object | null)[] | null

array di attività

Tipo: object | null · Response36Afe1097B20_KeywordsDataDataforseoTrendsDemographyLiveTaskInfo
cost
Tipo: number | null Formato: double

Costo totale delle attività, USD

data
Tipo: object | null

Contiene gli stessi parametri specificati nella richiesta POST

propertyName
Tipo: object | null
id
Tipo: string | null

identificatore dell'attività identificatore univoco dell'attività nel nostro sistema in formato UUID

path
Tipo: array (string | null)[] | null

Percorso URL

result
Tipo: array (object | null)[] | null

array di risultati

datetime
Tipo: string | null

data e ora di ricezione del risultato
nel formato UTC: “yyyy-mm-dd hh-mm-ss +00:00”
esempio:
2019-11-15 12:57:46 +00:00

items
Tipo: array (object | null)[] | null

contiene la popolarità delle keyword e i dati correlati

Tipo: object | null · Response36Afe1097B20_DataforseoTrendsDemographyElementItem
Tipo: object · Response36Afe1097B20_DataforseoTrendsDemographyElementItem
type
Discriminatore
Tipo: string | null

tipo di elemento

demography
Tipo: object | null · Response36Afe1097B20_Demography

ripartizione demografica dei dati sulla popolarità delle keyword per ciascun termine specificato
contiene dati sulla popolarità delle keyword per età e genere

age
Tipo: array (object | null)[] | null

distribuzione della popolarità delle keyword per età

keyword
Tipo: string | null

keyword pertinente per cui vengono forniti i dati demografici

values
Tipo: array (object | null)[] | null

contiene l'intervallo di età e i corrispondenti valori di popolarità della keyword

type
Tipo: string | null

tipo di elemento

value
Tipo: integer | null

tasso di popolarità della keyword nell'intervallo di età specificato
utilizzando questo value è possibile capire quanto è popolare una keyword in ciascuna fascia di età;
calcolo: determiniamo il valore di popolarità più alto per la keyword pertinente in tutte le fasce di età, quindi esprimiamo tutti gli altri valori come percentuale di quel valore più alto (100);
un valore di 100 è la massima popolarità del termine
un valore di 0 significa che non c'erano dati sufficienti per questo termine

gender
Tipo: array (object | null)[] | null

distribuzione della popolarità delle keyword per genere

keyword
Tipo: string | null

keyword pertinente per cui vengono forniti i dati demografici

values
Tipo: array (object | null)[] | null

contiene l'intervallo di età e i corrispondenti valori di popolarità della keyword

type
Tipo: string | null

tipo di elemento

value
Tipo: integer | null

tasso di popolarità della keyword nell'intervallo di età specificato
utilizzando questo value è possibile capire quanto è popolare una keyword in ciascuna fascia di età;
calcolo: determiniamo il valore di popolarità più alto per la keyword pertinente in tutte le fasce di età, quindi esprimiamo tutti gli altri valori come percentuale di quel valore più alto (100);
un valore di 100 è la massima popolarità del termine
un valore di 0 significa che non c'erano dati sufficienti per questo termine

demography_comparison
Tipo: object | null · Response36Afe1097B20_DemographyComparisonInfo

confronto dei dati demografici sulla popolarità delle keyword per i parametri specificati
contiene dati sulla popolarità delle keyword per età e genere
se è stata specificata una sola keyword, il valore sarà null

age
Tipo: object | null

tipo di elemento

propertyName
Tipo: array (integer | null)[] | null
gender
Tipo: object | null

tipo di elemento

propertyName
Tipo: array (integer | null)[] | null
keywords
Tipo: array (string | null)[] | null

keyword in un array POST

position
Tipo: integer | null

l'allineamento dell'elemento
può assumere i seguenti valori: 1, 2, 3, 4, ecc.

items_count
Tipo: integer | null Formato: int64

il numero di risultati restituiti nell'array items

keywords
Tipo: array (string | null)[] | null

keyword in un array POST

language_code
Tipo: string | null

codice lingua in un array POST
se non ci sono dati, il valore è null

location_code
Tipo: integer | null

codice località in un array POST
se non ci sono dati, il valore è null

type
Tipo: string | null

tipo di elemento

result_count
Tipo: integer | null Formato: int64

Numero di elementi nell'array dei risultati

status_code
Tipo: integer | null

codice di stato dell'attività generato da DataForSEO, può essere compreso nell'intervallo: 10000-60000 l'elenco completo dei codici di risposta è disponibile qui

status_message
Tipo: string | null

messaggio informativo dell'attività l'elenco completo dei messaggi informativi generali è disponibile qui

time
Tipo: string | null

Tempo di esecuzione in secondi

tasks_count
Tipo: integer | null Formato: int64

Il numero di attività nell'array tasks

tasks_error
Tipo: integer | null Formato: int64

Il numero di attività nell'array tasks restituite con un errore

time
Tipo: string | null

tempo di esecuzione totale, secondi

version
Tipo: string | null

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

post/v1/beta/dataforseo/keywords_data/dataforseo_trends/demography/live

curl https://openapi.felo.ai/v1/beta/dataforseo/keywords_data/dataforseo_trends/demography/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "keywords": [
      "rugby",
      "cricket"
    ],
    "date_from": "2023-01-01",
    "date_to": "2024-01-01",
    "type": "web",
    "location_name": "United States"
  }
]'

Mostra schema

{
  "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": [
        {
          "keywords": [
            null
          ],
          "type": null,
          "location_code": null,
          "language_code": null,
          "datetime": null,
          "items_count": null,
          "items": [
            {
              "type": "[Max Depth Exceeded]",
              "position": "[Max Depth Exceeded]",
              "keywords": "[Max Depth Exceeded]",
              "demography": "[Max Depth Exceeded]",
              "demography_comparison": "[Max Depth Exceeded]"
            }
          ]
        }
      ]
    }
  ]
}

Operazione riuscita

Impostare le attività live ‘DataForSEO Trends Demography’

AutenticazioneRequired

DataForSEO

Impostare le attività live ‘DataForSEO Trends Demography’

Riferimento prezzi