Felo API PlatformFelo API Platform
Todos los endpoints de DataForSEO
v0.2.0-beta
OpenAPI 3.1.0

Historial de enlaces entrantes

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

Historial de enlaces entrantes

​

El perfil de enlaces entrantes de un target tal como estaba en cada fecha de un intervalo, con date_from, date_to y un elemento por punto. Para solo el perfil actual, usa post_dataforseo_backlinks_summary_live. Para una serie temporal más ligera, post_dataforseo_backlinks_timeseries_summary_live informa menos métricas por punto. 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.0271.
  • 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
      valor mínimo 2019-01-01
      si no especificas este campo, se usará el valor mínimo de forma predeterminada
      formato de fecha: "yyyy-mm-dd"
      ejemplo:
      "2019-01-15"

    • date_to
      Tipo: string | null

      fecha de fin del intervalo de tiempo
      campo opcional
      si no especificas este campo, se usará la fecha de hoy de forma predeterminada
      formato de fecha: "yyyy-mm-dd"
      ejemplo:
      "2019-01-15"

    • rank_scale
      Tipo: string | null

      define la escala utilizada para calcular y mostrar los valores de rank, domain_from_rank y page_from_rank
      campo opcional

      puedes usar este parámetro para elegir si los valores de rank se presentan en una escala de 0–100 o de 0–1000

      valores posibles:
      one_hundred — los valores de rank se muestran en una escala de 0–100
      one_thousand — los valores de rank se muestran en una escala de 0–1000

      valor predeterminado: one_thousand

      obtén más información sobre cómo funciona este parámetro y cómo se calculan las métricas de ranking en este artículo del Centro de ayuda

    • 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
      campo obligatorio
      un dominio debe especificarse sin https:// y www.

