API di Substack

Substack Post API

Recupera i post di qualsiasi pubblicazione Substack tramite il suo URL, oppure passa l'URL di un singolo post (…/p/slug) per recuperare solo quell'articolo. Restituisce titolo, sottotitolo, data di pubblicazione, stato del paywall, numero di parole, coinvolgimento (reazioni, commenti, restack), profilo dell'autore, dettagli della pubblicazione, il corpo completo dell'articolo come testo, HTML e Markdown, e thread di commenti facoltativi.

2,86 USD/1k risultati, paghi a richiesta, nessun abbonamento.

Clearheaded
clearheaded.blog
ClearheadedSubscribe
HomeArchiveAbout

Why roadmaps are guesses

Sep · Priya Nakamura

The three-question standup

A shorter standup that actually surfaces risk

PaidSep · Priya Nakamura

Ask me anything: hiring your first PM

Reader questions from last week's thread

Sep · Priya Nakamura

Clearheaded

Type your email…Subscribe

Recommendations

Cosa ha restituito l'APIitems[0]
{
"postId": "148302911",
"title": "Why roadmaps are guesses",
"url": "https://www.clearheaded.blog/p/why-roadmaps-are-guesses",
"slug": "why-roadmaps-are-guesses",
"postType": "newsletter",
"createdUtc": 1758585600,
"wordcount": 2140,
"authorName": "Priya Nakamura",
... 22 campi in più
}
Disponibilità
99,48%
30d · 574 chiamate
Richieste
574
30 g · settimanale, ultime 12 sett.
Risposta
2,8s
mediana · 30d

Provalo

Ottieni Substack Post in una sola richiesta

Apri in
Risposta di esempio
Le esecuzioni gratuite restituiscono solo i primi 3 risultati. Ricarica una chiave per ottenere la risposta completa.

Questo esempio mostra 58 campi su 69. Vedi tutti i campi

{
  "found": true,
  "data": {
    "items": [
      {
        "postId": "148302911",
        "title": "Why roadmaps are guesses",
        "url": "https://www.clearheaded.blog/p/why-roadmaps-are-guesses",
        "slug": "why-roadmaps-are-guesses",
        "postType": "newsletter",
        "createdUtc": 1758585600,
        "wordcount": 2140,
        "authorName": "Priya Nakamura",
        "authorHandle": "priyanakamura",
        "contentStatus": "full",
        "text": "Every roadmap I have shipped was a guess with a deadline attached.",
        "publication": {
          "id": "pub_5521",
          "name": "Clearheaded",
          "url": "https://www.clearheaded.blog",
          "subdomain": "clearheaded",
          "customDomain": "www.clearheaded.blog",
          "description": "Notes on building things without lying to yourself.",
          "image": "https://substackcdn.com/image/fetch/clearheaded/logo.png",
          "language": "en",
          "paymentsEnabled": true,
          "subscriberCount": 38400
        },
        "comments": [
          {
            "commentId": "c_88213",
            "text": "This matches every planning meeting I have sat through for a decade.",
            "createdUtc": 1758600000,
            "authorName": "Devon Okafor",
            "authorHandle": "devonokafor",
            "authorUrl": "https://substack.com/@devonokafor",
            "authorImage": "https://substackcdn.com/image/fetch/clearheaded/devon-avatar.png",
            "reactionCount": 44,
            "restackCount": 2,
            "isPinned": true,
            "isAuthor": false,
            "replies": [
              {
                "commentId": "c_88240",
                "text": "Glad it landed. Curious how your team names the guess out loud.",
                "createdUtc": 1758603600,
                "authorName": "Priya Nakamura",
                "authorHandle": "priyanakamura",
                "authorUrl": "https://www.clearheaded.blog/people/priya-nakamura",
                "authorImage": "https://substackcdn.com/image/fetch/clearheaded/priya-avatar.png",
                "reactionCount": 12,
                "restackCount": 0,
                "isPinned": false,
                "isAuthor": true
              }
            ]
          }
        ]
      },
      {
        "postId": "148190442",
        "title": "The three-question standup",
        "url": "https://www.clearheaded.blog/p/the-three-question-standup",
        "slug": "the-three-question-standup",
        "subtitle": "",
        "description": "A shorter standup that actually surfaces risk",
        "postType": "newsletter",
        "createdUtc": 1757980800,
        "isPaid": true,
        "language": "en",
        "wordcount": 1420,
        "reactionCount": 501,
        "commentCount": 29,
        "replyCount": 6,
        "restackCount": 18,
        "authorName": "Priya Nakamura",
        "authorHandle": "priyanakamura",
        "authorUrl": "https://www.clearheaded.blog/people/priya-nakamura",
        "contentStatus": "preview_only",
        "text": "Most standups answer the same three questions badly. Here is a version that takes six minutes and actually works...",
        "publication": {
          "id": "pub_5521",
          "name": "Clearheaded",
          "url": "https://www.clearheaded.blog",
          "subdomain": "clearheaded"
        },
        "comments": []
      },
      {
        "postId": "148075310",
        "title": "Ask me anything: hiring your first PM",
        "url": "https://www.clearheaded.blog/p/ask-me-anything-hiring-your-first-pm",
        "slug": "ask-me-anything-hiring-your-first-pm",
        "subtitle": "Reader questions from last week's thread",
        "description": "Reader questions from last week's thread",
        "postType": "thread",
        "createdUtc": 1757376000,
        "isPaid": false,
        "language": "en",
        "wordcount": 640,
        "reactionCount": 203,
        "commentCount": 41,
        "replyCount": 9,
        "restackCount": 5,
        "authorName": "Priya Nakamura",
        "authorHandle": "priyanakamura",
        "authorUrl": "https://www.clearheaded.blog/people/priya-nakamura",
        "contentStatus": "metadata_only",
        "publication": {
          "id": "pub_5521",
          "name": "Clearheaded",
          "url": "https://www.clearheaded.blog",
          "subdomain": "clearheaded"
        },
        "comments": []
      }
    ]
  }
}

