---
title: "Autocomplete search"
method: GET
path: "/autocomplete/{entity_type}"
tags: ["Autocomplete"]
---

# Autocomplete search

`GET /autocomplete/{entity_type}`

Fast typeahead search returning up to 10 results. Use for search-as-you-type interfaces.

## Path parameters

- `entity_type` 'works' | 'authors' | 'sources' | 'institutions' | 'topics' | 'keywords' | 'publishers' | 'funders', required

## Query parameters

- `q` string, required
- `filter` string
- `api_key` string, required

## Response `200`

Successful response

- AutocompleteResponse
  - `meta` object
    - `count` integer
    - `db_response_time_ms` integer
  - `results` object[]
    - `id` string
    - `display_name` string
    - `hint` string, nullable
    - `cited_by_count` integer
    - `works_count` integer
    - `entity_type` string
    - `external_id` string, nullable

## Other responses

- `400` — Bad request - invalid parameters
- `429` — Rate limit exceeded

---

[API](https://skmtc.dev/openalex/apis/openalex-api.md) · [All operations](https://skmtc.dev/openalex/apis/openalex-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/openalex/openalex-api/revisions/60b6c8bd0799/schema)
