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

HTML de SERP de Google Images 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

HTML de SERP de Google Images en vivo

​

Devuelve los resultados de imágenes para una palabra clave en Google, 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 la SERP

      valor predeterminado: 100

      valor máximo: 200


      Tu cuenta se factura por cada SERP que contenga hasta 100 resultados;

      definir una profundidad superior a 100 puede generar cargos adicionales si el motor de búsqueda devuelve más de 100 resultados;

      si la profundidad especificada es mayor que el número de resultados de la respuesta, la diferencia se reembolsará automáticamente en el saldo de tu cuenta;

      El costo puede calcularse en la página Pricing.

    • keyword
      Tipo: string

      palabra clave

      campo obligatorio

      puedes especificar hasta 700 caracteres en el campo keyword

      todos los %## se decodificarán (el carácter '+' también 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”;

      si este campo contiene parámetros como 'allinanchor:', 'allintext:', 'allintitle:', 'allinurl:', 'define:', 'filetype:', 'id:', 'inanchor:', 'info:', 'intext:', 'intitle:', 'inurl:', 'link:', 'related:', 'site:', el cargo por tarea se multiplicará por 5

      Nota: las consultas que contienen el parámetro ‘cache:’ no se admiten y devolverán un error de validación


      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 obtener la lista de idiomas disponibles del motor de búsqueda y su language_code haciendo una solicitud independiente a https://api.dataforseo.com/v3/serp/google/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 obtener la lista de idiomas disponibles del motor de búsqueda y su language_name haciendo una solicitud independiente a https://api.dataforseo.com/v3/serp/google/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/google/locations

      ejemplo:

      2840

    • location_coordinate
      Tipo: string

      coordenadas GPS de una ubicación

      campo obligatorio si no especificas location_name o 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/google/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 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

      ten en cuenta que esta API solo proporciona resultados para desktop

      elige entre los siguientes valores: windows, macos

      valor predeterminado: windows

    • se_domain
      Tipo: string | null

      dominio del motor de búsqueda

      campo opcional

      elegimos el dominio del motor de búsqueda relevante automáticamente según la ubicación y el idioma que especifiques

      sin embargo, puedes definir un dominio de motor de búsqueda personalizado en este campo

      ejemplo:

      google.co.uk, google.com.au, google.de, etc.

    • search_param
      Tipo: string | null

      parámetros adicionales de la consulta de búsqueda

      campo opcional

      obtén la lista de parámetros disponibles y más detalles aquí

    • 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 emparejarla con el resultado

      encontrarás el valor tag especificado en el objeto data de la respuesta

    • 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://www.google.co.uk/search?q=%20rank%20tracker%20api&hl=en&gl=GB&uule=w+CAIQIFISCXXeIa8LoNhHEZkq1d1aOpZS

Respuestas
  • 200
    Tipo: object | null · Response36Afe1097B20_SerpGoogleImagesLiveHtmlResponseInfo
    • 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_SerpGoogleImagesLiveHtmlTaskInfo
        • 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/google/images/live/html
curl https://openapi.felo.ai/v1/beta/dataforseo/serp/google/images/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 Google Images SERP HTML