v0.2.0-beta

OpenAPI 3.1.0

Obter resultados de Google My Business Info por id

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 Operações

get/v1/beta/dataforseo/business_data/google/my_business_info/task_get/{id}

Obter resultados de Google My Business Info por id

Recupera por id uma consulta de Google Business Profile enfileirada. Encapsulado no envelope do DataForSEO: dados em tasks[0].result, resultado em tasks[0].status_code — uma requisição rejeitada ainda retorna HTTP 200. Encapsulado no envelope do DataForSEO: dados em tasks[0].result, resultado em tasks[0].status_code — uma requisição rejeitada ainda retorna HTTP 200. ⚠️ O tamanho da resposta foi fixado pelo depth ou limite definido no envio e não pode ser reduzido aqui; se estiver grande demais, reenvie com um valor menor em vez de paginar.

Referência de preços

Medição: Custo da resposta reportado.
Estimativa de referência por requisição: USD 0.012.
Multiplicador de referência do cliente: 1.0. Não o aplique novamente a um valor de cliente já liquidado.

Apenas metadados de referência, não uma cotação da conta, um preço garantido ou um limite de gastos. Créditos de recursos não são créditos Felo. As cobranças finais seguem os registros de cobrança da Felo.

Parâmetros de Caminho

id
Tipo: string
obrigatório

identificador da tarefa
identificador exclusivo da tarefa em nosso sistema no formato UUID
você poderá usá-lo por 30 dias para solicitar os resultados da tarefa a qualquer momento

Respostas

200
Tipo: object | null · Response36Afe1097B20_BusinessDataGoogleMyBusinessInfoTaskGetResponseInfo
cost
Tipo: number | null Formato: double

custo total das tarefas, USD

status_code
Tipo: integer | null

código de status geral você pode encontrar a lista completa dos códigos de resposta aqui

status_message
Tipo: string | null

mensagem informativa geral você pode encontrar a lista completa das mensagens informativas gerais aqui

tasks
Tipo: array (object | null)[] | null

array de tarefas

Tipo: object | null · Response36Afe1097B20_BusinessDataGoogleMyBusinessInfoTaskGetTaskInfo
cost
Tipo: number | null Formato: double

custo total das tarefas, USD

data
Tipo: object | null

contém os mesmos parâmetros que você especificou na requisição POST

propertyName
Tipo: object | null
id
Tipo: string | null

identificador da tarefa identificador exclusivo da tarefa em nosso sistema no formato UUID

path
Tipo: array (string | null)[] | null

caminho da URL

result
Tipo: array (object | null)[] | null

array de resultados

check_url
Tipo: string | null

URL direta para os resultados do mecanismo de busca
você pode usá-la para garantir que fornecemos resultados precisos

datetime
Tipo: string | null

data e hora em que o resultado foi recebido
no formato UTC: “yyyy-mm-dd hh-mm-ss +00:00”
exemplo:
2019-11-15 12:57:46 +00:00

item_types
Tipo: array (string | null)[] | null

tipos de itens
tipos de resultados de pesquisa encontrados no array items;
tipos de itens possíveis: google_business_info

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

array de itens de diretório

additional_categories
Tipo: array string[] | null

categorias de negócio adicionais
categorias adicionais do Google My Business que descrevem com mais detalhes os serviços prestados pela entidade empresarial

address
Tipo: string | null

endereço da entidade comercial

address_info
Tipo: object | null · Response36Afe1097B20_AddressInfo

objeto que contém os componentes de endereço da entidade comercial

address
Tipo: string | null

endereço do estabelecimento local

borough
Tipo: string | null

unidade administrativa ou distrito ao qual o estabelecimento local pertence

city
Tipo: string | null

nome da cidade onde o estabelecimento local está localizado

country_code
Tipo: string | null

código ISO do país do estabelecimento local

region
Tipo: string | null

região DMA à qual o estabelecimento local pertence

zip
Tipo: string | null

código postal do estabelecimento local