Riferimento completo di parametri e risposta - ogni campo, tipo ed esempio per questo endpoint.

Riferimento

Una richiesta, una sola forma di risposta.

Ogni campo che invii e ogni campo che ricevi, ciascuno con un esempio reale.

Ultima verifica 2026-11-21 · disponibilità e latenza misurate su 30d

Corpo della richiesta

JSON, inviato a questo endpoint.

  • urlstring

    https://www.clearheaded.blog

    L'URL di una pubblicazione Substack / dominio personalizzato per recuperarne i post recenti (es. https://www.astralcodexten.com), OPPURE l'URL di un singolo post per recuperare solo quell'articolo con il contenuto completo (es. https://www.astralcodexten.com/p/your-book-review).

  • contentTypeenum

    Limita a un solo tipo di post, oppure 'all' (es. newsletter).

  • endDatestring

    Restituisci solo i post pubblicati in questa data o prima, formato YYYY-MM-DD (es. 2024-12-31). Applicato entro gli ultimi 'limit' post analizzati.

  • includeCommentsboolean

    Includi i thread di commenti pubblici e le loro risposte dirette su ogni post (es. true).

  • includeContentboolean

    true

    Includi il corpo completo dell'articolo come testo, HTML e Markdown. Imposta false per i soli metadati, che è più veloce (es. false).

  • limitinteger

    3

    Numero massimo di post recenti da restituire quando viene indicato l'URL di una pubblicazione (1-100, predefinito 25); ignorato per l'URL di un singolo post, che restituisce sempre quel solo post. Paghi per ogni post restituito, quindi un limite più basso costa meno.

  • maxCommentsinteger

    Numero massimo di commenti raccolti per post quando 'includeComments' è true (0-500, predefinito 20). Non costa nulla in più (es. 50).

  • minCommentsinteger

    Restituisci solo i post con almeno questo numero di commenti (es. 10).

  • minReactionsinteger

    Restituisci solo i post con almeno questo numero di reazioni (es. 100).

  • minWordCountinteger

    Restituisci solo i post con almeno questo numero di parole, il che esclude note brevi e annunci (es. 1000).

  • onlyFreeboolean

    Restituisci solo i post gratuiti (senza paywall) (es. true).

  • startDatestring

    Restituisci solo i post pubblicati in questa data o dopo, formato YYYY-MM-DD (es. 2024-01-01). Applicato entro gli ultimi 'limit' post analizzati, quindi alza 'limit' per raggiungere intervalli di date più vecchi.

Tu invii. Un piccolo corpo JSON. I valori mostrati sono esempi da sostituire con i tuoi.

Risposta

JSON, un valore di esempio per campo.

each itemdata.items[]

