Nyne Nyne API Login
Company APIs

CheckSeller

Ask whether a company sells or provides a specific product or service. Both company_name and product_service are required. The request is queued asynchronously and returns a request_id; poll the status endpoint or supply a callback_url. The completed result carries a verdict (sells), a confidence level, and supporting evidence. A credit is charged only when a verdict is produced.

POST https://api.nyne.ai/company/checkseller API key

Manual credentials take precedence over your account key.

Try it needs these required parameters:

Overview

Verify whether a company sells a given product or service.

Parameters

company_name string required
Legal or commonly used company name. Max 255 chars.
product_service string required
Product or service to test for, e.g. “SOC 2 automation platform”. Max 255 chars.
callback_url string optional
http(s) URL on an allowed host that receives the completed payload automatically.

Polling for the result

This endpoint is asynchronous. A successful submit returns a request_id while the job runs in the background. Poll the same path with a GET request - same authentication headers - passing the request_id as a query parameter:

Loading your API credentials...

Each poll returns the job's current status; once it is completed the payload carries the result shown under Responses. Polling an unknown or expired request_id returns 404 request_not_found.

Status Meaning
queued · processing · pending The job is still running - keep polling.
completed The job finished; the payload carries the result and completed: true.
failed Terminal - the job could not complete; the error field explains why.

Poll every few seconds at first, backing off for long-running jobs. Polling is free - status checks never burn credits.

Prefer push delivery?
Supply the optional callback_url parameter and the completed payload is POSTed to your endpoint when the job finishes - no polling required. Delivery is retried up to 5 times with exponential backoff (1s, 5s, 15s, 1m, 5m) and a 30-second timeout per attempt; respond with a 2xx status to acknowledge receipt.

Credit usage

Credits are charged based on the matched configuration. The listed cost is the per-result unit price.

Feature Credits Notes
CheckSeller - Charged once when a verdict (yes/no/unknown) is produced
No data 0 No verdict / failure never burns credits
Heads up
A positive credit balance is required before each request. Empty results do not burn credits.

Responses

202 Seller check queued - poll the status endpoint with the returned request_id
400 missing_parameters / invalid_parameters / invalid_callback_url
401 Missing or invalid API credentials
403 subscription_required or ip_not_allowed
404 no checkseller data found (no credit charged)
429 rate_limit_exceeded / monthly_limit_exceeded
503 service_unavailable - the API is temporarily unavailable

A successful response wraps the payload in the { success, data, timestamp } envelope (also shown live in the panel on the right):

{
  "success": true,
  "data": {
    "request_id": "64f2d8e4cs1f065a9b4e7fbc3df6aabb_1700000123_3310",
    "status": "completed",
    "completed": true,
    "result": {
      "company": "Acme Cloud",
      "product_service": "SOC 2 compliance automation",
      "sells": true,
      "confidence": "medium",
      "evidence": "Acme Cloud lists SOC 2 automation on its compliance solutions page."
    },
    "completed_on": "2026-01-15T10:35:00Z"
  },
  "timestamp": "2026-01-01T00:00:00"
}