> ## Documentation Index
> Fetch the complete documentation index at: https://developers.explorium.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Autocomplete Businesses
> Autocomplete businesses by field and query.
## Endpoint: `GET /v1/businesses/autocomplete`
## Description
The **Fetch Business Autocomplete** endpoint provides **real-time suggestions** for business-related fields, helping users quickly find relevant categories, locations, and industries based on partial text input. This is useful for creating dynamic search fields and enhancing user experience in filtering interfaces.
| Attribute | Coverage Details |
| :------------------- | :------------------------------------------------------------------------ |
| **Supported Fields** | Country, Region, Google Category, NAICS Category, LinkedIn Category, etc. |
| **Geographic Scope** | Supports 150+ countries |
| **Response Time** | Optimized for real-time autocomplete functionality |
* **Input:** Specify a field type (`country`, `region_country`, etc.) and provide a partial query string.
* **Processing:** The system searches through indexed datasets to return the most relevant suggestions.
* **Output:** A structured response containing suggested values for the given input.
| Parameter | Type | Description |
| :---------------- | :------ | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `field` | String | The field for which autocomplete is requested (e.g., `country`, `industry`). |
| `query` | String | Partial text input to generate suggestions. |
| `semantic_search` | Boolean | Optional. When `true`, enables semantic autocomplete to return a broader, topic-aware set of suggestions. This parameter is intended for use with the `business_intent_topics` field. |
Example with contry field.
```shell Bash theme={null}
curl -X GET \
"https://api.explorium.ai/v1/businesses/autocomplete?field=country&query=unit" \
-H "API_KEY: your_api_key_here"
```
Example with business\_intent\_topics field.
```shell Bash theme={null}
curl -X GET \
'https://api.explorium.ai/v1/businesses/autocomplete?query=cloude&semantic_search=true&field=business_intent_topics' \
-H "API_KEY: your_api_key_here"
```
Example with contry field.
```json JSON theme={null}
[
{
"query": "unit",
"label": "United States",
"value": "us"
},
{
"query": "unit",
"label": "United Kingdom",
"value": "gb"
},
{
"query": "unit",
"label": "United Arab Emirates",
"value": "ae"
},
{
"query": "unit",
"label": "Tanzania, United Republic Of",
"value": "tz"
},
{
"query": "unit",
"label": "United States Minor Outlying Islands",
"value": "um"
}
]
```
Example with business\_intent\_topics field.
```json JSON theme={null}
[
{
"query": "cloude",
"label": "cloud: cloud data",
"value": "cloud: cloud data"
},
{
"query": "cloude",
"label": "business solutions: cloudapp",
"value": "business solutions: cloudapp"
},
{
"query": "cloude",
"label": "cloud: cloud integration",
"value": "cloud: cloud integration"
},
{
"query": "cloude",
"label": "media & advertising: cloudimage",
"value": "media & advertising: cloudimage"
},
{
"query": "cloude",
"label": "technology: cloudsuite",
"value": "technology: cloudsuite"
},
{
"query": "cloude",
"label": "cloud: cloud applications",
"value": "cloud: cloud applications"
},
{
"query": "cloude",
"label": "technology: cloudsense",
"value": "technology: cloudsense"
},
{
"query": "cloude",
"label": "technology: cloudnine",
"value": "technology: cloudnine"
},
{
"query": "cloude",
"label": "cloud: cloud server",
"value": "cloud: cloud server"
},
{
"query": "cloude",
"label": "technology: cloudflare",
"value": "technology: cloudflare"
},
{
"query": "cloude",
"label": "ecommerce: cloudcraze",
"value": "ecommerce: cloudcraze"
},
{
"query": "cloude",
"label": "business services: mapp cloud",
"value": "business services: mapp cloud"
},
{
"query": "cloude",
"label": "business services: cloudbees",
"value": "business services: cloudbees"
},
{
"query": "cloude",
"label": "cloud: multicloud",
"value": "cloud: multicloud"
},
{
"query": "cloude",
"label": "technology: content+cloud",
"value": "technology: content+cloud"
},
{
"query": "cloude",
"label": "cloud: cloud management",
"value": "cloud: cloud management"
},
{
"query": "cloude",
"label": "cloud: cloud management platform",
"value": "cloud: cloud management platform"
},
{
"query": "cloude",
"label": "technology: cloud essentials",
"value": "technology: cloud essentials"
},
{
"query": "cloude",
"label": "technology: cloudinary",
"value": "technology: cloudinary"
}
]
```
| **Filter** | **Description** | **Example Input** |
| :------------------------------ | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------ |
| `country` | Autocomplete for country names | `"Uni"` → United States, United Kingdom |
| `country_code` | Autocomplete for country codes (ISO 2-letter) | `"US"` → United States |
| `region_country_code` | Autocomplete for region-based country codes | `"EU"` → European Union countries |
| `google_category` | Google's business category classification | `"E-com"` → E-commerce |
| `naics_category` | Industry classification based on NAICS codes | `"541512"` → Computer Systems Design Services |
| `linkedin_category` | Industry classification from LinkedIn data | `"Retail"` → Retail Industry |
| `company_tech_stack_tech` | Technologies used by a company | `"Cloud"` → Cloud Computing, Cloud Security |
| `company_tech_stack_categories` | Technology categories used by the company | `"Marketing"` → CRM, AdTech |
| `job_title` | Autocomplete for job titles | `"Soft"` → Software Engineer, Software Developer |
| `company_size` | Autocomplete for company sizes (by number of employees) | `"500"` → Companies with \~500 employees |
| `company_revenue` | Revenue-based classification (**K, M, B, T** for thousands, millions, billions, trillions) | `"100M"` → \$100 Million+ |
| `number_of_locations` | Number of physical company locations | `"1"` → Companies with a single location |
| `company_age` | Company age in years | `"10"` → Companies older than 10 years |
| `job_department` | Autocomplete for job departments | `"Eng"` → Engineering, Product Engineering |
| `job_level` | Job seniority levels | `"Senior"` → Senior Manager, Senior Engineer |
| `city_region_country` | Combined location filter by city, region, and country | `"New York, NY, US"` → Companies in New York |
| `company_name` | Filter by company name | `"Meta"` → Meta Platforms Inc. |
| `business_intent_topics` | Business intent topics —
It is recommended to use `semantic_search=true` to receive a broader and smarter autocomplete result that identifies wider semantic connections to the searched term. | `"cloud"` → technology: cloudflare, cloud: cloud server |
* **Use precise queries** to get the most relevant autocomplete results.
* Enable `semantic_search=true` when working with **business intent topics** to receive broader, smarter, and semantically-aware suggestions.
* **Optimize search fields** by implementing real-time feedback mechanisms.
* **Restrict field selection** to avoid unnecessary queries and improve API efficiency.
* **Combine with filtering APIs** to refine user selections dynamically.
For detailed endpoint explanations, request examples, and integration tips, explore the documentation sections above.
## Body Params - Try Me Example
```
field: country
query: unit
```
## OpenAPI
````yaml get /v1/businesses/autocomplete
openapi: 3.1.0
info:
title: Partner Service
version: 0.2.349
servers:
- url: https://api.explorium.ai
description: AgentSource Server
security: []
paths:
/v1/businesses/autocomplete:
get:
tags:
- Businesses
summary: Autocomplete Businesses
description: Autocomplete businesses by field and query.
operationId: businesses_autocomplete
parameters:
- required: true
schema:
$ref: '#/components/schemas/AutocompleteType'
name: field
in: query
- required: false
schema:
type: string
title: Query
name: query
in: query
- required: false
schema:
type: boolean
title: Semantic Search
name: semantic_search
in: query
responses:
'200':
description: Successful Response
content:
application/json:
schema:
items:
$ref: '#/components/schemas/AutoCompleteItem'
type: array
title: Response Businesses Autocomplete
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
security:
- APIKeyHeader: []
- APIKeyHeader: []
components:
schemas:
AutocompleteType:
enum:
- country
- country_code
- region_country_code
- google_category
- naics_category
- linkedin_category
- company_tech_stack_tech
- company_tech_stack_categories
- job_title
- company_size
- company_revenue
- number_of_locations
- company_age
- job_department
- job_level
- city_region_country
- company_name
- business_intent_topics
- city_region
- skills
- interests
title: AutocompleteType
description: Enum for autocomplete types.
AutoCompleteItem:
properties:
query:
type: string
title: Query
label:
type: string
title: Label
value:
type: string
title: Value
type: object
required:
- query
- label
- value
title: AutoCompleteItem
example:
query: united
label: United States
value: us
HTTPValidationError:
properties:
detail:
items:
$ref: '#/components/schemas/ValidationError'
type: array
title: Detail
type: object
title: HTTPValidationError
ValidationError:
properties:
loc:
items:
anyOf:
- type: string
- type: integer
type: array
title: Location
msg:
type: string
title: Message
type:
type: string
title: Error Type
type: object
required:
- loc
- msg
- type
title: ValidationError
securitySchemes:
APIKeyHeader:
type: apiKey
in: header
name: api_key
````