capabilities
POST/v1/tools/capabilities
List the tools of the API and what each one charges for, what the corpus is, the closed vocabularies their filters accept — countries, site types, niche levels (cohort_levels; level 1 holds the narrowest niches and each higher level groups the niches of the level below), index axes, banding schemes with their numeric boundaries — the per-call limits in force for your organization, its plan and the free quota the plan includes, and the disclosure rules that govern what is returned before and after a project is revealed. Free. Read it before you write filters instead of guessing their values: unknown values are rejected, not ignored. Its vocabularies and prices are the same from call to call; the plan, quota and limits it reports follow your organization; what your organization has left to spend is in usage.
Request
Responses
- 200
- 400
- 401
- 413
- 415
- 429
- 500
- 503
The tool's answer
Response Headers
The request's id: quote it when you write to Megido support
The request cannot be served as sent: bad_request, invalid_params
Response Headers
The request's id: quote it when you write to Megido support
No key, or a key the API does not take: unauthorised
Response Headers
The request's id: quote it when you write to Megido support
Bearer realm="megido": send an API key of your organization as a Bearer token
The body is larger than the API takes: bad_request
Response Headers
The request's id: quote it when you write to Megido support
The body is not sent as application/json: bad_request
Response Headers
The request's id: quote it when you write to Megido support
Too many calls: rate_limited
Response Headers
The request's id: quote it when you write to Megido support
Seconds to wait before calling again; sent with rate_limited and lock_timeout only
The call failed on Megido's side: internal_error
Response Headers
The request's id: quote it when you write to Megido support
Not available just now: service_unavailable, lock_timeout
Response Headers
The request's id: quote it when you write to Megido support
Seconds to wait before calling again; sent with rate_limited and lock_timeout only