API di Substack
Cerca pubblicazioni, post, commenti e note su Substack per ottenere dettagli sugli autori, conteggi di engagement e dati sugli iscritti.
Gli URL delle pubblicazioni devono contenere un handle leggibile dall'URL. I domini personalizzati non vengono sempre riconosciuti.
Invia POST https://api.everyinfra.com/api/v1/social con platform impostato su substack e action impostato sul nome di una funzionalità dell'elenco qui sotto, ad esempio search.
- 7 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 Substack: 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 | Scopri le newsletter Substack che corrispondono a una parola chiave, con nome, handle, dominio personalizzato, lingua, autore e post principali di ogni pubblicazione. | Normale | |
Pubblicazionepublication | Cerca una pubblicazione Substack dal link della homepage e ottieni nome, handle, dominio personalizzato, lingua, autore, post principali e numero di iscritti, se reso pubblico. | Normale | |
Post della pubblicazionepublication_posts | Elenca i post di una pubblicazione Substack. | Normale | |
Dettagli del postpost | Leggi un singolo post Substack dal suo link /p/. | Normale | |
Commenticomments | Estrai i commenti sotto un post Substack. | Normale | |
Profiliprofile | Trova il profilo di un autore Substack dal suo handle. | Normale | |
Notenotes | Raccogli le Notes di un autore Substack, i post brevi tenuti separati dalle newsletter, con testo, tipo, like e ora di pubblicazione di ciascuna. | Normale |
Cosa accetta ogni azione di API di Substack?
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 Scopri le newsletter Substack che corrispondono a una parola chiave, con nome, handle, dominio personalizzato, lingua, autore e post principali di ogni pubblicazione. La ricerca confronta le pubblicazioni, non il testo dei post, e un numero di iscritti null indica che il dato è nascosto, non che è zero. | keyword | — | Valori del catalogo: defaultLimit=10, maxLimit=30. Per alcune azioni limit può controllare le pagine o l'espansione per elemento padre, quindi non è sempre un numero finale di righe. | id · handle · name · url · custom_domain · bio · language · subscriber_count · payments_enabled · avatar_url · cover_url · platform · author_name · author_username · top_posts | |
publicationPubblicazione Cerca una pubblicazione Substack dal link della homepage e ottieni nome, handle, dominio personalizzato, lingua, autore, post principali e numero di iscritti, se reso pubblico. Il link deve contenere un handle Substack riconoscibile, perché i domini personalizzati potrebbero non essere interpretati, e nessun dato proviene dalla dashboard dell'autore. | url | — | — | id · handle · name · url · custom_domain · bio · language · subscriber_count · payments_enabled · avatar_url · cover_url · platform · author_name · author_username · top_posts | |
publication_postsPost della pubblicazione Elenca i post di una pubblicazione Substack. Ogni post ha titolo, sottotitolo, autore, like, commenti, numero di parole, tempo di lettura e stato a pagamento. Restringi per formato con | url | content_type, since, until | Valori del catalogo: defaultLimit=10, maxLimit=30. 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 · subtitle · text · author_name · author_username · publication_name · publication_handle · publication_url · like_count · comment_count · repost_count · word_count · reading_time_minutes · post_type · audience · is_paid · podcast_url · image_url · posted_at · updated_at · tags · platform | |
postDettagli del post Leggi un singolo post Substack dal suo link /p/. Ottieni titolo, sottotitolo, testo, autore, pubblicazione, conteggi di engagement e se si tratta di contenuto a pagamento. Il testo dietro paywall non viene sbloccato. I commenti si ottengono con l'azione separata | url | — | — | id · url · title · subtitle · text · author_name · author_username · publication_name · publication_handle · publication_url · like_count · comment_count · repost_count · word_count · reading_time_minutes · post_type · audience · is_paid · podcast_url · image_url · posted_at · updated_at · tags · platform | |
commentsCommenti Estrai i commenti sotto un post Substack. Ottieni autore, like, numero di risposte e flag per risposte, commenti fissati e interventi dell'autore del post. Passa il link /p/ del post. Il batch potrebbe non contenere l'intera conversazione. | url | — | 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 · text · author_name · author_username · like_count · reply_count · reply_to_id · is_reply · is_pinned · is_author · posted_at · platform | |
profileProfili Trova il profilo di un autore Substack dal suo handle. Ottieni nome visualizzato, bio, avatar, username Twitter collegato e le pubblicazioni associate all'account. Accetta un handle semplice, un @handle o un link substack.com/@. Descrive la persona, non una pubblicazione, e non mostra dati sugli abbonamenti. | username | — | — | user_id · username · display_name · bio · avatar_url · twitter_username · platform · publications | |
notesNote Raccogli le Notes di un autore Substack, i post brevi tenuti separati dalle newsletter, con testo, tipo, like e ora di pubblicazione di ciascuna. Elenca solo le Notes di un autore, non è una ricerca su tutto il sito, e potrebbe non coprire l'intera cronologia. | username | — | Valori del catalogo: defaultLimit=25, 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 · kind · text · author_username · author_name · like_count · posted_at · platform · restacked_post · attachment_urls |
Cosa significano i parametri search di API di Substack?
Scopri le newsletter Substack che corrispondono a una parola chiave, con nome, handle, dominio personalizzato, lingua, autore e post principali di ogni pubblicazione. La ricerca confronta le pubblicazioni, non il testo dei post, e un numero di iscritti null indica che il dato è nascosto, non che è zero.
Riferimento API completo: parametri, esempi di codice, esempio di risposta e statokeywordObbligatorio- Specifica la stringa di query per trovare newsletter e pubblicazioni Substack. Non esegue ricerche full-text nel corpo dei post.Substack: separazione tra profili, siti delle pubblicazioni e dati della dashboard — Substack documenta separatamente i profili pubblici, i siti web delle pubblicazioni e la dashboard dell'editore. La ricerca in questa pagina trova solo i profili delle pubblicazioni; la gestione dei lettori e le statistiche sui ricavi della dashboard ufficiale non significano che questa interfaccia possa recuperare quelle analisi. · Verificato
Cosa significano i parametri publication di API di Substack?
Cerca una pubblicazione Substack dal link della homepage e ottieni nome, handle, dominio personalizzato, lingua, autore, post principali e numero di iscritti, se reso pubblico. Il link deve contenere un handle Substack riconoscibile, perché i domini personalizzati potrebbero non essere interpretati, e nessun dato proviene dalla dashboard dell'autore.
Riferimento API completo: parametri, esempi di codice, esempio di risposta e statourlObbligatorio- Specifica il link alla risorsa Substack di destinazione. Usa la home page della pubblicazione per publication e publication_posts, oppure link diretti /p/ ai post per post e comments. L'azione publication richiede un URL con un handle Substack riconoscibile (i domini personalizzati potrebbero non essere interpretati), mentre publication_posts accetta direttamente link con domini personalizzati.Substack: pagine autore e siti delle pubblicazioni sono indirizzi distinti — Un handle autore di Substack corrisponde a substack.com/@handle, mentre i siti web delle pubblicazioni possono usare subdomain.substack.com. Questo riferimento verifica le differenze tra oggetti e indirizzi; la risoluzione dei domini personalizzati resta strettamente vincolata alle regole dei parametri dell'azione corrispondente in questa pagina. · Verificato
Cosa significano i parametri publication_posts di API di Substack?
Elenca i post di una pubblicazione Substack. Ogni post ha titolo, sottotitolo, autore, like, commenti, numero di parole, tempo di lettura e stato a pagamento. Restringi per formato con content_type o per data con since e until. Il testo dietro paywall resta bloccato, e un batch potrebbe non coprire l'intero archivio.
urlObbligatorio- Specifica il link alla risorsa Substack di destinazione. Usa la home page della pubblicazione per publication e publication_posts, oppure link diretti /p/ ai post per post e comments. L'azione publication richiede un URL con un handle Substack riconoscibile (i domini personalizzati potrebbero non essere interpretati), mentre publication_posts accetta direttamente link con domini personalizzati.
content_typeFacoltativo- Filtra i post della pubblicazione per formato con all_types, newsletter_posts_only, podcast_episodes_only o threads_only. La presenza del campo va verificata nei link dei singoli post e impostare questo valore non sblocca i contenuti dietro paywall.Valori ammessi:
all_typesnewsletter_posts_onlypodcast_episodes_onlythreads_onlySubstack: formati articolo, audio e video e permessi sui contenuti — Substack classifica i post di testo, audio e video come formati di contenuto distinti e mantiene una netta separazione tra materiali pubblici e articoli privati. Il parametro `content_type` in questa pagina usa i propri valori ammessi, che non aggiungono tipi video né garantiscono che filtro e recupero siano verificati su ogni percorso di esecuzione. · Verificato sinceFacoltativo- Specifica la data di inizio, come stringa, per filtrare post o feed di attività in un intervallo di date. La sua presenza tra i parametri condivisi di profile o publication non abilita il filtro per data di creazione dell'account.
untilFacoltativo- Specifica la data di fine, come stringa, per filtrare post o feed di attività insieme a since. Questo parametro non rappresenta la data di scadenza dell'abbonamento né avvia un'esportazione completa dell'archivio storico.
Cosa significano i parametri post di API di Substack?
Leggi un singolo post Substack dal suo link /p/. Ottieni titolo, sottotitolo, testo, autore, pubblicazione, conteggi di engagement e se si tratta di contenuto a pagamento. Il testo dietro paywall non viene sbloccato. I commenti si ottengono con l'azione separata comments.
urlObbligatorio- Specifica il link alla risorsa Substack di destinazione. Usa la home page della pubblicazione per publication e publication_posts, oppure link diretti /p/ ai post per post e comments. L'azione publication richiede un URL con un handle Substack riconoscibile (i domini personalizzati potrebbero non essere interpretati), mentre publication_posts accetta direttamente link con domini personalizzati.Substack: le anteprime gratuite non sono articoli completi a pagamento — Substack consente ai creator di configurare anteprime gratuite e la posizione del paywall negli articoli a pagamento. Di conseguenza un testo non vuoto non dimostra che sia stato recuperato il contenuto completo, e impostare is_paid o filtrare i contenuti a pagamento non concede l'accesso in lettura. · Verificato
Cosa significano i parametri comments di API di Substack?
Estrai i commenti sotto un post Substack. Ottieni autore, like, numero di risposte e flag per risposte, commenti fissati e interventi dell'autore del post. Passa il link /p/ del post. Il batch potrebbe non contenere l'intera conversazione.
Riferimento API completo: parametri, esempi di codice, esempio di risposta e statourlObbligatorio- Specifica il link alla risorsa Substack di destinazione. Usa la home page della pubblicazione per publication e publication_posts, oppure link diretti /p/ ai post per post e comments. L'azione publication richiede un URL con un handle Substack riconoscibile (i domini personalizzati potrebbero non essere interpretati), mentre publication_posts accetta direttamente link con domini personalizzati.Substack: commenti nascosti e commenti eliminati — Le Reply Rules di Substack consentono agli autori di nascondere i commenti agli articoli o le risposte alle Notes invece di eliminarli definitivamente. L'assenza di un commento nei risultati pubblici non dimostra che sia stato eliminato, e questa interfaccia non può accedere alle dashboard di moderazione, ripristinare contenuti nascosti o modificare le regole. · Verificato
Cosa significano i parametri profile di API di Substack?
Trova il profilo di un autore Substack dal suo handle. Ottieni nome visualizzato, bio, avatar, username Twitter collegato e le pubblicazioni associate all'account. Accetta un handle semplice, un @handle o un link substack.com/@. Descrive la persona, non una pubblicazione, e non mostra dati sugli abbonamenti.
Riferimento API completo: parametri, esempi di codice, esempio di risposta e statousernameObbligatorio- Specifica l'handle del creator per profile o notes, come handle semplice (con prefisso @ facoltativo) o come link completo substack.com/@user. L'azione notes recupera brevi aggiornamenti del creator, non i post lunghi delle pubblicazioni.Substack: handle degli autori, nomi visualizzati e profili pubblici — Un handle Substack univoco forma l'URL del profilo dell'autore, mentre nomi visualizzati e bio si possono modificare in modo indipendente. Per questo la pagina distingue username da display_name e non dichiara di poter leggere abbonamenti nascosti o attività di like. · Verificato
Cosa significano i parametri notes di API di Substack?
Raccogli le Notes di un autore Substack, i post brevi tenuti separati dalle newsletter, con testo, tipo, like e ora di pubblicazione di ciascuna. Elenca solo le Notes di un autore, non è una ricerca su tutto il sito, e potrebbe non coprire l'intera cronologia.
Riferimento API completo: parametri, esempi di codice, esempio di risposta e statousernameObbligatorio- Specifica l'handle del creator per profile o notes, come handle semplice (con prefisso @ facoltativo) o come link completo substack.com/@user. L'azione notes recupera brevi aggiornamenti del creator, non i post lunghi delle pubblicazioni.Substack: cosa sono Notes e Restack — Substack definisce Notes come attività di contenuti brevi e Restack come la condivisione di contenuti all'interno di Notes, distinguendoli dall'invio della newsletter articolo per articolo. Le funzionalità ufficiali di Substack per pubblicazione, engagement e analisi dei ricavi non significano che questo endpoint di lettura delle note supporti quelle operazioni o metriche. · Verificato
Come usare l'API di Substack
- 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":"substack","action":"search","params":{"keyword":"<keyword>"}}'
Domande sull'API di Substack
Cosa posso ottenere con l'API di Substack?
Imposta platform su substack. Il catalogo attuale elenca ricerca, pubblicazione, post della pubblicazione, dettagli del post, commenti e more. Questi nomi di azione identificano oggetti o viste diversi di Substack; non sono modalità di ricerca intercambiabili.
Quale input avvia la richiesta search di Substack?
Specifica la stringa di query per trovare newsletter e pubblicazioni Substack. Non esegue ricerche full-text nel corpo dei post. Invialo come keyword all'interno di params.
Quali campi può restituire search di Substack?
Il suo schema dichiarato include handle, name, custom_domain e bio. Un campo dichiarato può comunque mancare in un singolo record, e ogni altra azione ha il proprio elenco di campi.
Tutte le azioni di Substack 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.