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

Yahoo Organic SERP HTML en vivo

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

Yahoo Organic SERP HTML en vivo

​

Devuelve los resultados clasificados de una palabra clave en Yahoo, de forma síncrona. Código fuente sin procesar en lugar de resultados analizados. 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.

Referencia de precios

  • Medición: Costo de respuesta reportado.
  • Estimación de referencia por solicitud: USD 0.02.
  • Multiplicador de referencia del cliente: 1.0. No lo apliques de nuevo 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)[]
    • depth
      Tipo: integer | null

      profundidad de análisis
      campo opcional
      número de resultados en el SERP
      valor predeterminado: 10
      valor máximo: 200
      Tu cuenta se factura por cada SERP que contenga hasta 10 resultados;
      Definir una profundidad superior a 10 puede generar cargos adicionales si el motor de búsqueda devuelve más de 10 resultados;
      El costo puede calcularse en la página Precios.

    • device
      Tipo: string | null

      tipo de dispositivo
      campo opcional
      devolver resultados para un tipo de dispositivo concreto
      puede tomar los valores: desktop, mobile
      valor predeterminado: desktop

    • keyword
      Tipo: string

      palabra clave
      campo obligatorio
      puedes especificar hasta 700 caracteres en el campo keyword
      todos los %## se decodificarán (el carácter '+' se decodificará como un espacio)
      si necesitas usar el carácter "%" en tu keyword, especifícalo como "%25";
      si necesitas usar el carácter “+” en tu keyword, especifícalo como “%2B”

      más información sobre las reglas y limitaciones de los campos keyword y keywords en las API de DataForSEO en este artículo del Centro de ayuda

    • language_code
      Tipo: string

      código de idioma del motor de búsqueda
      campo obligatorio si no especificas language_name
      si usas este campo, no necesitas especificar language_name
      puedes recibir la lista de idiomas disponibles del motor de búsqueda con su language_code haciendo una solicitud independiente a https://api.dataforseo.com/v3/serp/{{low_se_name}}/languages
      ejemplo:
      en

    • language_name
      Tipo: string

      nombre completo del idioma del motor de búsqueda
      campo obligatorio si no especificas language_code
      si usas este campo, no necesitas especificar language_code
      puedes recibir la lista de idiomas disponibles del motor de búsqueda con su language_name haciendo una solicitud independiente a https://api.dataforseo.com/v3/serp/{{low_se_name}}/languages
      ejemplo:
      English

    • location_code
      Tipo: integer

      código de ubicación del motor de búsqueda
      campo obligatorio si no especificas location_name o location_coordinate
      si usas este campo, no necesitas especificar location_name o location_coordinate
      puedes obtener la lista de ubicaciones disponibles de los motores de búsqueda y su location_code haciendo una solicitud independiente a https://api.dataforseo.com/v3/serp/{{low_se_name}}/locations
      ejemplo:
      2840

    • location_coordinate
      Tipo: string

      coordenadas GPS de una ubicación
      campo obligatorio si no especificas location_name_or location_code
      si usas este campo, no necesitas especificar location_name o location_code
      el parámetro location_coordinate debe especificarse en el formato "latitude,longitude,radius"
      el número máximo de dígitos decimales para "latitude" y "longitude": 7
      el valor mínimo para "radius": 199.9 (mm)
      el valor máximo para "radius": 199999 (mm)
      ejemplo:
      53.476225,-2.243572,200

    • location_name
      Tipo: string

      nombre completo de la ubicación del motor de búsqueda
      campo obligatorio si no especificas location_code o location_coordinate
      si usas este campo, no necesitas especificar location_code o location_coordinate
      puedes obtener la lista de ubicaciones disponibles del motor de búsqueda y su location_name haciendo una solicitud independiente a https://api.dataforseo.com/v3/serp/{{low_se_name}}/locations
      ejemplo:
      London,England,United Kingdom

    • max_crawl_pages
      Tipo: integer | null

      límite de páginas rastreadas
      campo opcional
      número de páginas de resultados de búsqueda que se van a rastrear
      valor predeterminado: 1
      valor máximo: 100
      Nota: los parámetros max_crawl_pages y depth se complementan entre sí;
      más información en nuestro centro de ayuda

    • os
      Tipo: string | null

      sistema operativo del dispositivo
      campo opcional
      si especificas desktop en el campo device, elige entre los siguientes valores: windows, macos
      valor predeterminado: windows
      si especificas mobile en el campo device, elige entre los siguientes valores: android, ios
      valor predeterminado: android

    • se_domain
      Tipo: string | null

      dominio del motor de búsqueda
      campo opcional
      elegimos automáticamente el dominio del motor de búsqueda relevante según la ubicación y el idioma que especifiques
      sin embargo, puedes establecer un dominio personalizado del motor de búsqueda en este campo
      ejemplo:
      au.search.yahoo.com, uk.search.yahoo.com, ca.search.yahoo.com, etc.

    • search_param
      Tipo: string | null

      parámetros adicionales de la consulta de búsqueda
      campo opcional
      obtén aquí la lista de parámetros disponibles y más detalles

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

      array de destinos para detener el rastreo campo opcional si se especifica, la respuesta contendrá resultados de SERP hasta el match_value especificado, inclusive; puedes especificar hasta 10 valores de destino en este array ejemplo: "stop_crawl_on_match":[{"match_value":"dataforseo.com","match_type":"with_subdomains"}] más información sobre este parámetro en nuestro Centro de ayuda - https://dataforseo.com/help-center/using-the-stop_crawl_on_match-parameter-in-serp-api Tu cuenta se facturará por cada SERP rastreada a través de los destinos especificados

      • match_type
        Tipo: string | null

        tipo de coincidencia del destino campo obligatorio si se especifica stop_crawl_on_match; tipo de coincidencia para match_value valores posibles: domain, with_subdomains, wildcard

      • match_value
        Tipo: string | null

        dominio o valor comodín de destino campo obligatorio si se especifica stop_crawl_on_match; especifica un dominio o valor comodín de destino; Nota: el nombre de dominio debe especificarse sin protocolo de solicitud; ejemplo: dataforseo.com

    • url
      Tipo: string | null

      URL directa de la consulta de búsqueda
      campo opcional
      puedes especificar una URL directa y la desglosaremos en los campos necesarios. Ten en cuenta que este método es el más difícil de procesar para nuestra API y también requiere que especifiques el idioma y la ubicación exactos en la URL. En la mayoría de los casos, no recomendamos usar este método.
      ejemplo:
      https://search.yahoo.com/search?p=rank+checker&n=100&vl=lang_en&vc=us&ei=UTF-8

