Yelp (niezależny wydawca) (wersja zapoznawcza)
Łącznik Yelp pozwala uzyskać najlepszą lokalną zawartość, punkty orientacyjne i recenzje użytkowników z milionów firm w 32 krajach.
Ten łącznik jest dostępny w następujących produktach i regionach:
| Usługa | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Wszystkie regiony usługi Power Automate z wyjątkiem następujących: - Rząd USA (GCC) - Rząd USA (GCC High) - China Cloud obsługiwane przez firmę 21Vianet - Departament Obrony USA (DoD) |
| Logic Apps | Standard | Wszystkie regiony usługi Logic Apps z wyjątkiem następujących: — Regiony platformy Azure Government — Regiony platformy Azure (Chiny) - Departament Obrony USA (DoD) |
| Power Apps | Premium | Wszystkie regiony usługi Power Apps z wyjątkiem następujących: - Rząd USA (GCC) - Rząd USA (GCC High) - China Cloud obsługiwane przez firmę 21Vianet - Departament Obrony USA (DoD) |
| Power Automate | Premium | Wszystkie regiony usługi Power Automate z wyjątkiem następujących: - Rząd USA (GCC) - Rząd USA (GCC High) - China Cloud obsługiwane przez firmę 21Vianet - Departament Obrony USA (DoD) |
| Kontakt | |
|---|---|
| Name | Ahmad Najjar |
| ahmadn82@hotmail.com |
| Metadane łącznika | |
|---|---|
| Publisher | Ahmad Najjar |
| Witryna internetowa | https://www.yelp.com/ |
| Zasady ochrony prywatności | https://terms.yelp.com/privacy/ |
Tworzenie połączenia
Łącznik obsługuje następujące typy uwierzytelniania:
| Wartość domyślna | Parametry tworzenia połączenia. | Wszystkie regiony | Nie można udostępniać |
Domyślny
Dotyczy: wszystkie regiony
Parametry tworzenia połączenia.
Nie jest to możliwe do udostępnienia połączenie. Jeśli aplikacja power zostanie udostępniona innemu użytkownikowi, zostanie wyświetlony monit o jawne utworzenie nowego połączenia.
| Name | Typ | Description | Wymagane |
|---|---|---|---|
| Klucz interfejsu API Firmy Yelp | securestring | Podaj klucz interfejsu API Yelp jako "Bearer API_KEY" | Prawda |
Limity ograniczania
| Nazwa | Wywołania | Okres odnowienia |
|---|---|---|
| Wywołania interfejsu API na połączenie | 100 | 60 sekund |
Akcje
| Autouzupełnianie |
Podaj sugestie autouzupełniania dla firm, słów kluczowych wyszukiwania i kategorii. |
| Uzyskiwanie recenzji |
Uzyskaj do trzech fragmentów przeglądu dla firmy. |
| Uzyskiwanie szczegółów biznesowych |
Uzyskaj zaawansowane dane biznesowe, takie jak imię i nazwisko, adres, numer telefonu, zdjęcia, ocena Yelp, poziomy cen i godziny pracy. |
| Wyszukaj firmy |
Wyszukaj firmy według terminu (słowa kluczowego), kategorii, lokalizacji, poziomu cen itp. Użyj tej akcji, jeśli masz ogólne informacje o bizie, takim jak nazwa i lokalizacja, ale nie znasz adresu. |
| Wyszukaj telefony służbowe |
Zwraca listę firm na podstawie podanego numeru telefonu. Użyj tej akcji, jeśli masz tylko numer telefonu lub mniej pewny siebie co do innych kryteriów dopasowania. |
| Znajdowanie dopasowania biznesowego |
Znajdź firmę Yelp, która pasuje do dokładnej lokalizacji wejściowej. Użyj tej akcji, aby dopasować dane biznesowe z innych źródeł do firm Yelp. |
Autouzupełnianie
Podaj sugestie autouzupełniania dla firm, słów kluczowych wyszukiwania i kategorii.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Tekst
|
text | True | string |
Tekst umożliwiający zwrócenie sugestii dotyczących autouzupełniania. |
|
Szerokość
|
latitude | True | double |
Wymagane, jeśli chcesz uzyskać sugestie dotyczące autouzupełniania dla firm. Szerokość geograficzna lokalizacji, aby wyszukać sugestie autouzupełniania biznesowego. |
|
Długość
|
longitude | True | double |
Wymagane, jeśli chcesz uzyskać sugestie dotyczące autouzupełniania dla firm. Długość geograficzna lokalizacji, aby wyszukać sugestie autouzupełniania biznesowego. |
|
Lokalizacja
|
locale | string |
Domyślne en_US. (Zobacz https://bit.ly/3lwvIWU) |
Zwraca
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
postanowienia
|
terms | array of object |
postanowienia |
|
SMS
|
terms.text | string |
SMS |
|
Firm
|
businesses | array of object |
Firm |
|
nazwa
|
businesses.name | string |
nazwa |
|
id
|
businesses.id | string |
id |
|
SMS
|
businesses.text | string |
SMS |
|
categories
|
categories | array of object |
categories |
|
alias
|
categories.alias | string |
alias |
|
title
|
categories.title | string |
title |
Uzyskiwanie recenzji
Uzyskaj do trzech fragmentów przeglądu dla firmy.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
identyfikator
|
id | True | string |
Unikatowy identyfikator Yelp tej firmy. |
|
Lokalizacja
|
locale | string |
Domyślne en_US. (Zobacz https://bit.ly/3lwvIWU) |
Zwraca
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
recenzje
|
reviews | array of object |
recenzje |
|
id
|
reviews.id | string |
id |
|
klasyfikacja
|
reviews.rating | integer |
klasyfikacja |
|
id
|
reviews.user.id | string |
id |
|
profile_url
|
reviews.user.profile_url | string |
profile_url |
|
image_url
|
reviews.user.image_url | string |
image_url |
|
nazwa
|
reviews.user.name | string |
nazwa |
|
SMS
|
reviews.text | string |
SMS |
|
time_created
|
reviews.time_created | string |
Godzina utworzenia |
|
URL
|
reviews.url | string |
URL |
|
łączny
|
total | integer |
łączny |
|
possible_languages
|
possible_languages | array of string |
Możliwe języki |
Uzyskiwanie szczegółów biznesowych
Uzyskaj zaawansowane dane biznesowe, takie jak imię i nazwisko, adres, numer telefonu, zdjęcia, ocena Yelp, poziomy cen i godziny pracy.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
identyfikator
|
id | True | string |
Unikatowy identyfikator Yelp tej firmy. |
|
Lokalizacja
|
locale | string |
Domyślne en_US. (Zobacz https://bit.ly/3lwvIWU) |
Zwraca
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
id
|
id | string |
id |
|
alias
|
alias | string |
alias |
|
nazwa
|
name | string |
nazwa |
|
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 |
|
klasyfikacja
|
rating | float |
klasyfikacja |
|
adres1
|
location.address1 | string |
adres1 |
|
adres2
|
location.address2 | string |
adres2 |
|
address3
|
location.address3 | string |
address3 |
|
city
|
location.city | string |
city |
|
zip_code
|
location.zip_code | string |
zip_code |
|
country
|
location.country | string |
country |
|
stan
|
location.state | string |
stan |
|
display_address
|
location.display_address | array of string |
display_address |
|
cross_streets
|
location.cross_streets | string |
cross_streets |
|
latitude
|
coordinates.latitude | float |
latitude |
|
długość geograficzna
|
coordinates.longitude | float |
długość geograficzna |
|
Zdjęcia
|
photos | array of string |
Zdjęcia |
|
cena
|
price | string |
cena |
|
Godzin
|
hours | array of object |
Godzin |
|
otwarty
|
hours.open | array of object |
otwarty |
|
is_overnight
|
hours.open.is_overnight | boolean |
is_overnight |
|
start
|
hours.open.start | string |
start |
|
koniec
|
hours.open.end | string |
koniec |
|
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 |
|
transakcje
|
transactions | array of |
transakcje |
|
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 |
|
koniec
|
special_hours.end | string |
koniec |
|
is_overnight
|
special_hours.is_overnight | boolean |
is_overnight |
Wyszukaj firmy
Wyszukaj firmy według terminu (słowa kluczowego), kategorii, lokalizacji, poziomu cen itp. Użyj tej akcji, jeśli masz ogólne informacje o bizie, takim jak nazwa i lokalizacja, ale nie znasz adresu.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Termin (słowo kluczowe)
|
term | True | string |
Wyszukaj termin, na przykład "restauracje". Termin może być również nazwami firm. |
|
Lokalizacja
|
location | True | string |
Obszar geograficzny używany podczas wyszukiwania firm. Np. Nowy Jork, NYC |
|
Szerokość
|
latitude | double |
Szerokość geograficzna lokalizacji, w której chcesz wyszukać w pobliżu. |
|
|
Długowzgodość
|
longtitude | double |
Długość geograficzna lokalizacji, w której chcesz wyszukać w pobliżu. |
|
|
Promień
|
radius | integer |
Sugerowany promień wyszukiwania w metrach. (Maks.: 40000 m) |
|
|
Kategorie
|
categories | string |
(Zobacz https://bit.ly/3jnraj5) |
|
|
Lokalizacja
|
locale | string |
Domyślne en_US. (Zobacz https://bit.ly/3lwvIWU) |
|
|
Ograniczenie
|
limit | integer |
Liczba wyników biznesowych do zwrócenia. Wartość domyślna (20). Maks. (50) |
|
|
Przesunięcie
|
offset | integer |
Zrównoważ listę zwróconych wyników biznesowych o tę kwotę. |
|
|
Sortuj według
|
sort_by | string |
Sugestia algorytmu wyszukiwania, według którego wyniki są sortowane. |
|
|
Otwórz teraz
|
open_now | boolean |
(Default=false). Po ustawieniu wartości true zwracaj teraz tylko otwarte firmy. |
Zwraca
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Total
|
total | integer |
Całkowita liczba wyszukiwań w Firmie Yelp oparta na kryteriach wyszukiwania. Czasami wartość może przekroczyć 1000. W takim przypadku nadal można uzyskać maksymalnie 1000 firm przy użyciu wielu zapytań i kombinacji parametrów "limit" i "offset". |
|
Firm
|
businesses | array of object |
Lista firmowa Yelp znajduje się na podstawie kryteriów wyszukiwania. |
|
Rating
|
businesses.rating | float |
Ocena dla tej firmy (wartości wahają się od 1, 1,5, ... 4.5, 5). |
|
Cena
|
businesses.price | string |
Poziom cen firmy. Wartość jest jedną z wartości $, $$, $$$ i $$$$. |
|
Telefon
|
businesses.phone | string |
Numer telefonu firmy. |
|
identyfikator
|
businesses.id | string |
Unikatowy identyfikator Yelp tej firmy. |
|
Pseudonim
|
businesses.alias | string |
Unikalny alias Yelp tej firmy. Może zawierać znaki Unicode. Przykład: "yelp-san-francisco" |
|
Jest zamknięty
|
businesses.is_closed | boolean |
Czy firma została (trwale) zamknięta |
|
categories
|
businesses.categories | array of object |
Lista par tytułów kategorii i aliasów skojarzonych z tą firmą. |
|
alias
|
businesses.categories.alias | string |
Alias kategorii, podczas wyszukiwania firmy w niektórych kategoriach, użyj aliasu, a nie tytułu. |
|
title
|
businesses.categories.title | string |
Tytuł kategorii do wyświetlania. |
|
Liczba recenzji
|
businesses.review_count | integer |
Liczba recenzji dla tej firmy. |
|
Name
|
businesses.name | string |
Nazwa tej firmy. |
|
adres URL
|
businesses.url | string |
Adres URL strony biznesowej na Yelp. |
|
Szerokość
|
businesses.coordinates.latitude | float |
Szerokość geograficzna tej firmy. |
|
Długość
|
businesses.coordinates.longitude | float |
Długość geograficzna tej firmy. |
|
Adres URL obrazu
|
businesses.image_url | string |
Adres URL zdjęcia dla tej firmy. |
|
Miejscowość
|
businesses.location.city | string |
Miasto tej firmy |
|
Country
|
businesses.location.country | string |
Kod kraju tej firmy. (ISO 3166-1 alfa-2) |
|
Adres 2
|
businesses.location.address2 | string |
Adres ulicy tej firmy, kontynuował. |
|
Adres 3
|
businesses.location.address3 | string |
Adres ulicy tej firmy, kontynuował. |
|
State
|
businesses.location.state | string |
Kod stanu tej firmy. ISO 3166-2 (z kilkoma wyjątkami) |
|
Adres 1
|
businesses.location.address1 | string |
Adres ulicy tej firmy. |
|
Kod pocztowy
|
businesses.location.zip_code | string |
Kod pocztowy tej firmy. |
|
Odległość
|
businesses.distance | float |
Odległość w metrach od lokalizacji wyszukiwania. Zwraca liczniki niezależnie od ustawień regionalnych. |
|
transakcje
|
businesses.transactions | array of string |
Lista transakcji, dla których firma jest zarejestrowana. Bieżące obsługiwane wartości to odbiór, dostawa i restaurant_reservation. |
|
Szerokość
|
region.center.latitude | double |
Położenie szerokości geograficznej środka granicy mapy. |
|
Długość
|
region.center.longitude | double |
Położenie długości geograficznej środka granicy mapy. |
Wyszukaj telefony służbowe
Zwraca listę firm na podstawie podanego numeru telefonu. Użyj tej akcji, jeśli masz tylko numer telefonu lub mniej pewny siebie co do innych kryteriów dopasowania.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Telefon
|
phone | True | string |
Numer telefonu firmy, którą chcesz wyszukać. (na przykład +14159083801) |
|
Lokalizacja
|
locale | string |
Domyślne en_US. (Zobacz https://bit.ly/3lwvIWU) |
Zwraca
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
łączny
|
total | integer |
łączny |
|
Firm
|
businesses | array of object |
Firm |
|
klasyfikacja
|
businesses.rating | float |
klasyfikacja |
|
cena
|
businesses.price | string |
cena |
|
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 |
|
nazwa
|
businesses.name | string |
nazwa |
|
URL
|
businesses.url | string |
URL |
|
latitude
|
businesses.coordinates.latitude | float |
latitude |
|
długość geograficzna
|
businesses.coordinates.longitude | float |
długość geograficzna |
|
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 |
|
adres2
|
businesses.location.address2 | string |
adres2 |
|
address3
|
businesses.location.address3 | string |
address3 |
|
stan
|
businesses.location.state | string |
stan |
|
adres1
|
businesses.location.address1 | string |
adres1 |
|
zip_code
|
businesses.location.zip_code | string |
zip_code |
|
transakcje
|
businesses.transactions | array of string |
transakcje |
Znajdowanie dopasowania biznesowego
Znajdź firmę Yelp, która pasuje do dokładnej lokalizacji wejściowej. Użyj tej akcji, aby dopasować dane biznesowe z innych źródeł do firm Yelp.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Name
|
name | True | string |
Nazwa firmy. Maksymalna długość wynosi 64; dozwolone są tylko cyfry, litery, spacje i !#$%&+, ./:?@'. |
|
Adres 1
|
address1 | True | string |
Pierwszy wiersz adresu firmy. Maksymalna długość wynosi 64; dozwolone są tylko cyfry, litery, spacje i /#&.: Pusty ciąg "" jest dozwolony; będzie to w szczególności zgodne z niektórymi firmami usług, które nie mają adresu ulicznego. |
|
Adres 2
|
address2 | string |
Drugi wiersz adresu firmy. Maksymalna długość wynosi 64; dozwolone są tylko cyfry, litery, spacje i /#&.: |
|
|
Adres 3
|
address3 | string |
Trzeci wiersz adresu firmy. Maksymalna długość wynosi 64; dozwolone są tylko cyfry, litery, spacje i /#&.: |
|
|
Miejscowość
|
city | True | string |
Miasto biznesu. Maksymalna długość wynosi 64; tylko cyfry, litery, spacje i . () są dozwolone. |
|
State
|
state | True | string |
Kod stanu iso 3166-2 (z kilkoma wyjątkami) tej firmy. Maksymalna długość to 3. |
|
Country
|
country | True | string |
Kod kraju ISO 3166-1 alfa-2 tej firmy. Maksymalna długość to 2. |
|
Szerokość
|
latitude | double |
Szerokość geograficzna WGS84 firmy w stopniach dziesiętnych. Musi należeć do zakresu od -90 do +90. |
|
|
Długość
|
longitude | double |
Długość geograficzna WGS84 firmy w stopniach dziesiętnych. Musi należeć do zakresu od -180 do +180. |
|
|
Telefon
|
phone | string |
Numer telefonu firmy, który można przesłać jako (a) lokalnie sformatowany tylko cyframi (np. 016703080) lub (b) w formacie międzynarodowym z wiodącym + znakiem i cyframi tylko po (+35316703080). Maksymalna długość to 32. |
|
|
Kod pocztowy
|
zip_code | string |
Kod pocztowy tej firmy. |
|
|
Identyfikator firmy Yelp
|
yelp_business_id | string |
Unikatowy identyfikator Firmy, jeśli jest dostępny. Służy jako wskazówka podczas znajdowania pasującej firmy. |
|
|
Ograniczenie
|
limit | integer |
Maksymalna liczba wyników biznesowych do zwrócenia. Domyślnie zostanie zwrócona wartość 3. Wartość minimalna to 1, wartość maksymalna to 10. |
|
|
Dopasuj próg
|
match_threshold | integer |
Określa, czy należy zastosować próg jakości dopasowania do dopasowanych firm. Musi być jednym z "none", "default" lub "strict". brak: nie należy stosować żadnego progu jakości dopasowania; zostaną zwrócone wszystkie potencjalne dopasowania biznesowe. wartość domyślna: Zastosuj próg jakości dopasowania, tak aby zwracane było tylko bardzo dokładne dopasowanie firm. strict: Zastosuj bardzo rygorystyczny próg jakości dopasowania. |
Zwraca
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
|
array of object | ||
|
nazwa
|
name | string |
nazwa |
|
adres1
|
location.address1 | string |
adres1 |
|
adres2
|
location.address2 | string |
adres2 |
|
address3
|
location.address3 | string |
address3 |
|
city
|
location.city | string |
city |
|
stan
|
location.state | string |
stan |
|
zip_code
|
location.zip_code | string |
zip_code |
|
country
|
location.country | string |
country |
|
latitude
|
coordinates.latitude | float |
latitude |
|
długość geograficzna
|
coordinates.longitude | float |
długość geograficzna |
|
phone
|
phone | string |
phone |
|
id
|
id | string |
id |
|
alias
|
alias | string |
alias |