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

Resumen histórico de posicionamiento

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

Resumen histórico de posicionamiento

​

El resumen de posicionamiento de un dominio tal como estaba en cada punto del historial disponible. Este endpoint no acepta parámetro de límite, pero se cobra por llamada y no por elemento, así que envía la lista completa de una vez. Envuelto en el sobre de DataForSEO: los datos en tasks[0].result, el resultado en tasks[0].status_code; una solicitud rechazada sigue devolviendo HTTP 200. Comprueba primero get_dataforseo_labs_google_available_history: indica las fechas existentes, y pedir una fecha fuera de ellas no devuelve nada en lugar de un error. La instantánea actual es post_dataforseo_labs_google_domain_rank_overview_live.

Referencia de precios

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

      correlacionar datos con conjuntos de datos obtenidos anteriormente
      campo opcional
      valor predeterminado: true
      si usas este parámetro, nuestro sistema correlacionará los datos que obtengas ahora con los conjuntos de datos obtenidos anteriormente
      este parámetro tiene como objetivo mitigar las inconsistencias que puedan derivarse de cambios en nuestra base de datos
      recomendamos establecer siempre correlate en true

    • date_from
      Tipo: string | null

      fecha inicial del intervalo de tiempo
      campo opcional
      si no especificas este campo, los datos se proporcionarán para los 6 meses anteriores
      valor mínimo posible: 2020-10-01
      formato de fecha: "yyyy-mm-dd"

    • 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:
      "2021-04-01"

    • ignore_synonyms
      Tipo: boolean | null

      ignorar palabras clave muy similares
      campo opcional
      si se define como true, solo se devolverán datos basados en las palabras clave principales y se excluirán los datos de todas las palabras clave muy similares;
      valor predeterminado: false

    • include_clickstream_data
      Tipo: boolean | null

      incluir o excluir datos de métricas basadas en clickstream en el resultado
      campo opcional
      si el parámetro se define como true, recibirás los campos clickstream_etv, clickstream_gender_distribution y clickstream_age_distribution con datos de clickstream en la respuesta;
      valor predeterminado: false;

      Nota: los datos históricos de clickstream están disponibles a partir de 2024/05 (mayo de 2024);
      con este parámetro activado, se te cobrará el doble del precio base por la solicitud;
      obtén más información sobre cómo se calculan las métricas basadas en clickstream en este artículo del Centro de ayuda

    • language_code
      Tipo: string | null

      código de idioma
      campo obligatorio si no especificas language_name
      Nota: es obligatorio especificar language_name o language_code
      puedes obtener la lista de ubicaciones disponibles con su language_code haciendo una solicitud independiente a la
      https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
      ejemplo:
      en

    • language_name
      Tipo: string

      nombre completo del idioma
      campo obligatorio si no especificas language_code
      Nota: es obligatorio especificar language_name o language_code
      puedes obtener la lista de ubicaciones disponibles con su language_name haciendo una solicitud independiente a la
      https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
      ejemplo:
      English

    • location_code
      Tipo: integer

      código de ubicación
      campo obligatorio si no especificas location_name
      Nota: es obligatorio especificar location_name o location_code
      puedes obtener la lista de ubicaciones disponibles con su location_code haciendo una solicitud independiente a la
      https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
      ejemplo:
      2840

    • location_name
      Tipo: string

      nombre completo de la ubicación
      campo obligatorio si no especificas location_code
      Nota: es obligatorio especificar location_name o location_code
      puedes obtener la lista de ubicaciones disponibles con su location_name haciendo una solicitud independiente a la
      https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
      ejemplo:
      United Kingdom

    • 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
      el nombre de dominio del sitio web de destino
      el dominio debe especificarse sin https:// ni www.