Respuestas
  • 200
    Tipo: object | null · Response36Afe1097B20_BacklinksHistoryLiveResponseInfo
    • 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_BacklinksHistoryLiveTaskInfo
        • 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"

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

            contiene datos históricos de backlinks del dominio especificado
            los datos se proporcionan mes a mes;
            las métricas se agregan según los backlinks que el dominio especificado tenía el primer día de cada mes

            • backlinks
              Tipo: integer | null Formato: int64

              número de backlinks

            • broken_backlinks
              Tipo: integer | null Formato: int64

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

            • broken_pages
              Tipo: integer | null

              número de páginas rotas
              número de páginas que reciben backlinks pero responden con códigos de estado 4xx o 5xx

            • crawled_pages
              Tipo: integer | null

              número de páginas rastreadas para el target

            • 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

            • external_links_count
              Tipo: integer | null Formato: int64

              número de enlaces externos en la página
              se calcula como la suma de los enlaces externos en las páginas del target especificado

            • info
              Tipo: object | null · Response36Afe1097B20_TargetInfo

              información sobre el target

              • cms
                Tipo: string | null

                sistema de gestión de contenido

              • country
                Tipo: string | null

                código del país al que pertenece el dominio target

              • ip_address
                Tipo: string | null

                dirección IP del target

              • is_ip
                Tipo: boolean | null

                indica si el target es una IP
                si es true, el dominio, subdominio o página web funciona como dirección IP y no tiene nombre de dominio

              • platform_type
                Tipo: array (string | null)[] | null

                tipo de plataforma

              • server
                Tipo: string | null

                servidor

              • target_spam_score
                Tipo: integer | null

                puntuación de spam del target
                si el target es un dominio/subdominio, este campo indica la puntuación de spam media de todas las páginas de ese dominio/subdominio;
                obtén más información sobre cómo se calcula la métrica en esta página del centro de ayuda

            • internal_links_count
              Tipo: integer | null Formato: int64

              número de enlaces internos
              se calcula como la suma de los enlaces internos en las páginas del target especificado

            • lost_backlinks
              Tipo: integer | null Formato: int64

              número de backlinks perdidos para el target
              los datos se proporcionan mediante una comparación con el período anterior
              Nota: estos datos están disponibles desde mayo de 2021;
              si el intervalo de fechas especificado en la solicitud POST es anterior a mayo de 2021, el campo será igual a 0

            • lost_referring_domains
              Tipo: integer | null Formato: int64

              número de dominios de referencia perdidos para el target
              los datos se proporcionan mediante una comparación con el período anterior
              Nota: estos datos están disponibles desde mayo de 2021;
              si el intervalo de fechas especificado en la solicitud POST es anterior a mayo de 2021, el campo será igual a 0

            • new_backlinks
              Tipo: integer | null Formato: int64

              número de backlinks nuevos para el target
              los datos se proporcionan mediante una comparación con el período anterior
              Nota: estos datos están disponibles desde mayo de 2021;
              si el intervalo de fechas especificado en la solicitud POST es anterior a mayo de 2021, el campo será igual a 0

            • new_referring_domains
              Tipo: integer | null Formato: int64

              número de dominios de referencia nuevos para el target
              los datos se proporcionan mediante una comparación con el período anterior
              Nota: estos datos están disponibles desde mayo de 2021;
              si el intervalo de fechas especificado en la solicitud POST es anterior a mayo de 2021, el campo será igual a 0

            • rank
              Tipo: integer | null

              rank de dominio en la date indicada
              obtén más información sobre la métrica y cómo se calcula en este artículo del Centro de ayuda

            • referring_domains
              Tipo: integer | null Formato: int64

              número de dominios de referencia
              los dominios de referencia incluyen subdominios que se cuentan como dominios separados para esta métrica

            • referring_domains_nofollow
              Tipo: integer | null Formato: int64

              número de dominios que apuntan al menos un enlace nofollow al target

            • referring_ips
              Tipo: integer | null Formato: int64

              número de direcciones IP de referencia
              número de direcciones IP que apuntan a esta página

            • referring_links_attributes
              Tipo: object | null

              atributos de enlace de los enlaces de referencia
              indica los atributos de enlace de los enlaces de referencia y el recuento de enlaces por atributo

              • propertyName
                Tipo: integer | null Formato: int64

                Signed 64-bit integers (long type).

            • referring_links_countries
              Tipo: object | null

              códigos de país ISO de los enlaces de referencia
              indica los códigos de país ISO de los dominios donde se encuentran los enlaces de referencia y el recuento de enlaces por país

              • propertyName
                Tipo: integer | null Formato: int64

                Signed 64-bit integers (long type).

            • referring_links_platform_types
              Tipo: object | null

              tipos de plataformas de referencia
              indica los tipos de plataformas de referencia y el recuento de enlaces por plataforma

              valores posibles: cms, blogs, ecommerce, message-boards, wikis, news, organization

              • propertyName
                Tipo: integer | null Formato: int64

                Signed 64-bit integers (long type).

            • referring_links_semantic_locations
              Tipo: object | null

              ubicaciones semánticas de los enlaces de referencia
              indica los elementos semánticos de HTML donde se encuentran los enlaces de referencia y el recuento de enlaces por ubicación semántica
              puedes obtener la lista completa de elementos semánticos aquí
              ejemplos:
              article, section, summary

              • propertyName
                Tipo: integer | null Formato: int64

                Signed 64-bit integers (long type).

            • referring_links_tld
              Tipo: object | null

              dominios de nivel superior de los enlaces de referencia
              contiene los dominios de nivel superior y el recuento de enlaces de referencia de cada uno

              • propertyName
                Tipo: integer | null Formato: int64

                Signed 64-bit integers (long type).

            • referring_links_types
              Tipo: object | null

              tipos de enlaces de referencia
              indica los tipos de los enlaces de referencia y el recuento de enlaces por tipo
              valores posibles:
              anchor, image, link, meta, canonical, alternate, redirect

              • propertyName
                Tipo: integer | null Formato: int64

                Signed 64-bit integers (long type).

            • referring_main_domains
              Tipo: integer | null Formato: int64

              número de dominios principales de referencia

            • referring_main_domains_nofollow
              Tipo: integer | null Formato: int64

              número de dominios principales que apuntan al menos un enlace nofollow al target

            • referring_pages
              Tipo: integer | null Formato: int64

              número de páginas que apuntan al target

            • referring_pages_nofollow
              Tipo: integer | null Formato: int64

              número de páginas de referencia que apuntan al menos un enlace nofollow al target

            • referring_subnets
              Tipo: integer | null Formato: int64

              número de subredes de referencia

            • 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 del 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
Request Example for post/v1/beta/dataforseo/backlinks/history/live
curl https://openapi.felo.ai/v1/beta/dataforseo/backlinks/history/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "target": "cnn.com",
    "date_from": "2020-01-01",
    "date_to": "2021-01-01"
  }
]'

{
  "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,
          "items_count": null,
          "items": [
            {
              "type": null,
              "date": null,
              "rank": null,
              "backlinks": null,
              "new_backlinks": null,
              "lost_backlinks": null,
              "new_referring_domains": null,
              "lost_referring_domains": null,
              "crawled_pages": null,
              "info": "[Max Depth Exceeded]",
              "internal_links_count": null,
              "external_links_count": null,
              "broken_backlinks": null,
              "broken_pages": null,
              "referring_domains": null,
              "referring_domains_nofollow": null,
              "referring_main_domains": null,
              "referring_main_domains_nofollow": null,
              "referring_ips": null,
              "referring_subnets": null,
              "referring_pages": null,
              "referring_pages_nofollow": null,
              "referring_links_tld": null,
              "referring_links_types": null,
              "referring_links_attributes": null,
              "referring_links_platform_types": null,
              "referring_links_semantic_locations": null,
              "referring_links_countries": null
            }
          ]
        }
      ]
    }
  ]
}

Operación correcta

Backlinks History