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

Intersección de dominios

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

DataForSEO

​

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

Intersección de dominios

​

Los dominios que enlazan a varios targets a la vez. ⚠️ Aquí targets es un objeto indexado por posición — {"1": "a.com", "2": "b.com"} —, no el array que reciben los endpoints masivos. exclude_targets elimina sitios de la comparación. Cada fila incluye domain_intersection y un summary por target. Úsalo para descubrir quién enlaza a tus competidores pero no a ti. El equivalente a nivel de página es post_dataforseo_backlinks_page_intersection_live.

Referencia de precios

  • Medición: Coste de la respuesta notificado.
  • Estimación de referencia por solicitud: USD 0.06.
  • 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_filters
      Tipo: array (object | null)[] | null

      filtra los backlinks de tu target
      campo opcional
      puedes usar este campo para filtrar los backlinks iniciales que se incluirán en el conjunto de datos de métricas agregadas de tu target
      puedes filtrar los backlinks por todos los campos disponibles en la respuesta de este endpoint
      con este parámetro, puedes incluir solo backlinks dofollow en la respuesta y crear un conjunto de datos de backlinks flexible para calcular las métricas
      ejemplo:
      "backlinks_filters": [["dofollow", "=", true]]

      Objeto vacío
    • 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 se excluyen los backlinks de subdominios del target
      campo opcional
      si se define como false, se omitirán los backlinks de subdominios del target y no recibirás el mismo dominio en la respuesta;
      valor predeterminado: true

    • exclude_targets
      Tipo: array string[] | null

      dominios, subdominios o páginas web que quieres excluir
      campo opcional
      puedes especificar hasta 10 dominios, subdominios o páginas web
      si usas este array, los resultados contendrán los dominios 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.internal_links_count",">","1"]

      [["2.referring_pages",">","2"],
      "and",
      ["1.backlinks",">","10"]]

      [["1.first_seen",">","2017-10-23 11:31:45 +00:00"],
      "and",
      [["2.target","like","%dataforseo.com%"],"or",["1.referring_domains",">","10"]]]

      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 del target 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:
      referring_links_tld
      referring_links_types
      referring_links_attributes
      referring_links_platform_types
      referring_links_semantic_locations

      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 los dominios especificados
      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 resultados devueltos
      campo opcional
      valor predeterminado: 100
      valor máximo: 1000

    • offset
      Tipo: integer | null

      desplazamiento en el array de resultados 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:
      ["backlinks,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:
      ["backlinks,desc","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_BacklinksDomainIntersectionLiveResponseInfo
    • 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_BacklinksDomainIntersectionLiveTaskInfo
        • 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 los dominios que enlazan con todos los targets del array POST

            • domain_intersection
              Tipo: object | null

              contiene datos sobre los dominios que enlazan a los destinos correspondientes especificados en el array POST
              los datos se proporcionan en objetos separados correspondientes a los dominios, subdominios o páginas especificados en el objeto targets

              • propertyName
                Tipo: object | null · Response36Afe1097B20_BacklinksDomainIntersection
                • backlinks
                  Tipo: integer | null Formato: int64

                  indica el número de backlinks

                • backlinks_spam_score
                  Tipo: integer | null Formato: int64

                  puntuación de spam media de los backlinks que apuntan al target
                  obtén más información sobre cómo se calcula la métrica en esta página del Centro de ayuda

                • broken_backlinks
                  Tipo: integer | null Formato: int64

                  número de backlinks rotos

                • broken_pages
                  Tipo: integer | null

                  número de páginas rotas

                • first_seen
                  Tipo: string | null

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

                • lost_date
                  Tipo: string | null

                  fecha y hora en que se perdió el último backlink de este target
                  indica la fecha y hora en que nuestro rastreador visitó la página y esta respondió con un código de estado 4xx o 5xx, o en que se eliminó el último 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 referido al target del array POST
                  indica el rank que el dominio de referencia (target arriba) refiere a tu target del array POST;
                  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

                • referring_domains
                  Tipo: integer | null Formato: int64

                  número de dominios de referencia

                • referring_domains_nofollow
                  Tipo: integer | null Formato: int64

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

                • referring_ips
                  Tipo: integer | null Formato: int64

                  número de direcciones IP de referencia

                • 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

                    Integer numbers.

                • 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

                • 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

                    Integer numbers.

                • 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í

                  • propertyName
                    Tipo: integer | null

                    Integer numbers.

                • 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

                    Integer numbers.

                • referring_links_types
                  Tipo: object | null

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

                  • propertyName
                    Tipo: integer | null

                    Integer numbers.

                • 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

                  indica el 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

                • target
                  Tipo: string | null

                  dominio que enlaza al destino correspondiente del array POST

                • type
                  Tipo: string | null

                  tipo de elemento

            • summary
              Tipo: object | null · Response36Afe1097B20_IntersectionSummaryInfo

              contiene el resumen de intersecciones de dominios

              • 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

            dominios, subdominios o páginas web de destino en un array POST

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

            cantidad total de resultados relevantes para tu 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/domain_intersection/live
curl https://openapi.felo.ai/v1/beta/dataforseo/backlinks/domain_intersection/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "targets": {
      "1": "moz.com",
      "2": "ahrefs.com"
    },
    "include_subdomains": false,
    "exclude_targets": [
      "semrush.com"
    ],
    "limit": 5,
    "order_by": [
      "1.backlinks,desc"
    ],
    "exclude_internal_backlinks": 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": [
            {
              "domain_intersection": null,
              "summary": "[Max Depth Exceeded]"
            }
          ]
        }
      ]
    }
  ]
}
Domain Intersection