Please log in to access your API credentials and start using our APIs.
Log In & Start Free Trial
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
| Field | Type | Required | Description |
|---|---|---|---|
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_nameorproduct_serviceomitted.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
- Experiment with the Company CheckSeller Playground.
- Review other endpoints: Company Search and Company Enrichment.