reveal_project
POST/v1/tools/reveal_project
Turn project ids into domains, along with the project's other domains (regional versions, mirrors) and, when known, the service through which the project entered the corpus: a payment service or platform on whose page its visitors complete payment. Costs the base price plus the reveal price for every project your organization has not already revealed, by this tool or by a lookup_domain hit; a newly revealed project also spends one unit of coverage if it was not seen this period. A reveal lasts for the whole organization as many days as capabilities reports in reveal_ttl_days: while it holds, every later response shows the domain automatically at no further charge, revealing the project again neither charges nor extends it, and after it lapses the project is anonymous again until revealed anew. Reveal only the projects your user needs named: descriptions, bands and niches are readable without it. For a domain your user already has, lookup_domain finds and reveals its project without the reveal price.
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