Hey everyone! I’ve been digging around for the OpenAPI specification for Notion’s API. It’s pretty clear that their API docs are generated from one, but I can’t seem to find the actual YAML or JSON file anywhere.
I’d really love to get my hands on this spec. It would be super helpful for a project I’m working on. Has anyone here managed to track it down? Or maybe you know if Notion has made it public somewhere?
If you’ve got any info on this, I’d be really grateful. Thanks in advance for any help!
I’ve been working with Notion’s API for a while, and you’re right - the OpenAPI spec isn’t publicly available. It’s frustrating, especially when you’re trying to integrate or build tools around their API. I tried contacting their support team about this, but they weren’t able to provide the spec.
Instead, I ended up using a tool called Swagger Inspector to analyze their API endpoints and generate a partial OpenAPI spec. It’s not perfect, but it gave me a good starting point. You might want to give that a try.
Alternatively, there are some community-made unofficial specs floating around on GitHub. They’re not complete or officially supported, but they could be helpful for your project. Just be aware that they might not always be up-to-date with the latest API changes.
hey davidw, i actually ran into this same issue a while back. unfortunately notion doesn’t seem to have their openapi spec publicly available i ended up reverse engineering parts of it for my project, but it was a pain. maybe try reaching out to their support team? they might be able to point you in the right direction. good luck!
I’ve been in your shoes, davidw. Notion’s lack of a public OpenAPI spec is indeed frustrating. In my experience, the best approach has been to create a custom spec based on their documentation.
I used a combination of the Postman API platform and manual crafting to build my own OpenAPI spec for Notion. It took some time, but it gave me a workable solution for my projects. The process also helped me understand Notion’s API structure more deeply.
One tip: pay close attention to their pagination and error handling. These areas can be tricky to capture accurately in a custom spec.
Remember, while this approach works, it’s not official and may need updates as Notion evolves their API. Regularly cross-checking with their documentation is crucial to maintain accuracy.
i ended up reverse engineering parts of it for my project, but it was a pain. maybe try reaching out to their support team? they might be able to point you in the right direction. good luck!