Please Log In

You need to log in to access your API credentials and start using our APIs. Start with our free trial!

Log In & Start Free Trial

Try the API Playground

Test this endpoint with real requests in the interactive playground. Queue seller checks, poll for results, and review JSON responses.

Launch CheckSeller Playground

Verify whether a company sells or provides a specific product or service. Responses are generated asynchronously with structured output.

Related Endpoints

Overview

API Endpoint

https://api.nyne.ai/company/checkseller
  • Endpoint: POST /company/checkseller
  • Delivery: Receive a request_id, poll for completion, or provide a callback URL.
  • Credits: 2 credits when a verdict is produced.
  • Use Cases: Product mapping, competitive intelligence, and sales enablement.

Authentication

Include your API key and secret in every request:

Headers
X-API-Key: your_api_key_hereX-API-Secret: your_api_secret_here

Rate Limits

Seller checks consume credits and respect your account limits:

  • Per Minute: 60 requests
  • Per Hour: 1000 requests
  • Monthly: Varies by plan

Credit Usage

API credits are consumed for seller verification requests:

  • CheckSeller Verification: 2 credits per completed verification

Credit Efficiency

Credits are charged when a verdict (yes/no/unknown) is produced. If the request fails or times out, no credits are charged.

POST /company/checkseller

Queue a seller check for the specified company/product pair.

POST /company/checkseller

Request Body

FieldTypeRequiredDescription
company_name string required Legal or commonly used company name.
product_service string required Product or service to test (e.g. “SOC 2 automation platform”).
callback_url string optional HTTPS URL to receive the completed payload automatically.

Example Request

{ "company_name": "Acme Cloud", "product_service": "SOC 2 compliance automation", "callback_url": "https://example.com/webhooks/checkseller" }

cURL Example

Queue a Seller Check 
curl -X POST https://api.nyne.ai/company/checkseller \
  -H "X-API-Key: your_api_key_here" \
  -H "X-API-Secret: your_api_secret_here" \
  -H "Content-Type: application/json" \
  -d '{
    "company_name": "Acme Cloud",
    "product_service": "SOC 2 compliance automation"
  }'

Immediate Response

{ "success": true, "data": { "request_id": "cocs_64f2d8e4_1700000123", "status": "queued", "message": "Company seller check queued. Use GET /company/checkseller?request_id=... to check status.", "callback_url": "https://example.com/webhooks/checkseller" }, "timestamp": "2025-11-10T22:20:03Z" }

GET /company/checkseller

Poll for completion or retrieve cached results.

GET /company/checkseller

Query Parameters

  • request_id (string, required) – identifier returned by the POST call.

cURL Example

Poll for Results 
curl -X GET "https://api.nyne.ai/company/checkseller?request_id=cocs_64f2d8e4_1700000123" \
  -H "X-API-Key: your_api_key_here" \
  -H "X-API-Secret: your_api_secret_here"

Completed Response

{ "success": true, "data": { "request_id": "cocs_64f2d8e4_1700000123", "status": "completed", "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." }, "created_on": "2025-11-10T22:20:03Z", "completed_on": "2025-11-10T22:20:17Z" }, "timestamp": "2025-11-10T22:20:17Z" }

Callback Payload

If callback_url is provided, the same JSON structure is POSTed to your endpoint once the verdict is ready.

Callback Example
POST https://example.com/webhooks/checkseller
Content-Type: application/json

{
  "request_id": "cocs_64f2d8e4_1700000123",
  "status": "completed",
  "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."
  },
  "created_at": "2025-11-10T22:20:03Z",
  "completed_at": "2025-11-10T22:20:17Z"
}

Error Codes

  • missing_parameters – company_name or product_service omitted.
  • invalid_callback_url – Callback URL must be HTTPS.
  • subscription_required – Account lacks enrichment access.
  • rate_limit_exceeded / monthly_limit_exceeded – Usage limits exceeded.

Next Steps

Try EZ Tool for a no-code interface | Open Playground