Post records: title, subtitle, URL, publish date, paywall status, word count, engagement (reactions, comments, restacks), author profile, publication details, the article body as text, HTML and Markdown, and comment threads when requested. Populated whenever the provider has data for the entity.

  • authorBiostring

    Author bio as shown on their Substack profile.

  • authorHandlestring

    priyanakamura

    Substack handle of the post author. Populated whenever the provider has data for the entity.

  • authorImagestring

    Profile photo URL of the post author.

  • authorNamestring

    Priya Nakamura

    Display name of the post author. Populated whenever the provider has data for the entity.

  • authorUrlstring

    Substack profile URL of the post author.

  • commentCountinteger

    Number of top-level comments on the post.

  • contentStatusstring

    full

    How much of the article body this record carries: 'full' for the whole article, 'preview_only' for the public excerpt of a paywalled post, 'metadata_only' when no body was requested or available, or 'failed' when extraction failed. Read this before trusting 'text', 'html', or 'markdown'. Populated whenever the provider has data for the entity.

  • createdUtcnumber

    1758585600

    UTC epoch timestamp in seconds (Unix time). Multiply by 1000 for a JS Date in milliseconds. Populated whenever the provider has data for the entity.

  • descriptionstring

    Short post description, usually the subtitle or an excerpt.

  • hasVoiceoverboolean

    Whether the post carries a narrated audio version.

  • htmlstring

    Article body as HTML. Present when 'includeContent' is true and 'contentStatus' is 'full' or 'preview_only'.

  • imagestring

    Cover image URL.

  • isPaidboolean

    Whether the post is behind a paywall.

  • languagestring

    Two-letter language code of the post.

  • markdownstring

    Article body as Markdown. Present when 'includeContent' is true and 'contentStatus' is 'full' or 'preview_only'.

  • podcastUrlstring

    Audio URL for a podcast post or a narrated voiceover, when the post has one.

  • postIdstring

    148302911

    Substack post identifier. Populated whenever the provider has data for the entity.

  • postTypestring

    newsletter

    Post type (newsletter, podcast, or thread). Populated whenever the provider has data for the entity.

  • reactionCountinteger

    Number of reactions (likes) on the post.

  • replyCountinteger

    Number of replies to comments on the post.

  • restackCountinteger

    Number of times the post was restacked.

  • slugstring

    why-roadmaps-are-guesses

    Post slug, the last path segment of the post URL. Populated whenever the provider has data for the entity.

  • subtitlestring

    Post subtitle or deck.

  • textstring

    Every roadmap I have shipped was a guess with a deadline attached.

    Article body as plain text. Present when 'includeContent' is true and 'contentStatus' is 'full' or 'preview_only'.

  • titlestring

    Why roadmaps are guesses

    Post title. Populated whenever the provider has data for the entity.

  • updatedUtcnumber

    UTC epoch timestamp in seconds (Unix time). Multiply by 1000 for a JS Date in milliseconds.

  • urlstring

    https://www.clearheaded.blog/p/why-roadmaps-are-guesses

    Canonical post URL. Populated whenever the provider has data for the entity.

  • wordcountinteger

    2140

    Approximate word count of the article.

each commentdata.items[].comments[]

Top-level comment threads on the post, each with its direct replies. Empty unless 'includeComments' is true. Replies nested more than one level deep are not returned.

  • authorHandlestring

    devonokafor

    Substack handle of the comment author.

  • authorImagestring

    https://substackcdn.com/image/fetch/clearheaded/devon-avatar.png

    Profile photo URL of the comment author.

  • authorNamestring

    Devon Okafor

    Display name of the comment author.

  • authorUrlstring

    https://substack.com/@devonokafor

    Substack profile URL of the comment author.

  • commentIdstring

    c_88213

    Substack comment identifier.

  • createdUtcnumber

    1758600000

    UTC epoch timestamp in seconds (Unix time). Multiply by 1000 for a JS Date in milliseconds.

  • editedUtcnumber

    UTC epoch timestamp in seconds (Unix time). Multiply by 1000 for a JS Date in milliseconds.

  • isAuthorboolean

    false

    Whether the comment was written by the post author.

  • isPinnedboolean

    true

    Whether the comment is pinned by the publication.

  • reactionCountinteger

    44

    Number of reactions on the comment.

  • restackCountinteger

    2

    Number of times the comment was restacked.

  • textstring

    This matches every planning meeting I have sat through for a decade.

    Comment body text.

each replydata.items[].comments[].replies[]

Direct replies to this comment.

  • authorHandlestring

    priyanakamura

    Substack handle of the reply author.

  • authorImagestring

    https://substackcdn.com/image/fetch/clearheaded/priya-avatar.png

    Profile photo URL of the reply author.

  • authorNamestring

    Priya Nakamura

    Display name of the reply author.

  • authorUrlstring

    https://www.clearheaded.blog/people/priya-nakamura

    Substack profile URL of the reply author.

  • commentIdstring

    c_88240

    Substack comment identifier.

  • createdUtcnumber

    1758603600

    UTC epoch timestamp in seconds (Unix time). Multiply by 1000 for a JS Date in milliseconds.

  • editedUtcnumber

    UTC epoch timestamp in seconds (Unix time). Multiply by 1000 for a JS Date in milliseconds.

  • isAuthorboolean

    true

    Whether the reply was written by the post author.

  • isPinnedboolean

    false

    Whether the reply is pinned by the publication.

  • reactionCountinteger

    12

    Number of reactions on the reply.

  • restackCountinteger

    0

    Number of times the reply was restacked.

  • textstring

    Glad it landed. Curious how your team names the guess out loud.

    Reply body text.

publicationdata.items[].publication