attributes
Tipo: object | null · Response36Afe1097B20_BusinessDataAttributesInfo

detalhes do serviço em forma de verificações avaliadas por usuários;
detalhes do serviço de uma entidade comercial exibidos em forma de verificações e baseados no feedback dos usuários e na category do negócio

available_attributes
Tipo: object | null

atributos disponíveis
indica os atributos que uma entidade comercial pode oferecer

propertyName
Tipo: array (string | null)[] | null
unavailable_attributes
Tipo: object | null

atributos indisponíveis
indica os atributos que uma entidade comercial não pode oferecer

propertyName
Tipo: array (string | null)[] | null
book_online_url
Tipo: string | null

URL no botão 'reservar online' do elemento
URL que direciona os usuários para a página de reserva ou pedido online da entidade empresarial

category
Tipo: string | null

categoria de negócio
categoria geral do Google My Business que melhor descreve os serviços prestados pela entidade empresarial

category_ids
Tipo: array string[] | null

IDs globais de categoria
IDs universais de categoria que não mudam com base no país selecionado

cid
Tipo: string | null

client id definido pelo Google
id exclusivo de um estabelecimento local;
pode ser usado com a Google Reviews API para obter uma lista completa de avaliações
saiba mais sobre o identificador neste artigo da central de ajuda

contact_url
Tipo: string | null

URL da página de contato preferida

contributor_url
Tipo: string | null

URL do perfil do Local Guides do usuário ou da entidade, se disponível

description
Tipo: string | null

descrição do elemento na SERP
a descrição da entidade comercial para a qual os resultados são coletados

directory
Tipo: object | null · Response36Afe1097B20_BusinessDirectoryInfo

itens do diretório
inclui informações sobre empresas localizadas dentro do estabelecimento comercial de destino e que têm o mesmo endereço

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

tipos de itens encontrados
tipos de resultados de pesquisa encontrados no array items;
tipos de itens possíveis: google_business_info

additional_categories
Tipo: array string[] | null

categorias de negócio adicionais
categorias adicionais do Google My Business que descrevem com mais detalhes os serviços prestados pela entidade empresarial

address
Tipo: string | null

endereço da entidade comercial

address_info
Tipo: object | null · Response36Afe1097B20_AddressInfo

objeto que contém os componentes de endereço da entidade comercial

address
Tipo: string | null

endereço do estabelecimento local

borough
Tipo: string | null

unidade administrativa ou distrito ao qual o estabelecimento local pertence

city
Tipo: string | null

nome da cidade onde o estabelecimento local está localizado

country_code
Tipo: string | null

código ISO do país do estabelecimento local

region
Tipo: string | null

região DMA à qual o estabelecimento local pertence

zip
Tipo: string | null

código postal do estabelecimento local

category
Tipo: string | null

categoria de negócio
categoria geral do Google My Business que melhor descreve os serviços prestados pela entidade empresarial

category_ids
Tipo: array string[] | null

IDs globais de categoria
IDs universais de categoria que não mudam com base no país selecionado

cid
Tipo: string | null

client id definido pelo Google
id exclusivo de um estabelecimento local;
pode ser usado com a Google Reviews API para obter uma lista completa de avaliações
saiba mais sobre o identificador neste artigo da central de ajuda

domain
Tipo: string | null

domínio da entidade comercial

feature_id
Tipo: string | null

o identificador exclusivo do elemento na SERP
saiba mais sobre o identificador neste artigo da central de ajuda

hotel_rating
Tipo: string | null

classificação por estrelas do hotel
as classificações variam entre 1 e 5 estrelas, saiba mais
se não houver informações de classificação do hotel, o valor será null

is_claimed
Tipo: boolean | null

mostra se a entidade foi verificada pelo proprietário no Google Maps

is_directory_item
Tipo: boolean | null

