Please log in to access your API credentials and start using our APIs.
Log In & Start Free Trial
Discover relevant companies using location, industry, and keyword filters. Results are generated asynchronously with structured JSON output.
Related Endpoints
Overview
API Endpoint
https://api.nyne.ai/company/search
- Endpoint:
POST /company/search - Delivery: Always asynchronous. Receive a
request_idimmediately, then poll or register a callback. - Credits: 5 credits per completed request.
- Callback Support: Optional
callback_urlto receive results automatically.
Authentication
Authenticate every request with your API key and secret:
Headers
X-API-Key: your_api_key_hereX-API-Secret: your_api_secret_here
Rate Limits
Company search requests count against the following limits for your account:
- Per Minute: 60 requests
- Per Hour: 1000 requests
- Monthly: Varies by plan
Credit Usage
API credits are consumed for company search requests:
- Company Search: 5 credits per completed request
Credit Efficiency
Credits are charged upon successful completion. The cost applies per search request, regardless of the number of companies returned.
POST /company/search
Queue a company search request.
POST /company/search
Request Body
| Field | Type | Required | Description |
|---|---|---|---|
industry |
string | optional* | Industry focus (e.g. “Healthcare SaaS”). Required if website_keyword is not supplied. |
website_keyword |
string | optional* | Keyword that should appear on company sites (e.g. “SOC 2”). Required if industry is omitted. |
location |
string | optional | Geographic filter (city, region, or country). |
max_results |
integer | optional | Maximum results to return (1 - 50). Defaults to 25. |
validate_keyword |
boolean | optional | Fetch each website and retain only companies whose HTML includes website_keyword. |
callback_url |
string | optional | HTTPS endpoint that receives the completed payload. |
Example Request
{
"industry": "SaaS",
"website_keyword": "SOC 2",
"location": "San Francisco Bay Area",
"max_results": 20,
"validate_keyword": true
}
cURL Example
Queue a Company Search
curl -X POST https://api.nyne.ai/company/search \
-H "X-API-Key: your_api_key_here" \
-H "X-API-Secret: your_api_secret_here" \
-H "Content-Type: application/json" \
-d '{
"industry": "SaaS",
"website_keyword": "SOC 2",
"location": "San Francisco",
"max_results": 5
}'
Immediate Response
{
"success": true,
"data": {
"request_id": "cosearch_64f2d8e4_1700000123",
"status": "queued",
"message": "Company search request queued. Poll this endpoint with GET request_id to retrieve results.",
"max_results": 20
},
"timestamp": "2025-11-10T22:15:03Z"
}
GET /company/search?request_id=...
Poll for completion or retrieve cached results.
GET /company/search
Query Parameters
request_id(string, required) – value returned byPOST /company/search.
cURL Example
Poll for Results
curl -X GET "https://api.nyne.ai/company/search?request_id=cosearch_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": "cosearch_64f2d8e4_1700000123",
"status": "completed",
"companies": [
{ "name": "SecureOps Cloud", "url": "https://secureopscloud.com" },
{ "name": "CompliantStack", "url": "https://compliantstack.io" }
],
"results": [
{ "name": "SecureOps Cloud", "url": "https://secureopscloud.com" },
{ "name": "CompliantStack", "url": "https://compliantstack.io" }
],
"total_results": 2,
"created_on": "2025-11-10T22:15:03Z",
"completed_on": "2025-11-10T22:15:18Z"
}
}
Callback Payload
If you supply callback_url, we POST the same structure shown above to your endpoint once results are ready. The callback worker retries on transient failures up to the configured maximum.
Callback Example
POST <callback_url>
Content-Type: application/json
{
"request_id": "cosearch_64f2d8e4_1700000123",
"status": "completed",
"success": true,
"data": {
"success": true,
"results": [
{ "name": "SecureOps Cloud", "url": "https://secureopscloud.com" }
],
"total_results": 1,
"page": 1,
"limit": 50,
"enrichments_count": 1,
"has_more_results": false
},
"completed_on": "2025-11-10T22:15:18Z",
"timestamp": "2025-11-10T22:15:18Z"
}
Error Codes
missing_parameters– Bothindustryandwebsite_keywordwere omitted.invalid_limit–max_resultsoutside 1–50.invalid_callback_url– Callback URL is not HTTPS.subscription_required– Search product is not enabled on this account.rate_limit_exceeded/monthly_limit_exceeded– Usage exceeded configured limits.
Next Steps
- Launch the Company Search Playground to test requests with your credentials.
- Monitor usage through the Usage API.