# substack.post **stable** **Standard** Fetch a Substack post by slug. `GET /v1/substack/post` ## What you get One Substack record in Onekey's unified shape, in `data`. If the record does not exist you get a `404 not_found` and are not charged. ## What it costs - **Standard · 1 credit** for a fresh fetch, charged only when it succeeds. - **Free when served from cache (0.2 credit for a cached response over 100 KB).** - **Free** if the request is invalid (never charged) or the source fails or reports not found (refunded). ## Parameters | Name | Type | Required | Default | What it is | Constraints | | --- | --- | --- | --- | --- | --- | | `pub` | string | yes | (required) | Allowlisted Substack publication host, e.g. www.astralcodexten.com | max 253 chars; must match `[a-z0-9.-]{3,253}`; trimmed, lowercased | | `slug` | string | yes | (required) | Post slug | max 150 chars; must match `[a-z0-9][a-z0-9-]{0,150}`; trimmed, lowercased | ## Request ```bash curl "https://api.onekey.dev/v1/substack/post?pub=www.astralcodexten.com&slug=open-thread-435" \ -H "x-api-key: YOUR_API_KEY" ``` ```python import requests res = requests.get( "https://api.onekey.dev/v1/substack/post", params={"pub": "www.astralcodexten.com", "slug": "open-thread-435"}, headers={"x-api-key": "YOUR_API_KEY"}, ) body = res.json() if body["success"]: print(body["data"]) else: print(body["error"]["code"], body["error"]["message"]) ``` ```javascript const params = new URLSearchParams({ pub: "www.astralcodexten.com", slug: "open-thread-435" }); const res = await fetch(`https://api.onekey.dev/v1/substack/post?${params}`, { headers: { "x-api-key": "YOUR_API_KEY" }, }); const body = await res.json(); if (body.success) console.log(body.data); else console.error(body.error.code, body.error.message); ``` ## Recorded response A real Substack response, recorded and returned in Onekey's shape. Fields the platform does not provide are `null`. ```json { "success": true, "data": { "content": { "id": "199202126", "title": "Open Thread 435", "url": "https://www.astralcodexten.com/p/open-thread-435", "createdAt": "2026-05-25T16:11:06Z", "text": "This is the weekly visible open thread. Post about anything you want, ask random questions, whatever. ACX has an unofficial subreddit , Discord , and bulletin board , and in-person meetups around the world . Most content is free, some is subscriber only; you can subscribe here . Also: 1: Thanks to everyone who sent in a book review contest entry. I’ll have finalist voting up within a week or two. 2: 80,000 Hours, an effective altruist career advice organization, is publishing their book 80,000 Hours: How To Have A Fulfilling Career That Does Good . Along with talking about how to most effectively do good, it also discusses which careers are most likely to be automated by AI soonest (and I trust Ben to have high-quality thinking on this topic). Release date is tomorrow, but if you’re fast you can preorder today for special bonuses. 3: I filled out my early ballot for the California primary election (Alameda County); if you’re interested you can find my choices and explanations