o estabelecimento comercial faz parte do diretório
indica se o estabelecimento comercial faz parte do diretório;
se true, o item faz parte de um diretório maior de empresas com o mesmo endereço (por exemplo, um shopping ou um centro comercial);
observação: se o estabelecimento comercial for um item pai no diretório, o valor será null

latitude
Tipo: number | null

coordenada de latitude dos estabelecimentos locais no google maps
exemplo:
"latitude": 51.584091

local_justifications
Tipo: array string[] | null

justificativas locais do Google
trechos de texto que “justificam” por que a empresa aparece para a consulta de pesquisa

longitude
Tipo: number | null

coordenada de longitude do estabelecimento local no google maps
exemplo:
"longitude": -0.31365919999999997

main_image
Tipo: string | null

URL da imagem principal apresentada no perfil do Google My Business

phone
Tipo: string | null

telefone da entidade comercial

place_id
Tipo: string | null

identificador exclusivo do local
place id do estabelecimento local apresentado no elemento
saiba mais sobre o identificador neste artigo da central de ajuda

price_level
Tipo: string | null

nível de preço do estabelecimento
pode assumir os valores: inexpensive, moderate, expensive, very_expensive
se não houver informações de nível de preço, o valor será null

rank_absolute
Tipo: integer | null

ranking absoluto entre todos os elementos

rank_group
Tipo: integer | null

posição dentro de um grupo de elementos com valores de type idênticos
as posições dos elementos com valores de type diferentes são omitidas de rank_group

rating
Tipo: object | null · Response36Afe1097B20_RatingInfo

a avaliação do elemento
a taxa de popularidade com base nas avaliações e exibida na SERP

rating_max
Tipo: integer | null

o valor máximo para um rating_type

rating_type
Tipo: string | null

o tipo de avaliação aqui você pode encontrar os seguintes elementos: Max5, Percents, CustomMax

value
Tipo: number | null Formato: double

o valor da avaliação

votes_count
Tipo: integer | null Formato: int64

a quantidade de feedback

rating_distribution
Tipo: object | null

a distribuição das avaliações da entidade comercial o objeto exibe o número de avaliações de 1 a 5 estrelas, conforme avaliado pelos usuários

propertyName
Tipo: integer | null Formato: Int64
snippet
Tipo: string | null

informações adicionais sobre a entidade comercial

title
Tipo: string | null

título do diretório
pode assumir os seguintes valores: At this place, Directory

total_photos
Tipo: string | null Formato: int64

número total de imagens apresentadas no perfil do Google My Business

type
Tipo: string | null

tipo de elemento

url
Tipo: string | null

URL para visualizar o cardápio

work_hours
Tipo: object | null · Response36Afe1097B20_BusinessWorkHoursInfo

horário de funcionamento
informações sobre o horário de trabalho do estabelecimento local

work_hours
Tipo: object | null · Response36Afe1097B20_WorkHours

horário de funcionamento
informações sobre o horário de trabalho do estabelecimento local

current_status
Tipo: string | null

status atual do estabelecimento
indica se o estabelecimento está aberto ou fechado

timetable
Tipo: object | null

tabela de horários de funcionamento

propertyName
Tipo: array (object | null)[] | null

horário de funcionamento aos domingos

close
Tipo: object | null · Response36Afe1097B20_TimeInfo

horário de fechamento

hour
Tipo: integer | null

horas no formato de 24 horas

minute
Tipo: integer | null

minutos

open
Tipo: object | null · Response36Afe1097B20_TimeInfo

horário de abertura

hour
Tipo: integer | null

horas no formato de 24 horas

minute
Tipo: integer | null

minutos

title
Tipo: string | null

título do elemento
domínio do sistema de menu online

domain
Tipo: string | null

domínio da entidade comercial

feature_id
Tipo: string | null

o identificador exclusivo do elemento na SERP
saiba mais sobre o identificador neste artigo da central de ajuda

hotel_rating
Tipo: number | null

classificação por estrelas do hotel
as classificações variam entre 1 e 5 estrelas, saiba mais
se não houver informações de classificação do hotel, o valor será null

