API di Mastodon
Recupera gli status pubblici di Mastodon, profili essenziali e timeline pubbliche per account, hashtag o istanza.
Imposta il dominio dell'istanza per le query sulle timeline. Gli username di altre istanze richiedono il nome del server corrispondente.
Invia POST https://api.everyinfra.com/api/v1/social con platform impostato su mastodon e action impostato sul nome di una funzionalità dell'elenco qui sotto, ad esempio user_posts.
- 5 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 Mastodon: 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 |
|---|---|---|---|
Post dell'utenteuser_posts | Estrai i post di un account Mastodon, indicato come handle o utente@istanza in username. | Normale | |
Profiliprofile | Risolvi un handle Mastodon o un indirizzo utente@istanza per ottenere il nome visualizzato, l'handle completo, l'istanza di appartenenza e il link al profilo dell'account. | Normale | |
Hashtaghashtag | Sfoglia i post di un hashtag di Mastodon, indicato senza # in hashtag, con autore, testo, lingua, link ai contenuti multimediali e numero di Mi piace, boost e risposte. | Normale | |
Tendenzetrending | Ottieni i post di tendenza su un'istanza Mastodon, mastodon.social se instance non ne indica un'altra. | Normale | |
Timelinetimeline | Leggi la timeline pubblica di un'istanza Mastodon, fosstodon.org di default. | Normale |
Cosa accetta ogni azione di API di Mastodon?
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 |
|---|---|---|---|---|---|
user_postsPost dell'utente Estrai i post di un account Mastodon, indicato come handle o utente@istanza in | username | instance | 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 · text · author_name · author_username · author_url · instance · like_count · reblog_count · comment_count · language · is_reblog · posted_at · platform · media_urls · hashtags | |
profileProfili Risolvi un handle Mastodon o un indirizzo utente@istanza per ottenere il nome visualizzato, l' | username | instance | — | username · display_name · handle · instance · url · platform | |
hashtagHashtag Sfoglia i post di un hashtag di Mastodon, indicato senza # in | hashtag | instance | 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 · text · author_name · author_username · author_url · instance · like_count · reblog_count · comment_count · language · is_reblog · posted_at · platform · media_urls · hashtags | |
trendingTendenze Ottieni i post di tendenza su un'istanza Mastodon, mastodon.social se | instance | 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 · text · author_name · author_username · author_url · instance · like_count · reblog_count · comment_count · language · is_reblog · posted_at · platform · media_urls · hashtags | ||
timelineTimeline Leggi la timeline pubblica di un'istanza Mastodon, fosstodon.org di default. Ogni post include autore, testo, lingua, link ai contenuti multimediali e numero di Mi piace, boost e risposte. Non è il feed personale di un utente autenticato né un archivio di tutto Mastodon. | instance | 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 · text · author_name · author_username · author_url · instance · like_count · reblog_count · comment_count · language · is_reblog · posted_at · platform · media_urls · hashtags |
Cosa significano i parametri user_posts di API di Mastodon?
Estrai i post di un account Mastodon, indicato come handle o utente@istanza in username. Ottieni numero di Mi piace, boost e risposte, lingua e un indicatore che segnala i boost. Gli account con lo stesso nome su altre istanze restano separati. La cronologia completa non è garantita.
usernameObbligatorio- Specifica l'handle dell'account Mastodon o il formato completo user@instance, con @ iniziale facoltativo. Se fornisci un handle breve senza istanza, viene usato mastodon.social, e nomi utente identici su istanze diverse corrispondono ad account distinti.Mastodon WebFinger: gli handle degli account richiedono la risoluzione del dominio — La documentazione ufficiale afferma esplicitamente che @user
@example.com e @user @example.org sono account distinti, definiti sia dallo username sia dal dominio. Questo documento chiarisce le regole di identificazione degli account e non implica che questo gateway restituisca tutti i metadati ufficiali dell'oggetto Account. · Verificato instanceFacoltativo- Seleziona il dominio di un'istanza Mastodon senza schema né percorso. Timeline usa fosstodon.org come predefinito e le altre azioni mastodon.social. Un'istanza esplicita ha la priorità sul dominio indicato in username, quindi mantieni coerenti i due valori.
Cosa significano i parametri profile di API di Mastodon?
Risolvi un handle Mastodon o un indirizzo utente@istanza per ottenere il nome visualizzato, l'handle completo, l'istanza di appartenenza e il link al profilo dell'account. Un handle senza istanza viene cercato su mastodon.social a meno che tu non imposti instance, e una corrispondenza non dimostra che sia l'account che intendevi.
usernameObbligatorio- Specifica l'handle dell'account Mastodon o il formato completo user@instance, con @ iniziale facoltativo. Se fornisci un handle breve senza istanza, viene usato mastodon.social, e nomi utente identici su istanze diverse corrispondono ad account distinti.Mastodon WebFinger: gli handle degli account richiedono la risoluzione del dominio — La documentazione ufficiale afferma esplicitamente che @user
@example.com e @user @example.org sono account distinti, definiti sia dallo username sia dal dominio. Questo documento chiarisce le regole di identificazione degli account e non implica che questo gateway restituisca tutti i metadati ufficiali dell'oggetto Account. · Verificato instanceFacoltativo- Seleziona il dominio di un'istanza Mastodon senza schema né percorso. Timeline usa fosstodon.org come predefinito e le altre azioni mastodon.social. Un'istanza esplicita ha la priorità sul dominio indicato in username, quindi mantieni coerenti i due valori.
Cosa significano i parametri hashtag di API di Mastodon?
Sfoglia i post di un hashtag di Mastodon, indicato senza # in hashtag, con autore, testo, lingua, link ai contenuti multimediali e numero di Mi piace, boost e risposte. Provengono dalla timeline del tag di una sola istanza ed escludono boost e risposte, quindi non misurano l'intera conversazione federata.
hashtagObbligatorio- Specifica il tag senza # iniziale per ottenere la timeline dell'hashtag su un'istanza di destinazione. Esclude boost e risposte, quindi non rappresenta un campione completo dei tag della rete federata.Mastodon: feed degli hashtag e limiti dell'anteprima pubblica delle istanze — La documentazione ufficiale afferma che i feed degli hashtag recuperano i post pubblici che contengono un determinato tag, con percorsi del tag senza il simbolo #; l'accesso all'istanza è limitato quando le anteprime pubbliche sono disattivate. I parametri di EveryInfra per escludere Boost e risposte sono quelli documentati in questa pagina, non una copia di tutte le chiavi di query ufficiali. · Verificato
instanceFacoltativo- Seleziona il dominio di un'istanza Mastodon senza schema né percorso. Timeline usa fosstodon.org come predefinito e le altre azioni mastodon.social. Un'istanza esplicita ha la priorità sul dominio indicato in username, quindi mantieni coerenti i due valori.
Cosa significano i parametri trending di API di Mastodon?
Ottieni i post di tendenza su un'istanza Mastodon, mastodon.social se instance non ne indica un'altra. Ogni post include autore, testo, lingua, contenuti multimediali e numero di Mi piace, boost e risposte. Posizioni e conteggi riflettono il momento della chiamata. Non spiegano l'algoritmo delle tendenze né classificano l'intero fediverso.
instanceFacoltativo- Seleziona il dominio di un'istanza Mastodon senza schema né percorso. Timeline usa fosstodon.org come predefinito e le altre azioni mastodon.social. Un'istanza esplicita ha la priorità sul dominio indicato in username, quindi mantieni coerenti i due valori.
Cosa significano i parametri timeline di API di Mastodon?
Leggi la timeline pubblica di un'istanza Mastodon, fosstodon.org di default. Ogni post include autore, testo, lingua, link ai contenuti multimediali e numero di Mi piace, boost e risposte. Non è il feed personale di un utente autenticato né un archivio di tutto Mastodon.
Riferimento API completo: parametri, esempi di codice, esempio di risposta e statoinstanceFacoltativo- Seleziona il dominio di un'istanza Mastodon senza schema né percorso. Timeline usa fosstodon.org come predefinito e le altre azioni mastodon.social. Un'istanza esplicita ha la priorità sul dominio indicato in username, quindi mantieni coerenti i due valori.
Come usare l'API di Mastodon
- 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":"mastodon","action":"user_posts","params":{"username":"<username>"}}'
Domande sull'API di Mastodon
Cosa posso ottenere con l'API di Mastodon?
Imposta platform su mastodon. Il catalogo attuale elenca post dell'utente, profili, hashtag, tendenze e timeline. Questi nomi di azione identificano oggetti o viste diversi di Mastodon; non sono modalità di ricerca intercambiabili.
Quale input avvia la richiesta user_posts di Mastodon?
Specifica l'handle dell'account Mastodon o il formato completo user@instance, con @ iniziale facoltativo. Se fornisci un handle breve senza istanza, viene usato mastodon.social, e nomi utente identici su istanze diverse corrispondono ad account distinti. Invialo come username all'interno di params.
Quali campi può restituire user_posts di Mastodon?
Il suo schema dichiarato include text, author_name, author_username e author_url. Un campo dichiarato può comunque mancare in un singolo record, e ogni altra azione ha il proprio elenco di campi.
Tutte le azioni di Mastodon 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.