The publication the post belongs to.

  • customDomainstring

    www.clearheaded.blog

    Custom domain the publication is served on, when it has one.

  • descriptionstring

    Notes on building things without lying to yourself.

    Publication tagline or hero text.

  • idstring

    pub_5521

    Substack publication identifier.

  • imagestring

    https://substackcdn.com/image/fetch/clearheaded/logo.png

    Publication logo URL.

  • languagestring

    en

    Two-letter language code of the publication.

  • namestring

    Clearheaded

    Publication name.

  • paymentsEnabledboolean

    true

    Whether the publication sells paid subscriptions.

  • subdomainstring

    clearheaded

    Publication subdomain on substack.com.

  • subscriberCountinteger

    38400

    Subscriber count, when the publication publishes it.

  • urlstring

    https://www.clearheaded.blog

    Publication home URL.

top level
  • foundboolean

    true

    Whether any posts were found for the request.

  • reason"not_found"

    Present only when `found` is false, and says why there is no result. `not_found`: the source states the target does not exist, or returned nothing for it. A `found: false` answer is a successful call, not an error, and `costUsd` is what it actually cost.

Tu ricevi. Campi con nome e tipo nella stessa struttura, qualunque fonte risponda.

FAQ

Sull'API Substack Post

L'API Substack Post di AnyAPI restituisce dati Substack come JSON normalizzato da una sola chiamata POST a /v1/run/substack.posts. Recupera i post di qualsiasi pubblicazione Substack tramite il suo URL, oppure passa l'URL di un singolo post (…/p/slug) per recuperare solo quell'articolo. Restituisce titolo, sottotitolo, data di pubblicazione, stato del paywall, numero di parole, coinvolgimento (reazioni, commenti, restack), profilo dell'autore, dettagli della pubblicazione, il corpo completo dell'articolo come testo, HTML e Markdown, e thread di commenti facoltativi. AnyAPI restituisce un unico schema normalizzato qualunque fonte la serva. Costa 2,86 USD ogni 1.000 risultati, e mai più di 0,289 USD per una singola richiesta, in dollari statunitensi, senza abbonamento e senza minimo mensile. Negli ultimi 30 giorni, il 99,5% delle chiamate Substack Post tramite AnyAPI è riuscito, con un tempo di risposta mediano di 2,8 secondi su 574 chiamate misurate.

Costa 2,86 USD ogni 1.000 risultati, e mai più di 0,289 USD per una singola richiesta, in dollari statunitensi, senza abbonamento e senza minimo mensile. Ricarichi un portafoglio in USD e ogni chiamata lo scala. Alcune richieste fallite finanziate dal portafoglio comportano costi di elaborazione che trasferiamo al costo, senza ricarico; la risposta di errore mostra l'importo addebitato.

Recupera i post di qualsiasi pubblicazione Substack tramite il suo URL, oppure passa l'URL di un singolo post (…/p/slug) per recuperare solo quell'articolo. Restituisce titolo, sottotitolo, data di pubblicazione, stato del paywall, numero di parole, coinvolgimento (reazioni, commenti, restack), profilo dell'autore, dettagli della pubblicazione, il corpo completo dell'articolo come testo, HTML e Markdown, e thread di commenti facoltativi. La risposta è JSON normalizzato con la stessa busta che restituisce ogni endpoint AnyAPI, quindi analizzare un secondo endpoint significa cambiare l'URL e nient'altro.

Negli ultimi 30 giorni, il 99,5% delle chiamate Substack Post tramite AnyAPI è riuscito, con un tempo di risposta mediano di 2,8 secondi su 574 chiamate misurate. Sono misurazioni di AnyAPI sul traffico che passa dal gateway, ricalcolate di continuo, non un obiettivo di livello di servizio pubblicato.

Sì. Un nuovo account AnyAPI parte con 0,10 USD di saldo gratuito e senza bisogno di carta.

Invia una richiesta POST a https://api.getanyapi.com/v1/run/substack.posts con la tua chiave AnyAPI in un header "Authorization: Bearer" e l'input come corpo JSON. La stessa chiave e lo stesso portafoglio funzionano su ogni endpoint AnyAPI.

No. Aggiungi dollari statunitensi a un unico saldo prepagato AnyAPI e ogni richiesta lo scala. Non c'è un piano mensile né un minimo, e lo stesso saldo paga ogni endpoint AnyAPI.

Sì. Installa @getanyapi/sdk da npm per TypeScript o getanyapi da pip per Python. Entrambi chiamano ogni endpoint AnyAPI con la stessa chiave, e funziona anche qualsiasi client HTTP.

Sì. Un agente può collegarsi al server MCP di AnyAPI su https://api.getanyapi.com/mcp, oppure creare da solo la propria chiave di prova gratuita con un POST non autenticato a https://api.getanyapi.com/agent/signup e chiamare questo endpoint via HTTP.