is_claimed
Tipo: boolean | null

mostra se a entidade foi verificada pelo proprietário no Google Maps

is_directory_item
Tipo: boolean | null

o estabelecimento comercial faz parte do diretório
indica se o estabelecimento comercial faz parte do diretório;
se true, o item faz parte de um diretório maior de empresas com o mesmo endereço (por exemplo, um shopping ou um centro comercial);
observação: se o estabelecimento comercial for um item pai no diretório, o valor será null

latitude
Tipo: number | null

coordenada de latitude dos estabelecimentos locais no google maps
exemplo:
"latitude": 51.584091

local_business_links
Tipo: array (object | null)[] | null

interações disponíveis com a empresa
lista de opções para interagir com a empresa diretamente nos resultados de pesquisa

type
Tipo: string | null

tipo de elemento

logo
Tipo: string | null

URL do logotipo exibido no perfil do Google My Business

longitude
Tipo: number | null

coordenada de longitude do estabelecimento local no google maps
exemplo:
"longitude": -0.31365919999999997

main_image
Tipo: string | null

URL da imagem principal apresentada no perfil do Google My Business

original_title
Tipo: string | null

título original do elemento
título original não traduzido pelo Google

people_also_search
Tipo: array (object | null)[] | null

entidades comerciais relacionadas

cid
Tipo: string | null

ID de cliente definido pelo Google
ID exclusivo de um estabelecimento local
saiba mais sobre o identificador neste artigo da central de ajuda

feature_id
Tipo: string | null

o identificador exclusivo do elemento na SERP
saiba mais sobre o identificador neste artigo da central de ajuda

rating
Tipo: object | null · Response36Afe1097B20_RatingInfo

a avaliação do elemento
a taxa de popularidade com base nas avaliações e exibida na SERP

rating_max
Tipo: integer | null

o valor máximo para um rating_type

rating_type
Tipo: string | null

o tipo de avaliação aqui você pode encontrar os seguintes elementos: Max5, Percents, CustomMax

value
Tipo: number | null Formato: double

o valor da avaliação

votes_count
Tipo: integer | null Formato: int64

a quantidade de feedback

title
Tipo: string | null

título do elemento na SERP
o nome da entidade comercial para a qual os resultados são coletados

phone
Tipo: string | null

telefone da entidade comercial

place_id
Tipo: string | null

identificador exclusivo do local
place id do estabelecimento local apresentado no elemento
saiba mais sobre o identificador neste artigo da central de ajuda

place_topics
Tipo: object | null

palavras-chave mencionadas nas avaliações de clientes
contém as palavras-chave mais populares relacionadas a produtos/serviços mencionados nas avaliações de clientes de uma entidade comercial e o número de avaliações que mencionam cada palavra-chave
exemplo:"place_topics": { "egg roll": 48, "birthday": 33 }

propertyName
Tipo: integer | null Formato: int64

Signed 64-bit integers (long type).

popular_times
Tipo: object | null · Response36Afe1097B20_PopularTimes

horários de maior movimento
informações relacionadas aos horários de pico da entidade comercial

popular_times_by_days
Tipo: object | null

horários de pico
informações sobre os horários de maior movimento do estabelecimento local em cada dia da semana

propertyName
Tipo: array (object | null)[] | null

horário de funcionamento aos domingos

popular_index
Tipo: integer | null

índice de popularidade índice de popularidade relativo e limitado no tempo, medido de 0 a 100; um valor mais alto corresponde a um horário do dia com mais movimento

time
Tipo: object | null · Response36Afe1097B20_TimeInfo

horas no formato de 24 horas

hour
Tipo: integer | null

horas no formato de 24 horas

minute
Tipo: integer | null

minutos

position
Tipo: string | null

o alinhamento na SERP

price_level
Tipo: string | null

nível de preço do estabelecimento
pode assumir os valores: inexpensive, moderate, expensive, very_expensive
se não houver informações de nível de preço, o valor será null

