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

Obtener resultados de Business Data Google Reviews por id

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

DataForSEO

​

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

Obtener resultados de Business Data Google Reviews por id

​

Recupera por id reseñas de Google Business Profile en cola. Envuelto en el sobre de DataForSEO: datos en tasks[0].result, resultado en tasks[0].status_code; una solicitud rechazada sigue devolviendo HTTP 200. ⚠️ El tamaño depende del depth definido al enviar y no puede reducirse aquí.

Referencia de precios

  • Medición: Coste de la respuesta notificado.
  • Estimación de referencia por solicitud: USD 0.012.
  • 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.

Parámetros de ruta
  • id
    Tipo: string
    obligatorio

    identificador de la tarea
    identificador único de la tarea en nuestro sistema en formato UUID
    podrás usarlo durante 30 días para solicitar los resultados de la tarea en cualquier momento

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

          • check_url
            Tipo: string | null

            URL directa a los resultados del motor de búsqueda
            puedes usarla para asegurarte de que proporcionamos resultados precisos

          • cid
            Tipo: string | null

            ID de cliente definido por Google
            ID único de un establecimiento local
            obtén más información sobre el identificador en este artículo del centro de ayuda

          • 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

          • feature_id
            Tipo: string | null

            el identificador único del elemento 'reviews' en la SERP
            obtén más información sobre el identificador en este artículo del centro de ayuda

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

            reseñas encontradas
            puedes obtener más resultados con el parámetro depth al establecer una tarea

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

              imágenes enviadas por el autor de la reseña

              • alt
                Tipo: string | null

                etiqueta alt de la imagen

              • image_url
                Tipo: string | null

                URL de la imagen
                la URL que conduce a la imagen en el recurso original o en el almacenamiento de DataForSEO (si la fuente original no está disponible)

              • type
                Tipo: string | null

                tipo de elemento

              • url
                Tipo: string | null

                URL relevante

            • local_guide
              Tipo: boolean | null

              indica si el autor de la reseña tiene el estado de 'local guide'

            • original_language
              Tipo: string | null

              idioma original del texto de la reseña

            • original_owner_answer
              Tipo: string | null

              texto original de la respuesta del propietario
              la respuesta original a la reseña, sin traducción automática aplicada

            • original_review_text
              Tipo: string | null

              contenido original de la reseña
              el contenido original de la reseña, sin traducción automática aplicada

            • owner_answer
              Tipo: string | null

              texto de la respuesta del propietario
              la respuesta del propietario a la reseña

            • owner_time_ago
              Tipo: string | null

              hora de publicación
              indica el momento (en formato 'hace tiempo') en que el propietario envió la respuesta a la reseña

            • owner_timestamp
              Tipo: string | null

              fecha y hora de la respuesta del propietario a la reseña
              en formato UTC: “yyyy-mm-dd hh-mm-ss +00:00”
              ejemplo:
              2019-11-15 12:57:46 +00:00

            • photos_count
              Tipo: integer | null Formato: int64

              número total de fotos enviadas por el autor de la reseña

            • position
              Tipo: string | null

              la alineación de la reseña en la SERP
              puede tomar los siguientes valores: right

            • profile_image_url
              Tipo: string | null

              URL de la imagen de perfil del autor de la reseña

            • profile_name
              Tipo: string | null

              nombre de perfil del autor de la reseña

            • profile_url
              Tipo: string | null

              URL del perfil del autor de la reseña

            • rank_absolute
              Tipo: integer | null

              rank absoluto entre todas las reseñas listadas
              posición absoluta entre todas las reseñas de la lista

            • rank_group
              Tipo: integer | null

              posición dentro de un grupo de elementos con valores de type idénticos
              las posiciones de los elementos con valores de type diferentes se omiten de rank_group

            • rating
              Tipo: object | null · Response36Afe1097B20_RatingInfo

              la puntuación enviada por el autor de la reseña

              • rating_max
                Tipo: integer | null

                el valor máximo para un rating_type

              • rating_type
                Tipo: string | null

                el tipo de valoración aquí puedes encontrar los siguientes elementos: Max5, Percents, CustomMax

              • value
                Tipo: number | null Formato: double

                el valor de la valoración

              • votes_count
                Tipo: integer | null Formato: int64

                la cantidad de feedback

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

              aspectos destacados de la reseña
              contiene criterios y valoraciones destacados

              • assessment
                Tipo: string | null

                evaluación del aspecto

              • feature
                Tipo: string | null

                aspecto evaluado

            • review_id
              Tipo: string | null

              el identificador único de una reseña en Google
              ejemplo:
              ChZDSUhNMG9nS0VJQ0FnSUMxbHFyMFlnEAE

            • review_text
              Tipo: string | null

              el contenido de la reseña

            • review_url
              Tipo: string | null

              la URL de la reseña

            • reviews_count
              Tipo: integer | null Formato: int64

              número total de reseñas enviadas por el autor de la reseña

            • time_ago
              Tipo: string | null

              la hora de publicación
              indica el momento (en formato 'hace tiempo') en que se listó la reseña

            • timestamp
              Tipo: string | null

              fecha y hora en que se publicó una reseña
              en formato UTC: “yyyy-mm-dd hh-mm-ss +00:00”
              ejemplo:
              2019-11-15 12:57:46 +00:00

            • type
              Tipo: string | null

              tipo de elemento

            • xpath
              Tipo: string | null

              el XPath de la reseña

          • items_count
            Tipo: integer | null Formato: int64

            el número de elementos de reseñas del array de resultados
            puedes obtener más resultados con el parámetro depth al establecer una tarea

          • 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

          • place_id
            Tipo: string | null

            identificador único de una ubicación comercial asignado por Google
            obtén más información sobre el identificador en este artículo del centro de ayuda

          • rating
            Tipo: object | null · Response36Afe1097B20_RatingInfo

            valoración del establecimiento local correspondiente
            tasa de popularidad basada en las reseñas y mostrada en la SERP

            • rating_max
              Tipo: integer | null

              el valor máximo para un rating_type

            • rating_type
              Tipo: string | null

              el tipo de valoración aquí puedes encontrar los siguientes elementos: Max5, Percents, CustomMax

            • value
              Tipo: number | null Formato: double

              el valor de la valoración

            • votes_count
              Tipo: integer | null Formato: int64

              la cantidad de feedback

          • reviews_count
            Tipo: integer | null Formato: int64

            el número total de reseñas

          • se_domain
            Tipo: string | null

            dominio del motor de búsqueda en un array POST

          • sub_title
            Tipo: string | null

            subtítulo del elemento 'reviews' en la SERP
            información adicional (por ejemplo, dirección) sobre el elemento 'reviews' para el que se recopilan las reseñas

          • title
            Tipo: string | null

            título del elemento 'reviews' en la SERP
            el nombre del establecimiento local para el que se recopilan las reseñas

          • 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 get/v1/beta/dataforseo/business_data/google/reviews/task_get/{id}
