Yelp (Editora Independente) (Pré-visualização)
O conector Yelp permite que você obtenha o melhor conteúdo local, pontos de interesse e avaliações de usuários de milhões de empresas em 32 países.
Este conector está disponível nos seguintes produtos e regiões:
| Serviço | Class | Regiões |
|---|---|---|
| Estúdio Copiloto | Premium | Todas as regiões do Power Automatic , exceto as seguintes: - Governo dos EUA (CCG) - Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Aplicações Lógicas | Standard | Todas as regiões do Logic Apps , exceto as seguintes: - Regiões do Azure Government - Regiões do Azure China - Departamento de Defesa dos EUA (DoD) |
| Aplicações Power | Premium | Todas as regiões do Power Apps , exceto as seguintes: - Governo dos EUA (CCG) - Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Automatize o poder | Premium | Todas as regiões do Power Automatic , exceto as seguintes: - Governo dos EUA (CCG) - Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Contato | |
|---|---|
| Nome | Ahmad Najjar |
| ahmadn82@hotmail.com |
| Metadados do conector | |
|---|---|
| Editora | Ahmad Najjar |
| Sítio Web | https://www.yelp.com/ |
| Política de privacidade | https://terms.yelp.com/privacy/ |
A criar uma ligação
O conector suporta os seguintes tipos de autenticação:
| Predefinição | Parâmetros para criar conexão. | Todas as regiões | Não compartilhável |
Padrão
Aplicável: Todas as regiões
Parâmetros para criar conexão.
Esta conexão não é compartilhável. Se o aplicativo avançado for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.
| Nome | Tipo | Description | Obrigatório |
|---|---|---|---|
| Chave da API do Yelp | securestring | Forneça uma chave da API do Yelp como 'API_KEY ao portador' | Verdade |
Limites de Limitação
| Name | Chamadas | Período de Renovação |
|---|---|---|
| Chamadas de API por conexão | 100 | 60 segundos |
Ações
| Encontre o Business Match |
Encontre a empresa Yelp que corresponde a um local exato de entrada. Use esta ação para combinar dados comerciais de outras fontes com as empresas do Yelp. |
| Obter avaliações |
Obtenha até três trechos de avaliações para um estabelecimento. |
| Obter detalhes da empresa |
Obtenha dados comerciais ricos, como nome, endereço, número de telefone, fotos, classificação do Yelp, níveis de preços e horas de funcionamento. |
| Pesquisar Empresas |
Pesquisa de empresas por Termo (palavra-chave), categoria, localização, nível de preço, etc. Use esta ação quando tiver informações gerais sobre a biz, como nome e localização, mas não souber o endereço. |
| Pesquisar Telefones Empresariais |
Retorna uma lista de empresas com base no número de telefone fornecido. Use esta ação quando tiver apenas o número de telefone ou menos confiante sobre outros critérios de correspondência. |
| Preenchimento Automático |
Forneça sugestões de preenchimento automático para empresas, palavras-chave de pesquisa e categorias. |
Encontre o Business Match
Encontre a empresa Yelp que corresponde a um local exato de entrada. Use esta ação para combinar dados comerciais de outras fontes com as empresas do Yelp.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Nome
|
name | True | string |
O nome da empresa. O comprimento máximo é de 64; apenas dígitos, letras, espaços e !#$%&+, ./:?@'são permitidos. |
|
Endereço 1
|
address1 | True | string |
A primeira linha do endereço do negócio. O comprimento máximo é de 64; apenas dígitos, letras, espaços e /#&,.: são permitidos. A string vazia "" é permitida; Isso corresponderá especificamente a certas empresas de serviços que não têm endereço. |
|
Endereço 2
|
address2 | string |
A segunda linha do endereço da empresa. O comprimento máximo é de 64; apenas dígitos, letras, espaços e /#&,.: são permitidos. |
|
|
Endereço 3
|
address3 | string |
A terceira linha do endereço do negócio. O comprimento máximo é de 64; apenas dígitos, letras, espaços e /#&,.: são permitidos. |
|
|
City
|
city | True | string |
A cidade do negócio. O comprimento máximo é de 64; apenas dígitos, letras, espaços e . () são permitidos. |
|
Estado
|
state | True | string |
O código de estado ISO 3166-2 (com algumas exceções) deste negócio. O comprimento máximo é 3. |
|
Country
|
country | True | string |
O código de país ISO 3166-1 alpha-2 desta empresa. O comprimento máximo é 2. |
|
Latitude
|
latitude | double |
A latitude WGS84 do negócio em graus decimais. Deve estar entre -90 e +90. |
|
|
Longitude
|
longitude | double |
A longitude WGS84 do negócio em graus decimais. Deve estar entre -180 e +180. |
|
|
Telemóvel
|
phone | string |
O número de telefone da empresa que pode ser enviado como (a) formatado localmente apenas com dígitos (por exemplo, 016703080) ou (b) formatado internacionalmente com um sinal + à esquerda e dígitos somente após (+35316703080). O comprimento máximo é 32. |
|
|
Código Postal
|
zip_code | string |
O CEP deste negócio. |
|
|
ID da empresa Yelp
|
yelp_business_id | string |
Identificador Yelp único da empresa, se disponível. Usado como uma dica ao encontrar um negócio correspondente. |
|
|
Limite
|
limit | integer |
Número máximo de resultados comerciais a devolver. Por padrão, ele retornará 3. O mínimo é 1, o máximo é 10. |
|
|
Limiar de correspondência
|
match_threshold | integer |
Especifica se um limite de qualidade correspondente deve ser aplicado às empresas correspondentes. Deve ser um de 'nenhum', 'padrão' ou 'estrito'. nenhum: Não aplicar qualquer limiar de qualidade correspondente; Todas as potenciais correspondências de negócios serão retornadas. padrão: aplique um limite de qualidade de correspondência de modo que apenas empresas muito próximas sejam retornadas. rigoroso: Aplique um limite de qualidade de correspondência muito rigoroso. |
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
|
array of object | ||
|
nome
|
name | string |
nome |
|
Endereço1
|
location.address1 | string |
Endereço1 |
|
Endereço2
|
location.address2 | string |
Endereço2 |
|
Endereço3
|
location.address3 | string |
Endereço3 |
|
city
|
location.city | string |
city |
|
state
|
location.state | string |
state |
|
zip_code
|
location.zip_code | string |
zip_code |
|
country
|
location.country | string |
country |
|
latitude
|
coordinates.latitude | float |
latitude |
|
longitude
|
coordinates.longitude | float |
longitude |
|
phone
|
phone | string |
phone |
|
id
|
id | string |
id |
|
alias
|
alias | string |
alias |
Obter avaliações
Obtenha até três trechos de avaliações para um estabelecimento.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
ID
|
id | True | string |
ID Yelp único deste negócio. |
|
Localidade
|
locale | string |
Padrão en_US. (Ver https://bit.ly/3lwvIWU) |
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
avalições
|
reviews | array of object |
avalições |
|
id
|
reviews.id | string |
id |
|
classificação
|
reviews.rating | integer |
classificação |
|
id
|
reviews.user.id | string |
id |
|
profile_url
|
reviews.user.profile_url | string |
profile_url |
|
image_url
|
reviews.user.image_url | string |
image_url |
|
nome
|
reviews.user.name | string |
nome |
|
enviar SMS
|
reviews.text | string |
enviar SMS |
|
time_created
|
reviews.time_created | string |
Tempo criado |
|
URL
|
reviews.url | string |
URL |
|
total
|
total | integer |
total |
|
possible_languages
|
possible_languages | array of string |
Línguas possíveis |
Obter detalhes da empresa
Obtenha dados comerciais ricos, como nome, endereço, número de telefone, fotos, classificação do Yelp, níveis de preços e horas de funcionamento.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
ID
|
id | True | string |
ID Yelp único deste negócio. |
|
Localidade
|
locale | string |
Padrão en_US. (Ver https://bit.ly/3lwvIWU) |
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
id
|
id | string |
id |
|
alias
|
alias | string |
alias |
|
nome
|
name | string |
nome |
|
image_url
|
image_url | string |
image_url |
|
is_claimed
|
is_claimed | boolean |
is_claimed |
|
is_closed
|
is_closed | boolean |
is_closed |
|
URL
|
url | string |
URL |
|
phone
|
phone | string |
phone |
|
display_phone
|
display_phone | string |
display_phone |
|
review_count
|
review_count | integer |
review_count |
|
categories
|
categories | array of object |
categories |
|
alias
|
categories.alias | string |
alias |
|
title
|
categories.title | string |
title |
|
classificação
|
rating | float |
classificação |
|
Endereço1
|
location.address1 | string |
Endereço1 |
|
Endereço2
|
location.address2 | string |
Endereço2 |
|
Endereço3
|
location.address3 | string |
Endereço3 |
|
city
|
location.city | string |
city |
|
zip_code
|
location.zip_code | string |
zip_code |
|
country
|
location.country | string |
country |
|
state
|
location.state | string |
state |
|
display_address
|
location.display_address | array of string |
display_address |
|
cross_streets
|
location.cross_streets | string |
cross_streets |
|
latitude
|
coordinates.latitude | float |
latitude |
|
longitude
|
coordinates.longitude | float |
longitude |
|
Fotografias
|
photos | array of string |
Fotografias |
|
Preço
|
price | string |
Preço |
|
Horas
|
hours | array of object |
Horas |
|
aberto
|
hours.open | array of object |
aberto |
|
is_overnight
|
hours.open.is_overnight | boolean |
is_overnight |
|
start
|
hours.open.start | string |
start |
|
fim
|
hours.open.end | string |
fim |
|
day
|
hours.open.day | integer |
day |
|
hours_type
|
hours.hours_type | string |
hours_type |
|
is_open_now
|
hours.is_open_now | boolean |
is_open_now |
|
transações
|
transactions | array of |
transações |
|
special_hours
|
special_hours | array of object |
special_hours |
|
date
|
special_hours.date | string |
date |
|
is_closed
|
special_hours.is_closed | string |
is_closed |
|
start
|
special_hours.start | string |
start |
|
fim
|
special_hours.end | string |
fim |
|
is_overnight
|
special_hours.is_overnight | boolean |
is_overnight |
Pesquisar Empresas
Pesquisa de empresas por Termo (palavra-chave), categoria, localização, nível de preço, etc. Use esta ação quando tiver informações gerais sobre a biz, como nome e localização, mas não souber o endereço.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Termo (palavra-chave)
|
term | True | string |
Termo de pesquisa, por exemplo "restaurantes". O termo também pode ser nomes de empresas. |
|
Localização
|
location | True | string |
A área geográfica utilizada na pesquisa de empresas. Por exemplo, Nova Iorque, Nova Iorque |
|
Latitude
|
latitude | double |
Latitude do local que você deseja pesquisar nas proximidades. |
|
|
Longevidade
|
longtitude | double |
Longitude do local que você deseja pesquisar nas proximidades. |
|
|
Raio
|
radius | integer |
Um raio de pesquisa sugerido em metros. (Máx: 40000 m) |
|
|
Categorias
|
categories | string |
(Ver https://bit.ly/3jnraj5) |
|
|
Localidade
|
locale | string |
Padrão en_US. (Ver https://bit.ly/3lwvIWU) |
|
|
Limite
|
limit | integer |
Número de resultados de negócios a retornar. Padrão (20). Máximo (50) |
|
|
Compensação
|
offset | integer |
Compensa a lista de resultados comerciais devolvidos por este montante. |
|
|
Ordenar por
|
sort_by | string |
Sugestão ao algoritmo de pesquisa para que os resultados sejam ordenados por. |
|
|
Abrir agora
|
open_now | boolean |
(Default=false). Quando definido como verdadeiro, só devolva os negócios abertos agora. |
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
Total
|
total | integer |
Número total de negócios que o Yelp encontra com base nos critérios de pesquisa. Às vezes, o valor pode exceder 1000. Nesse caso, você ainda só pode obter até 1000 empresas usando várias consultas e combinações dos parâmetros "limite" e "offset". |
|
Negócios
|
businesses | array of object |
Lista de negócios que o Yelp encontra com base nos critérios de pesquisa. |
|
Rating
|
businesses.rating | float |
Classificação para este negócio (valor varia de 1, 1.5, ... 4.5, 5). |
|
Preço
|
businesses.price | string |
Nível de preços do negócio. O valor é um de $, $$, $$$ e $$$$. |
|
Telemóvel
|
businesses.phone | string |
Número de telefone da empresa. |
|
ID
|
businesses.id | string |
ID Yelp único deste negócio. |
|
Alias
|
businesses.alias | string |
Alias Yelp únicos deste negócio. Pode conter caracteres unicode. Exemplo: "yelp-san-francisco" |
|
Está fechado
|
businesses.is_closed | boolean |
Se a empresa foi (permanentemente) encerrada |
|
categories
|
businesses.categories | array of object |
Lista de títulos de categoria e pares de alias associados a este negócio. |
|
alias
|
businesses.categories.alias | string |
Alias de uma categoria, ao pesquisar negócios em determinadas categorias, use alias em vez do título. |
|
title
|
businesses.categories.title | string |
Título de uma categoria para fins de exibição. |
|
Contagem de avaliações
|
businesses.review_count | integer |
Número de avaliações para este estabelecimento. |
|
Nome
|
businesses.name | string |
Nome desta empresa. |
|
URL
|
businesses.url | string |
URL da página de negócios no Yelp. |
|
Latitude
|
businesses.coordinates.latitude | float |
Latitude deste negócio. |
|
Longitude
|
businesses.coordinates.longitude | float |
Longitude deste negócio. |
|
URL da imagem
|
businesses.image_url | string |
URL da foto para esta empresa. |
|
City
|
businesses.location.city | string |
Cidade deste negócio |
|
Country
|
businesses.location.country | string |
Código do país desta empresa. (ISO 3166-1 alfa-2) |
|
Endereço 2
|
businesses.location.address2 | string |
Endereço da rua deste negócio, continuou. |
|
Endereço 3
|
businesses.location.address3 | string |
Endereço da rua deste negócio, continuou. |
|
Estado
|
businesses.location.state | string |
Código do Estado deste negócio. ISO 3166-2 (com algumas exceções) |
|
Endereço 1
|
businesses.location.address1 | string |
Endereço desta empresa. |
|
Código Postal
|
businesses.location.zip_code | string |
CEP deste negócio. |
|
Distância
|
businesses.distance | float |
Distância em metros do local de pesquisa. Isso retorna medidores independentemente da localidade. |
|
transações
|
businesses.transactions | array of string |
Lista de transações do Yelp para as quais a empresa está registrada. Os valores atuais suportados são recolha, entrega e restaurant_reservation. |
|
Latitude
|
region.center.latitude | double |
Posição de latitude do centro dos limites do mapa. |
|
Longitude
|
region.center.longitude | double |
Posição da longitude do centro dos limites do mapa. |
Pesquisar Telefones Empresariais
Retorna uma lista de empresas com base no número de telefone fornecido. Use esta ação quando tiver apenas o número de telefone ou menos confiante sobre outros critérios de correspondência.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Telemóvel
|
phone | True | string |
Número de telefone da empresa que pretende pesquisar. (como +14159083801) |
|
Localidade
|
locale | string |
Padrão en_US. (Ver https://bit.ly/3lwvIWU) |
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
total
|
total | integer |
total |
|
Negócios
|
businesses | array of object |
Negócios |
|
classificação
|
businesses.rating | float |
classificação |
|
Preço
|
businesses.price | string |
Preço |
|
phone
|
businesses.phone | string |
phone |
|
id
|
businesses.id | string |
id |
|
alias
|
businesses.alias | string |
alias |
|
categories
|
businesses.categories | array of object |
categories |
|
alias
|
businesses.categories.alias | string |
alias |
|
title
|
businesses.categories.title | string |
title |
|
review_count
|
businesses.review_count | integer |
review_count |
|
nome
|
businesses.name | string |
nome |
|
URL
|
businesses.url | string |
URL |
|
latitude
|
businesses.coordinates.latitude | float |
latitude |
|
longitude
|
businesses.coordinates.longitude | float |
longitude |
|
image_url
|
businesses.image_url | string |
image_url |
|
is_closed
|
businesses.is_closed | boolean |
is_closed |
|
city
|
businesses.location.city | string |
city |
|
country
|
businesses.location.country | string |
country |
|
Endereço2
|
businesses.location.address2 | string |
Endereço2 |
|
Endereço3
|
businesses.location.address3 | string |
Endereço3 |
|
state
|
businesses.location.state | string |
state |
|
Endereço1
|
businesses.location.address1 | string |
Endereço1 |
|
zip_code
|
businesses.location.zip_code | string |
zip_code |
|
transações
|
businesses.transactions | array of string |
transações |
Preenchimento Automático
Forneça sugestões de preenchimento automático para empresas, palavras-chave de pesquisa e categorias.
Parâmetros
| Name | Chave | Necessário | Tipo | Description |
|---|---|---|---|---|
|
Texto
|
text | True | string |
Texto para retornar sugestões de preenchimento automático. |
|
Latitude
|
latitude | True | double |
Obrigatório se quiser obter sugestões de preenchimento automático para empresas. Latitude do local para procurar sugestões de preenchimento automático de negócios. |
|
Longitude
|
longitude | True | double |
Obrigatório se quiser obter sugestões de preenchimento automático para empresas. Longitude do local para procurar sugestões de preenchimento automático de negócios. |
|
Localidade
|
locale | string |
Padrão en_US. (Ver https://bit.ly/3lwvIWU) |
Devoluções
| Name | Caminho | Tipo | Description |
|---|---|---|---|
|
termos
|
terms | array of object |
termos |
|
enviar SMS
|
terms.text | string |
enviar SMS |
|
Negócios
|
businesses | array of object |
Negócios |
|
nome
|
businesses.name | string |
nome |
|
id
|
businesses.id | string |
id |
|
enviar SMS
|
businesses.text | string |
enviar SMS |
|
categories
|
categories | array of object |
categories |
|
alias
|
categories.alias | string |
alias |
|
title
|
categories.title | string |
title |