questions_and_answers_count
Tipo: integer | null

Integer numbers.

rank_absolute
Tipo: integer | null

ranking absoluto entre todos os elementos

rank_group
Tipo: integer | null

posição dentro de um grupo de elementos com valores de type idênticos
as posições dos elementos com valores de type diferentes são omitidas de rank_group

rating
Tipo: object | null · Response36Afe1097B20_RatingInfo

a avaliação do elemento
a taxa de popularidade com base nas avaliações e exibida na SERP

rating_max
Tipo: integer | null

o valor máximo para um rating_type

rating_type
Tipo: string | null

o tipo de avaliação aqui você pode encontrar os seguintes elementos: Max5, Percents, CustomMax

value
Tipo: number | null Formato: double

o valor da avaliação

votes_count
Tipo: integer | null Formato: int64

a quantidade de feedback

rating_distribution
Tipo: object | null

a distribuição de avaliações da entidade comercial
o objeto exibe o número de avaliações de 1 a 5 estrelas, conforme avaliado pelos usuários

propertyName
Tipo: integer | null Formato: Int64
services
Tipo: array (object | null)[] | null

lista de serviços oferecidos pelo negócio

category
Tipo: string | null

categoria de negócio
categoria geral do Google My Business que melhor descreve os serviços prestados pela entidade empresarial

price
Tipo: object | null · Response36Afe1097B20_PriceInfo
currency
Tipo: string | null

moeda do preço listado código ISO da moeda aplicada ao preço

current
Tipo: number | null Formato: double

preço atual indica o preço atual do produto ou serviço em destaque no resultado

displayed_price
Tipo: string | null

string de preço no resultado string de preço bruta conforme fornecida no resultado

is_price_range
Tipo: boolean | null

o preço é fornecido como um intervalo indica se um preço é fornecido como um intervalo

max_value
Tipo: number | null Formato: double

o preço máximo o preço máximo do produto ou serviço conforme indicado no resultado

regular
Tipo: number | null Formato: double

preço normal indica o preço normal do produto ou serviço sem descontos aplicados

snippet
Tipo: string | null

informações adicionais sobre a entidade comercial

title
Tipo: string | null

título do elemento na SERP
o nome da entidade comercial para a qual os resultados são coletados

snippet
Tipo: string | null

informações adicionais sobre a entidade comercial

title
Tipo: string | null

título do elemento na SERP
o nome da entidade comercial para a qual os resultados são coletados

total_photos
Tipo: integer | null Formato: int64

número total de imagens apresentadas no perfil do Google My Business

type
Tipo: string | null

tipo de elemento

url
Tipo: string | null

url absoluta da entidade comercial

work_time
Tipo: object | null · Response36Afe1097B20_BusinessWorkHoursInfo

detalhes do horário de funcionamento
informações relacionadas ao horário de funcionamento da entidade comercial

work_hours
Tipo: object | null · Response36Afe1097B20_WorkHours

horário de funcionamento
informações sobre o horário de trabalho do estabelecimento local

current_status
Tipo: string | null

status atual do estabelecimento
indica se o estabelecimento está aberto ou fechado

timetable
Tipo: object | null

tabela de horários de funcionamento

propertyName
Tipo: array (object | null)[] | null

horário de funcionamento aos domingos

close
Tipo: object | null · Response36Afe1097B20_TimeInfo

horário de fechamento

hour
Tipo: integer | null

horas no formato de 24 horas

minute
Tipo: integer | null

minutos

open
Tipo: object | null · Response36Afe1097B20_TimeInfo

horário de abertura

hour
Tipo: integer | null

horas no formato de 24 horas

minute
Tipo: integer | null

minutos

items_count
Tipo: integer | null Formato: int64

tipos de itens
o número de itens no array items

keyword
Tipo: string | null