Respuestas
  • 200
    Tipo: object | null · Response36Afe1097B20_DataforseoLabsGoogleHistoricalRankOverviewLiveResponseInfo
    • 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_DataforseoLabsGoogleHistoricalRankOverviewLiveTaskInfo
        • 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 datos históricos de ranking y tráfico

            • metrics
              Tipo: object | null

              datos de ranking relevantes para el dominio especificado

              • propertyName
                Tipo: object · Response36Afe1097B20_DataforseoLabsMetricsInfo
                • clickstream_age_distribution
                  Tipo: object | null

                  distribución de métricas basadas en clickstream por edad
                  para obtener resultados de este campo, el parámetro include_clickstream_data debe establecerse en true
                  obtén más información sobre cómo se calcula la métrica en este artículo del centro de ayuda

                  • propertyName
                    Tipo: integer | null Formato: int64

                    Signed 64-bit integers (long type).

                • clickstream_etv
                  Tipo: number | null Formato: double

                  volumen de tráfico estimado basado en datos de clickstream
                  se calcula como el producto de los valores de click-through-rate y de volumen de búsqueda de clickstream de todas las palabras clave para las que posiciona el dominio
                  para obtener resultados de este campo, el parámetro include_clickstream_data debe establecerse en true
                  obtén más información sobre cómo se calcula la métrica en este artículo del centro de ayuda

                • clickstream_gender_distribution
                  Tipo: object | null

                  distribución de métricas estimadas basadas en clickstream por género
                  para obtener resultados de este campo, el parámetro include_clickstream_data debe establecerse en true
                  obtén más información sobre cómo se calcula la métrica en este artículo del centro de ayuda

                  • propertyName
                    Tipo: integer | null Formato: int64

                    Signed 64-bit integers (long type).

                • count
                  Tipo: integer | null Formato: int64

                  recuento total de SERP orgánicas que contienen el dominio o subdominio

                • estimated_paid_traffic_cost
                  Tipo: number | null

                  costo estimado de convertir el tráfico de búsqueda orgánica en pago
                  representa el costo mensual estimado (USD) de publicar anuncios para todas las palabras clave de la categoría para las que posiciona el dominio o subdominio
                  la métrica se calcula como el producto de los valores de etv orgánico y cpc de pago e indica el costo de dirigir el volumen estimado de tráfico orgánico mensual mediante publicidad PPC en Google Search
                  obtén más información sobre cómo se calcula la métrica en este artículo del centro de ayuda

                • etv
                  Tipo: number | null

                  volumen de tráfico estimado
                  tráfico orgánico mensual estimado al dominio o subdominio
                  se calcula como el producto de los valores de CTR (click-through-rate) y de volumen de búsqueda de todas las palabras clave de la categoría para las que posiciona el dominio o subdominio
                  obtén más información sobre cómo se calcula la métrica en este artículo del centro de ayuda

                • is_down
                  Tipo: integer | null

                  el ranking bajó
                  indica cuántos elementos posicionados del objetivo indicado bajaron

                • is_lost
                  Tipo: integer | null

                  elementos posicionados perdidos
                  indica cuántos elementos posicionados del objetivo indicado se presentaban anteriormente en las SERP, pero no se encontraron durante la última comprobación

                • is_new
                  Tipo: integer | null

                  número de nuevos elementos posicionados
                  indica cuántos nuevos elementos posicionados se encontraron para el objetivo indicado

                • is_up
                  Tipo: integer | null

                  el ranking subió
                  indica cuántos elementos posicionados del objetivo indicado subieron

                • pos_1
                  Tipo: integer | null

                  número de SERP orgánicas en las que el dominio o subdominio ocupa el puesto #1

                • pos_11_20
                  Tipo: integer | null

                  número de SERP orgánicas en las que el dominio o subdominio ocupa el puesto #11-20

                • pos_2_3
                  Tipo: integer | null

                  número de SERP orgánicas en las que el dominio o subdominio ocupa el puesto #2-3

                • pos_21_30
                  Tipo: integer | null

                  número de SERP orgánicas en las que el dominio o subdominio ocupa el puesto #21-30

                • pos_31_40
                  Tipo: integer | null

                  número de SERP orgánicas en las que el dominio o subdominio ocupa el puesto #31-40

                • pos_4_10
                  Tipo: integer | null

                  número de SERP orgánicas en las que el dominio o subdominio ocupa el puesto #4-10

                • pos_41_50
                  Tipo: integer | null

                  número de SERP orgánicas en las que el dominio o subdominio ocupa el puesto #41-50

                • pos_51_60
                  Tipo: integer | null

                  número de SERP orgánicas en las que el dominio o subdominio ocupa el puesto #51-60

                • pos_61_70
                  Tipo: integer | null

                  número de SERP orgánicas en las que el dominio o subdominio ocupa el puesto #61-70

                • pos_71_80
                  Tipo: integer | null

                  número de SERP orgánicas en las que el dominio o subdominio ocupa el puesto #71-80

                • pos_81_90
                  Tipo: integer | null

                  número de SERP orgánicas en las que el dominio o subdominio ocupa el puesto #81-90

                • pos_91_100
                  Tipo: integer | null

                  número de SERP orgánicas en las que el dominio o subdominio ocupa el puesto #91-100

            • month
              Tipo: integer | null

              mes para el que se proporcionan los datos

            • se_type
              Tipo: string | null

              tipo de motor de búsqueda

            • year
              Tipo: integer | null

              año para el que se proporcionan los datos

          • items_count
            Tipo: integer | null Formato: int64

            el número de resultados devueltos en el array items

          • language_code
            Tipo: string | null

            código de idioma en un array POST

          • location_code
            Tipo: integer | null

            código de ubicación en un array POST

          • se_type
            Tipo: string | null

            tipo de motor de búsqueda

          • target
            Tipo: string | null

            dominio de destino en un array POST

          • total_count
            Tipo: integer | null Formato: int64

            cantidad total de resultados de nuestra base de datos 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/dataforseo_labs/google/historical_rank_overview/live
curl https://openapi.felo.ai/v1/beta/dataforseo/dataforseo_labs/google/historical_rank_overview/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "target": "dataforseo.com",
    "location_code": 2840,
    "language_code": "en",
    "date_from": "2021-01-01",
    "date_to": "2021-03-29"
  }
]'

{
  "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": [
        {
          "se_type": null,
          "target": null,
          "location_code": null,
          "language_code": null,
          "total_count": null,
          "items_count": null,
          "items": [
            {
              "se_type": null,
              "year": null,
              "month": null,
              "metrics": null
            }
          ]
        }
      ]
    }
  ]
}

Operación correcta

Historical Rank Overview