Inconsistence between documentation & usage



I’m working with the twitter Public API right now,
I spotted some inconsistencies:

  • There is 95 endpoints documented in the Public API (most of them with rate limit).
  • Only 36 are documented in the rate limit charts.
  • A call to the application/rate_limit return 76 endpoints rate limit informations.

From the call to the api rate limit, I have some totally undocumented endpoints like:

Also, the call doesn’t return rate limit for endpoints documented as rate-limited.

You can find on this gist the list of all endpoints:

I didn’t push the analyse further, but is there any way to get a find a documentation of the api ? Even a technical schema would be fine (json schema of the API etc).