---
title: "Search words in transcript"
method: GET
path: "/v2/transcript/{transcript_id}/word-search"
tags: ["transcript"]
---

# Search words in transcript

`GET /v2/transcript/{transcript_id}/word-search`

<Note>To search through a transcription created on our EU server, replace `api.assemblyai.com` with `api.eu.assemblyai.com`.</Note>
Search through the transcript for keywords. You can search for individual words, numbers, or phrases containing up to five words or numbers.

## Path parameters

- `transcript_id` string, required

## Query parameters

- `words` string[], required

## Response `200`

Word search response

- WordSearchResponse
  - `id` string, uuid, required — The ID of the transcript
  - `total_count` integer, required — The total count of all matched instances. For e.g., word 1 matched 2 times, and word 2 matched 3 times, `total_count` will equal 5.
  - `matches` WordSearchMatch[], required — The matches of the search
    - `text` string, required — The matched word
    - `count` integer, required — The total amount of times the word is in the transcript
    - `timestamps` WordSearchTimestamp[], required — An array of timestamps
      - integer[] — An array of timestamps structured as [`start_time`, `end_time`] in milliseconds
    - `indexes` integer[], required — An array of all index locations for that word within the `words` array of the completed transcript

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `404` — Not found
- `429` — Too many requests
- `500` — An error occurred while processing the request
- `503` — Service unavailable
- `504` — Gateway timeout

---

[API](https://skmtc.net/assemblyai/apis/assemblyai-api.md) · [All operations](https://skmtc.net/assemblyai/apis/assemblyai-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/assemblyai/assemblyai-api/versions/f743e2ea9459/schema)