search_cohorts
POST/v1/tools/search_cohorts
Find market niches either by describing them in words or by conditions on the niche itself: size, level in the hierarchy, median quality index, share of growing members (members whose visits grew by more than 10% over the last month), leading country. Every project underneath these niches is a site where revenue has been observed, so a niche here is a market rather than a topic. Returns niche ids with a gloss, the number of member projects and a quality summary — never their member sites. With text, the results are the niches closest in meaning; sorting by size, index or growth then orders the closest ones only, as many as relevance_pool_cohorts in capabilities. Costs the base price plus the first-seen price for every niche shown to your organization for the first time this period, and each such niche spends one unit of coverage; call with estimate: true to see the price and get a quote_token first. This is the cheapest way into a market: use it before searching for projects when the user cannot yet name a single site in the space.
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
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, layer_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