Yelp (publicador independiente) (versión preliminar)
El conector Yelp le permite obtener el mejor contenido local, puntos de interés y opiniones de usuarios de millones de empresas en 32 países.
Este conector está disponible en los siguientes productos y regiones:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Todas las regiones de Power Automate excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Aplicaciones lógicas | Estándar | Todas las regiones de Logic Apps excepto las siguientes: - Regiones de Azure Government - Regiones de Azure China - Departamento de Defensa de EE. UU. (DoD) |
| Power Apps | Premium | Todas las regiones de Power Apps excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Power Automate | Premium | Todas las regiones de Power Automate excepto las siguientes: - Gobierno de EE. UU. (GCC) - Gobierno de EE. UU. (GCC High) - China Cloud operado por 21Vianet - Departamento de Defensa de EE. UU. (DoD) |
| Contacto | |
|---|---|
| Nombre | Ahmad Kayjar |
| Correo Electrónico | ahmadn82@hotmail.com |
| Metadatos del conector | |
|---|---|
| Publicador | Ahmad Kayjar |
| Sitio web | https://www.yelp.com/ |
| Directiva de privacidad | https://terms.yelp.com/privacy/ |
Creación de una conexión
El conector admite los siguientes tipos de autenticación:
| Predeterminado | Parámetros para crear una conexión. | Todas las regiones | No se puede compartir |
Predeterminado
Aplicable: Todas las regiones
Parámetros para crear una conexión.
Esta conexión no se puede compartir. Si la aplicación de energía se comparte con otro usuario, se pedirá a otro usuario que cree explícitamente una nueva conexión.
| Nombre | Tipo | Description | Obligatorio |
|---|---|---|---|
| Clave de API de Yelp | securestring | Proporcione una clave de API de Yelp como "Bearer API_KEY" | Cierto |
Limitaciones
| Nombre | Llamadas | Período de renovación |
|---|---|---|
| Llamadas API por conexión | 100 | 60 segundos |
Acciones
| Autocompletar |
Proporcione sugerencias de autocompletar para empresas, palabras clave de búsqueda y categorías. |
| Buscar coincidencia empresarial |
Busque la empresa de Yelp que coincida con una ubicación de entrada exacta. Use esta acción para buscar coincidencias con datos empresariales de otros orígenes con empresas de Yelp. |
| Buscar empresas |
Busque empresas por término (palabra clave), categoría, ubicación, nivel de precio, etc. Use esta acción cuando tenga información general en el biz como nombre y ubicación, pero no conozca la dirección. |
| Buscar teléfonos profesionales |
Devuelve una lista de empresas en función del número de teléfono proporcionado. Use esta acción cuando solo tenga el número de teléfono o menos seguro sobre otros criterios de coincidencia. |
| Obtener detalles empresariales |
Obtenga datos empresariales enriquecidos, como el nombre, la dirección, el número de teléfono, las fotos, la clasificación de Yelp, los niveles de precio y las horas de funcionamiento. |
| Obtener revisiones |
Obtenga hasta tres extractos de revisión para un negocio. |
Autocompletar
Proporcione sugerencias de autocompletar para empresas, palabras clave de búsqueda y categorías.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Mensaje de texto
|
text | True | string |
Texto para el que se devuelven sugerencias de autocompletar. |
|
Latitude
|
latitude | True | double |
Obligatorio si quiere obtener sugerencias de autocompletar para empresas. Latitud de la ubicación para buscar sugerencias de autocompletar empresariales. |
|
Longitude
|
longitude | True | double |
Obligatorio si quiere obtener sugerencias de autocompletar para empresas. Longitud de la ubicación para buscar sugerencias de autocompletar empresariales. |
|
Configuración regional
|
locale | string |
En_US predeterminado. (Ver https://bit.ly/3lwvIWU) |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
letra chica
|
terms | array of object |
letra chica |
|
texto
|
terms.text | string |
texto |
|
Empresas
|
businesses | array of object |
Empresas |
|
nombre
|
businesses.name | string |
nombre |
|
id
|
businesses.id | string |
id |
|
texto
|
businesses.text | string |
texto |
|
categories
|
categories | array of object |
categories |
|
alias
|
categories.alias | string |
alias |
|
title
|
categories.title | string |
title |
Buscar coincidencia empresarial
Busque la empresa de Yelp que coincida con una ubicación de entrada exacta. Use esta acción para buscar coincidencias con datos empresariales de otros orígenes con empresas de Yelp.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Nombre
|
name | True | string |
Nombre de la empresa. La longitud máxima es 64; solo se permiten dígitos, letras, espacios y !#$%&+, ./:?@'. |
|
Dirección 1
|
address1 | True | string |
Primera línea de la dirección de la empresa. La longitud máxima es 64; solo se permiten dígitos, letras, espacios y /#&.: . Se permite la cadena vacía "" ; esto coincidirá específicamente con ciertas empresas de servicios que no tienen ninguna dirección postal. |
|
Dirección 2
|
address2 | string |
Segunda línea de la dirección de la empresa. La longitud máxima es 64; solo se permiten dígitos, letras, espacios y /#&.: . |
|
|
Dirección 3
|
address3 | string |
Tercera línea de la dirección de la empresa. La longitud máxima es 64; solo se permiten dígitos, letras, espacios y /#&.: . |
|
|
City
|
city | True | string |
La ciudad del negocio. La longitud máxima es 64; solo dígitos, letras, espacios y . () se permiten. |
|
Estado
|
state | True | string |
El código de estado ISO 3166-2 (con algunas excepciones) de esta empresa. La longitud máxima es 3. |
|
País
|
country | True | string |
El código de país iso 3166-1 alfa-2 de esta empresa. La longitud máxima es 2. |
|
Latitude
|
latitude | double |
Latitud WGS84 de la empresa en grados decimales. Debe estar comprendido entre -90 y +90. |
|
|
Longitude
|
longitude | double |
Longitud WGS84 de la empresa en grados decimales. Debe estar comprendido entre -180 y +180. |
|
|
Teléfono
|
phone | string |
Número de teléfono de la empresa que se puede enviar como (a) con formato local solo con dígitos (por ejemplo, 016703080) o (b) con formato internacional con un signo + inicial y dígitos solo después (+35316703080). La longitud máxima es 32. |
|
|
Código postal
|
zip_code | string |
El código postal de esta empresa. |
|
|
Id. de negocio de Yelp
|
yelp_business_id | string |
Identificador Yelp único de la empresa si está disponible. Se usa como sugerencia al buscar una empresa coincidente. |
|
|
Limit
|
limit | integer |
Número máximo de resultados empresariales que se van a devolver. De forma predeterminada, devolverá 3. El mínimo es 1, el máximo es 10. |
|
|
Umbral de coincidencia
|
match_threshold | integer |
Especifica si se debe aplicar un umbral de calidad de coincidencia a las empresas coincidentes. Debe ser uno de los elementos "none", "default" o "strict". none: no aplique ningún umbral de calidad de coincidencia; se devolverán todas las posibles coincidencias empresariales. valor predeterminado: aplique un umbral de calidad de coincidencia, de modo que solo se devuelvan empresas que coincidan muy estrechamente. strict: aplique un umbral de calidad de coincidencia muy estricto. |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
|
array of object | ||
|
nombre
|
name | string |
nombre |
|
Dirección1
|
location.address1 | string |
Dirección1 |
|
dirección2
|
location.address2 | string |
dirección2 |
|
address3
|
location.address3 | string |
address3 |
|
city
|
location.city | string |
city |
|
estado
|
location.state | string |
estado |
|
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 |
Buscar empresas
Busque empresas por término (palabra clave), categoría, ubicación, nivel de precio, etc. Use esta acción cuando tenga información general en el biz como nombre y ubicación, pero no conozca la dirección.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Término (palabra clave)
|
term | True | string |
Término de búsqueda, por ejemplo, "restaurantes". El término también puede ser nombres empresariales. |
|
Ubicación
|
location | True | string |
El área geográfica utilizada al buscar empresas. Por ejemplo, Nueva York, Nueva York |
|
Latitude
|
latitude | double |
Latitud de la ubicación en la que desea buscar cerca. |
|
|
Longtitude
|
longtitude | double |
Longitud de la ubicación en la que desea buscar cerca. |
|
|
Radio
|
radius | integer |
Radio de búsqueda sugerido en metros. (Máximo: 40000 m) |
|
|
Categorías
|
categories | string |
(Ver https://bit.ly/3jnraj5) |
|
|
Configuración regional
|
locale | string |
En_US predeterminado. (Ver https://bit.ly/3lwvIWU) |
|
|
Limit
|
limit | integer |
Número de resultados empresariales que se van a devolver. Valor predeterminado (20). Máx. (50) |
|
|
Desplazar
|
offset | integer |
Desfase la lista de resultados empresariales devueltos por esta cantidad. |
|
|
Ordenar por
|
sort_by | string |
Sugerencia al algoritmo de búsqueda por el que se ordenan los resultados. |
|
|
Abrir ahora
|
open_now | boolean |
(Default=false). Cuando se establece en true, solo se devuelven las empresas abiertas ahora. |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Total
|
total | integer |
Número total de búsquedas de Yelp empresariales en función de los criterios de búsqueda. A veces, el valor puede superar los 1000. En tal caso, todavía puede obtener hasta 1000 empresas usando varias consultas y combinaciones de los parámetros "limit" y "offset". |
|
Empresas
|
businesses | array of object |
Lista de búsquedas empresariales de Yelp en función de los criterios de búsqueda. |
|
Rating
|
businesses.rating | float |
Clasificación para este negocio (valor oscila entre 1, 1,5, ... 4.5, 5). |
|
Precio
|
businesses.price | string |
Nivel de precio de la empresa. El valor es uno de $, $$, » y $].. |
|
Teléfono
|
businesses.phone | string |
Número de teléfono del negocio. |
|
identificación
|
businesses.id | string |
Identificador único de Yelp de esta empresa. |
|
Alias
|
businesses.alias | string |
Alias único de Yelp de este negocio. Puede contener caracteres unicode. Ejemplo: "yelp-san-francisco" |
|
Está cerrado
|
businesses.is_closed | boolean |
Si el negocio se ha cerrado (permanentemente) |
|
categories
|
businesses.categories | array of object |
Lista de pares de título y alias de categoría asociados a esta empresa. |
|
alias
|
businesses.categories.alias | string |
Alias de una categoría, al buscar negocios en determinadas categorías, use alias en lugar del título. |
|
title
|
businesses.categories.title | string |
Título de una categoría para mostrar. |
|
Recuento de revisión
|
businesses.review_count | integer |
Número de revisiones para este negocio. |
|
Nombre
|
businesses.name | string |
Nombre de esta empresa. |
|
URL
|
businesses.url | string |
Dirección URL de la página empresarial en Yelp. |
|
Latitude
|
businesses.coordinates.latitude | float |
Latitud de este negocio. |
|
Longitude
|
businesses.coordinates.longitude | float |
Longitud de este negocio. |
|
URL de imagen
|
businesses.image_url | string |
Dirección URL de la foto para este negocio. |
|
City
|
businesses.location.city | string |
Ciudad de este negocio |
|
País
|
businesses.location.country | string |
Código de país de esta empresa. (ISO 3166-1 alpha-2) |
|
Dirección 2
|
businesses.location.address2 | string |
Dirección postal de este negocio, continuó. |
|
Dirección 3
|
businesses.location.address3 | string |
Dirección postal de este negocio, continuó. |
|
Estado
|
businesses.location.state | string |
Código de estado de esta empresa. ISO 3166-2 (con algunas excepciones) |
|
Dirección 1
|
businesses.location.address1 | string |
Dirección postal de este negocio. |
|
Código postal
|
businesses.location.zip_code | string |
Código postal de esta empresa. |
|
Distancia
|
businesses.distance | float |
Distancia en metros de la ubicación de búsqueda. Esto devuelve medidores independientemente de la configuración regional. |
|
transacciones
|
businesses.transactions | array of string |
Lista de transacciones de Yelp para las que está registrada la empresa. Los valores admitidos actuales son recogida, entrega y restaurant_reservation. |
|
Latitude
|
region.center.latitude | double |
Posición de latitud del centro de límites del mapa. |
|
Longitude
|
region.center.longitude | double |
Posición de longitud del centro de límites del mapa. |
Buscar teléfonos profesionales
Devuelve una lista de empresas en función del número de teléfono proporcionado. Use esta acción cuando solo tenga el número de teléfono o menos seguro sobre otros criterios de coincidencia.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
Teléfono
|
phone | True | string |
Número de teléfono de la empresa que desea buscar. (como +14159083801) |
|
Configuración regional
|
locale | string |
En_US predeterminado. (Ver https://bit.ly/3lwvIWU) |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
total
|
total | integer |
total |
|
Empresas
|
businesses | array of object |
Empresas |
|
Clasificación
|
businesses.rating | float |
Clasificación |
|
precio
|
businesses.price | string |
precio |
|
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 |
|
nombre
|
businesses.name | string |
nombre |
|
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 |
|
dirección2
|
businesses.location.address2 | string |
dirección2 |
|
address3
|
businesses.location.address3 | string |
address3 |
|
estado
|
businesses.location.state | string |
estado |
|
Dirección1
|
businesses.location.address1 | string |
Dirección1 |
|
zip_code
|
businesses.location.zip_code | string |
zip_code |
|
transacciones
|
businesses.transactions | array of string |
transacciones |
Obtener detalles empresariales
Obtenga datos empresariales enriquecidos, como el nombre, la dirección, el número de teléfono, las fotos, la clasificación de Yelp, los niveles de precio y las horas de funcionamiento.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
identificación
|
id | True | string |
Identificador único de Yelp de esta empresa. |
|
Configuración regional
|
locale | string |
En_US predeterminado. (Ver https://bit.ly/3lwvIWU) |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
id
|
id | string |
id |
|
alias
|
alias | string |
alias |
|
nombre
|
name | string |
nombre |
|
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 |
|
Clasificación
|
rating | float |
Clasificación |
|
Dirección1
|
location.address1 | string |
Dirección1 |
|
dirección2
|
location.address2 | string |
dirección2 |
|
address3
|
location.address3 | string |
address3 |
|
city
|
location.city | string |
city |
|
zip_code
|
location.zip_code | string |
zip_code |
|
country
|
location.country | string |
country |
|
estado
|
location.state | string |
estado |
|
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 |
|
photos
|
photos | array of string |
photos |
|
precio
|
price | string |
precio |
|
horas
|
hours | array of object |
horas |
|
abrir
|
hours.open | array of object |
abrir |
|
is_overnight
|
hours.open.is_overnight | boolean |
is_overnight |
|
start
|
hours.open.start | string |
start |
|
end
|
hours.open.end | string |
end |
|
Día
|
hours.open.day | integer |
Día |
|
hours_type
|
hours.hours_type | string |
hours_type |
|
is_open_now
|
hours.is_open_now | boolean |
is_open_now |
|
transacciones
|
transactions | array of |
transacciones |
|
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 |
|
end
|
special_hours.end | string |
end |
|
is_overnight
|
special_hours.is_overnight | boolean |
is_overnight |
Obtener revisiones
Obtenga hasta tres extractos de revisión para un negocio.
Parámetros
| Nombre | Clave | Requerido | Tipo | Description |
|---|---|---|---|---|
|
identificación
|
id | True | string |
Identificador único de Yelp de esta empresa. |
|
Configuración regional
|
locale | string |
En_US predeterminado. (Ver https://bit.ly/3lwvIWU) |
Devoluciones
| Nombre | Ruta de acceso | Tipo | Description |
|---|---|---|---|
|
Comentarios
|
reviews | array of object |
Comentarios |
|
id
|
reviews.id | string |
id |
|
Clasificación
|
reviews.rating | integer |
Clasificación |
|
id
|
reviews.user.id | string |
id |
|
profile_url
|
reviews.user.profile_url | string |
profile_url |
|
image_url
|
reviews.user.image_url | string |
image_url |
|
nombre
|
reviews.user.name | string |
nombre |
|
texto
|
reviews.text | string |
texto |
|
time_created
|
reviews.time_created | string |
Hora de creación |
|
URL
|
reviews.url | string |
URL |
|
total
|
total | integer |
total |
|
possible_languages
|
possible_languages | array of string |
Idiomas posibles |