Autocomplete examples

Try partial-name lookups and inspect matching entities.

📘

Choose the matching entity

Autocomplete suggests entities based on a partial name. Review the suggestions and select the intended entity; it does not automatically resolve ambiguous matches.

Below are a few common examples to help you find the entity you're looking for.

Replace YOUR_API_KEY with your provisioned key. See Make your first API request for key setup.

Example 1: Find any entities that match "box"

  • Query for a string of "box"
  • Limit response to only 15 results
GET /v4/data/autocompletes?query=box&limit=15 HTTP/1.1
Host: api.crunchbase.com
X-cb-user-key: YOUR_API_KEY
Accept: application/json
curl --request GET 'https://api.crunchbase.com/v4/data/autocompletes?query=box&limit=15' \
  --header 'X-cb-user-key: YOUR_API_KEY' \
  --header 'Accept: application/json'

Example 2: Find an investor that match "mayfield"

  • Query for a string of "Mayfield"
  • Restrict results to investors by using collection_ids=principal.investors
GET /v4/data/autocompletes?query=mayfield&collection_ids=principal.investors&limit=10 HTTP/1.1
Host: api.crunchbase.com
X-cb-user-key: YOUR_API_KEY
Accept: application/json
curl --request GET 'https://api.crunchbase.com/v4/data/autocompletes?query=mayfield&collection_ids=principal.investors&limit=10' \
  --header 'X-cb-user-key: YOUR_API_KEY' \
  --header 'Accept: application/json'

Example 3: Find a category or category group that match "mobile payment"

  • Query for a string of "mobile payment"
  • Restrict results to categories & category groups by using collection_ids=categories,category_groups
  • Limit response to only 10 results
GET /v4/data/autocompletes?query=mobile%20payment&collection_ids=categories,category_groups&limit=10 HTTP/1.1
Host: api.crunchbase.com
X-cb-user-key: YOUR_API_KEY
Accept: application/json

Example 4: Find a company that match "airbnb"

  • Query for a string of "airbnb"
  • Restrict results to companies by using collection_ids=organization.companies
GET /v4/data/autocompletes?query=airbnb&collection_ids=organization.companies HTTP/1.1
Host: api.crunchbase.com
X-cb-user-key: YOUR_API_KEY
Accept: application/json

Example 5: Find a country or city that match "united"

  • Query for a string of "united"
  • Focus the search to countries and cities by using collection_ids=location.countries,location.cities
  • Limit response to only 10 results
GET /v4/data/autocompletes?query=united&limit=10&collection_ids=location.countries,location.cities HTTP/1.1
Host: api.crunchbase.com
X-cb-user-key: YOUR_API_KEY
Accept: application/json

Did this page help you?