Why use notion-client over @notionhq/client?

[janek]

Description

notion-client is an npm package that's part of this repository, with description "Robust TypeScript client for the unofficial Notion API." . I was wondering why it's used over the official @notionhq/client. I'm sure there's a reason (TS?) - but perhaps it should be mentioned in the docs along with some advice on how to choose between them.

[transitive-bullshit]

Agreed we could definitely improve the docs here.

notion-client came way before the official client was released, and the official client doesn't support all block types and is extremely inefficient for some reason. More detail here https://github.com/NotionX/react-notion-x/tree/master/packages/notion-compat

[janek]

That makes a lot of sense, thank you for answering so quickly (and for all your work)! I did have some weird timeouts using the official API, maybe I'll switch then :)

Leaving it up to you if you want the issue open or closed.

[rowthan]

Is there an API doc for unofficial API？I just want know what kind of API can be call with https://www.notion.so/api/v3