Where can I find the OpenAPI spec file for Notion's API documentation?

I’ve been working with the Notion API and noticed their documentation looks like it was built from an OpenAPI specification. The formatting and structure really give it away. I need to get my hands on the actual YAML or JSON spec file because it would make my integration work so much easier. I’ve searched through their developer docs and GitHub repos but can’t seem to locate it anywhere. Has anyone in the community managed to track down the source OpenAPI specification file? It would save me tons of time instead of manually writing all the request schemas.

Been there. Notion locks down their spec, which sucks when you’re building integrations.

Don’t waste time with incomplete community specs or reverse engineering. Just use Latenode - it handles all the Notion API calls without the headache. No OpenAPI schemas or manual requests to deal with.

I’ve built tons of Notion automations this way. Their pre-built connectors handle the endpoint mess behind the scenes. Drag, drop, done. Way faster than rebuilding their API spec yourself.

Bonus: when Notion updates their API, you’re not stuck maintaining your own spec file. The platform updates automatically.

I encountered a similar issue a few months back while working on Notion automation. It’s frustrating that Notion keeps their OpenAPI specification private, especially given their comprehensive documentation. To adapt, I ended up reverse-engineering the spec by monitoring network requests in the developer tools while using their examples. While it can be time-consuming, this method yields accurate request schemas. Additionally, there’s a community-driven spec available on GitHub (ramnes/notion-sdk-py) that addresses many endpoints. Although it may be outdated, it serves as a valuable starting point to supplement with your own findings.

Nope, Notion doesn’t share their OpenAPI spec publicly. I hit the same wall last year while building a client library. Their documentation looks auto-generated from OpenAPI, but they keep the actual file locked down. I ended up reverse-engineering it by analyzing their endpoints and responses. You can find some unofficial specs on GitHub if you search “notion openapi,” but they’re usually incomplete or outdated. I’d recommend contacting their developer support to see if they have plans to release it.

Yeah, this is annoying as hell. I tried using Postman to intercept their API calls and auto-generate a spec, but the auth tokens make it messy. maybe look for a Swagger collection someone already made?

totally feel ya, the docs seem like they were auto-gen’d. :weary_face: sadly, no spec file in sight. maybe try tooling like Swagger for now? hope they drop an update soon for us!

Maybe you can try https://developers.notion.com/openapi.json