HackerReposA FIELD GUIDE TO OPEN SOURCE
ProSponsor the shelf♧ 0
← Back to top all-time
jamalex
notion-py
Python2019–2022
jamalex / notion-py

notion-py

Unofficial Python API client for Notion.so

8Distinct people
8Mentions
0Explicit recommenders
4.4KGitHub stars
REPOSITORY AT A GLANCE

What to know before exploring

What it is

Unofficial Python API client for Notion.so

GitHub

Where it is used

No documented product use has been verified yet.

What people are saying

No recommendation phrase was found in the indexed comments.

No classified warning is attached to this page. Read the discussions before treating silence as approval.

Also in these discussions

Mentioned in the same Hacker News threads. That is not proof they are substitutes.

This week on Hacker News

Nov 7–Nov 14 UTC · Direct repository links and separately labeled related project stories. Indexed through 11/14/2026, 3:56:07 PM UTC.

No direct repository links were found in the indexed HN discussions over the past seven days. Older discussions are available below.

Mentions over time

HN mentions by year8 dated mentions

Observed mentions: 2019-01-18 15:44:43 UTC to 2022-03-15 19:24:29 UTC.

01232019-01-01 00:00:00 UTC to 2020-01-01 00:00:00 UTC (exclusive): 2 mentions; 1 submissions, 1 comments20192020-01-01 00:00:00 UTC to 2021-01-01 00:00:00 UTC (exclusive): 2 mentions; 0 submissions, 2 comments20202021-01-01 00:00:00 UTC to 2022-01-01 00:00:00 UTC (exclusive): 3 mentions; 0 submissions, 3 comments2022-01-01 00:00:00 UTC to 2023-01-01 00:00:00 UTC (exclusive): 1 mentions; 1 submissions, 0 comments2022

Counts come from the repository’s dated source evidence. Index cutoff: 2026-11-02 08:16:59 UTC.

View mention counts and date ranges
UTC ranges include their start and exclude their end. Select a period to filter the source evidence.
PeriodStart (UTC)End (exclusive, UTC)MentionsSubmissionsComments
20192019-01-01 00:00:00 UTC2020-01-01 00:00:00 UTC211
20202020-01-01 00:00:00 UTC2021-01-01 00:00:00 UTC202
20212021-01-01 00:00:00 UTC2022-01-01 00:00:00 UTC303
20222022-01-01 00:00:00 UTC2023-01-01 00:00:00 UTC110

What Hacker News says

8 sources
Slightly unrelated, but notion's unofficial python API is cool AF! https://github.com/jamalex/notion-py It's way more powerful than their official API. The official API can only interact with databases, which (as anyone who uses Notion knows) is a tiny subset of the overall things you want to use Notion for. The unofficial Python API lets you have complete programmatic access to all notion pages. The tradeoff is that certain things break. However, after reading the code, I found it quite easy to fix the problems I ran into (https://github.com/jamalex/notion-py/pull/345) and I suspect you'll be able to do the same. (I empathize with maintainers not prioritizing their open source work ahead of family life, business, etc.) Was surprised that it was even possible to have a nice Python class for every possible Notion object, let alone control
Read the rest
them and update them on the fly. I wish their official API would be as flexible. Maybe one day.
In Lessons learned from sharding Postgres at Notion
This is a great news. I've been toying with the idea of generating parts of my blog from notion. There are currently some projects which reverse-engineered the API and provide an "unofficial" clients [1][2]. The problem though is that I'd like to blog to be minimum maintenance after a spike of work and I'm afraid the unofficial clients will inevitably break and will require updates. The problem with the current beta is the limits of the API. E.g. code block are not supported[3], so you can't really use it to generate a technical blog. Looking forward to the GA :) [1]: https://github.com/jamalex/notion-py [2]: https://github.com/kjk/notionapi [3]: https://developers.notion.com/reference/get-block-children
In Notion API – public beta
I have been using Notion in its API form for a while through notion-py[1]. Currently, it powers my blog[2] and for me, it's a really good integration. I write something, ask my friends to review it. I run a command to publish it, and it's live. The workflow is really, really good and removes a ton of friction because the software that you write in is also the one that powers your blog's content. Overall, I think Notion API can open up many, many possibilities, since it can become a really good CMS, besides already being a great note-taking tool, and a team app. Notion has millions of users, and it's a huge market already. Btw, if you're interested in running your blog on Notion, I would love to hear from you! [3] [1]: https://github.com/jamalex/notion-py [2]: https://shubhamjain.co/ [3]: https://twitter.com/shubhamjainco
In Notion API – public beta
We combined different approaches to make it work: First, inspecting all network requests that are happening on the web client. That helped to inspect all requests made to read a page and edit content (a lot of data is transiting, maybe that's why it's slow on the startup...). And then I realized there were few existing open-source projects that already done that (https://github.com/kjk/notionapi and https://github.com/jamalex/notion-py), but there were lacking an HTTP API endpoint so that we can easily plug them that to Zapier/Integromat or a Webhook. These two repo didn't had a way to convert a Markdown to a Notion content - which would make it complicated to know every type of blocks that makes a Notion page. Finally you needed to be tech-savvy to be able to deploy the open-source projects and there wasn't any simple integration SaaS ou
Read the rest
t there – so it was limiting a large section of people who use Notion extensively, and are familiar with automation tools.
In Show HN: We reverse engineered Notion’s API and built 30 automations

MAKE YOURSELF AT HOME

A few shortcuts

/
Search the collection
?
Open this guide
Esc
Close dialogs and navigation

Your saved repositories and interests stay in this browser.