What are the exact headers returned by the Notion API when you exceed the rate limit and how should our client handle them
Download run
Fan-out diagram
The searches the AI actually ran for this prompt.
SEED QUERY
What are the exact headers returned by the Notion API when you exceed the rate limit and how should our client handle them
1 real search · 1 real-search pass
Notion API rate limits 429 response headers Retry-After documentationGoogle ↗
OBSERVEDReason
Badge and edge weight = share of passes that produced the query. Hover a query for its intent and routing format.
Query classes
Google's semantic query class for every sub-query: what kind of answer each search is after, simulated vs real.
ChatGPT real searches (1)
Classes come from the query-classifier (a local Laya model). 1 of 1 calls are low-confidence (under 50%) — hover a query in the table to see its confidence.
Searches and sources
ChatGPT1 real searches · gpt-6
Notion API rate limits 429 response headers Retry-After documentation Google ↗
- API Reference · notion.notion.site
- Request limits - Notion API · notionapi.apidog.io
- Rate limit waits in the response body · creatorstoolbox.com
- New Notion API Changelog Entry: September 9, 2026 · Issue #395 · ramnes/notion-sdk-py · github.com
- Notion Rate Limits: 180 per minute per connection · jitterflow.io
- Faster retries and plan-based rate limits · creatorstoolbox.com