discoveries

Trigger a discovery (by ICP id or inline criteria).

Debits 100 credits (the per-discovery cost) and queues a discovery. The body is EITHER {icpId} (runs a saved ICP's criteria) OR inline DiscoveryCriteria — mutually exclusive, and ENFORCED: mixing them is a 400 schema_validation_failed rejected before any debit, never a silent "the saved ICP won and your inline fields were discarded". The lone exception is the warn-and-confirm control acknowledge_low_yield, which may accompany icpId. X-Idempotency-Key is required. An unknown icpId refunds the debit and returns 404.

post/api/v1/discoveries

Request

  • Base URL: https://api.prosp.cc
  • URL: https://api.prosp.cc/api/v1/discoveries
  • Auth: OAuth 2 (client credentials, token URL https://prosp-mcp-641053169627.auth.eu-central-1.amazoncognito.com/oauth2/token, scopes: mcp/execute)

Headers

X-Idempotency-Keystring required

Client-generated key that makes execute safe to retry.

Request body

OR
OR

Example request

{
  "query": "Find retail partners in Europe",
  "industries": [
    "Retail",
    "Fashion"
  ],
  "locations": [
    "Germany",
    "Austria"
  ],
  "language": "de"
}

Response

Queued, or the existing job for a duplicate (idempotency key or query).

OR

Example response

{
  "poll_after_seconds": 20,
  "estimated_duration_seconds": 2900,
  "estimated_duration_p50_seconds": 1140,
  "estimated_duration_p90_seconds": 2400,
  "estimated_duration_p95_seconds": 2900,
  "estimated_yield": 4
}

Changes

No recorded changes to this operation across all 1 revision of this API.