curl https://openapi.felo.ai/v1/beta/dataforseo/business_data/google/reviews/task_get/00000000-0000-0000-0000-000000000000 \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
  "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,
          "check_url": null,
          "datetime": null,
          "title": null,
          "sub_title": null,
          "rating": {
            "rating_type": null,
            "value": null,
            "votes_count": null,
            "rating_max": null
          },
          "feature_id": null,
          "place_id": null,
          "cid": null,
          "reviews_count": null,
          "items_count": null,
          "items": [
            {
              "type": null,
              "rank_group": null,
              "rank_absolute": null,
              "position": null,
              "xpath": null,
              "review_text": null,
              "original_review_text": null,
              "original_language": null,
              "time_ago": null,
              "timestamp": null,
              "rating": "[Max Depth Exceeded]",
              "reviews_count": null,
              "photos_count": null,
              "local_guide": null,
              "profile_name": null,
              "profile_url": null,
              "review_url": null,
              "profile_image_url": null,
              "owner_answer": null,
              "original_owner_answer": null,
              "owner_time_ago": null,
              "owner_timestamp": null,
              "review_id": null,
              "images": [
                "[Max Depth Exceeded]"
              ],
              "review_highlights": [
                "[Max Depth Exceeded]"
              ]
            }
          ]
        }
      ]
    }
  ]
}
Get Business Data Google Reviews Results by id