Respuestas
  • 200
    Tipo: object | null · Response36Afe1097B20_SerpYahooOrganicLiveHtmlResponseInfo
    • 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_SerpYahooOrganicLiveHtmlTaskInfo
        • 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

          • datetime
            Tipo: string | null

            fecha y hora en que se recibió el resultado
            en formato UTC: “yyyy-mm-dd hh-mm-ss +00:00”
            ejemplo:
            2019-11-15 12:57:46 +00:00

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

            elementos de resultados de búsqueda encontrados en el SERP

            • date
              Tipo: string | null

              fecha y hora en que se escaneó la página HTML
              en formato UTC: “yyyy-mm-dd hh-mm-ss +00:00”
              ejemplo:
              2019-11-15 12:57:46 +00:00

            • html
              Tipo: string | null

              página HTML

            • page
              Tipo: integer | null

              número de serie de la página HTML devuelta

          • items_count
            Tipo: integer | null Formato: int64

            el número de resultados devueltos en el array items

          • keyword
            Tipo: string | null

            palabra clave recibida en un array POST
            la palabra clave se devuelve con %## decodificado (el carácter '+' se decodificará como un espacio)

          • 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_domain
            Tipo: string | null

            dominio del motor de búsqueda en un array POST

          • type
            Tipo: string | null

            tipo de elemento

        • 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/serp/yahoo/organic/live/html
curl https://openapi.felo.ai/v1/beta/dataforseo/serp/yahoo/organic/live/html \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "language_code": "en",
    "location_code": 2840,
    "keyword": "albert einstein"
  }
]'

{
  "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": [
        {
          "keyword": null,
          "type": null,
          "se_domain": null,
          "location_code": null,
          "language_code": null,
          "datetime": null,
          "items_count": null,
          "items": [
            {
              "page": null,
              "date": null,
              "html": null
            }
          ]
        }
      ]
    }
  ]
}

Operación correcta

Live Yahoo Organic SERP HTML