search_projects
POST/v1/tools/search_projects
Find projects by a description of the idea, by similarity to one or more projects already on hand, or by conditions on their measured profile — quality axes, scale band, growth direction, country, site type — in any combination. Every project in the corpus is a site where revenue has been observed; how much a site earns and what it charges is not part of this corpus. Returns cards: id, short description, site type, quality index, scale band, growth, main country and niche. The domain appears only on projects your organization has revealed; reveal_project turns a card into a domain. With text or seed projects, the results are the projects closest in meaning, the seeds themselves left out; sorting by index, scale or growth then orders the closest ones only, as many as relevance_pool in capabilities. Costs the base price plus the first-seen price for every project shown to your organization for the first time this period, and each such project spends one unit of coverage; without limit a call returns as many rows as list_max in capabilities allows. Call with estimate: true to see the price and get a quote_token first. Use it when your user describes a kind of site or the niche is already known; for a market question start with search_cohorts, and for a domain your user already has use lookup_domain.
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, 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