I’ve been trying to find the OpenAPI specification for the Notion API, but no luck so far. The API reference looks like it’s made from an OpenAPI spec, but I can’t find the actual YAML or JSON file anywhere.
Does anyone know if Notion makes this available? It would be super helpful for my project. I’ve checked their docs and GitHub, but maybe I missed something?
If you’ve come across it or know where to look, please let me know. Thanks!
I’ve actually been in a similar situation with Notion’s API recently. From my experience, Notion doesn’t publicly provide their OpenAPI specification. It’s frustrating, I know. I ended up having to manually build my own OpenAPI spec based on their documentation.
If you’re comfortable with it, you could try reaching out to Notion’s developer support. They might be able to provide more insight or even share the spec if it exists internally. Another option is to use a tool like Swagger Inspector to generate an OpenAPI spec by making calls to the API endpoints. It’s not perfect, but it can give you a starting point.
Alternatively, there are community-created unofficial OpenAPI specs for Notion floating around on GitHub. Just be cautious, as these aren’t official and may not be up-to-date with the latest API changes.
hey there! i’ve been using notion api for a while now, and sadly they don’t have an official openapi spec available publicly. it’s kinda annoying tbh. you could try making your own based on their docs, or check github for community-made specs. just be careful cuz they might not be 100% accurate. good luck with your project!
I’ve been working extensively with Notion’s API, and unfortunately, I haven’t come across an official OpenAPI spec either. It’s a common pain point for developers trying to integrate with Notion.
In my experience, the best approach has been to create a custom OpenAPI specification based on their documentation. It’s time-consuming, but it gives you full control over the structure. I’ve found tools like Stoplight Studio helpful for this process.
Another option is to check out some of the community-driven efforts on GitHub. While not official, some developers have created fairly comprehensive specs that can serve as a good starting point. Just remember to validate against the official docs, as these community versions may not always be up-to-date.
If you’re set on an official spec, consider reaching out to Notion’s developer relations team. They might have more information or could potentially point you in the right direction.