v0.2.0-beta

OpenAPI 3.1.0

Serie temporale: backlink nuovi e persi

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/backlinks/timeseries_new_lost_summary/live

Serie temporale: backlink nuovi e persi

Backlink e domini di riferimento nuovi e persi per un target per periodo, raggruppati per group_range. È la derivata di post_dataforseo_backlinks_timeseries_summary_live: quello dà il livello, questo la variazione. Un totale piatto che nasconde un forte ricambio emerge solo qui. Per gli stessi valori su molti target insieme usare post_dataforseo_backlinks_bulk_new_lost_backlinks_live. Questo endpoint non ha un parametro limit, quindi l'unica leva è chiamarlo meno spesso.

Riferimento prezzi

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

Corpo

application/json

Tipo: array (object | null)[]
- date_from
  Tipo: string | null
  
  data di inizio dell'intervallo temporale
  campo facoltativo
  questo campo indica la data usata come soglia per i backlink e i domini di riferimento nuovi e persi;
  i backlink e i domini di riferimento comparsi nel nostro indice dopo la data specificata saranno considerati nuovi;
  i backlink e i domini di riferimento non trovati dopo la data specificata, ma presenti in precedenza, saranno considerati persi;
  
  valore minimo: 2019-01-30
  il valore massimo non deve superare la data specificata in date_to
  formato data: "yyyy-mm-dd"
  esempio:
  "2021-01-01"
- date_to
  Tipo: string | null
  
  data di fine dell'intervallo temporale
  campo facoltativo
  se non si specifica questo campo, verrà usata la data odierna per impostazione predefinita
  il valore minimo non deve precedere la data specificata in date_from
  valore massimo: data odierna
  formato data: "yyyy-mm-dd"
  esempio:
  "2021-01-15"
- group_range
  Tipo: string | null
  
  intervallo temporale utilizzato per raggruppare i risultati
  campo facoltativo
  valore predefinito: month
  valori possibili: day, week, month, year
  
  nota: per day restituiremo elementi corrispondenti a tutte le date comprese tra date_from e date_to, estremi inclusi;
  per week/month/year restituiremo elementi corrispondenti a settimane/mesi/anni completi, in cui ogni elemento indicherà l'ultimo giorno della settimana/del mese/dell'anno
  
  ad esempio, se si specifica:
  "group_range": "month", "date_from": "2022-03-23", "date_to": "2022-05-13"
  restituiremo elementi compresi tra 2022-03-01 e 2022-05-31, ovvero tre elementi corrispondenti alle seguenti date: 2022-03-31, 2022-04-30, 2022-05-31
  
  se non ci sono dati per un determinato day/week/month/year, restituiremo 0
- include_subdomains
  Tipo: boolean | null
  
  indica se i sottodomini del target verranno inclusi nella ricerca
  campo facoltativo
  se impostato su false, i sottodomini verranno ignorati
  valore predefinito: true
- 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
- target
  Tipo: string
  
  dominio per cui ottenere i dati
  campo obbligatorio
  un dominio va specificato senza https:// e www.
  esempio:
  "forbes.com"

Risposte

200
Tipo: object | null · Response36Afe1097B20_BacklinksTimeseriesNewLostSummaryLiveResponseInfo
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_BacklinksTimeseriesNewLostSummaryLiveTaskInfo
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

date_from
Tipo: string | null

data di inizio dell'intervallo di tempo
in formato UTC: “yyyy-mm-dd”
esempio:
2019-01-01

date_to
Tipo: string | null

data di fine dell'intervallo di tempo
in formato UTC: "yyyy-mm-dd"
esempio:
"2019-01-15"

group_range
Tipo: string | null

group_range dall'array POST

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

contiene i dati pertinenti su backlink e domini di riferimento

date
Tipo: string | null

data e ora in cui sono stati memorizzati i dati per il target
in formato UTC: “yyyy-mm-dd hh-mm-ss +00:00”
esempio:
2019-11-15 12:57:46 +00:00

lost_backlinks
Tipo: integer | null Formato: int64

numero di backlink persi
numero di backlink persi del target

lost_referring_domains
Tipo: integer | null Formato: int64

numero di domini di riferimento persi
numero di domini di riferimento persi del target

lost_referring_main_domains
Tipo: integer | null Formato: int64

numero di domini principali di riferimento persi
numero di domini principali di riferimento persi del target

new_backlinks
Tipo: integer | null Formato: int64

numero di nuovi backlink
numero di nuovi backlink che puntano al target

new_referring_domains
Tipo: integer | null Formato: int64

numero di nuovi domini di riferimento
numero di nuovi domini di riferimento che puntano al target

new_referring_main_domains
Tipo: integer | null Formato: int64

numero di nuovi domini principali di riferimento
numero di nuovi domini principali di riferimento che puntano al target

type
Tipo: string | null

tipo di elemento

items_count
Tipo: integer | null Formato: int64

il numero di risultati restituiti nell'array items

target
Tipo: string | null

target da un array POST

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/backlinks/timeseries_new_lost_summary/live

curl https://openapi.felo.ai/v1/beta/dataforseo/backlinks/timeseries_new_lost_summary/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "target": "dataforseo.com",
    "date_from": "2021-12-01",
    "date_to": "2022-02-01",
    "group_range": "month"
  }
]'

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": [
        {
          "target": null,
          "date_from": null,
          "date_to": null,
          "group_range": null,
          "items_count": null,
          "items": [
            {
              "type": null,
              "date": null,
              "new_backlinks": null,
              "lost_backlinks": null,
              "new_referring_domains": null,
              "lost_referring_domains": null,
              "new_referring_main_domains": null,
              "lost_referring_main_domains": null
            }
          ]
        }
      ]
    }
  ]
}

Operazione riuscita

Serie temporale: backlink nuovi e persi

AutenticazioneRequired

DataForSEO

Serie temporale: backlink nuovi e persi

Riferimento prezzi