Company Autocomplete

Company Autocomplete powers the company search bar in our own app. It is designed for interactive typeahead/autocomplete UIs: the user types a few characters of a company name or domain and picks a suggestion from a dropdown.

Unlike Company Search, it consumes no API credits, so you can safely call it on every keystroke. The intended flow is: suggestions are free, and only an explicit action on the selected company — a Company Search, Technographics or Buying Intent request — is charged normally.

Request

GET https://api.theirstack.com/v1/companies/autocomplete?text=goog&limit=10
Authorization: Bearer <token>

Requests are rate limited to 5 requests per second, which is comfortably above what a debounced typeahead needs.

Response

{
    "data": [
        {
            "id": "google",
            "name": "Google",
            "domain": "google.com",
            "industry": "internet",
            "country": "United States",
            "country_code": "US",
            "employee_count": 7543,
            "logo": "https://example.com/logo.png",
            "num_jobs": 746,
            "num_technologies": 213,
            "num_keywords": 260,
            "num_buying_intent_topics": 47,
            "possible_domains": ["google.com"]
        }
    ],
    "metadata": {
        "total_results": 1
    }
}

Render the suggestion with name, logo and domain, and once the user selects a company, use its name or domain to run the paid lookup that fits your use case.

Recommended usage

• Debounce keystrokes (300 ms or more) and require at least 2 characters before calling.
• Keep limit small — a dropdown rarely needs more than 10 suggestions.
• Do not use this endpoint for bulk enumeration or scraping. It is meant to back a search box, not to page through our company database — usage may be reviewed and approval revoked.