API di Yelp
Recupera da Yelp i dettagli operativi delle attività, valutazioni, recensioni e conteggi dei feedback a partire dai link delle attività.
Combina le parole chiave di ricerca con una località. Se ometti la località, le ricerche usano New York come impostazione predefinita.
Invia POST https://api.everyinfra.com/api/v1/social con platform impostato su yelp e action impostato sul nome di una funzionalità dell'elenco qui sotto, ad esempio search.
- 3 funzionalità
- $1.39 per 1.000 richieste
- Nessun addebito per chiamate non riuscite o risultati vuoti
Disponibilità della piattaforma
- Operatività nelle ultime 24 ore
- Normale
Ultimi 30 giorni
Funzionalità disponibili
Ogni azione di Yelp: cosa fa, quanto costa e come ha funzionato nelle ultime 24 ore. Apri un'azione per vederne parametri, campi della risposta ed esempi di codice.
| Funzionalità | Cosa fa | Per 1.000Righe vuote: $1.39 | Stato nelle ultime 24 ore · Tutto regolare |
|---|---|---|---|
Ricercasearch | Cerca attività locali su Yelp in una città o in un codice ZIP. | Normale | |
Dettagliprofile | Apri la pagina di un'attività su Yelp dal suo link /biz/. | Normale | |
Recensionireviews | Leggi le recensioni Yelp di un'attività, 10 per pagina. | Normale |
Cosa accetta ogni azione di API di Yelp?
Ogni risposta qui sotto associa un'azione richiamabile ai suoi input reali. Il significato dei parametri e i valori ammessi dipendono dall'azione: un nome familiare non ha lo stesso significato su tutte le piattaforme.
Le fonti ufficiali sono linkate solo per chiarire il termine della piattaforma accanto a cui compaiono. Non implicano autorizzazione o approvazione da parte della piattaforma e le funzionalità del sito ufficiale non fanno parte dell'API di EveryInfra, a meno che questa pagina non le elenchi.
Consegna Sync per ogni azione.
| Azione | Obbligatori | Facoltativi | Limite | Per 1.000Righe vuote: $1.39 | Campi della risposta |
|---|---|---|---|---|---|
searchRicerca Cerca attività locali su Yelp in una città o in un codice ZIP. Ottieni valutazione, numero di recensioni, fascia di prezzo, categorie, contatti, orari e stato di rivendicazione. Imposta sempre | keyword | location | Valori del catalogo: defaultLimit=10, maxLimit=50. Per alcune azioni limit può controllare le pagine o l'espansione per elemento padre, quindi non è sempre un numero finale di righe. | id · name · url · rating · rating_scale · review_count · price_range · categories · image_url · platform · phone · website · cuisine · description · address · city · region · postal_code · country · is_claimed · is_verified · health_score · established_year · images · amenities · highlights · hours | |
profileDettagli Apri la pagina di un'attività su Yelp dal suo link /biz/. Ottieni valutazione, fascia di prezzo, categorie, contatti, indirizzo, orari, servizi, punti di forza e foto. Una pagina non rivendicata, indicata da | url | — | — | id · name · url · rating · rating_scale · review_count · price_range · phone · website · categories · cuisine · description · address · city · region · postal_code · country · is_claimed · is_verified · health_score · established_year · image_url · platform · images · amenities · highlights · hours | |
reviewsRecensioni Leggi le recensioni Yelp di un'attività, 10 per pagina. Ogni recensione include testo, valutazione, data, autore, numero di foto e voti useful, funny e cool. Per la pagina successiva, rimanda | url | page_token | Valori del catalogo: defaultLimit=10, maxLimit=10. Per alcune azioni limit può controllare le pagine o l'espansione per elemento padre, quindi non è sempre un numero finale di righe. Un limit più alto è accettato e ridotto a 10. Per la pagina successiva, ripassa next_page_token come page_token con gli altri parametri invariati; ogni pagina è una chiamata. Le pagine arrivano fino a 100 righe; oltre 50 righe, richiedi la pagina con mode=async. | id · text · rating · rating_scale · posted_at · author_name · useful_count · photo_count · business_name · business_url · platform · funny_count · cool_count |
Cosa significano i parametri search di API di Yelp?
Cerca attività locali su Yelp in una città o in un codice ZIP. Ottieni valutazione, numero di recensioni, fascia di prezzo, categorie, contatti, orari e stato di rivendicazione. Imposta sempre location, perché la ricerca ha New York come valore predefinito. health_score compare solo per i ristoranti.
keywordObbligatorio- Definisce i termini di ricerca di attività o servizi locali (ad es. coffee) per l'azione search di Yelp. Per evitare che venga usata New York come predefinita, abbina questo parametro a una località esplicita.
locationFacoltativo- Imposta la città, il quartiere o il CAP per la ricerca di attività, ad es. Austin, TX o 78701. Descrive la posizione dell'attività, non quella dell'autore della recensione.
Cosa significano i parametri profile di API di Yelp?
Apri la pagina di un'attività su Yelp dal suo link /biz/. Ottieni valutazione, fascia di prezzo, categorie, contatti, indirizzo, orari, servizi, punti di forza e foto. Una pagina non rivendicata, indicata da is_claimed, potrebbe contenere informazioni non aggiornate. Nessuno di questi dati prova la proprietà o le licenze.
urlObbligatorio- Accetta un URL di un'attività Yelp con lo slug /biz/ per le azioni profile e reviews, che recuperano i metadati dell'attività o le recensioni degli utenti. I link ai profili utente non sono supportati.
Cosa significano i parametri reviews di API di Yelp?
Leggi le recensioni Yelp di un'attività, 10 per pagina. Ogni recensione include testo, valutazione, data, autore, numero di foto e voti useful, funny e cool. Per la pagina successiva, rimanda next_page_token come page_token. I token durano 24 ore.
urlObbligatorio- Accetta un URL di un'attività Yelp con lo slug /biz/ per le azioni profile e reviews, che recuperano i metadati dell'attività o le recensioni degli utenti. I link ai profili utente non sono supportati.Yelp: rapporto tra recensioni non consigliate e valutazioni complessive — Yelp afferma che le recensioni attualmente non consigliate non rientrano nel calcolo della valutazione complessiva a stelle né del numero di recensioni di un'attività; per questo il numero di elementi e il punteggio medio di un campione raccolto non si possono presentare direttamente come metriche aggregate ufficiali del sito. · Verificato
page_tokenFacoltativo- Token di paginazione: per ottenere la pagina successiva, ripassa il next_page_token della risposta precedente; omettilo per la prima pagina. Lascia invariati tutti gli altri parametri. I token durano 24 ore e ogni pagina corrisponde a una chiamata.
Come usare l'API di Yelp
- 01Scegli un'azione della piattaforma dal catalogo pubblico.
- 02Invia piattaforma, azione e parametri obbligatori a POST /api/v1/social.
- 03Leggi il risultato dalla risposta. Per un'azione asincrona, interroga periodicamente il job ID restituito.
- 04Salva i campi della risposta che servono alla tua applicazione.
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"yelp","action":"search","params":{"keyword":"<keyword>"}}'
Domande sull'API di Yelp
Cosa posso ottenere con l'API di Yelp?
Imposta platform su yelp. Il catalogo attuale elenca ricerca, dettagli e recensioni. Questi nomi di azione identificano oggetti o viste diversi di Yelp; non sono modalità di ricerca intercambiabili.
Quale input avvia la richiesta search di Yelp?
Definisce i termini di ricerca di attività o servizi locali (ad es. coffee) per l'azione search di Yelp. Per evitare che venga usata New York come predefinita, abbina questo parametro a una località esplicita. Invialo come keyword all'interno di params.
Quali campi può restituire search di Yelp?
Il suo schema dichiarato include name, rating, rating_scale e review_count. Un campo dichiarato può comunque mancare in un singolo record, e ogni altra azione ha il proprio elenco di campi.
Tutte le azioni di Yelp rispondono subito?
Le azioni indicate come asincrone restituiscono un job ID da interrogare periodicamente. Tutte le altre azioni possono essere eseguite anche in modo asincrono: aggiungi "mode": "async" al corpo della richiesta per ricevere subito un job ID, utile per task lenti o limiti elevati. Il catalogo attuale contiene consegna sync.