API di Douban
Cerca film, libri e musica su Douban e recupera recensioni lunghe, recensioni brevi e discussioni nei gruppi.
I filtri per tipo di contenuto accettano all, movie, book o music, mentre gli elementi di discussione richiedono URL espliciti.
Invia POST https://api.everyinfra.com/api/v1/social con platform impostato su douban e action impostato sul nome di una funzionalità dell'elenco qui sotto, ad esempio search.
- 4 funzionalità
- Da $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 Douban: 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 film, libri e album su Douban per titolo o argomento. | Normale | |
Recensionireviews | Leggi le recensioni lunghe di Douban su un film, un libro o un album dal link della scheda. | $24 per 1.000 richiesteOgni riga vale una chiamata | Normale |
Commenticomments | Elenca i commenti brevi di Douban su un film, un libro o un album dal link della scheda, ciascuno con testo, etichetta di valutazione, autore, numero di voti e data. | Normale | |
Argomento del gruppogroup_topic | Leggi una discussione di un gruppo Douban dal link del topic. | Normale |
Cosa accetta ogni azione di API di Douban?
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 film, libri e album su Douban per titolo o argomento. Ottieni anno, regista e cast, autore o artista, valutazione, numero di votanti e copertina. Limita i risultati a film, libri o musica con | keyword | search_type, type | Valori del catalogo: defaultLimit=20, 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 · url · title · subject_type · year · director · cast · author · artist · rating · rating_scale · rating_count · cover_url · platform | |
reviewsRecensioni Leggi le recensioni lunghe di Douban su un film, un libro o un album dal link della scheda. Ogni recensione include titolo, testo, etichetta di valutazione, autore e numero di risposte. Ogni valutazione appartiene alla propria recensione. Il batch non contiene sempre tutte le recensioni del titolo. | url | — | Valori del catalogo: defaultLimit=15, maxLimit=50. Per alcune azioni limit può controllare le pagine o l'espansione per elemento padre, quindi non è sempre un numero finale di righe. | $24 per 1.000 richiesteOgni riga vale una chiamata | id · url · subject_id · subject_name · subject_type · title · text · rating · rating_scale · rating_label · author_name · author_url · author_avatar_url · reply_count · posted_at · platform |
commentsCommenti Elenca i commenti brevi di Douban su un film, un libro o un album dal link della scheda, ciascuno con testo, etichetta di valutazione, autore, numero di voti e data. Questi commenti brevi sono distinti dalle recensioni lunghe restituite da | url | — | 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 · subject_id · subject_name · subject_type · text · rating · rating_scale · rating_label · author_name · author_url · author_avatar_url · vote_count · posted_at · platform | |
group_topicArgomento del gruppo Leggi una discussione di un gruppo Douban dal link del topic. Ottieni il post iniziale, nome e link del gruppo, autore, numero di risposte e le risposte. | url | max_replies | 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 · url · title · text · group_id · group_name · group_url · author_name · author_url · reply_count · replies · posted_at · platform |
Cosa significano i parametri search di API di Douban?
Cerca film, libri e album su Douban per titolo o argomento. Ottieni anno, regista e cast, autore o artista, valutazione, numero di votanti e copertina. Limita i risultati a film, libri o musica con search_type. Se li invii entrambi, type ha la precedenza.
keywordObbligatorio- Specifica la query di ricerca per titolo o argomento per trovare elementi multimediali su Douban tra film, libri e musica. Non esegue ricerche full-text all'interno delle recensioni lunghe o degli argomenti dei gruppi.
search_typeFacoltativo- Filtra la ricerca degli elementi per categoria con all (predefinito), movie, book o music. Se viene fornito anche type, type ha la precedenza; i valori non riconosciuti ricadono su all.Valori ammessi:
allbookmoviemusic typeFacoltativo- Ha la precedenza su search_type per filtrare la ricerca degli elementi per categoria (all, movie, book o music). Filtra solo il tipo di voce del catalogo e non sceglie tra reviews (recensioni lunghe) e comments (commenti brevi), che dipendono dal tipo di azione.Valori ammessi:
allbookmoviemusicDouban Books: l'ambito delle valutazioni e delle recensioni dei libri — Douban Books distingue valutazioni, recensioni complete e recensioni brevi, e consiglia di considerare il voto di un libro insieme agli altri feedback. Questo spiega il contesto di valutazione di una scheda libro; non rende il punteggio una misura oggettiva del valore né aggiunge a questo endpoint funzioni disponibili solo sul sito web. · Verificato
Cosa significano i parametri reviews di API di Douban?
Leggi le recensioni lunghe di Douban su un film, un libro o un album dal link della scheda. Ogni recensione include titolo, testo, etichetta di valutazione, autore e numero di risposte. Ogni valutazione appartiene alla propria recensione. Il batch non contiene sempre tutte le recensioni del titolo.
Riferimento API completo: parametri, esempi di codice, esempio di risposta e statourlObbligatorio- Specifica l'URL del soggetto nel formato /subject/<ID>/ su movie.douban.com, book.douban.com o music.douban.com per le azioni reviews o comments, oppure nel formato www.douban.com/group/topic/<ID>/ per group_topic. Recensioni lunghe, commenti brevi e risposte agli argomenti dei gruppi sono gestiti da endpoint di azione separati.Douban Movies: recensioni lunghe, recensioni brevi e limiti di visibilità — Douban Movies spiega separatamente le recensioni dei film e le recensioni brevi, precisando che la sezione delle recensioni brevi non le mostra tutte e che i contenuti visualizzati in forma compressa hanno una visibilità pubblica diversa. Gli elenchi di recensioni dei film restituiti da questo endpoint non vanno considerati uno storico completo né l'insieme di tutte le opinioni del pubblico; questa fonte non sostituisce le regole specifiche per libri o musica. · Verificato
Cosa significano i parametri comments di API di Douban?
Elenca i commenti brevi di Douban su un film, un libro o un album dal link della scheda, ciascuno con testo, etichetta di valutazione, autore, numero di voti e data. Questi commenti brevi sono distinti dalle recensioni lunghe restituite da reviews.
urlObbligatorio- Specifica l'URL del soggetto nel formato /subject/<ID>/ su movie.douban.com, book.douban.com o music.douban.com per le azioni reviews o comments, oppure nel formato www.douban.com/group/topic/<ID>/ per group_topic. Recensioni lunghe, commenti brevi e risposte agli argomenti dei gruppi sono gestiti da endpoint di azione separati.Douban Movies: recensioni lunghe, recensioni brevi e limiti di visibilità — Douban Movies spiega separatamente le recensioni dei film e le recensioni brevi, precisando che la sezione delle recensioni brevi non le mostra tutte e che i contenuti visualizzati in forma compressa hanno una visibilità pubblica diversa. Gli elenchi di recensioni dei film restituiti da questo endpoint non vanno considerati uno storico completo né l'insieme di tutte le opinioni del pubblico; questa fonte non sostituisce le regole specifiche per libri o musica. · Verificato
Cosa significano i parametri group_topic di API di Douban?
Leggi una discussione di un gruppo Douban dal link del topic. Ottieni il post iniziale, nome e link del gruppo, autore, numero di risposte e le risposte. max_replies imposta quante risposte recuperare, da 1 a 100 (default 20). I gruppi chiusi non sono accessibili, e la discussione potrebbe essere incompleta.
urlObbligatorio- Specifica l'URL del soggetto nel formato /subject/<ID>/ su movie.douban.com, book.douban.com o music.douban.com per le azioni reviews o comments, oppure nel formato www.douban.com/group/topic/<ID>/ per group_topic. Recensioni lunghe, commenti brevi e risposte agli argomenti dei gruppi sono gestiti da endpoint di azione separati.Douban Groups: leggere le discussioni è diverso dal gestire i membri — L'assistenza di Douban elenca l'iscrizione ai gruppi, la messa in evidenza delle discussioni e la gestione dei membri come funzioni distinte, alcune delle quali richiedono i permessi di responsabile o amministratore del gruppo. Recuperare qui discussioni specifiche e citare la documentazione sulla gestione non concede tali permessi, né fornisce operazioni di iscrizione, pubblicazione o gestione. · Verificato
max_repliesFacoltativo- Limita il numero di risposte all'argomento recuperate da group_topic per richiesta; accetta numeri interi da 1 a 100 (predefinito 20). I valori fuori intervallo vengono riportati ai limiti, quelli non interpretabili tornano al valore predefinito, e il numero restituito non garantisce il recupero di tutte le risposte storiche.
Come usare l'API di Douban
- 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":"douban","action":"search","params":{"keyword":"<keyword>"}}'
Domande sull'API di Douban
Cosa posso ottenere con l'API di Douban?
Imposta platform su douban. Il catalogo attuale elenca ricerca, recensioni, commenti e argomento del gruppo. Questi nomi di azione identificano oggetti o viste diversi di Douban; non sono modalità di ricerca intercambiabili.
Quale input avvia la richiesta search di Douban?
Specifica la query di ricerca per titolo o argomento per trovare elementi multimediali su Douban tra film, libri e musica. Non esegue ricerche full-text all'interno delle recensioni lunghe o degli argomenti dei gruppi. Invialo come keyword all'interno di params.
Quali campi può restituire search di Douban?
Il suo schema dichiarato include title, subject_type, year e director. Un campo dichiarato può comunque mancare in un singolo record, e ogni altra azione ha il proprio elenco di campi.
Tutte le azioni di Douban 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.