react-notion-x icon indicating copy to clipboard operation
react-notion-x copied to clipboard

Why use `notion-client` over `@notionhq/client`?

Open janek opened this issue 2 years ago • 3 comments
trafficstars

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.

janek avatar Mar 24 '23 15:03 janek

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

transitive-bullshit avatar Mar 24 '23 16:03 transitive-bullshit

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.

janek avatar Mar 24 '23 21:03 janek

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

rowthan avatar May 10 '23 06:05 rowthan