get_cohort
POST/v1/tools/get_cohort
Open one niche: its gloss with labeling confidence, size, the distribution of its members over quality index bands, scale bands, growth bands, countries and site types in whole percents, its position in the hierarchy — parent, children, neighboring niches — and a stable sample of member projects as cards. Opening the niche itself spends no coverage; every parent, child, neighbor and sample member shown to your organization for the first time this period costs the first-seen price on top of the base price and spends one unit of coverage, so ask only for the parts you need. Use the hierarchy to widen or narrow the market definition instead of searching again. It takes a niche id: to find a niche by words or by conditions use search_cohorts.
Request
Responses
- 200
- 400
- 401
- 402
- 403
- 409
- 413
- 415
- 429
- 500
- 503
The tool's answer, or with estimate: true its estimate, whose data is a Quote holding quote_token
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, limit_exceeded, invalid_quote_token, unknown_filter_value
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
Not enough credits: insufficient_balance, quota_exhausted
Response Headers
The request's id: quote it when you write to Megido support
Not allowed for your organization or your key: org_suspended, coverage_exceeded
Response Headers
The request's id: quote it when you write to Megido support
In conflict with the state of a quote, the corpus or a task: quote_expired, quote_spent, quote_outdated, confirmation_required, corpus_updated, cohort_rebuilt
Response Headers
The request's id: quote it when you write to Megido support
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, tool_unavailable
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