API di Lemmy
Recupera post e commenti annidati di Lemmy per parola chiave, community o timeline dell'istanza.
Imposta il dominio dell'istanza di destinazione per ogni query. La copertura completa di tutte le istanze federate non è garantita.
Invia POST https://api.everyinfra.com/api/v1/social con platform impostato su lemmy e action impostato sul nome di una funzionalità dell'elenco qui sotto, ad esempio search.
- 4 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 Lemmy: 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 post Lemmy su un'istanza per keyword, con community, autore, punteggio, voti positivi e negativi, numero di commenti, link esterno e indicatori che segnalano se il post è NSFW, bloccato o in evidenza. | Normale | |
Communitycommunity | Leggi i post di una community Lemmy, per nome o nome@istanza. | Normale | |
Feed di notiziefeed | Sfoglia il feed dei post di un'istanza Lemmy, lemmy.world di default. | Normale | |
Commenticomments | Recupera i commenti dai post di una community Lemmy, con punteggio, voti, profondità, ID del commento padre, indicatore di eliminazione e post di appartenenza. | Normale |
Cosa accetta ogni azione di API di Lemmy?
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 post Lemmy su un'istanza per | keyword | instance, sort, top_range | 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 · title · body · url · external_url · community · community_url · instance · author_username · author_url · score · upvote_count · downvote_count · comment_count · thumbnail_url · embed_title · is_nsfw · is_locked · is_featured · posted_at · updated_at · platform | |
communityCommunity Leggi i post di una community Lemmy, per nome o nome@istanza. Ottieni punteggio, voti, numero di commenti, link e indicatori del post, ordinati per hot di default. Le community con lo stesso nome su altre istanze non vengono unite. | community | instance, sort, top_range | 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 · title · body · url · external_url · community · community_url · instance · author_username · author_url · score · upvote_count · downvote_count · comment_count · thumbnail_url · embed_title · is_nsfw · is_locked · is_featured · posted_at · updated_at · platform | |
feedFeed di notizie Sfoglia il feed dei post di un'istanza Lemmy, lemmy.world di default. Ogni post include community, punteggio, voti, numero di commenti e indicatori. I post sono ordinati per attività di default. Non è né una timeline personalizzata né una visione completa del fediverso. | instance, sort, top_range | 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 · title · body · url · external_url · community · community_url · instance · author_username · author_url · score · upvote_count · downvote_count · comment_count · thumbnail_url · embed_title · is_nsfw · is_locked · is_featured · posted_at · updated_at · platform | ||
commentsCommenti Recupera i commenti dai post di una community Lemmy, con punteggio, voti, profondità, ID del commento padre, indicatore di eliminazione e post di appartenenza. | community | instance, max_comments, sort, top_range | Valori del catalogo: defaultLimit=10, 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 · text · author_username · author_url · score · upvote_count · downvote_count · depth · parent_comment_id · is_deleted · post_url · post_title · community · posted_at · platform |
Cosa significano i parametri search di API di Lemmy?
Cerca post Lemmy su un'istanza per keyword, con community, autore, punteggio, voti positivi e negativi, numero di commenti, link esterno e indicatori che segnalano se il post è NSFW, bloccato o in evidenza. La ricerca viene eseguita sull'istanza scelta in instance, lemmy.world di default, e non copre l'intero fediverso.
keywordObbligatorio- Specifica il termine di ricerca per l'azione search di Lemmy, che viene eseguita sull'istanza indicata e non garantisce una ricerca completa su tutte le istanze federate.Lemmy: ciò che è visibile da un'istanza non corrisponde all'intero Fediverso — Le guide ufficiali per i nuovi utenti spiegano che le istanze sono gestite da operatori diversi; la normale navigazione mostra solo le community note all'istanza locale, mentre gli oggetti di altre istanze vanno risolti separatamente. Questo contesto spiega la prospettiva dell'istanza e gli oggetti post, senza riportare nei parametri del gateway tutte le funzionalità della ricerca web. · Verificato
instanceFacoltativo- Seleziona il dominio dell'istanza Lemmy, ad esempio lemmy.world, che è anche il valore predefinito. È accettato anche l'URL completo dell'istanza, che viene ridotto al solo hostname. Sceglie il punto di accesso della query, non il nome di una community.
sortFacoltativo- Ordina i post come hot, active, new, top, most_comments o new_comments. Search e community usano hot come predefinito, feed usa active e comments usa most_comments.Valori ammessi:
activehotmost_commentsnewnew_commentstop top_rangeFacoltativo- Imposta la finestra temporale del punteggio solo quando sort è top: hour, sixhour, twelvehour, day, week (predefinito), month, threemonths, sixmonths, ninemonths, year o all. Non è un filtro sulla data di pubblicazione dei commenti.Valori ammessi:
alldayhourmonthninemonthssixhoursixmonthsthreemonthstwelvehourweekyear
Cosa significano i parametri community di API di Lemmy?
Leggi i post di una community Lemmy, per nome o nome@istanza. Ottieni punteggio, voti, numero di commenti, link e indicatori del post, ordinati per hot di default. Le community con lo stesso nome su altre istanze non vengono unite. top_range si applica solo quando ordini per top.
communityObbligatorio- Specifica il nome della community o l'identificatore tra istanze nel formato name@instance. Nell'azione community elenca i post della community; nell'azione comments recupera i post della community ed espande i relativi commenti, invece di interrogare direttamente l'URL di un singolo post.Lemmy: identificatori delle community e accesso tra istanze — Le guide ufficiali presentano gli URL delle community e il formato identificativo !name@instance, distinguendo tra community locali e federate. EveryInfra specifica questo parametro come name o name@instance; il prefisso ! e i formati URL dell'interfaccia ufficiale non sono supportati automaticamente da questa API. · Verificato
instanceFacoltativo- Seleziona il dominio dell'istanza Lemmy, ad esempio lemmy.world, che è anche il valore predefinito. È accettato anche l'URL completo dell'istanza, che viene ridotto al solo hostname. Sceglie il punto di accesso della query, non il nome di una community.
sortFacoltativo- Ordina i post come hot, active, new, top, most_comments o new_comments. Search e community usano hot come predefinito, feed usa active e comments usa most_comments.Valori ammessi:
activehotmost_commentsnewnew_commentstop top_rangeFacoltativo- Imposta la finestra temporale del punteggio solo quando sort è top: hour, sixhour, twelvehour, day, week (predefinito), month, threemonths, sixmonths, ninemonths, year o all. Non è un filtro sulla data di pubblicazione dei commenti.Valori ammessi:
alldayhourmonthninemonthssixhoursixmonthsthreemonthstwelvehourweekyear
Cosa significano i parametri feed di API di Lemmy?
Sfoglia il feed dei post di un'istanza Lemmy, lemmy.world di default. Ogni post include community, punteggio, voti, numero di commenti e indicatori. I post sono ordinati per attività di default. Non è né una timeline personalizzata né una visione completa del fediverso.
Riferimento API completo: parametri, esempi di codice, esempio di risposta e statoinstanceFacoltativo- Seleziona il dominio dell'istanza Lemmy, ad esempio lemmy.world, che è anche il valore predefinito. È accettato anche l'URL completo dell'istanza, che viene ridotto al solo hostname. Sceglie il punto di accesso della query, non il nome di una community.
sortFacoltativo- Ordina i post come hot, active, new, top, most_comments o new_comments. Search e community usano hot come predefinito, feed usa active e comments usa most_comments.Valori ammessi:
activehotmost_commentsnewnew_commentstop top_rangeFacoltativo- Imposta la finestra temporale del punteggio solo quando sort è top: hour, sixhour, twelvehour, day, week (predefinito), month, threemonths, sixmonths, ninemonths, year o all. Non è un filtro sulla data di pubblicazione dei commenti.Valori ammessi:
alldayhourmonthninemonthssixhoursixmonthsthreemonthstwelvehourweekyear
Cosa significano i parametri comments di API di Lemmy?
Recupera i commenti dai post di una community Lemmy, con punteggio, voti, profondità, ID del commento padre, indicatore di eliminazione e post di appartenenza. max_comments limita i commenti per post, da 1 a 200 con un valore predefinito di 50, non il totale della richiesta.
communityObbligatorio- Specifica il nome della community o l'identificatore tra istanze nel formato name@instance. Nell'azione community elenca i post della community; nell'azione comments recupera i post della community ed espande i relativi commenti, invece di interrogare direttamente l'URL di un singolo post.
instanceFacoltativo- Seleziona il dominio dell'istanza Lemmy, ad esempio lemmy.world, che è anche il valore predefinito. È accettato anche l'URL completo dell'istanza, che viene ridotto al solo hostname. Sceglie il punto di accesso della query, non il nome di una community.
max_commentsFacoltativo- Imposta il numero massimo di commenti da recuperare per post nell'azione comments: il valore predefinito è 50 e l'intervallo consentito va da 1 a 200. Limita i commenti per post, non il totale dei post o dei commenti della richiesta, e riporta automaticamente nell'intervallo i valori che ne escono.Lemmy: gerarchie di commenti annidati e limiti — La documentazione ufficiale spiega i commenti di primo livello, le gerarchie di risposte annidate e il calcolo del punteggio (voti positivi meno voti negativi). I limiti di commenti per post di EveryInfra sono impostazioni specifiche del servizio, non opzioni di ordinamento ufficiali; raggiungere un limite non garantisce l'inclusione completa di tutti i nodi genitore e figlio. · Verificato
sortFacoltativo- Ordina i post come hot, active, new, top, most_comments o new_comments. Search e community usano hot come predefinito, feed usa active e comments usa most_comments.Valori ammessi:
activehotmost_commentsnewnew_commentstop top_rangeFacoltativo- Imposta la finestra temporale del punteggio solo quando sort è top: hour, sixhour, twelvehour, day, week (predefinito), month, threemonths, sixmonths, ninemonths, year o all. Non è un filtro sulla data di pubblicazione dei commenti.Valori ammessi:
alldayhourmonthninemonthssixhoursixmonthsthreemonthstwelvehourweekyear
Come usare l'API di Lemmy
- 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":"lemmy","action":"search","params":{"keyword":"<keyword>"}}'
Domande sull'API di Lemmy
Cosa posso ottenere con l'API di Lemmy?
Imposta platform su lemmy. Il catalogo attuale elenca ricerca, community, feed di notizie e commenti. Questi nomi di azione identificano oggetti o viste diversi di Lemmy; non sono modalità di ricerca intercambiabili.
Quale input avvia la richiesta search di Lemmy?
Specifica il termine di ricerca per l'azione search di Lemmy, che viene eseguita sull'istanza indicata e non garantisce una ricerca completa su tutte le istanze federate. Invialo come keyword all'interno di params.
Quali campi può restituire search di Lemmy?
Il suo schema dichiarato include title, body, external_url e community. Un campo dichiarato può comunque mancare in un singolo record, e ogni altra azione ha il proprio elenco di campi.
Tutte le azioni di Lemmy 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.