API di Yandex
Recupera le attività di Yandex Maps e i prodotti di Yandex Market per analizzare recensioni delle attività, prezzi degli articoli e valutazioni dei negozi.
Imposta la città di destinazione per filtrare le ricerche di attività locali. Mosca è la regione predefinita per le ricerche su Market.
Invia POST https://api.everyinfra.com/api/v1/social con platform impostato su yandex 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
- Operatività nelle ultime 24 ore 99%
Disponibilità della piattaforma
- Operatività nelle ultime 24 ore
- 99%
Ultimi 30 giorni
Funzionalità disponibili
Ogni azione di Yandex: 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 | Trova attività e luoghi su Yandex Maps per una parola chiave in una città. | Normale | |
Mercatomarket | Confronta i prodotti su Yandex Market per un termine di ricerca. | Buono · operatività 99% | |
Recensionireviews | Raccogli le recensioni di un'attività su Yandex Maps, fino a 200 per chiamata. | Normale |
Cosa accetta ogni azione di API di Yandex?
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 Trova attività e luoghi su Yandex Maps per una parola chiave in una città. Ottieni indirizzo, telefono, sito web, categorie, valutazione, numero di recensioni, coordinate e stato di apertura attuale. | keyword | category, lang, language, location, max_price, min_price, sort | Valori del catalogo: defaultLimit=20, maxLimit=100. Per alcune azioni limit può controllare le pagine o l'espansione per elemento padre, quindi non è sempre un numero finale di righe. | id · url · name · text · address · city · country · categories · rating · rating_scale · review_count · phone · website · lat · lng · is_open_now · platform | |
marketMercato Confronta i prodotti su Yandex Market per un termine di ricerca. Ottieni prezzo, valutazione, numero di recensioni e di acquisti, nome e valutazione del negozio e disponibilità. Imposta la città con | keyword | city, max_price, min_price, region, sort | Valori del catalogo: defaultLimit=20, maxLimit=100. Per alcune azioni limit può controllare le pagine o l'espansione per elemento padre, quindi non è sempre un numero finale di righe. | id · url · title · price · currency · rating · rating_scale · rating_count · review_count · purchase_count · category · shop_name · shop_rating · stock · is_available · image_url · platform | |
reviewsRecensioni Raccogli le recensioni di un'attività su Yandex Maps, fino a 200 per chiamata. Ogni recensione include testo, punteggio, data, like e dislike e la risposta del titolare. Passa il link di un luogo sulla mappa o l'ID dell'attività, non il link di un prodotto di Market. Con | url | language, sort | Valori del catalogo: defaultLimit=20, maxLimit=200. Per alcune azioni limit può controllare le pagine o l'espansione per elemento padre, quindi non è sempre un numero finale di righe. | id · url · text · rating · rating_scale · posted_at · language · like_count · dislike_count · comment_count · author_name · owner_reply · business_id · business_name · business_rating · business_review_count · platform |
Cosa significano i parametri search di API di Yandex?
Trova attività e luoghi su Yandex Maps per una parola chiave in una città. Ottieni indirizzo, telefono, sito web, categorie, valutazione, numero di recensioni, coordinate e stato di apertura attuale. location ha Mosca come valore predefinito e category restringe il tipo di luogo. Le valutazioni non confermano disponibilità o qualità.
keywordObbligatorio- Indica i termini di ricerca per le azioni Yandex: luoghi locali in search e articoli e-commerce in market. Le schede della mappa e i cataloghi prodotti interrogano dataset distinti.
categoryFacoltativo- Filtra le categorie di luoghi per l'azione search di Yandex (ad es. restaurants, cafes, coffee_shops, hotels, oppure none per azzerare il filtro). Questo parametro non si applica alle categorie di prodotti di Yandex Market e deve essere coerente con la parola chiave e la città indicate.Valori ammessi:
atmsauto_repairbanksbars_pubsbeauty_salonsburgerscafescar_washcinemascoffee_shopsdentistsdry_cleaningfast_foodfitness_clubsgas_stationsgovernment_servicesgrocery_storeshookah_barshospitalshotelskindergartensmuseumsnonepharmaciespizzarestaurantsschoolsshopping_mallssports_facilitiessushi_rollsveterinary_clinicsYandex Maps: schede delle attività, categorie e valutazioni — La documentazione ufficiale sulle schede delle attività descrive la categoria dell'attività, l'indirizzo, la valutazione, il numero di recensioni e le informazioni operative. Questo chiarisce gli oggetti della mappa; la presenza di pulsanti nelle schede delle attività non implica che questa API offra funzionalità di prenotazione o di modifica della mappa. · Verificato langFacoltativo- Imposta la lingua della risposta per l'azione search di Yandex; accetta ru, en, kk, tr o uk. Controlla la lingua dell'interfaccia di ricerca e non garantisce la traduzione delle recensioni scritte dagli utenti.Valori ammessi:
enkkrutruk languageFacoltativo- Imposta la lingua dell'interfaccia di fallback per le azioni Yandex, con ru come predefinito per search ed en per reviews. Se passi esplicitamente lang nell'azione search, questo parametro viene sovrascritto.
locationFacoltativo- Imposta la città di destinazione per l'azione search di Yandex, con Mosca come predefinita. Questo parametro accetta nomi di città ed è distinto dagli ID regione numerici di Yandex Market.
max_priceFacoltativo- Imposta il limite superiore di prezzo per l'azione Yandex di destinazione, se usato insieme a min_price. Non filtra per valutazione massima degli utenti. Il filtro usa numeri interi: i decimali vengono arrotondati per eccesso (145.98 diventa 146).
min_priceFacoltativo- Imposta il limite inferiore di prezzo per le azioni Yandex: rappresenta il prezzo del prodotto in market e la fascia di prezzo del luogo in search. Questi valori riflettono i prezzi della piattaforma di destinazione, non i costi di utilizzo dell'API. Il filtro usa numeri interi: i decimali vengono arrotondati per difetto (39.81 diventa 39).
sortFacoltativo- Controlla l'ordinamento per ciascuna azione Yandex. Accetta relevance o distance per search; popular o top_rated per market; e newest (predefinito), relevance, top_rated o lowest_rated per reviews. I valori non sono intercambiabili tra azioni diverse.Valori ammessi:
distancerelevance
Cosa significano i parametri market di API di Yandex?
Confronta i prodotti su Yandex Market per un termine di ricerca. Ottieni prezzo, valutazione, numero di recensioni e di acquisti, nome e valutazione del negozio e disponibilità. Imposta la città con city o con il codice numerico region, che ha Mosca come valore predefinito. Non viene effettuato alcun ordine e la disponibilità non è garantita.
keywordObbligatorio- Indica i termini di ricerca per le azioni Yandex: luoghi locali in search e articoli e-commerce in market. Le schede della mappa e i cataloghi prodotti interrogano dataset distinti.
cityFacoltativo- Indica lo slug della città di destinazione (ad es. moscow, saint_petersburg) per l'azione market di Yandex. Deve corrispondere a un valore enum consentito e non può sostituire location nelle ricerche su mappa.Valori ammessi:
chelyabinskkazankrasnodarkrasnoyarskmoscownizhny_novgorodnovosibirskomskpermrostov_on_donsaint_petersburgsamaraufavolgogradvoronezhyekaterinburgYandex Market: le condizioni di consegna dipendono da città e prodotto — Le condizioni di consegna ufficiali di Yandex Market legano direttamente metodi di spedizione, tempi e costi alla città e al prodotto specifico, con le condizioni esatte indicate nelle pagine del prodotto e del checkout; ciò chiarisce che i prezzi mostrati nella ricerca iniziale dei prodotti non costituiscono un costo totale finale della consegna garantito né un impegno a effettuare la consegna. · Verificato max_priceFacoltativo- Imposta il limite superiore di prezzo per l'azione Yandex di destinazione, se usato insieme a min_price. Non filtra per valutazione massima degli utenti. Il filtro usa numeri interi: i decimali vengono arrotondati per eccesso (145.98 diventa 146).
min_priceFacoltativo- Imposta il limite inferiore di prezzo per le azioni Yandex: rappresenta il prezzo del prodotto in market e la fascia di prezzo del luogo in search. Questi valori riflettono i prezzi della piattaforma di destinazione, non i costi di utilizzo dell'API. Il filtro usa numeri interi: i decimali vengono arrotondati per difetto (39.81 diventa 39).
regionFacoltativo- Accetta un codice regione numerico della città per l'azione market di Yandex, con 213 (Mosca) come predefinito. È un identificativo di regione interno, non il codice paese RU. Se fornisci esplicitamente il parametro city, questa impostazione viene sovrascritta.
sortFacoltativo- Controlla l'ordinamento per ciascuna azione Yandex. Accetta relevance o distance per search; popular o top_rated per market; e newest (predefinito), relevance, top_rated o lowest_rated per reviews. I valori non sono intercambiabili tra azioni diverse.Valori ammessi:
populartop_rated
Cosa significano i parametri reviews di API di Yandex?
Raccogli le recensioni di un'attività su Yandex Maps, fino a 200 per chiamata. Ogni recensione include testo, punteggio, data, like e dislike e la risposta del titolare. Passa il link di un luogo sulla mappa o l'ID dell'attività, non il link di un prodotto di Market. Con sort puoi mostrare per prime le lamentele usando lowest_rated.
urlObbligatorio- Indica l'URL completo di un luogo su Yandex Maps o direttamente una stringa businessId per l'azione reviews. Questo parametro non accetta link a prodotti Yandex Market.
languageFacoltativo- Imposta la lingua dell'interfaccia di fallback per le azioni Yandex, con ru come predefinito per search ed en per reviews. Se passi esplicitamente lang nell'azione search, questo parametro viene sovrascritto.Yandex Maps: recensioni originali e traduzioni dell'interfaccia — La documentazione ufficiale di Yandex afferma che le recensioni scritte in una lingua diversa da quella dell'interfaccia possono essere mostrate tradotte, con un'opzione per tornare al testo originale; per questo il parametro della lingua di questa API non può essere considerato un filtro diretto sulla lingua in cui la recensione è stata scritta né una garanzia di traduzione. · Verificato
sortFacoltativo- Controlla l'ordinamento per ciascuna azione Yandex. Accetta relevance o distance per search; popular o top_rated per market; e newest (predefinito), relevance, top_rated o lowest_rated per reviews. I valori non sono intercambiabili tra azioni diverse.Valori ammessi:
lowest_ratednewestrelevancetop_rated
Come usare l'API di Yandex
- 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":"yandex","action":"search","params":{"keyword":"<keyword>"}}'
Domande sull'API di Yandex
Cosa posso ottenere con l'API di Yandex?
Imposta platform su yandex. Il catalogo attuale elenca ricerca, mercato e recensioni. Questi nomi di azione identificano oggetti o viste diversi di Yandex; non sono modalità di ricerca intercambiabili.
Quale input avvia la richiesta search di Yandex?
Indica i termini di ricerca per le azioni Yandex: luoghi locali in search e articoli e-commerce in market. Le schede della mappa e i cataloghi prodotti interrogano dataset distinti. Invialo come keyword all'interno di params.
Quali campi può restituire search di Yandex?
Il suo schema dichiarato include name, text, address e city. Un campo dichiarato può comunque mancare in un singolo record, e ogni altra azione ha il proprio elenco di campi.
Tutte le azioni di Yandex 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.