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

Experiment with live requests, poll for status, and inspect JSON responses using the interactive playground.

Launch Company Search Playground

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_id immediately, then poll or register a callback.
  • Credits: 5 credits per completed request.
  • Callback Support: Optional callback_url to 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

FieldTypeRequiredDescription
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

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 by POST /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 – Both industry and website_keyword were omitted.
  • invalid_limit – max_results outside 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

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