v0.2.0-beta

OpenAPI 3.1.0

Resumen de series temporales de enlaces entrantes nuevos y perdidos

Felo API Support

MIT

Servidor

https://openapi.felo.ai

Bibliotecas cliente

Shell Curl

DataForSEO

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

DataForSEO Operaciones

post/v1/beta/dataforseo/backlinks/timeseries_new_lost_summary/live

Resumen de series temporales de enlaces entrantes nuevos y perdidos

Enlaces entrantes y dominios de referencia nuevos y perdidos para un target por periodo, agrupados por group_range. Es la derivada de post_dataforseo_backlinks_timeseries_summary_live: aquel da el nivel, este el cambio. Un total plano que oculta una gran rotación solo aparece aquí. Para las mismas cifras en muchos targets a la vez, usa post_dataforseo_backlinks_bulk_new_lost_backlinks_live. Este endpoint no acepta parámetro de límite, así que la única palanca es llamarlo con menos frecuencia.

Referencia de precios

Medición: Coste de la respuesta notificado.
Estimación de referencia por solicitud: USD 0.0372.
Multiplicador de referencia del cliente: 1.0. No volver a aplicarlo a un importe de cliente ya liquidado.

Solo metadatos de referencia, no una cotización de la cuenta, un precio garantizado ni un límite de gasto. Los créditos de recursos no son créditos de Felo. Los cargos finales se rigen por los registros de facturación de Felo.

Cuerpo

application/json

Tipo: array (object | null)[]
- date_from
  Tipo: string | null
  
  fecha inicial del intervalo de tiempo
  campo opcional
  este campo indica la fecha que se usará como umbral para los backlinks y dominios de referencia nuevos y perdidos;
  los backlinks y dominios de referencia que aparecieron en nuestro índice después de la fecha especificada se considerarán nuevos;
  los backlinks y dominios de referencia que no se encontraron después de la fecha especificada, pero existían antes, se considerarán perdidos;
  
  valor mínimo: 2019-01-30
  el valor máximo no debe superar la fecha especificada en date_to
  formato de fecha: "yyyy-mm-dd"
  ejemplo:
  "2021-01-01"
- date_to
  Tipo: string | null
  
  fecha final del intervalo de tiempo
  campo opcional
  si no especificas este campo, se usará la fecha de hoy de forma predeterminada
  el valor mínimo no debe ser anterior a la fecha especificada en date_from
  valor máximo: la fecha de hoy
  formato de fecha: "yyyy-mm-dd"
  ejemplo:
  "2021-01-15"
- group_range
  Tipo: string | null
  
  intervalo de tiempo que se usará para agrupar los resultados
  campo opcional
  valor predeterminado: month
  valores posibles: day, week, month, year
  
  nota: para day, devolveremos elementos correspondientes a todas las fechas entre date_from y date_to, ambos inclusive;
  para week/month/year, devolveremos elementos correspondientes a semanas/meses/años completos, donde cada elemento indicará el último día de la semana/mes/año
  
  por ejemplo, si especificas:
  "group_range": "month", "date_from": "2022-03-23", "date_to": "2022-05-13"
  devolveremos elementos entre 2022-03-01 y 2022-05-31, es decir, tres elementos correspondientes a las siguientes fechas: 2022-03-31, 2022-04-30, 2022-05-31
  
  si no hay datos para un determinado day/week/month/year, devolveremos 0
- include_subdomains
  Tipo: boolean | null
  
  indica si los subdominios del target se incluirán en la búsqueda
  campo opcional
  si se define como false, los subdominios se ignorarán
  valor predeterminado: true
- tag
  Tipo: string | null
  
  identificador de tarea definido por el usuario
  campo opcional
  el límite de caracteres es 255
  puedes usar este parámetro para identificar la tarea y relacionarla con el resultado
  encontrarás el valor de tag especificado en el objeto data de la respuesta
- target
  Tipo: string
  
  dominio para obtener datos
  campo obligatorio
  un dominio debe especificarse sin https:// y www.
  ejemplo:
  "forbes.com"

