import osimport assemblyaifrom assemblyai.prerecorded.v2 import Transcript# `Transcript.get_by_id()` uses the default client, which reads the global settings.assemblyai.settings.api_key = os.environ["ASSEMBLYAI_API_KEY"]transcript = Transcript.get_by_id("<TRANSCRIPT_ID>")matches = transcript.word_search(["foo", "bar", "foo bar"])for match in matches: print(f"Found '{match.text}' {match.count} times in the transcript")
{
"error": "Authentication error, API token missing/invalid"
}
{
"error": "Not found"
}
{
"error": "Too Many Requests"
}
{
"error": "Internal server error. Please retry your request. If the error persists, please contact support@assemblyai.com for more information."
}
API reference
Word search
To search through a transcription created on our EU server, replace api.assemblyai.com with api.eu.assemblyai.com.
Search through the transcript for keywords. You can search for individual words, numbers, or phrases containing up to five words or numbers.
GET
/
v2
/
transcript
/
{transcript_id}
/
word-search
import osimport assemblyaifrom assemblyai.prerecorded.v2 import Transcript# `Transcript.get_by_id()` uses the default client, which reads the global settings.assemblyai.settings.api_key = os.environ["ASSEMBLYAI_API_KEY"]transcript = Transcript.get_by_id("<TRANSCRIPT_ID>")matches = transcript.word_search(["foo", "bar", "foo bar"])for match in matches: print(f"Found '{match.text}' {match.count} times in the transcript")
{
"error": "Authentication error, API token missing/invalid"
}
{
"error": "Not found"
}
{
"error": "Too Many Requests"
}
{
"error": "Internal server error. Please retry your request. If the error persists, please contact support@assemblyai.com for more information."
}
Authorizations
Authorization
string
header
required
Add your AssemblyAI API key as the Authorization header value. Required on every request.
Path Parameters
transcript_id
string
required
ID of the transcript
Query Parameters
words
string[]
required
Keywords to search for
Response
Word search response
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
object[]
required
The matches of the search
Show child attributes
Was this page helpful?
{"docsConfig":{"theme":"aspen","$schema":"https://mintlify.com/docs.json","name":"AssemblyAI","description":"AssemblyAI provides production-ready Voice AI models for speech-to-text, speaker detection, sentiment analysis, and more. Build with pre-recorded or streaming audio using REST APIs and WebSockets.","colors":{"primary":"#614fd2","light":"#887bdd","dark":"#614fd2"},"logo":{"light":"https://mintcdn.com/assemblyai-fff14a6f/vMuNaI_PbWUbVeV0/assets/assemblyai-lockup-primary.svg?fit=max\u0026auto=format\u0026n=vMuNaI_PbWUbVeV0\u0026q=85\u0026s=808d2a677e2536423045d44b3f330ac2","dark":"https://mintcdn.com/assemblyai-fff14a6f/vMuNaI_PbWUbVeV0/assets/assemblyai-lockup-secondary.svg?fit=max\u0026auto=format\u0026n=vMuNaI_PbWUbVeV0\u0026q=85\u0026s=065ec1618693f8650241242ec62ed0ad","href":"https://www.assemblyai.com"},"favicon":"https://mintcdn.com/assemblyai-fff14a6f/6OQYF4QMRVQRoCb1/assets/favicon.png?fit=max\u0026auto=format\u0026n=6OQYF4QMRVQRoCb1\u0026q=85\u0026s=74b6b6a7321938bd113d4a271e06068d","api":{"openapi":["openapi.yaml","api-reference/specs/llm-gateway.yaml","api-reference/specs/streaming-token.yaml"],"asyncapi":["api-reference/specs/streaming.yaml","api-reference/specs/streaming-tts.yaml"]},"background":{"color":{"light":"#fdfcf8","dark":"#1d1b16"}},"navbar":{"links":[{"href":"https://www.assemblyai.com/playground","label":"Playground"},{"href":"https://www.assemblyai.com/changelog","label":"Changelog"}],"primary":{"type":"button","label":"Sign In","href":"https://www.assemblyai.com/dashboard/login"}},"footer":{"socials":{"x":"https://x.com/AssemblyAI","github":"https://github.com/AssemblyAI","linkedin":"https://www.linkedin.com/company/assemblyai"},"links":[{"header":"Legal","items":[{"label":"Terms of Service","href":"https://www.assemblyai.com/legal/terms-of-service"},{"label":"Privacy Policy","href":"https://www.assemblyai.com/legal/privacy-policy"},{"label":"Trust Center","href":"https://app.vanta.com/assemblyai/trust/7n80syl8zln1bn1qm3x8eg"},{"label":"Subprocessors","href":"https://app.vanta.com/assemblyai/trust/7n80syl8zln1bn1qm3x8eg/subprocessors"},{"label":"Do not sell my Personal Information","href":"#privacy-choices"}]}]},"seo":{"metatags":{"canonical":"https://www.assemblyai.com/docs"}},"fonts":{"heading":{"family":"GT Standard","weight":600,"source":"https://www.assemblyai.com/_aai/fonts/rebrand/GT-Standard-M-Semibold.woff2","format":"woff2"},"body":{"family":"GT Standard","weight":400,"source":"https://www.assemblyai.com/_aai/fonts/rebrand/GT-Standard-M-Regular.woff2","format":"woff2"}},"icons":{"library":"fontawesome"},"banner":{"content":"**New** AssemblyAI-TTS-1: Text-to-speech for voice agents. [Learn more](https://www.assemblyai.com/docs/tts/getting-started/quickstart)","dismissible":true},"contextual":{"options":["copy","view","chatgpt","claude","download-spec"],"display":"header"},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"assemblyai-fff14a6f","hasAudioNarration":false,"actualSubdomain":"assemblyai-fff14a6f","customDomains":["assemblyai.com"],"gitSource":{"type":"github","owner":"assemblyai","repo":"assemblyai-docs","deployBranch":"master","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true,"agentFeedback":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"REMOVE_BRANDING":{"status":"ENABLED"},"CONTEXTUAL_FEEDBACK":{"status":"ENABLED"},"CODE_SNIPPET_FEEDBACK":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6b00bd95c524b540ef00820b","clientVersion":"0.0.4248","searchFilterCounts":[{"language":"default","tag":"Overview","count":119},{"language":"default","tag":"FAQ","count":96},{"language":"default","tag":"Pre-recorded STT","count":75},{"language":"default","tag":"Guides","count":60},{"language":"default","tag":"Real-time STT","count":50},{"language":"default","tag":"Tutorials","count":48},{"language":"default","tag":"Pre-recorded audio","count":47},{"language":"default","tag":"LLM Gateway","count":45},{"language":"default","tag":"API reference","count":35},{"language":"default","tag":"Features","count":35}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true,"attachments":{"status":"DISABLED"}},"basePath":"/docs","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"site-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"@font-face{font-family:\"GT Standard\";src:url(\"https://www.assemblyai.com/_aai/fonts/rebrand/GT-Standard-M-Regular.woff2\")\n format(\"woff2\"),\n url(\"https://www.assemblyai.com/docs/assets/GT-Standard-M-Regular.woff2\")\n format(\"woff2\"),\n url(\"/assets/GT-Standard-M-Regular.woff2\") format(\"woff2\");font-weight:400;font-style:normal;font-display:swap}@font-face{font-family:\"GT Standard\";src:url(\"https://www.assemblyai.com/_aai/fonts/rebrand/GT-Standard-M-Medium.woff2\")\n format(\"woff2\"),\n url(\"https://www.assemblyai.com/docs/assets/GT-Standard-M-Medium.woff2\")\n format(\"woff2\"),\n url(\"/assets/GT-Standard-M-Medium.woff2\") format(\"woff2\");font-weight:500;font-style:normal;font-display:swap}@font-face{font-family:\"GT Standard\";src:url(\"https://www.assemblyai.com/_aai/fonts/rebrand/GT-Standard-M-Semibold.woff2\")\n format(\"woff2\"),\n url(\"https://www.assemblyai.com/docs/assets/GT-Standard-M-Semibold.woff2\")\n format(\"woff2\"),\n url(\"/assets/GT-Standard-M-Semibold.woff2\") format(\"woff2\");font-weight:600;font-style:normal;font-display:swap}@font-face{font-family:\"Modern Gothic Mono\";src:url(\"https://www.assemblyai.com/_aai/fonts/rebrand/ModernGothicMono-Light.woff2\")\n format(\"woff2\");font-weight:300;font-style:normal;font-display:swap}@font-face{font-family:\"Modern Gothic Mono\";src:url(\"https://www.assemblyai.com/_aai/fonts/rebrand/ModernGothicMono-Regular.woff2\")\n format(\"woff2\");font-weight:400;font-style:normal;font-display:swap}@font-face{font-family:\"Modern Gothic Mono\";src:url(\"https://www.assemblyai.com/_aai/fonts/rebrand/ModernGothicMono-Medium.woff2\")\n format(\"woff2\");font-weight:500;font-style:normal;font-display:swap}@font-face{font-family:\"Modern Gothic Mono\";src:url(\"https://www.assemblyai.com/_aai/fonts/rebrand/ModernGothicMono-Italic.woff2\")\n format(\"woff2\");font-weight:400;font-style:italic;font-display:swap}html:root{--font-family-body-custom: \"GT Standard\", -apple-system, BlinkMacSystemFont,\n \"Segoe UI\", sans-serif;--font-family-headings-custom: \"GT Standard\", -apple-system, BlinkMacSystemFont,\n \"Segoe UI\", sans-serif}code,kbd,samp,pre,pre code,pre code span{font-family:\"Modern Gothic Mono\", \"JetBrains Mono\", ui-monospace, SFMono-Regular,\n Menlo, Consolas, monospace!important}html{overflow-y:scroll;scrollbar-gutter:stable}pre,pre code,pre code span{font-size:0.75rem!important;line-height:1.5!important}:not(pre)>code{font-size:0.75rem!important;line-height:inherit!important}[data-nav-tag=\"WSS\"]{color:#614fd2!important;background-color:rgba(136, 123, 221, 0.14)!important;font-size:0.55rem!important}:is(.dark) [data-nav-tag=\"WSS\"]{color:#887bdd!important}div:has(>.nav-tag-pill>[data-nav-tag=\"WSS\"]){order:-1}.nav-tag-pill:has(>[data-nav-tag=\"WSS\"]){width:2.375rem;justify-content:flex-start}.ws-endpoint{display:flex;align-items:center;gap:0.625rem;margin:1rem 0 1.75rem;padding:0.5rem 0.75rem;border:1px solid rgba(0, 0, 0, 0.08);border-radius:0.5rem;background:rgba(0, 0, 0, 0.02);font-size:0.875rem;overflow-x:auto}:is(.dark) .ws-endpoint{border-color:rgba(255, 255, 255, 0.1);background:rgba(255, 255, 255, 0.03)}.ws-endpoint-badge{flex:none;font-weight:700;font-size:0.75rem;letter-spacing:0.02em;color:#614fd2;background:rgba(136, 123, 221, 0.14);padding:0.1875rem 0.5rem;border-radius:0.375rem}:is(.dark) .ws-endpoint-badge{color:#887bdd}.ws-endpoint-url{font-family:ui-monospace, SFMono-Regular, \"SF Mono\", Menlo, Consolas, monospace;white-space:nowrap}#assistant-entry,:is(.dark) #assistant-entry{background-color:#614fd2!important;filter:none!important}#assistant-entry:hover,:is(.dark) #assistant-entry:hover{background-color:#614fd2!important;opacity:0.9;filter:none!important}#assistant-entry span,#assistant-entry svg,:is(.dark) #assistant-entry span,:is(.dark) #assistant-entry svg{color:#ffffff!important}.callout strong{font-weight:700}*{-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale;-o-font-smoothing:antialiased}.katex-display{overflow-x:visible!important;overflow-y:visible!important}.katex-display>.katex{display:flex!important;justify-content:center;width:100%!important;overflow-x:visible!important;overflow-y:visible!important}.katex-display>.katex>.katex-html{display:inline-block!important;width:auto!important;max-width:100%;overflow-x:visible!important;overflow-y:visible!important}.card-logo-icon{display:block;width:1.5rem!important;height:1.5rem!important;min-width:1.5rem;max-width:1.5rem;max-height:1.5rem;margin:0!important;object-fit:contain;object-position:center;vertical-align:middle}.card-logo-icon-livekit{transform:scale(0.9)}.card-logo-icon-pipecat{transform:scale(1.12)}.card-logo-icon-livekit,.card-logo-icon-pipecat,.card-logo-icon-vercel{color:#614fd2}:is(.dark) .card-logo-icon-livekit,:is(.dark) .card-logo-icon-pipecat,:is(.dark) .card-logo-icon-vercel{color:#887bdd}.recommended-pill{background:#614fd2;color:#fff;padding:2px 8px;border-radius:9999px;font-size:0.7rem;font-weight:600;margin-left:6px;vertical-align:middle;white-space:nowrap}:is(.dark) .recommended-pill{background:#614fd2}.preview-pill{background:#b45309;color:#fff;padding:2px 8px;border-radius:9999px;font-size:0.7rem;font-weight:600;margin-left:6px;vertical-align:middle;white-space:nowrap}:is(.dark) .preview-pill{background:#b45309}table code{white-space:nowrap}"}]}
{"page":{"pagePath":"pre-recorded-audio/api-reference/transcripts/word-search","slug":"/pre-recorded-audio/api-reference/transcripts/word-search","pageMetadata":{"title":"Word search","og.description":"Search a transcript for words or phrases.","openapi":"openapi.yaml GET /v2/transcript/{transcript_id}/word-search","description":"\u003cNote>To search through a transcription created on our EU server, replace `api.assemblyai.com` with `api.eu.assemblyai.com`.\u003c/Note>\nSearch through the transcript for keywords. You can search for individual words, numbers, or phrases containing up to five words or numbers.\n","href":"/pre-recorded-audio/api-reference/transcripts/word-search"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n }, {Note} = _components;\n if (!Note) _missingMdxReference(\"Note\", true);\n return _jsxs(_components.p, {\n children: [_jsxs(Note, {\n children: [\"To search through a transcription created on our EU server, replace \", _jsx(_components.code, {\n children: \"api.assemblyai.com\"\n }), \" with \", _jsx(_components.code, {\n children: \"api.eu.assemblyai.com\"\n }), \".\"]\n }), \"\\nSearch through the transcript for keywords. You can search for individual words, numbers, or phrases containing up to five words or numbers.\"]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\nfunction _missingMdxReference(id, component) {\n throw new Error(\"Expected \" + (component ? \"component\" : \"object\") + \" `\" + id + \"` to be defined: you likely forgot to import, pass, or provide it.\");\n}\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Word search","og.description":"Search a transcript for words or phrases.","openapi":"openapi.yaml GET /v2/transcript/{transcript_id}/word-search","description":"\u003cNote>To search through a transcription created on our EU server, replace `api.assemblyai.com` with `api.eu.assemblyai.com`.\u003c/Note>\nSearch through the transcript for keywords. You can search for individual words, numbers, or phrases containing up to five words or numbers.\n","href":"/pre-recorded-audio/api-reference/transcripts/word-search"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/docs/_mintlify/custom/assemblyai-fff14a6f/c705301dcef66bf6/rudderstack.js","/docs/_mintlify/custom/assemblyai-fff14a6f/700d2574de973df9/chat-widget.js","/docs/_mintlify/custom/assemblyai-fff14a6f/33c4022d4e30e01c/ketch.js"],"openApiReferenceData":{"operation":{"tags":["transcript"],"summary":"Search words in transcript","description":"\u003cNote>To search through a transcription created on our EU server, replace `api.assemblyai.com` with `api.eu.assemblyai.com`.\u003c/Note>\nSearch through the transcript for keywords. You can search for individual words, numbers, or phrases containing up to five words or numbers.\n","operationId":"wordSearch","x-fern-sdk-group-name":"transcripts","x-fern-sdk-method-name":"wordSearch","x-fern-request-name":"WordSearchParams","parameters":["e2976195-0a5f-4d6a-962a-530b94c93fa3","2ffa8168-d09a-4180-a613-cfc114d359f8"],"x-codeSamples":[{"lang":"python","label":"Python SDK","source":"import os\n\nimport assemblyai\nfrom assemblyai.prerecorded.v2 import Transcript\n\n# `Transcript.get_by_id()` uses the default client, which reads the global settings.\nassemblyai.settings.api_key = os.environ[\"ASSEMBLYAI_API_KEY\"]\n\ntranscript = Transcript.get_by_id(\"\u003cTRANSCRIPT_ID>\")\n\nmatches = transcript.word_search([\"foo\", \"bar\", \"foo bar\"])\n\nfor match in matches:\n print(f\"Found '{match.text}' {match.count} times in the transcript\")\n"},{"lang":"javascript","label":"JavaScript SDK","source":"import { AssemblyAI } from \"assemblyai\";\n\nconst client = new AssemblyAI({ apiKey: process.env.ASSEMBLYAI_API_KEY });\n\nconst { matches } = await client.transcripts.wordSearch(\"\u003cTRANSCRIPT_ID>\", [\n \"foo\",\n \"bar\",\n \"foo bar\",\n]);\n\nfor (const match of matches) {\n console.log(`Found '${match.text}' ${match.count} times in the transcript`);\n}\n"},{"lang":"bash","label":"cURL","source":"curl -s \"https://api.assemblyai.com/v2/transcript/\u003cTRANSCRIPT_ID>/word-search?words=foo,bar,foo%20bar\" \\\n -H \"authorization: $ASSEMBLYAI_API_KEY\" | jq -c '.matches[] | {text, count}'\n"},{"lang":"python","label":"Python","source":"import os\n\nimport requests\n\nresponse = requests.get(\n \"https://api.assemblyai.com/v2/transcript/\u003cTRANSCRIPT_ID>/word-search\",\n headers={\"authorization\": os.environ[\"ASSEMBLYAI_API_KEY\"]},\n params={\"words\": \",\".join([\"foo\", \"bar\", \"foo bar\"])},\n)\n\nresponse.raise_for_status()\n\nfor match in response.json()[\"matches\"]:\n print(f\"Found '{match['text']}' {match['count']} times in the transcript\")\n"},{"lang":"javascript","label":"JavaScript","source":"const words = [\"foo\", \"bar\", \"foo bar\"];\nconst params = new URLSearchParams({ words: words.join(\",\") });\n\nconst response = await fetch(\n `https://api.assemblyai.com/v2/transcript/\u003cTRANSCRIPT_ID>/word-search?${params}`,\n { headers: { authorization: process.env.ASSEMBLYAI_API_KEY } },\n);\n\nconst { matches } = await response.json();\n\nfor (const match of matches) {\n console.log(`Found '${match.text}' ${match.count} times in the transcript`);\n}\n"}],"responses":{"200":"51db96b2-f89a-4899-b906-b203cd17202d","400":"b57483d4-d2de-4251-9e8b-d3d5df1cf1b6","401":"4072223e-5d39-4ee9-a0b9-15928f1acda4","404":"c0045ef7-9588-46d5-821c-36da9e5b6adc","429":"c180708b-c550-4c7e-9478-5f591735cfdd","500":"dfe3659a-7258-411d-a6aa-1da36a28a687","503":"5744205f-e309-4f8b-b2e7-e46ea200a8d5","504":"614b9d56-181b-4d06-b95e-5e6060923b72"},"method":"get","type":"path","servers":["90f40eae-7250-4ea8-a01b-fc04eabb210e"],"security":["da0aa2b4-d1f8-45b5-8ba0-ae4397fdd565"],"path":"/v2/transcript/{transcript_id}/word-search","baseUrlOptions":["https://api.assemblyai.com"],"title":"Search words in transcript","codeSamples":[{"label":"Python SDK","lang":"python","source":"import os\n\nimport assemblyai\nfrom assemblyai.prerecorded.v2 import Transcript\n\n# `Transcript.get_by_id()` uses the default client, which reads the global settings.\nassemblyai.settings.api_key = os.environ[\"ASSEMBLYAI_API_KEY\"]\n\ntranscript = Transcript.get_by_id(\"\u003cTRANSCRIPT_ID>\")\n\nmatches = transcript.word_search([\"foo\", \"bar\", \"foo bar\"])\n\nfor match in matches:\n print(f\"Found '{match.text}' {match.count} times in the transcript\")\n"},{"label":"JavaScript SDK","lang":"javascript","source":"import { AssemblyAI } from \"assemblyai\";\n\nconst client = new AssemblyAI({ apiKey: process.env.ASSEMBLYAI_API_KEY });\n\nconst { matches } = await client.transcripts.wordSearch(\"\u003cTRANSCRIPT_ID>\", [\n \"foo\",\n \"bar\",\n \"foo bar\",\n]);\n\nfor (const match of matches) {\n console.log(`Found '${match.text}' ${match.count} times in the transcript`);\n}\n"},{"label":"cURL","lang":"bash","source":"curl -s \"https://api.assemblyai.com/v2/transcript/\u003cTRANSCRIPT_ID>/word-search?words=foo,bar,foo%20bar\" \\\n -H \"authorization: $ASSEMBLYAI_API_KEY\" | jq -c '.matches[] | {text, count}'\n"},{"label":"Python","lang":"python","source":"import os\n\nimport requests\n\nresponse = requests.get(\n \"https://api.assemblyai.com/v2/transcript/\u003cTRANSCRIPT_ID>/word-search\",\n headers={\"authorization\": os.environ[\"ASSEMBLYAI_API_KEY\"]},\n params={\"words\": \",\".join([\"foo\", \"bar\", \"foo bar\"])},\n)\n\nresponse.raise_for_status()\n\nfor match in response.json()[\"matches\"]:\n print(f\"Found '{match['text']}' {match['count']} times in the transcript\")\n"},{"label":"JavaScript","lang":"javascript","source":"const words = [\"foo\", \"bar\", \"foo bar\"];\nconst params = new URLSearchParams({ words: words.join(\",\") });\n\nconst response = await fetch(\n `https://api.assemblyai.com/v2/transcript/\u003cTRANSCRIPT_ID>/word-search?${params}`,\n { headers: { authorization: process.env.ASSEMBLYAI_API_KEY } },\n);\n\nconst { matches } = await response.json();\n\nfor (const match of matches) {\n console.log(`Found '${match.text}' ${match.count} times in the transcript`);\n}\n"}],"requiredOnlyExamples":false,"requestExampleType":"codeSamples","responseExampleType":"generated"},"dependencies":{"parameters":{"e2976195-0a5f-4d6a-962a-530b94c93fa3":{"name":"transcript_id","x-label":"Transcript ID","in":"path","description":"ID of the transcript","required":true,"schema":{"type":"string","isRequired":true,"description":"ID of the transcript","uniqueKey":"","typeLabel":"string"}},"2ffa8168-d09a-4180-a613-cfc114d359f8":{"name":"words","x-label":"Words","in":"query","description":"Keywords to search for","required":true,"style":"form","explode":false,"schema":{"type":"array","items":{"x-label":"Word","type":"string","uniqueKey":"items.[INDEX]","typeLabel":"string"},"isRequired":true,"description":"Keywords to search for","uniqueKey":"","typeLabel":"string[]"}}},"responses":{"51db96b2-f89a-4899-b906-b203cd17202d":{"description":"Word search response","content":{"application/json":{"schema":{"x-label":"Word search response","type":"object","x-fern-sdk-group-name":"transcripts","additionalProperties":false,"properties":{"id":{"x-label":"Transcript ID","description":"The ID of the transcript","type":"string","format":"uuid","isRequired":true,"uniqueKey":"id","typeLabel":"string\u003cuuid>"},"total_count":{"x-label":"Total count of matches","description":"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.","type":"integer","isRequired":true,"uniqueKey":"total_count","typeLabel":"integer"},"matches":{"x-label":"Matches","description":"The matches of the search","type":"array","items":{"type":"object","x-label":"Match","x-fern-sdk-group-name":"transcripts","additionalProperties":false,"properties":{"text":{"x-label":"Text","description":"The matched word","type":"string","isRequired":true,"uniqueKey":"matches.items.[INDEX].text","typeLabel":"string"},"count":{"x-label":"Count","description":"The total amount of times the word is in the transcript","type":"integer","isRequired":true,"uniqueKey":"matches.items.[INDEX].count","typeLabel":"integer"},"timestamps":{"x-label":"Timestamps","description":"An array of timestamps","type":"array","items":{"x-label":"Timestamp","description":"An array of timestamps structured as [`start_time`, `end_time`] in milliseconds","x-fern-sdk-group-name":"transcripts","type":"array","items":{"x-label":"Timestamp","description":"Timestamp in milliseconds","type":"integer","uniqueKey":"matches.items.[INDEX].timestamps.items.[INDEX].items.[INDEX]","typeLabel":"integer"},"example":[250,650],"uniqueKey":"matches.items.[INDEX].timestamps.items.[INDEX]","typeLabel":"integer[]"},"isRequired":true,"uniqueKey":"matches.items.[INDEX].timestamps","typeLabel":"integer[][]"},"indexes":{"x-label":"Indexes","description":"An array of all index locations for that word within the `words` array of the completed transcript","type":"array","items":{"x-label":"Index","type":"integer","uniqueKey":"matches.items.[INDEX].indexes.items.[INDEX]","typeLabel":"integer"},"isRequired":true,"uniqueKey":"matches.items.[INDEX].indexes","typeLabel":"integer[]"}},"required":["text","count","timestamps","indexes"],"example":{"text":"smoke","count":6,"timestamps":[[250,650],[49168,49398],[55284,55594],[168888,169118],[215108,215386],[225944,226170]],"indexes":[0,136,156,486,652,698]},"uniqueKey":"matches.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"matches","typeLabel":"object[]"}},"required":["id","total_count","matches"],"example":{"id":"d5a3d302-066e-43fb-b63b-8f57baf185db","total_count":10,"matches":[{"text":"smoke","count":6,"timestamps":[[250,650],[49168,49398],[55284,55594],[168888,169118],[215108,215386],[225944,226170]],"indexes":[0,136,156,486,652,698]},{"text":"wildfires","count":4,"timestamps":[[1668,2346],[33852,34546],[50118,51110],[231356,232354]],"indexes":[4,90,140,716]}]},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"id":"d5a3d302-066e-43fb-b63b-8f57baf185db","total_count":10,"matches":[{"text":"smoke","count":6,"timestamps":[[250,650],[49168,49398],[55284,55594],[168888,169118],[215108,215386],[225944,226170]],"indexes":[0,136,156,486,652,698]},{"text":"wildfires","count":4,"timestamps":[[1668,2346],[33852,34546],[50118,51110],[231356,232354]],"indexes":[4,90,140,716]}]}}},"exampleType":"generated"}},"exampleType":"generated"},"b57483d4-d2de-4251-9e8b-d3d5df1cf1b6":{"x-label":"Bad request","description":"Bad request","content":{"application/json":{"schema":{"x-label":"Error","type":"object","additionalProperties":true,"required":["error"],"properties":{"error":{"x-label":"Error message","description":"Error message","type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"status":{"x-label":"Status","type":"string","const":"error","uniqueKey":"status","typeLabel":"string"}},"example":{"error":"Transcript creation error, audio_url not found"},"uniqueKey":"","typeLabel":"object"},"example":{"error":"This is a sample error message"},"examples":{"Example":{"title":"Example","value":{"error":"This is a sample error message"}}},"exampleType":"examples"}},"exampleType":"examples"},"4072223e-5d39-4ee9-a0b9-15928f1acda4":{"x-label":"Unauthorized","description":"Unauthorized","content":{"application/json":{"schema":{"x-label":"Error","type":"object","additionalProperties":true,"required":["error"],"properties":{"error":{"x-label":"Error message","description":"Error message","type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"status":{"x-label":"Status","type":"string","const":"error","uniqueKey":"status","typeLabel":"string"}},"example":{"error":"Transcript creation error, audio_url not found"},"uniqueKey":"","typeLabel":"object"},"example":{"error":"Authentication error, API token missing/invalid"},"examples":{"Example":{"title":"Example","value":{"error":"Authentication error, API token missing/invalid"}}},"exampleType":"examples"}},"exampleType":"examples"},"c0045ef7-9588-46d5-821c-36da9e5b6adc":{"x-label":"Not found","description":"Not found","content":{"application/json":{"schema":{"x-label":"Error","type":"object","additionalProperties":true,"required":["error"],"properties":{"error":{"x-label":"Error message","description":"Error message","type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"status":{"x-label":"Status","type":"string","const":"error","uniqueKey":"status","typeLabel":"string"}},"example":{"error":"Transcript creation error, audio_url not found"},"uniqueKey":"","typeLabel":"object"},"example":{"error":"Not found"},"examples":{"Example":{"title":"Example","value":{"error":"Not found"}}},"exampleType":"examples"}},"exampleType":"examples"},"c180708b-c550-4c7e-9478-5f591735cfdd":{"x-label":"Too many requests","description":"Too many requests","content":{"application/json":{"schema":{"x-label":"Error","type":"object","additionalProperties":true,"required":["error"],"properties":{"error":{"x-label":"Error message","description":"Error message","type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"status":{"x-label":"Status","type":"string","const":"error","uniqueKey":"status","typeLabel":"string"}},"example":{"error":"Transcript creation error, audio_url not found"},"uniqueKey":"","typeLabel":"object"},"example":{"error":"Too Many Requests"},"examples":{"Example":{"title":"Example","value":{"error":"Too Many Requests"}}},"exampleType":"examples"}},"headers":{"Retry-After":{"description":"The number of seconds to wait before retrying the request","schema":{"type":"integer"}}},"exampleType":"examples"},"dfe3659a-7258-411d-a6aa-1da36a28a687":{"x-label":"Internal server error","description":"An error occurred while processing the request","content":{"application/json":{"schema":{"x-label":"Error","type":"object","additionalProperties":true,"required":["error"],"properties":{"error":{"x-label":"Error message","description":"Error message","type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"status":{"x-label":"Status","type":"string","const":"error","uniqueKey":"status","typeLabel":"string"}},"example":{"error":"Transcript creation error, audio_url not found"},"uniqueKey":"","typeLabel":"object"},"example":{"error":"Internal server error. Please retry your request. If the error persists, please contact support@assemblyai.com for more information."},"examples":{"Example":{"title":"Example","value":{"error":"Internal server error. Please retry your request. If the error persists, please contact support@assemblyai.com for more information."}}},"exampleType":"examples"}},"exampleType":"examples"},"5744205f-e309-4f8b-b2e7-e46ea200a8d5":{"x-label":"Service unavailable","description":"Service unavailable","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"614b9d56-181b-4d06-b95e-5e6060923b72":{"x-label":"Gateway timeout","description":"Gateway timeout","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}}},"security":{"da0aa2b4-d1f8-45b5-8ba0-ae4397fdd565":{"ApiKey":{"type":"apiKey","in":"header","name":"Authorization","description":"Add your AssemblyAI API key as the Authorization header value. Required on every request.","scopes":[],"schemeName":"ApiKey"}}},"servers":{"90f40eae-7250-4ea8-a01b-fc04eabb210e":{"url":"https://api.assemblyai.com","description":"AssemblyAI API","x-fern-server-name":"Default"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"Authorization","description":"Add your AssemblyAI API key as the Authorization header value. Required on every request.","scopes":[],"schemeName":"ApiKey"},"schema":{"title":"Authorization","type":"string","description":"Add your AssemblyAI API key as the Authorization header value. Required on every request.","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"ApiKey","name":"Authorization"}],"title":"ApiKey"}]},"originalFileLocation":"openapi.yaml"},"subdomain":"assemblyai-fff14a6f","siteName":"AssemblyAI","title":"Word search - AssemblyAI","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-07-20T20:00:27.242Z","originalFileLocation":"pre-recorded-audio/api-reference/transcripts/word-search.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"To search through a transcription created on our EU server, replace api.assemblyai.com with api.eu.assemblyai.com. Search through the transcript for keywords. You can search for individual words, numbers, or phrases containing up to five words or numbers.\">\u003cmeta data-mint-head name=\"application-name\" content=\"AssemblyAI\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/assemblyai-fff14a6f/IP3FX8MjuVkHah_W/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/docs/mintlify-assets/_mintlify/favicons/assemblyai-fff14a6f/IP3FX8MjuVkHah_W/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/assemblyai-fff14a6f/IP3FX8MjuVkHah_W/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/assemblyai-fff14a6f/IP3FX8MjuVkHah_W/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/assemblyai-fff14a6f/IP3FX8MjuVkHah_W/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/assemblyai-fff14a6f/IP3FX8MjuVkHah_W/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/assemblyai-fff14a6f/IP3FX8MjuVkHah_W/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/assemblyai-fff14a6f/IP3FX8MjuVkHah_W/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/assemblyai-fff14a6f/IP3FX8MjuVkHah_W/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Word search - AssemblyAI\">\u003cmeta data-mint-head property=\"og:description\" content=\"To search through a transcription created on our EU server, replace api.assemblyai.com with api.eu.assemblyai.com. Search through the transcript for keywords. You can search for individual words, numbers, or phrases containing up to five words or numbers.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"AssemblyAI\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://www.assemblyai.com/docs/pre-recorded-audio/api-reference/transcripts/word-search\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://assemblyai-fff14a6f.mintlify.site/docs/_mintlify/api/og/v2?division=API+reference\u0026amp;title=Word+search\u0026amp;description=%3CNote%3ETo+search+through+a+transcription+created+on+our+EU+server%2C+replace+%60api.assemblyai.com%60+with+%60api.eu.assemblyai.com%60.%3C%2FNote%3E%0ASearch+through+the+transcrip\u0026amp;theme=7f291be5810d1f7c5136ed41\u0026amp;signature=83fa1afb451ded8c24d0b9bd909691f61b054190a35708eff59f2a5f12216559\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Word search - AssemblyAI\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"To search through a transcription created on our EU server, replace api.assemblyai.com with api.eu.assemblyai.com. Search through the transcript for keywords. You can search for individual words, numbers, or phrases containing up to five words or numbers.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://assemblyai-fff14a6f.mintlify.site/docs/_mintlify/api/og/v2?division=API+reference\u0026amp;title=Word+search\u0026amp;description=%3CNote%3ETo+search+through+a+transcription+created+on+our+EU+server%2C+replace+%60api.assemblyai.com%60+with+%60api.eu.assemblyai.com%60.%3C%2FNote%3E%0ASearch+through+the+transcrip\u0026amp;theme=7f291be5810d1f7c5136ed41\u0026amp;signature=83fa1afb451ded8c24d0b9bd909691f61b054190a35708eff59f2a5f12216559\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/docs/mintlify-assets/_mintlify/favicons/assemblyai-fff14a6f/IP3FX8MjuVkHah_W/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"AssemblyAI\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#614fd2\">\u003clink data-mint-head rel=\"canonical\" href=\"https://www.assemblyai.com/docs/pre-recorded-audio/api-reference/transcripts/word-search\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/docs/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/pre-recorded-audio/api-reference/transcripts/word-search.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://www.assemblyai.com/#organization\",\"name\":\"AssemblyAI\",\"url\":\"https://www.assemblyai.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/assemblyai-fff14a6f/vMuNaI_PbWUbVeV0/assets/assemblyai-lockup-primary.svg?fit=max\u0026auto=format\u0026n=vMuNaI_PbWUbVeV0\u0026q=85\u0026s=808d2a677e2536423045d44b3f330ac2\"}},{\"@type\":\"WebSite\",\"@id\":\"https://www.assemblyai.com/docs#website\",\"name\":\"AssemblyAI\",\"url\":\"https://www.assemblyai.com/docs\",\"publisher\":{\"@id\":\"https://www.assemblyai.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://www.assemblyai.com/docs/pre-recorded-audio/api-reference/transcripts/word-search#webpage\",\"url\":\"https://www.assemblyai.com/docs/pre-recorded-audio/api-reference/transcripts/word-search\",\"name\":\"Word search\",\"description\":\"To search through a transcription created on our EU server, replace api.assemblyai.com with api.eu.assemblyai.com. Search through the transcript for keywords. You can search for individual words, numbers, or phrases containing up to five words or numbers.\",\"dateModified\":\"2026-07-20T20:00:27.242Z\",\"isPartOf\":{\"@id\":\"https://www.assemblyai.com/docs#website\"},\"breadcrumb\":{\"@id\":\"https://www.assemblyai.com/docs/pre-recorded-audio/api-reference/transcripts/word-search#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://www.assemblyai.com/docs/pre-recorded-audio/api-reference/transcripts/word-search#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"API reference\",\"item\":\"https://www.assemblyai.com/docs/pre-recorded-audio/api-reference/files/upload\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Word search\",\"item\":\"https://www.assemblyai.com/docs/pre-recorded-audio/api-reference/transcripts/word-search\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://www.assemblyai.com/docs/pre-recorded-audio/api-reference/transcripts/word-search#apireference\",\"headline\":\"Word search\",\"name\":\"Word search\",\"description\":\"To search through a transcription created on our EU server, replace api.assemblyai.com with api.eu.assemblyai.com. Search through the transcript for keywords. You can search for individual words, numbers, or phrases containing up to five words or numbers.\",\"url\":\"https://www.assemblyai.com/docs/pre-recorded-audio/api-reference/transcripts/word-search\",\"mainEntityOfPage\":{\"@id\":\"https://www.assemblyai.com/docs/pre-recorded-audio/api-reference/transcripts/word-search#webpage\"},\"dateModified\":\"2026-07-20T20:00:27.242Z\",\"publisher\":{\"@id\":\"https://www.assemblyai.com/#organization\"},\"isPartOf\":{\"@id\":\"https://www.assemblyai.com/docs#website\"}}]}\u003c/script>","agentPointerHref":"/docs/pre-recorded-audio/api-reference/transcripts/word-search.md","siteName":"AssemblyAI","nav":{"global":null,"tabs":[{"tab":"Overview","pages":[{"title":"Overview","href":""}]},{"tab":"Pre-recorded STT","groups":[{"group":"Getting started","pages":[{"title":"Quickstart","href":"/pre-recorded-audio/getting-started/transcribe-an-audio-file"},{"group":"Model selection","pages":[{"title":"Model selection","sidebarTitle":"Speech models","href":"/pre-recorded-audio/select-the-speech-model"},{"title":"assemblyai-stt-3-7 migration guide","sidebarTitle":"assemblyai-stt-3-7 migration guide","href":"/pre-recorded-audio/assemblyai-stt-3-7-migration-guide"}]}]},{"group":"Features","pages":[{"title":"Prompting and Keyterms","sidebarTitle":"Prompting and Keyterms","href":"/pre-recorded-audio/prompting"},{"title":"Medical Mode","href":"/pre-recorded-audio/medical-mode"},{"title":"Veterinary Mode (beta)","sidebarTitle":"Veterinary Mode","tag":"Beta","href":"/pre-recorded-audio/veterinary-mode"},{"title":"Speaker Diarization","sidebarTitle":"Speaker Diarization","href":"/pre-recorded-audio/label-speakers"},{"title":"Multichannel Transcription","sidebarTitle":"Multichannel Transcription","href":"/pre-recorded-audio/transcribe-multiple-audio-channels"},{"title":"Code Switching","sidebarTitle":"Code Switching","href":"/pre-recorded-audio/code-switching"},{"group":"Languages","pages":[{"title":"Automatic Language Detection","sidebarTitle":"Detect language automatically","href":"/pre-recorded-audio/language-detection"},{"title":"Set Language Manually","sidebarTitle":"Set language manually","href":"/pre-recorded-audio/set-language-manually"},{"title":"Supported Languages","sidebarTitle":"Supported languages","href":"/pre-recorded-audio/supported-languages"}]},{"title":"PII Redaction","sidebarTitle":"PII Redaction","href":"/pre-recorded-audio/redact-pii-from-transcripts"},{"title":"Content Moderation","sidebarTitle":"Content Moderation","href":"/pre-recorded-audio/detect-sensitive-content"},{"title":"Speech Threshold","sidebarTitle":"Speech Threshold","href":"/pre-recorded-audio/set-minimum-speech-threshold"},{"title":"Set the Start and End of the Transcript","sidebarTitle":"Set the start and end of the transcript","href":"/pre-recorded-audio/set-the-start-and-end-of-the-transcript"}]},{"group":"Formatting","pages":[{"title":"Punctuation and formatting","sidebarTitle":"Punctuation and formatting","href":"/pre-recorded-audio/formatting"},{"title":"Custom Spelling","sidebarTitle":"Custom Spelling","href":"/pre-recorded-audio/correct-spelling-of-terms"},{"title":"Verbatim","sidebarTitle":"Verbatim","href":"/pre-recorded-audio/include-filler-words"},{"title":"Profanity Filtering","sidebarTitle":"Profanity Filtering","href":"/pre-recorded-audio/filter-profanity-from-transcripts"}]},{"group":"Managing transcripts","pages":[{"title":"Transcript Status","sidebarTitle":"Check transcript status","href":"/pre-recorded-audio/check-transcript-status"},{"title":"Word Search","sidebarTitle":"Word Search","href":"/pre-recorded-audio/search-for-words-in-transcript"},{"title":"Transcript export options","sidebarTitle":"Export transcripts as SRT, VTT, or text","href":"/pre-recorded-audio/export-transcripts-as-srt-vtt-or-text"},{"title":"Delete Transcripts","sidebarTitle":"Delete transcripts","href":"/pre-recorded-audio/delete-transcripts"}]},{"group":"API reference","pages":[{"title":"Upload a media file","openapi":"openapi.yaml POST /v2/upload","href":"/pre-recorded-audio/api-reference/files/upload"},{"title":"Transcribe audio","openapi":"openapi.yaml POST /v2/transcript","href":"/pre-recorded-audio/api-reference/transcripts/submit"},{"title":"Get a transcript","openapi":"openapi.yaml GET /v2/transcript/{transcript_id}","href":"/pre-recorded-audio/api-reference/transcripts/get"},{"title":"Get transcript sentences","openapi":"openapi.yaml GET /v2/transcript/{transcript_id}/sentences","href":"/pre-recorded-audio/api-reference/transcripts/get-sentences"},{"title":"Get transcript paragraphs","openapi":"openapi.yaml GET /v2/transcript/{transcript_id}/paragraphs","href":"/pre-recorded-audio/api-reference/transcripts/get-paragraphs"},{"title":"Get subtitles","openapi":"openapi.yaml GET /v2/transcript/{transcript_id}/{subtitle_format}","href":"/pre-recorded-audio/api-reference/transcripts/get-subtitles"},{"title":"Get redacted audio","openapi":"openapi.yaml GET /v2/transcript/{transcript_id}/redacted-audio","description":"\u003cNote>To retrieve the redacted audio on the EU server, replace `api.assemblyai.com` with `api.eu.assemblyai.com` in the `GET` request above.\u003c/Note>\n\u003cNote>Redacted audio files are only available for 24 hours. Make sure to download the file within this time frame.\u003c/Note>\nRetrieve the redacted audio object containing the status and URL to the redacted audio.\n","href":"/pre-recorded-audio/api-reference/transcripts/get-redacted-audio"},{"title":"Word search","openapi":"openapi.yaml GET /v2/transcript/{transcript_id}/word-search","href":"/pre-recorded-audio/api-reference/transcripts/word-search"},{"title":"List transcripts","openapi":"openapi.yaml GET /v2/transcript","description":"\u003cNote>To retrieve your transcriptions on our EU server, replace `api.assemblyai.com` with `api.eu.assemblyai.com`.\u003c/Note>\nRetrieve a list of transcripts you created.\nTranscripts are sorted from newest to oldest and can be retrieved for the last 30 days of usage. The previous URL always points to a page with older transcripts.\n\n**Pagination**\n\nThis endpoint returns paginated results. The response includes a `page_details` object with the following properties:\n- `page_details.limit` - Maximum number of transcripts per page.\n- `page_details.result_count` - Total number of transcripts returned on the current page.\n- `page_details.current_url` - URL to the current page.\n- `page_details.prev_url` - URL to the previous page of older transcripts.\n- `page_details.next_url` - URL to the next page of newer transcripts.\n","href":"/pre-recorded-audio/api-reference/transcripts/list"},{"title":"Delete a transcript","openapi":"openapi.yaml DELETE /v2/transcript/{transcript_id}","href":"/pre-recorded-audio/api-reference/transcripts/delete"}]},{"group":"Advanced","pages":[{"title":"Webhooks for pre-recorded audio","sidebarTitle":"Webhooks","href":"/pre-recorded-audio/webhooks"},{"title":"Benchmarks","sidebarTitle":"View model benchmarks","href":"/pre-recorded-audio/benchmarks"},{"title":"Evaluating Pre-recorded STT models","sidebarTitle":"Evaluate model accuracy","href":"/pre-recorded-audio/evaluations"},{"title":"Cloud Endpoints and Data Residency","sidebarTitle":"Cloud endpoints \u0026 data residency","href":"/pre-recorded-audio/select-the-region"},{"title":"Rate limits","sidebarTitle":"Manage rate limits","href":"/pre-recorded-audio/rate-limits"}]},{"group":"Guides","pages":[{"group":"Migration guides","expanded":false,"pages":[{"title":"Migration guide: Deepgram to AssemblyAI","sidebarTitle":"Migration guide Deepgram to AssemblyAI","href":"/pre-recorded-audio/migration-guides/dg_to_aai"},{"title":"Migration guide: OpenAI to AssemblyAI","sidebarTitle":"Migration guide OpenAI to AssemblyAI","href":"/pre-recorded-audio/migration-guides/oai_to_aai"},{"title":"Migration guide: AWS Transcribe to AssemblyAI","sidebarTitle":"Migration guide AWS Transcribe to AssemblyAI","href":"/pre-recorded-audio/migration-guides/aws_to_aai"},{"title":"Migration guide: Google Speech-to-Text to AssemblyAI","sidebarTitle":"Migration guide Google Speech-to-Text to AssemblyAI","href":"/pre-recorded-audio/migration-guides/google_to_aai"},{"title":"Migration guide: Gladia to AssemblyAI","sidebarTitle":"Migration guide Gladia to AssemblyAI","href":"/pre-recorded-audio/migration-guides/gladia_to_aai"}]},{"group":"Tutorials","expanded":false,"pages":[{"title":"Best Practices for building Meeting Notetakers","sidebarTitle":"Build a meeting notetaker","href":"/meeting-notetaker-best-practices"},{"title":"Build a medical scribe","href":"/medical-scribe-best-practices"},{"title":"Best Practices for building Contact Center Applications","sidebarTitle":"Build a contact center application","href":"/contact-center-best-practices"},{"group":"Basic transcription workflows","pages":[{"title":"Get YouTube Video Transcripts with yt-dlp","href":"/pre-recorded-audio/guides/transcribe_youtube_videos"},{"title":"Build a UI for Transcription with Gradio and Python","href":"/pre-recorded-audio/guides/gradio-frontend"},{"title":"Detect Low Confidence Words in a Transcript","href":"/pre-recorded-audio/guides/detecting-low-confidence-words"}]},{"group":"Batch transcription","pages":[{"title":"Running Bulk Transcription and Load Tests at Scale","href":"/pre-recorded-audio/guides/bulk-transcription-and-load-tests-at-scale"},{"title":"Transcribe Multiple Files Simultaneously Using the JavaScript SDK","href":"/pre-recorded-audio/guides/sdk-node-batch"},{"title":"Transcribe Multiple Files Simultaneously Using the Python SDK","href":"/pre-recorded-audio/guides/batch_transcription"}]},{"group":"Hosting audio files","pages":[{"title":"Transcribe from an S3 Bucket","href":"/pre-recorded-audio/guides/transcribe_from_s3"},{"title":"Transcribe Google Drive Files","sidebarTitle":"Transcribe a Google Drive File","href":"/pre-recorded-audio/guides/transcribing-google-drive-file"},{"title":"Transcribe GitHub Files","href":"/pre-recorded-audio/guides/transcribing-github-files"}]},{"group":"Speaker labels","pages":[{"title":"Iterate over Speaker Labels with Make.com","href":"/pre-recorded-audio/guides/make-speaker-labels"},{"title":"Calculate the Talk / Listen Ratio of Speakers","href":"/pre-recorded-audio/guides/talk-listen-ratio"},{"title":"Plot A Speaker Timeline with Matplotlib","href":"/pre-recorded-audio/guides/speaker_timeline"},{"title":"Generate Custom Speaker Labels with Pyannote","href":"/pre-recorded-audio/guides/Use_AssemblyAI_with_Pyannote_to_generate_custom_Speaker_Labels"},{"title":"Use Speaker Diarization with Async Chunking","href":"/pre-recorded-audio/guides/speaker-diarization-with-async-chunking"},{"title":"Setup A Speaker Identification System using Pinecone \u0026 Nvidia TitaNet","href":"/pre-recorded-audio/guides/titanet-speaker-identification"}]},{"group":"Automatic Language Detection","pages":[{"title":"Use Automatic Language Detection as a Separate Step From Transcription","href":"/pre-recorded-audio/guides/automatic-language-detection-separate"},{"title":"Route to Default Language if Language Confidence is Low","href":"/pre-recorded-audio/guides/automatic-language-detection-route-default-language"}]},{"group":"Subtitles","pages":[{"title":"Create Custom Length Subtitles","href":"/pre-recorded-audio/guides/subtitle_creation_by_word_count"},{"title":"Create Subtitles with Speaker Labels","href":"/pre-recorded-audio/guides/speaker_labelled_subtitles"},{"title":"Generate Subtitles for Videos","href":"/pre-recorded-audio/guides/subtitles"},{"title":"Translate an AssemblyAI Subtitle Transcript","href":"/pre-recorded-audio/guides/translate_subtitles"}]},{"group":"Delete transcripts","pages":[{"title":"Schedule a DELETE request with AssemblyAI and EasyCron","href":"/pre-recorded-audio/guides/schedule_delete"}]},{"group":"Error handling and audio file fixes","pages":[{"title":"Troubleshoot Common Errors","href":"/pre-recorded-audio/guides/common_errors_and_solutions"},{"title":"Implement Retry Server Error Logic","href":"/pre-recorded-audio/guides/retry-server-error"},{"title":"Implement Retry Upload Error Logic","href":"/pre-recorded-audio/guides/retry-upload-error"},{"title":"Identify Duplicate Dual Channel Files","href":"/pre-recorded-audio/guides/identify_duplicate_channels"},{"title":"Correct Audio Duration Discrepancies with Multi-Tool Validation and Transcoding","href":"/pre-recorded-audio/guides/audio-duration-fix"},{"title":"Audio File Downsampling Recommendations and Best Practices","href":"/pre-recorded-audio/guides/downsampling"}]},{"group":"Translation","pages":[{"title":"Translate an AssemblyAI Subtitle Transcript","href":"/pre-recorded-audio/guides/translate_subtitles"},{"title":"Translate AssemblyAI Transcripts Into Other Languages Using Commercial Models","href":"/pre-recorded-audio/guides/translate_transcripts"},{"title":"Transform Chinese transcripts into Simplified or Traditional Text","href":"/pre-recorded-audio/guides/traditional_simplified_chinese"}]},{"group":"Do more with our SDKs","pages":[{"title":"Do More With Our SDKs","href":"/pre-recorded-audio/guides/do-more-with-sdk"}]}]}]}]},{"tab":"Real-time STT","pages":[{"title":"Real-time STT","href":"/streaming/getting-started/transcribe-streaming-audio"}]},{"tab":"Sync STT","pages":[{"title":"Sync STT","href":"/sync-stt/getting-started/quickstart"}]},{"tab":"Dictation API","pages":[{"title":"Dictation API","href":"/dictation"}]},{"tab":"Text to Speech","pages":[{"title":"Text to Speech","href":"/tts/getting-started/quickstart"}]},{"tab":"Voice Agent API","hidden":true,"pages":[{"title":"Voice Agent API","href":"/voice-agents/voice-agent-api"}]},{"tab":"Speech Understanding","pages":[{"title":"Speech Understanding","href":"/speech-understanding/getting-started"}]},{"tab":"LLM Gateway","pages":[{"title":"LLM Gateway","href":"/llm-gateway/quickstart"}]},{"tab":"FAQ","pages":[{"title":"FAQ","href":"/faq"}]}]},"basePath":"","title":"Word search - AssemblyAI","deploymentId":"dpl_C8nwD4Qo785i7PBDK32YZuKGR9Lm","buildId":"dpl_C8nwD4Qo785i7PBDK32YZuKGR9Lm","dynamics":["10e4515597","c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["BannerMarkdown-haQH9fri.js","dist-Bb1ZYRob.js","lib-DMeTj1gb.js","lib-B8HbPgcC.js","katex-Dbtb6Wk7.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js","OpenApiReferenceProvider-BHpAblIa.js","snippetPresets-C-QjF0k_.js","utils-Dz5URj_u.js","style-to-object-BY3JEAdk.js","utils-Da_yhPn5.js","v4-DIgz8zy6.js","addUniqueKeysToSchema-CIIxiDBb.js","conditional-requirements-CFM0id0Q.js","cloneDeep-k_8athT8.js","_Uint8Array-3TACpfVy.js","isObject-FP1Yky1u.js","ApiExamples-BwENSgQX.js","usePlaygroundInputsStore-Bwm_Juam.js","shallow-DiWjILlR.js","isEqual-D8db76Nf.js","CodeSnippets-DkFc-r7T.js","CodeSnippet-DzxI2vN3.js","getApiPlaygroundDisplay-Co0Ej2uF.js","Page-Dq2tE-AS.js","DynamicMarkdown-3piqoEk_.js","SectionHeading-BfyA8rV0.js","icon-Dz7YG_yb.js","MethodPill-D7hco0-Q.js","getPastedJson-DYtIXN3i.js","DuplicateIcon-CWgJhuEu.js","axios-CsQoIw0U.js","Markdown-Bj6sjipA.js","AssistantPageLink-vuoZnuCk.js"]}