palavra-chave recebida em um array POST
a palavra-chave é retornada com %## decodificado (o caractere '+' será decodificado como um espaço)
este campo conterá o parâmetro cid se você o especificou no campo keyword ao definir uma tarefa;
exemplo:
cid:2946633002421908862
saiba mais sobre o parâmetro neste artigo da central de ajuda

language_code
Tipo: string | null

código de idioma em um array POST

location_code
Tipo: integer | null

código de localização em um array POST

se_domain
Tipo: string | null

domínio do mecanismo de busca conforme especificado em um array POST

result_count
Tipo: integer | null Formato: int64

número de elementos no array de resultados

status_code
Tipo: integer | null

código de status da tarefa gerado pelo DataForSEO; pode estar no seguinte intervalo: 10000-60000 você pode encontrar a lista completa dos códigos de resposta aqui

status_message
Tipo: string | null

mensagem informativa da tarefa você pode encontrar a lista completa das mensagens informativas gerais aqui

time
Tipo: string | null

tempo de execução, segundos

tasks_count
Tipo: integer | null Formato: int64

o número de tarefas no array de tarefas

tasks_error
Tipo: integer | null Formato: int64

o número de tarefas no array de tarefas retornadas com erro

time
Tipo: string | null

tempo total de execução, em segundos

version
Tipo: string | null

a versão atual da API
application/json
400

Não foi possível processar a requisição. Verifique os parâmetros da requisição.
401

É necessária uma chave de API da Felo válida.
402

A requisição não pode prosseguir porque um requisito de cobrança não foi atendido.
403

A conta não tem permissão para realizar esta operação.
429

Um limite de requisições ou de gastos foi atingido.
502

O serviço não pôde concluir a requisição.
503

A API ou o serviço de cobrança está temporariamente indisponível.
504

O serviço atingiu o tempo limite ao processar a requisição.
default

Resposta de erro; respostas repassadas do upstream podem usar formatos do provedor

application/json

get/v1/beta/dataforseo/business_data/google/my_business_info/task_get/{id}

curl https://openapi.felo.ai/v1/beta/dataforseo/business_data/google/my_business_info/task_get/00000000-0000-0000-0000-000000000000 \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

Mostrar Schema

{
  "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,
          "se_domain": null,
          "location_code": null,
          "language_code": null,
          "check_url": null,
          "datetime": null,
          "item_types": [
            null
          ],
          "items_count": null,
          "items": [
            {
              "type": null,
              "rank_group": null,
              "rank_absolute": null,
              "position": null,
              "title": null,
              "original_title": null,
              "description": null,
              "category": null,
              "category_ids": [
                "[Max Depth Exceeded]"
              ],
              "additional_categories": [
                "[Max Depth Exceeded]"
              ],
              "cid": null,
              "feature_id": null,
              "address": null,
              "address_info": "[Max Depth Exceeded]",
              "place_id": null,
              "phone": null,
              "url": null,
              "contact_url": null,
              "contributor_url": null,
              "book_online_url": null,
              "domain": null,
              "logo": null,
              "main_image": null,
              "total_photos": null,
              "snippet": null,
              "latitude": null,
              "longitude": null,
              "is_claimed": null,
              "questions_and_answers_count": null,
              "attributes": "[Max Depth Exceeded]",
              "place_topics": null,
              "rating": "[Max Depth Exceeded]",
              "hotel_rating": null,
              "price_level": null,
              "rating_distribution": null,
              "people_also_search": [
                "[Max Depth Exceeded]"
              ],
              "work_time": "[Max Depth Exceeded]",
              "popular_times": "[Max Depth Exceeded]",
              "local_business_links": [
                "[Max Depth Exceeded]"
              ],
              "is_directory_item": null,
              "directory": "[Max Depth Exceeded]",
              "services": [
                "[Max Depth Exceeded]"
              ]
            }
          ]
        }
      ]
    }
  ]
}

Operação bem-sucedida

Obter resultados de Google My Business Info por id

AutenticaçãoRequired

DataForSEO

Obter resultados de Google My Business Info por id

Referência de preços