lookup_domain
POST/v1/tools/lookup_domain
Check whether given domains are in the corpus. A hit returns a revealed card (project id, domain, short description, site type, quality index, scale and growth bands, main country, niche and, when known, the payment service), the project's other domains (regional versions, mirrors) and the profile parts available for the project. This is the only tool that accepts a raw domain; a scheme, a path, a leading www and a trailing dot are stripped, other subdomains are kept and usually miss. A domain known as another address of a project in the corpus (a regional version, a mirror or a redirect) returns that project, with mirror_of naming its domain. Every distinct submitted domain is charged the base price, including those not found unless charges_empty of lookup_domain in capabilities is false; a miss returns found: false and nothing else. A hit reveals the project to your organization for as many days as reveal_ttl_days in capabilities at no reveal price, exactly as reveal_project would, and spends one unit of coverage if your organization has not seen the project this period; reveal_project adds nothing for a project found here.
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
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
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
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