Respuestas

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

costo total de las tareas, USD

status_code
Tipo: integer | null

código de estado general puedes encontrar la lista completa de los códigos de respuesta aquí

status_message
Tipo: string | null

mensaje informativo general puedes encontrar la lista completa de los mensajes informativos generales aquí

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

array de tareas

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

costo total de las tareas, USD

data
Tipo: object | null

contiene los mismos parámetros que especificaste en la solicitud POST

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

identificador de la tarea identificador único de la tarea en nuestro sistema en formato UUID

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

ruta de la URL

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

array de resultados

date_from
Tipo: string | null

fecha de inicio del intervalo de tiempo
en formato UTC: “yyyy-mm-dd”
ejemplo:
2019-01-01

date_to
Tipo: string | null

fecha de fin del intervalo de tiempo
en formato UTC: "yyyy-mm-dd"
ejemplo:
"2019-01-15"

group_range
Tipo: string | null

group_range del array POST

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

contiene backlinks relevantes y datos de dominios de referencia

date
Tipo: string | null

fecha y hora en que se almacenaron los datos del target
en formato UTC: "yyyy-mm-dd hh-mm-ss +00:00"
ejemplo:
2019-11-15 12:57:46 +00:00

lost_backlinks
Tipo: integer | null Formato: int64

número de backlinks perdidos
número de backlinks perdidos del target

lost_referring_domains
Tipo: integer | null Formato: int64

número de dominios de referencia perdidos
número de dominios de referencia perdidos del target

lost_referring_main_domains
Tipo: integer | null Formato: int64

número de dominios principales de referencia perdidos
número de dominios principales de referencia perdidos del target

new_backlinks
Tipo: integer | null Formato: int64

número de backlinks nuevos
número de backlinks nuevos que apuntan al target

new_referring_domains
Tipo: integer | null Formato: int64

número de dominios de referencia nuevos
número de dominios de referencia nuevos que apuntan al target

new_referring_main_domains
Tipo: integer | null Formato: int64

número de dominios principales de referencia nuevos
número de dominios principales de referencia nuevos que apuntan al target

type
Tipo: string | null

tipo de elemento

items_count
Tipo: integer | null Formato: int64

el número de resultados devueltos en el array items

target
Tipo: string | null

target de un array POST

result_count
Tipo: integer | null Formato: int64

número de elementos en el array de resultados

status_code
Tipo: integer | null

código de estado de la tarea generado por DataForSEO; puede estar dentro del siguiente intervalo: 10000-60000 puedes encontrar la lista completa de los códigos de respuesta aquí

status_message
Tipo: string | null

mensaje informativo de la tarea puedes encontrar la lista completa de los mensajes informativos generales aquí

time
Tipo: string | null

tiempo de ejecución, segundos

tasks_count
Tipo: integer | null Formato: int64

el número de tareas en el array de tareas

tasks_error
Tipo: integer | null Formato: int64

el número de tareas en el array de tareas devueltas con un error

time
Tipo: string | null

tiempo total de ejecución, en segundos

version
Tipo: string | null

la versión actual de la API
application/json
400

No se pudo procesar la solicitud. Comprueba los parámetros de la solicitud.
401

Se requiere una clave de API de Felo válida.
402

La solicitud no puede continuar porque no se cumple un requisito de facturación.
403

La cuenta no tiene permiso para realizar esta operación.
429

Se ha alcanzado un límite de solicitudes o de gasto.
502

El servicio no pudo completar la solicitud.
503

La API o el servicio de facturación no están disponibles temporalmente.
504

El servicio agotó el tiempo de espera al procesar la solicitud.
default

Respuesta de error; las respuestas de paso del upstream pueden usar formatos del proveedor

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"
  }
]'

Mostrar esquema

{
  "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
            }
          ]
        }
      ]
    }
  ]
}

Operación correcta

Resumen de series temporales de enlaces entrantes nuevos y perdidos

AutenticaciónRequired

DataForSEO

Resumen de series temporales de enlaces entrantes nuevos y perdidos

Referencia de precios