The Autocomplete API from Ocean.io — 5 operation(s) for autocomplete.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/ocean-io-autocomplete-api"curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Ocean.io API Documentation Autocomplete API
summary: Welcome to Ocean.io's API.
description: Welcome to Ocean.io's API.
version: 2.0.0
x-logo:
url: https://cdn2.ocean.io/assets/images/logo/256x92_ocean-logo.svg
servers:
- url: https://api.ocean.io
tags:
- name: Autocomplete
paths:
/v2/autocomplete/companies:
post:
tags:
- Autocomplete
summary: Autocomplete companies
description: Auto complete the name search
operationId: autoCompleteCompany
parameters:
- name: apiToken
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Apitoken
- name: x-api-token
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Api-Token
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/models__autocomplete_companies__AutoCompletionBody'
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/models__autocomplete_companies__AutoCompletionResult'
'403':
content:
application/json:
schema:
type: object
properties:
detail:
type: string
enum:
- API token should be provided in headers or query parameters
- Current API token is not registered in our database
required:
- detail
description: Forbidden
'402':
content:
application/json:
schema:
type: object
properties:
detail:
type: string
enum:
- Insufficient credits
required:
- detail
description: Payment Required
'400':
content:
application/json:
schema:
type: object
properties:
detail:
type: string
enum:
- Conflicting API tokens provided in query parameters and headers
required:
- detail
description: Bad Request
'404':
description: Not found
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/v2/autocomplete/keywords:
post:
tags:
- Autocomplete
summary: Autocomplete keywords
description: Auto complete the keyword search.
operationId: autoCompleteKeywords
parameters:
- name: apiToken
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Apitoken
- name: x-api-token
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Api-Token
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/models__autocomplete_keyword__AutoCompletionBody'
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/models__autocomplete_keyword__AutoCompletionResult'
'403':
content:
application/json:
schema:
type: object
properties:
detail:
type: string
enum:
- API token should be provided in headers or query parameters
- Current API token is not registered in our database
required:
- detail
description: Forbidden
'402':
content:
application/json:
schema:
type: object
properties:
detail:
type: string
enum:
- Insufficient credits
required:
- detail
description: Payment Required
'400':
content:
application/json:
schema:
type: object
properties:
detail:
type: string
enum:
- Conflicting API tokens provided in query parameters and headers
required:
- detail
description: Bad Request
'404':
description: Not found
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/v2/autocomplete/job-titles:
post:
tags:
- Autocomplete
summary: Autocomplete job titles
description: Auto complete the job title search.
operationId: autoCompleteJobTitles
parameters:
- name: apiToken
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Apitoken
- name: x-api-token
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Api-Token
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/models__autocomplete_job_title__AutoCompletionBody'
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/models__autocomplete_job_title__AutoCompletionResult'
'403':
content:
application/json:
schema:
type: object
properties:
detail:
type: string
enum:
- API token should be provided in headers or query parameters
- Current API token is not registered in our database
required:
- detail
description: Forbidden
'402':
content:
application/json:
schema:
type: object
properties:
detail:
type: string
enum:
- Insufficient credits
required:
- detail
description: Payment Required
'400':
content:
application/json:
schema:
type: object
properties:
detail:
type: string
enum:
- Conflicting API tokens provided in query parameters and headers
required:
- detail
description: Bad Request
'404':
description: Not found
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/v2/autocomplete/locations:
post:
tags:
- Autocomplete
summary: Autocomplete locations
description: Auto complete the location search
operationId: autoCompleteLocations
parameters:
- name: apiToken
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Apitoken
- name: x-api-token
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Api-Token
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/models__autocomplete_locations__AutoCompletionBody'
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/models__autocomplete_locations__AutoCompletionResult'
'403':
content:
application/json:
schema:
type: object
properties:
detail:
type: string
enum:
- API token should be provided in headers or query parameters
- Current API token is not registered in our database
required:
- detail
description: Forbidden
'402':
content:
application/json:
schema:
type: object
properties:
detail:
type: string
enum:
- Insufficient credits
required:
- detail
description: Payment Required
'400':
content:
application/json:
schema:
type: object
properties:
detail:
type: string
enum:
- Conflicting API tokens provided in query parameters and headers
required:
- detail
description: Bad Request
'404':
description: Not found
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/v2/autocomplete/skills:
post:
tags:
- Autocomplete
summary: Autocomplete skills
description: Auto complete the skill search.
operationId: autoCompleteSkills
parameters:
- name: apiToken
in: query
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Apitoken
- name: x-api-token
in: header
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: X-Api-Token
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/models__autocomplete_skills__AutoCompletionBody'
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/models__autocomplete_skills__AutoCompletionResult'
'403':
content:
application/json:
schema:
type: object
properties:
detail:
type: string
enum:
- API token should be provided in headers or query parameters
- Current API token is not registered in our database
required:
- detail
description: Forbidden
'402':
content:
application/json:
schema:
type: object
properties:
detail:
type: string
enum:
- Insufficient credits
required:
- detail
description: Payment Required
'400':
content:
application/json:
schema:
type: object
properties:
detail:
type: string
enum:
- Conflicting API tokens provided in query parameters and headers
required:
- detail
description: Bad Request
'404':
description: Not found
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
components:
schemas:
models__autocomplete_job_title__AutoCompletionResult:
properties:
jobTitles:
items:
type: string
type: array
title: Job titles found
description: Array of found job titles. Returns empty array if no results
examples:
- Software Engineer
- Senior Software Engineer
additionalProperties: false
type: object
required:
- jobTitles
title: AutoCompletionResult
ValidationError:
properties:
loc:
items:
anyOf:
- type: string
- type: integer
type: array
title: Location
msg:
type: string
title: Message
type:
type: string
title: Error Type
input:
title: Input
ctx:
type: object
title: Context
type: object
required:
- loc
- msg
- type
title: ValidationError
models__autocomplete_locations__Location:
properties:
countryCode:
type: string
title: Country code
description: ISO country code
examples:
- us
filterCode:
type: string
title: Filter code
description: Code used for filtering locations
examples:
- us-CA
name:
type: string
title: Location name
description: English name of the location
examples:
- California
parentCode:
type: string
title: Parent code
description: Code of the parent location
examples:
- us
parentName:
type: string
title: Parent name
description: Name of the parent location
examples:
- United States
type:
$ref: '#/components/schemas/LocationType'
title: Location type
description: 'Type of location: 1-country, 2-region, 3-municipality, 4-city'
examples:
- 2-region
additionalProperties: false
type: object
required:
- countryCode
- filterCode
- name
- parentCode
- parentName
- type
title: Location
models__autocomplete_locations__AutoCompletionBody:
properties:
query:
type: string
title: Autocomplete request for location
description: Beginning of the location
examples:
- londo
limit:
type: integer
maximum: 15.0
minimum: 1.0
title: Limit
description: Number of locations to return. Default is 5 if not specified, maximum is 15.
default: 5
examples:
- 5
locationType:
$ref: '#/components/schemas/LocationSearchType'
title: Location type
description: Type of entities to search locations for. Use 'people' to include non-standard locations like 'San Francisco Bay Area'.
default: companies
examples:
- companies
additionalProperties: false
type: object
required:
- query
title: AutoCompletionBody
models__autocomplete_skills__AutoCompletionBody:
properties:
query:
type: string
title: Autocomplete request for skills
description: Beginning of the skill name
examples:
- python
limit:
type: integer
maximum: 15.0
minimum: 1.0
title: Limit
description: Number of skills to return. Default is 5 if not specified, maximum is 15.
default: 5
examples:
- 5
additionalProperties: false
type: object
required:
- query
title: AutoCompletionBody
models__autocomplete_companies__AutoCompletionResult:
properties:
companies:
items:
$ref: '#/components/schemas/AutoCompletionCompany'
type: array
title: Companies found
description: Array of found companies. Returns empty array if no results
additionalProperties: false
type: object
required:
- companies
title: AutoCompletionResult
models__autocomplete_keyword__AutoCompletionResult:
properties:
keywords:
items:
type: string
type: array
title: Keywords found
description: Array of found keywords. Returns empty array if no results
examples:
- software
- software development
additionalProperties: false
type: object
required:
- keywords
title: AutoCompletionResult
HTTPValidationError:
properties:
detail:
items:
$ref: '#/components/schemas/ValidationError'
type: array
title: Detail
type: object
title: HTTPValidationError
models__autocomplete_companies__AutoCompletionBody:
properties:
name:
type: string
title: Auto completion input
description: Beginning of the name or the domain of a company
examples:
- ocea
countryFilters:
items:
type: string
type: array
nullable: true
title: Country filters
description: List of countries to filter for the autocompletion
examples:
- - dk
- se
excludeDomains:
items:
type: string
type: array
nullable: true
title: Exclude domains
description: List of domains to exclude from the results
examples:
- - ocean.com
forLookalikeSearch:
type: boolean
title: For lookalike search
description: 'When `false`, returns all matching companies without domain validation or status filters. WARNING: Do not set this parameter to `false` if the autocomplete results will be used as input for a lookalike search.'
default: true
additionalProperties: false
type: object
required:
- name
title: AutoCompletionBody
models__autocomplete_job_title__AutoCompletionBody:
properties:
query:
type: string
maxLength: 100
minLength: 1
title: Autocomplete request for job title
description: Beginning of the job title
examples:
- developer
limit:
type: integer
maximum: 15.0
minimum: 1.0
title: Limit
description: Number of job titles to return. Default is 5 if not specified, maximum is 15.
default: 5
examples:
- 5
additionalProperties: false
type: object
required:
- query
title: AutoCompletionBody
models__autocomplete_skills__AutoCompletionResult:
properties:
skills:
items:
type: string
type: array
title: Skills found
description: Array of found skills. Returns empty array if no results
examples:
- Python
- Python Programming
- Python Django
additionalProperties: false
type: object
required:
- skills
title: AutoCompletionResult
LocationSearchType:
type: string
enum:
- companies
- people
title: LocationSearchType
AutoCompletionCompany:
properties:
domain:
type: string
title: Domain
description: Domain of the company, used as a unique identifier
examples:
- ocean.io
logo:
type: string
nullable: true
title: Logo
description: Logo of the company (URL)
examples:
- https://cdn2.ocean.io/companies-logos-v1/domain.com/020539e284d9318e805301b672ad23047c30818a.png
name:
type: string
nullable: true
title: Name
description: Name of the company
examples:
- Ocean
additionalProperties: false
type: object
required:
- domain
title: AutoCompletionCompany
models__autocomplete_keyword__AutoCompletionBody:
properties:
query:
type: string
title: Autocomplete request for keywords
description: Beginning of the keyword
examples:
- softw
limit:
type: integer
maximum: 15.0
minimum: 1.0
title: Limit
description: Number of keywords to return. Default is 5 if not specified, maximum is 15.
default: 5
examples:
- 5
additionalProperties: false
type: object
required:
- query
title: AutoCompletionBody
LocationType:
type: string
enum:
- 1-country
- 2-region
- 3-municipality
- 4-city
title: LocationType
models__autocomplete_locations__AutoCompletionResult:
properties:
locations:
items:
$ref: '#/components/schemas/models__autocomplete_locations__Location'
type: array
title: Locations found
description: Array of found locations with metadata. Returns empty array if no results
additionalProperties: false
type: object
required:
- locations
title: AutoCompletionResult