Skip to main content
GET
/
v1
/
businesses
/
autocomplete
Autocomplete Businesses
curl --request GET \
  --url https://api.explorium.ai/v1/businesses/autocomplete \
  --header 'api_key: <api-key>'
[
  {
    "query": "united",
    "label": "United States",
    "value": "us"
  }
]

​
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.
AttributeCoverage Details
Supported FieldsCountry, Region, Google Category, NAICS Category, LinkedIn Category, etc.
Geographic ScopeSupports 150+ countries
Response TimeOptimized 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.
ParameterTypeDescription
fieldStringThe field for which autocomplete is requested (e.g., country, industry).
queryStringPartial text input to generate suggestions.
semantic_searchBooleanOptional. 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.
Bash
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.
Bash
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
[
  {
    "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

[
{
"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"
}
]
FilterDescriptionExample Input
countryAutocomplete for country names"Uni" → United States, United Kingdom
country_codeAutocomplete for country codes (ISO 2-letter)"US" → United States
region_country_codeAutocomplete for region-based country codes"EU" → European Union countries
google_categoryGoogle’s business category classification"E-com" → E-commerce
naics_categoryIndustry classification based on NAICS codes"541512" → Computer Systems Design Services
linkedin_categoryIndustry classification from LinkedIn data"Retail" → Retail Industry
company_tech_stack_techTechnologies used by a company"Cloud" → Cloud Computing, Cloud Security
company_tech_stack_categoriesTechnology categories used by the company"Marketing" → CRM, AdTech
job_titleAutocomplete for job titles"Soft" → Software Engineer, Software Developer
company_sizeAutocomplete for company sizes (by number of employees)"500" → Companies with ~500 employees
company_revenueRevenue-based classification (K, M, B, T for thousands, millions, billions, trillions)"100M" → $100 Million+
number_of_locationsNumber of physical company locations"1" → Companies with a single location
company_ageCompany age in years"10" → Companies older than 10 years
job_departmentAutocomplete for job departments"Eng" → Engineering, Product Engineering
job_levelJob seniority levels"Senior" → Senior Manager, Senior Engineer
city_region_countryCombined location filter by city, region, and country"New York, NY, US" → Companies in New York
company_nameFilter by company name"Meta" → Meta Platforms Inc.
business_intent_topicsBusiness 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

Authorizations

​
api_key
string
header
required

Query Parameters

​
field
enum<string>
required

Enum for autocomplete types.

Available options:
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
​
query
string
default:""
​
semantic_search
boolean
default:false

Response

Successful Response

​
query
string
required
​
label
string
required
​
value
string
required