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

Intersección de páginas

Servidor:https://openapi.felo.ai
Bibliotecas cliente

DataForSEO

​

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

Intersección de páginas

​

Las páginas que enlazan a varias URL de destino a la vez, en lugar de los dominios. ⚠️ targets es un objeto indexado por posición y acepta URL completas, no dominios sin protocolo. Cada fila incluye page_intersection y un summary por target. El equivalente a nivel de dominio es post_dataforseo_backlinks_domain_intersection_live, que conviene consultar primero.

Referencia de precios

  • Medición: Coste de la respuesta notificado.
  • Estimación de referencia por solicitud: USD 0.033.
  • 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)[]
    • backlinks_status_type
      Tipo: string | null

      define qué backlinks devolver y contar
      campo opcional
      puedes usar este campo para elegir qué backlinks se devolverán y se usarán para las métricas agregadas de tus targets;
      valores posibles:
      all - se devolverán y contarán todos los backlinks;
      live - se devolverán y contarán los backlinks encontrados en la última comprobación;
      lost - se devolverán y contarán los backlinks perdidos;

      valor predeterminado: live

    • exclude_internal_backlinks
      Tipo: boolean | null

      indica si los backlinks internos de subdominios al target se excluirán de los resultados
      campo opcional
      si se define como true, los resultados no incluirán datos sobre backlinks internos de subdominios del mismo dominio que el target
      si se define como false, los enlaces internos se incluirán en el resultado
      valor predeterminado: true

    • exclude_targets
      Tipo: array string[] | null

      dominios, subdominios o páginas web que quieres excluir
      campo opcional
      puedes definir hasta 10 dominios, subdominios o páginas web
      si usas este array, los resultados contendrán las páginas de referencia que enlazan a targets pero no a exclude_targets
      ejemplo:
      "exclude_targets": [<br>"bbc.com",<br>"https://www.apple.com/iphone/*",<br>"https://dataforseo.com/apis/*"]

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

      array de parámetros de filtrado de resultados
      campo opcional
      puedes añadir varios filtros a la vez (8 filtros como máximo)
      define un operador lógico and o or entre las condiciones
      se admiten los siguientes operadores:
      regex, not_regex, =, <>, in, not_in, like, not_like, ilike, not_ilike, match, not_match
      puedes usar el operador % con like y not_like para coincidir con cualquier cadena de cero o más caracteres
      ejemplo:
      ["1.rank",">","80"]

      [["2.page_from_rank",">","55"],
      "and",
      ["1.original","=","true"]]

      [["1.first_seen",">","2017-10-23 11:31:45 +00:00"],
      "and",
      [["1.acnhor","like","%seo%"],"or",["1.text_pre","not_like","%seo%"]]]

      La lista completa de filtros posibles está disponible aquí.

      Objeto vacío
    • include_indirect_links
      Tipo: boolean | null

      indica si los enlaces indirectos a los targets se incluirán en los resultados
      campo opcional
      si se define como true, los resultados incluirán datos sobre enlaces indirectos que apuntan a una página que redirige a un destino o apunta a una página canónica
      si se define como false, los enlaces indirectos se ignorarán
      valor predeterminado: true

    • include_subdomains
      Tipo: boolean | null

      indica si los subdominios de los targets se incluirán en la búsqueda
      campo opcional
      si se define como false, los subdominios se ignorarán
      valor predeterminado: true

    • internal_list_limit
      Tipo: integer | null

      número máximo de elementos dentro de los arrays internos
      campo opcional
      puedes usar este campo para limitar el número de elementos de los siguientes arrays:
      attributes
      domain_from_platform_type

      valor predeterminado: 10
      valor máximo: 1000

    • intersection_mode
      Tipo: string | null

      indica si se deben intersecar los backlinks
      campo opcional
      usa este campo para intersecar o combinar resultados de las URL especificadas
      valores posibles: all, partial
      all - los resultados se basan en todos los backlinks;
      partial - los resultados se basan solo en los backlinks que se intersecan;
      valor predeterminado: all

    • limit
      Tipo: integer | null

      el número máximo de backlinks devueltos
      campo opcional

      valor predeterminado: 100
      valor máximo: 1000

    • offset
      Tipo: integer | null

      desplazamiento en el array de resultados de los backlinks devueltos
      campo opcional

      valor predeterminado: 0
      si especificas el valor 10, se omitirán los diez primeros backlinks del array de resultados y los datos se proporcionarán para los backlinks siguientes

    • order_by
      Tipo: array string[] | null

      reglas de ordenación de los resultados
      campo opcional
      puedes usar los mismos valores que en el array filters para ordenar los resultados
      tipos de ordenación posibles:
      asc - los resultados se ordenarán en orden ascendente
      desc - los resultados se ordenarán en orden descendente
      usa una coma para definir el tipo de ordenación
      ejemplo:
      ["rank,desc"]
      ten en cuenta que puedes definir como máximo tres reglas de ordenación en una sola solicitud
      usa una coma para separar varias reglas de ordenación
      ejemplo:
      ["domain_from_rank,desc","page_from_rank,asc"]

    • 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

    • targets
      Tipo: object | null

      dominios, subdominios o páginas web para obtener enlaces
      campo obligatorio
      puedes definir hasta 20 dominios, subdominios o páginas web
      un dominio o subdominio debe especificarse sin https:// y www.
      una página debe especificarse con URL absoluta (incluido http:// o https://)
      ejemplo:
      "targets": {<br>"1": "http://planet.postgresql.org/",<br>"2": "http://gborg.postgresql.org/"<br>}

      • propertyName
        Tipo: string | null
Respuestas
  • 200
    Tipo: object | null · Response36Afe1097B20_BacklinksPageIntersectionLiveResponseInfo
    • 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_BacklinksPageIntersectionLiveTaskInfo
        • 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

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

            contiene backlinks relevantes y datos de dominios de referencia

            • page_intersection
              Tipo: object | null

              contiene datos sobre las páginas que enlazan a los destinos correspondientes especificados en el array POST
              los datos se proporcionan en objetos separados correspondientes a las páginas especificadas en el objeto targets

              • propertyName
                Tipo: array (object | null)[] | null
                • alt
                  Tipo: string | null

                  texto alternativo de la imagen
                  este campo será null si el type del backlink no es image

                • anchor
                  Tipo: string | null

                  texto de ancla del backlink

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

                  atributos de enlace de los enlaces de referencia
                  ejemplo:
                  nofollow

                • backlink_spam_score
                  Tipo: integer | null

                  puntuación de spam del backlink
                  obtén más información sobre cómo se calcula la métrica en esta página del Centro de ayuda

                • dofollow
                  Tipo: boolean | null

                  indica si el backlink es dofollow
                  si es false, el backlink es nofollow

                • domain_from
                  Tipo: string | null

                  dominio que hace referencia al dominio o la página web de destino

                • domain_from_country
                  Tipo: string | null

                  código de país ISO del dominio de referencia

                • domain_from_ip
                  Tipo: string | null

                  dirección IP del dominio de referencia

                • domain_from_is_ip
                  Tipo: boolean | null

                  indica si el dominio es una IP
                  si es true, el dominio funciona como una dirección IP y no tiene nombre de dominio

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

                  tipos de plataforma del dominio de referencia

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

                • domain_from_rank
                  Tipo: integer | null

                  rank de dominio del dominio de referencia
                  indica el rank del dominio en el momento en que nuestro rastreador vio el backlink por última vez;
                  domain_from_rank se calcula según el método de clasificación de nodos en una base de datos enlazada — un principio usado en el algoritmo PageRank original de Google
                  obtén más información sobre la métrica y cómo se calcula en este artículo del Centro de ayuda

                • domain_to
                  Tipo: string | null

                  dominio al que apunta el backlink

                • first_seen
                  Tipo: string | null

                  fecha y hora en que nuestro rastreador encontró el backlink por primera vez
                  en formato UTC: “yyyy-mm-dd hh-mm-ss +00:00”
                  ejemplo:
                  2019-11-15 12:57:46 +00:00

                • group_count
                  Tipo: integer | null Formato: int64

                  indica el número total de backlinks de este dominio
                  por ejemplo, si mode se define como one_per_domain, este campo indicará el número total de backlinks procedentes de este dominio

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

                  ruta del enlace indirecto
                  indica una URL o una secuencia de URLs que conducen a url_to

                  • status_code
                    Tipo: integer | null

                    código de estado general
                    puedes encontrar la lista completa de códigos de respuesta aquí
                    Nota: recomendamos encarecidamente diseñar un sistema necesario para gestionar las condiciones excepcionales o de error relacionadas

                  • type
                    Tipo: string | null

                    tipo de elemento

                  • url
                    Tipo: string | null

                    URL del enlace indirecto

                • is_broken
                  Tipo: boolean | null

                  indica si el backlink está roto
                  si es true, el backlink apunta a una página que responde con un código de estado 4xx o 5xx

                • is_indirect_link
                  Tipo: boolean | null

                  indica si el backlink es un enlace indirecto
                  si es true, el backlink es un enlace indirecto que apunta a una página que redirige a url_to o apunta a una página canónica

                • is_lost
                  Tipo: boolean | null

                  indica si se eliminó el backlink
                  si es true, se eliminó el backlink o la página entera

                • is_new
                  Tipo: boolean | null

                  indica si el backlink es nuevo
                  si es true, el backlink se encontró en la página la última vez que nuestro rastreador la visitó

                • item_type
                  Tipo: string | null

                  tipo de enlace
                  valores posibles:
                  anchor, image, link, meta, canonical, alternate, redirect

                • last_seen
                  Tipo: string | null

                  fecha más reciente en que nuestro rastreador visitó el backlink
                  en formato UTC: “yyyy-mm-dd hh-mm-ss +00:00”
                  ejemplo:
                  2019-11-15 12:57:46 +00:00

                • links_count
                  Tipo: integer | null Formato: int64

                  número de backlinks idénticos encontrados en la página de referencia

                • original
                  Tipo: boolean | null

                  indica si el backlink estaba presente en la página de referencia cuando nuestro rastreador la visitó por primera vez

                • page_from_encoding
                  Tipo: string | null

                  codificación de caracteres de la página de referencia
                  ejemplo:
                  utf-8

                • page_from_external_links
                  Tipo: integer | null

                  número de enlaces externos encontrados en la página de referencia

                • page_from_internal_links
                  Tipo: integer | null

                  número de enlaces internos encontrados en la página de referencia

                • page_from_language
                  Tipo: string | null

                  idioma de la página de referencia
                  en formato ISO 639-1
                  ejemplo:
                  en

                • page_from_rank
                  Tipo: integer | null

                  rank de página de la página de referencia
                  page_from_rank se calcula según el método de clasificación de nodos en una base de datos enlazada — un principio usado en el algoritmo PageRank original de Google
                  obtén más información sobre la métrica y cómo se calcula en este artículo del Centro de ayuda

                • page_from_size
                  Tipo: integer | null

                  tamaño de la página de referencia, en bytes
                  ejemplo:
                  63357

                • page_from_status_code
                  Tipo: integer | null

                  código de estado HTTP devuelto por la página de referencia
                  ejemplo:
                  200

                • page_from_title
                  Tipo: string | null

                  título de la página de referencia

                • prev_seen
                  Tipo: string | null

                  fecha anterior a la más reciente en que nuestro rastreador visitó el backlink
                  en formato UTC: “yyyy-mm-dd hh-mm-ss +00:00”
                  ejemplo:
                  2019-11-15 12:57:46 +00:00

                • rank
                  Tipo: integer | null

                  rank de backlink
                  rank se calcula según el método de clasificación de nodos en una base de datos enlazada — un principio usado en el algoritmo PageRank original de Google
                  obtén más información sobre la métrica y cómo se calcula en este artículo del Centro de ayuda

                • semantic_location
                  Tipo: string | null

                  indica el elemento semántico de HTML donde se encuentra el backlink
                  puedes obtener la lista completa de elementos semánticos aquí
                  ejemplos:
                  article, section, summary

                • text_post
                  Tipo: string | null

                  fragmento después del texto de ancla

                • text_pre
                  Tipo: string | null

                  fragmento de texto antes del texto de ancla

                • tld_from
                  Tipo: string | null

                  dominio de nivel superior de la URL de referencia

                • type
                  Tipo: string | null

                  tipo de elemento

                • url_from
                  Tipo: string | null

                  URL de la página donde se encuentra el backlink

                • url_from_https
                  Tipo: boolean | null

                  indica si la URL de referencia está protegida con HTTPS
                  si es true, la URL de referencia está protegida con HTTPS

                • url_to
                  Tipo: string | null

                  URL a la que apunta el backlink

                • url_to_https
                  Tipo: boolean | null

                  indica si la URL a la que apunta el backlink está protegida con HTTPS
                  si es true, la URL está protegida con HTTPS

                • url_to_redirect_target
                  Tipo: string | null

                  URL de destino de la redirección
                  página de destino a la que apunta la redirección

                • url_to_spam_score
                  Tipo: integer | null

                  puntuación de spam de la página referenciada
                  si el valor es null, nuestro rastreador aún no ha visitado la página web a la que apunta el enlace
                  obtén más información sobre cómo se calcula la métrica en esta página del Centro de ayuda

                • url_to_status_code
                  Tipo: integer | null

                  código de estado de la página referenciada
                  si el valor es null, nuestro rastreador aún no ha visitado la página web a la que apunta el enlace
                  ejemplo:
                  200

            • summary
              Tipo: object | null · Response36Afe1097B20_IntersectionSummaryInfo

              contiene el resumen de intersecciones de páginas

              • intersections_count
                Tipo: integer | null Formato: int64

                número total de intersecciones

          • items_count
            Tipo: integer | null Formato: int64

            el número de resultados devueltos en el array items

          • targets
            Tipo: object | null

            targets de un array POST

            • propertyName
              Tipo: string | null
          • total_count
            Tipo: integer | null Formato: int64

            cantidad total de resultados relevantes para la solicitud

        • 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/page_intersection/live
curl https://openapi.felo.ai/v1/beta/dataforseo/backlinks/page_intersection/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "targets": {
      "1": "football.com",
      "2": "fifa.com"
    },
    "exclude_targets": [
      "skysports.com"
    ],
    "limit": 5,
    "order_by": [
      "1.rank,desc"
    ],
    "filters": [
      [
        "2.domain_from_rank",
        ">",
        400
      ],
      "and",
      [
        "1.dofollow",
        "=",
        true
      ]
    ]
  }
]'
{
  "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": [
        {
          "targets": null,
          "total_count": null,
          "items_count": null,
          "items": [
            {
              "page_intersection": null,
              "summary": "[Max Depth Exceeded]"
            }
          ]
        }
      ]
    }
  ]
}
Page Intersection