# pip install vizlook
from vizlook import Vizlook
vizlook = Vizlook(api_key="YOUR_VIZLOOK_API_KEY")
response = vizlook.answer(
"What is ChatGPT?",
include_transcription=True,
)
print("response with original API field name: ")
print(response.to_dict())
print("response with snake case field name: ")
print(response.to_dict(use_api_field_name=False))
print("get field value with snake case key from pydantic model: ")
print(response.answer)
{ "answer": "ChatGPT is an artificial intelligence (AI) chatbot developed by OpenAI and released in 2022. It is a generative AI tool that allows users to interact with it in a way that simulates natural conversation, responding to questions and requests.", "citations": [ { "url": "https://www.youtube.com/watch?v=j5vQ6oXSZpU", "title": "What makes OpenAI's new GPT-5 different from past versions?", "description": "OpenAI on Thursday launched GPT-5, the latest generation of the artificial intelligence technology that powers ChatGPT. OpenAI said the new model is faster and smarter than ever before. Technology journalist Jacob Ward joins CBS News to discuss the release.\n\nCBS News 24/7 is the premier anchored streaming news service from CBS News and Stations that is available free to everyone with access to the internet and is the destination for breaking news, live events, original reporting and storytelling, and programs from CBS News and Stations' top anchors and correspondents working locally, nationally and around the globe. It is available on more than 30 platforms across mobile, desktop and connected TVs for free, as well as CBSNews.com and Paramount+ and live in 91 countries.", "thumbnail": { "url": "https://i.ytimg.com/vi/j5vQ6oXSZpU/sddefault.jpg", "width": 640, "height": 480 }, "author": { "name": "CBS News", "url": "https://www.youtube.com/@cbsnews", "avatar": "https://yt3.ggpht.com/ytc/AIdro_niBFv49gSx4rr1afMZU_Pv7SeuPKO2SMHvv0Ar7OKxM4o=s88-c-k-c0x00ffffff-no-rj" }, "publishedDate": "2025-08-07T21:07:09.000Z", "duration": 359, "favicon": "https://www.youtube.com/s/desktop/f788da0a/img/logos/favicon_48x48.png", "score": 0.8580227, "highlights": [ { "startTime": 0, "endTime": 23, "visualDescription": "A male presenter in a dark long-sleeved shirt and jeans stands in a modern, brightly lit office space with plants and wooden accents. He gestures with his hands as he speaks. The background shows a large white screen displaying 'GPT-5'. An inset video then appears, showing a woman looking at a laptop, which displays a 'ChatGPT 5' interface. The interface shows a schedule planning assistant, detailing a day's schedule from coffee with Grant to a flight departure, and includes 'Two quick email actions' and a 'Light packing list'. The woman nods and smiles. Overlapping text on screen announces 'OPENAI RELEASES GPT-5 FIFTH GENERATION OF THE A.I. TECHNOLOGY THAT POWERS CHATGPT'.", "audioTranscription": "Welcome into CBS News 24/7, OpenAI launches GPT-5, it's the latest generation of the artificial intelligence technology that powers ChatGPT.\nOpenAI says the new model is faster and smarter than ever before, it comes more than two years after the release of its predecessor, and expectations are high." } ], "transcription": { "videoClips": [ { "startTime": 0, "endTime": 23, "visualDescription": "A male presenter in a dark long-sleeved shirt and jeans stands in a modern, brightly lit office space with plants and wooden accents. He gestures with his hands as he speaks. The background shows a large white screen displaying 'GPT-5'. An inset video then appears, showing a woman looking at a laptop, which displays a 'ChatGPT 5' interface. The interface shows a schedule planning assistant, detailing a day's schedule from coffee with Grant to a flight departure, and includes 'Two quick email actions' and a 'Light packing list'. The woman nods and smiles. Overlapping text on screen announces 'OPENAI RELEASES GPT-5 FIFTH GENERATION OF THE A.I. TECHNOLOGY THAT POWERS CHATGPT'." }, { "startTime": 24, "endTime": 43, "visualDescription": "A male tech journalist, Jacob Ward, wearing a plaid shirt and dark pants, stands opposite a female presenter in a light blue suit. They are on a brightly lit studio set with a large purple background displaying 'CBS NEWS TECHWATCH' in white bold letters with circuit board graphics. The female presenter holds a tablet and gestures while speaking. A smaller screen to the left shows the previous segment with the man presenting in the modern office, and then a graphic that says 'Introducing ChatGPT'." } ], "audioClips": [ { "startTime": 1, "endTime": 10, "transcription": "Welcome into CBS News 24/7, OpenAI launches GPT-5, it's the latest generation of the artificial intelligence technology that powers ChatGPT.", "speakerId": "speaker_1" }, { "startTime": 11, "endTime": 23, "transcription": "OpenAI says the new model is faster and smarter than ever before, it comes more than two years after the release of its predecessor, and expectations are high.", "speakerId": "speaker_1" }, { "startTime": 24, "endTime": 35, "transcription": "So I want to bring in Jacob Ward, technology journalist, host of The Rip Current podcast.", "speakerId": "speaker_1" }, { "startTime": 35, "endTime": 38, "transcription": "Thanks for being here, also the author of The Loop, How Technology is Creating World Without Choices, and How to Fight Back.", "speakerId": "speaker_1" }, { "startTime": 38, "endTime": 43, "transcription": "Okay, first things first, we're talking about this release of ChatGPT-5.", "speakerId": "speaker_1" } ] } } ], "dollarCost": { "total": 0.01 }}
API Reference
Answer
The /answer endpoint leverages Vizlook search results and an LLM to provide answers, offering direct responses for specific queries and detailed, cited summaries for open-ended questions.
Each response includes both the LLM’s answer and the sources utilized. Furthermore, the endpoint supports streaming (by setting stream true), delivering tokens as they are generated.
# pip install vizlook
from vizlook import Vizlook
vizlook = Vizlook(api_key="YOUR_VIZLOOK_API_KEY")
response = vizlook.answer(
"What is ChatGPT?",
include_transcription=True,
)
print("response with original API field name: ")
print(response.to_dict())
print("response with snake case field name: ")
print(response.to_dict(use_api_field_name=False))
print("get field value with snake case key from pydantic model: ")
print(response.answer)
{ "answer": "ChatGPT is an artificial intelligence (AI) chatbot developed by OpenAI and released in 2022. It is a generative AI tool that allows users to interact with it in a way that simulates natural conversation, responding to questions and requests.", "citations": [ { "url": "https://www.youtube.com/watch?v=j5vQ6oXSZpU", "title": "What makes OpenAI's new GPT-5 different from past versions?", "description": "OpenAI on Thursday launched GPT-5, the latest generation of the artificial intelligence technology that powers ChatGPT. OpenAI said the new model is faster and smarter than ever before. Technology journalist Jacob Ward joins CBS News to discuss the release.\n\nCBS News 24/7 is the premier anchored streaming news service from CBS News and Stations that is available free to everyone with access to the internet and is the destination for breaking news, live events, original reporting and storytelling, and programs from CBS News and Stations' top anchors and correspondents working locally, nationally and around the globe. It is available on more than 30 platforms across mobile, desktop and connected TVs for free, as well as CBSNews.com and Paramount+ and live in 91 countries.", "thumbnail": { "url": "https://i.ytimg.com/vi/j5vQ6oXSZpU/sddefault.jpg", "width": 640, "height": 480 }, "author": { "name": "CBS News", "url": "https://www.youtube.com/@cbsnews", "avatar": "https://yt3.ggpht.com/ytc/AIdro_niBFv49gSx4rr1afMZU_Pv7SeuPKO2SMHvv0Ar7OKxM4o=s88-c-k-c0x00ffffff-no-rj" }, "publishedDate": "2025-08-07T21:07:09.000Z", "duration": 359, "favicon": "https://www.youtube.com/s/desktop/f788da0a/img/logos/favicon_48x48.png", "score": 0.8580227, "highlights": [ { "startTime": 0, "endTime": 23, "visualDescription": "A male presenter in a dark long-sleeved shirt and jeans stands in a modern, brightly lit office space with plants and wooden accents. He gestures with his hands as he speaks. The background shows a large white screen displaying 'GPT-5'. An inset video then appears, showing a woman looking at a laptop, which displays a 'ChatGPT 5' interface. The interface shows a schedule planning assistant, detailing a day's schedule from coffee with Grant to a flight departure, and includes 'Two quick email actions' and a 'Light packing list'. The woman nods and smiles. Overlapping text on screen announces 'OPENAI RELEASES GPT-5 FIFTH GENERATION OF THE A.I. TECHNOLOGY THAT POWERS CHATGPT'.", "audioTranscription": "Welcome into CBS News 24/7, OpenAI launches GPT-5, it's the latest generation of the artificial intelligence technology that powers ChatGPT.\nOpenAI says the new model is faster and smarter than ever before, it comes more than two years after the release of its predecessor, and expectations are high." } ], "transcription": { "videoClips": [ { "startTime": 0, "endTime": 23, "visualDescription": "A male presenter in a dark long-sleeved shirt and jeans stands in a modern, brightly lit office space with plants and wooden accents. He gestures with his hands as he speaks. The background shows a large white screen displaying 'GPT-5'. An inset video then appears, showing a woman looking at a laptop, which displays a 'ChatGPT 5' interface. The interface shows a schedule planning assistant, detailing a day's schedule from coffee with Grant to a flight departure, and includes 'Two quick email actions' and a 'Light packing list'. The woman nods and smiles. Overlapping text on screen announces 'OPENAI RELEASES GPT-5 FIFTH GENERATION OF THE A.I. TECHNOLOGY THAT POWERS CHATGPT'." }, { "startTime": 24, "endTime": 43, "visualDescription": "A male tech journalist, Jacob Ward, wearing a plaid shirt and dark pants, stands opposite a female presenter in a light blue suit. They are on a brightly lit studio set with a large purple background displaying 'CBS NEWS TECHWATCH' in white bold letters with circuit board graphics. The female presenter holds a tablet and gestures while speaking. A smaller screen to the left shows the previous segment with the man presenting in the modern office, and then a graphic that says 'Introducing ChatGPT'." } ], "audioClips": [ { "startTime": 1, "endTime": 10, "transcription": "Welcome into CBS News 24/7, OpenAI launches GPT-5, it's the latest generation of the artificial intelligence technology that powers ChatGPT.", "speakerId": "speaker_1" }, { "startTime": 11, "endTime": 23, "transcription": "OpenAI says the new model is faster and smarter than ever before, it comes more than two years after the release of its predecessor, and expectations are high.", "speakerId": "speaker_1" }, { "startTime": 24, "endTime": 35, "transcription": "So I want to bring in Jacob Ward, technology journalist, host of The Rip Current podcast.", "speakerId": "speaker_1" }, { "startTime": 35, "endTime": 38, "transcription": "Thanks for being here, also the author of The Loop, How Technology is Creating World Without Choices, and How to Fight Back.", "speakerId": "speaker_1" }, { "startTime": 38, "endTime": 43, "transcription": "Okay, first things first, we're talking about this release of ChatGPT-5.", "speakerId": "speaker_1" } ] } } ], "dollarCost": { "total": 0.01 }}
The generated answer based on search results. if no search results, return empty string "".
Example:
"ChatGPT is an artificial intelligence (AI) chatbot developed by OpenAI and released in 2022. It is a generative AI tool that allows users to interact with it in a way that simulates natural conversation, responding to questions and requests."
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Vizlook","description":"Enable your AI to query video with simple and contextual comprehension APIs. Try it free!","colors":{"primary":"#2563EB","light":"#2563EB","dark":"#2563EB"},"logo":{"light":"https://mintcdn.com/maxai/o9Qb4RVdnxqLUMwp/logo/logo.png?fit=max\u0026auto=format\u0026n=o9Qb4RVdnxqLUMwp\u0026q=85\u0026s=c57f6202b02bd5169a75c2a6efce44d9","dark":"https://mintcdn.com/maxai/o9Qb4RVdnxqLUMwp/logo/logo.png?fit=max\u0026auto=format\u0026n=o9Qb4RVdnxqLUMwp\u0026q=85\u0026s=c57f6202b02bd5169a75c2a6efce44d9"},"favicon":"/favicon.ico","api":{"playground":{"display":"simple"},"examples":{"defaults":"required","languages":["cURL","Python","JavaScript"]}},"navbar":{"links":[{"label":"Support","href":"mailto:support@vizlook.com"}],"primary":{"type":"button","label":"Dashboard","href":"https://www.vizlook.com/dashboard/api-keys"}},"footer":{"socials":{"github":"https://github.com/vizlook"}},"contextual":{"options":["copy","view"]},"navigation":{"global":{"anchors":[{"anchor":"GitHub","icon":"github","href":"https://github.com/vizlook"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"maxai","hasAudioNarration":false,"actualSubdomain":"maxai","customDomains":["docs.vizlook.com"],"gitSource":{"type":"github","owner":"watchsky","repo":"vizlook-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6a20cb4d6bbb46a0adf9776c","collectionId":"257809f1-8733-4106-a2a5-d6311c1af732","schemaVersion":"v2"},"entitlements":{},"buildId":"6a20cb4d6bbb46a0adf9776c:success","clientVersion":"0.0.4043","searchFilterCounts":[{"language":"default","tag":"Documentation","count":11},{"language":"default","tag":"Platform","count":6},{"language":"default","tag":"SDKs","count":4},{"language":"default","tag":"API Reference","count":3},{"language":"default","tag":"Getting Started","count":2}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","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":"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":"llms-txt-v2","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":"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":"byok-sep-25","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":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","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}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"#ask-ai-code-block-button,#assistant-entry,#assistant-entry-mobile,#chat-assistant-sheet,#chat-assistant-textarea{display:none}.no-margin{margin:0}"}],"page":{"pagePath":"documentation/api-reference/answer","slug":"/documentation/api-reference/answer","pageMetadata":{"title":"Answer","description":"The `/answer` endpoint leverages Vizlook search results and an LLM to provide answers, offering direct responses for specific queries and detailed, cited summaries for open-ended questions.\u003cbr />\u003cbr />Each response includes both the LLM's answer and the sources utilized. Furthermore, the endpoint supports streaming (by setting `stream` true), delivering tokens as they are generated.","openapi":"POST /answer","href":"/documentation/api-reference/answer"},"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 };\n return _jsxs(_components.p, {\n children: [\"The \", _jsx(_components.code, {\n children: \"/answer\"\n }), \" endpoint leverages Vizlook search results and an LLM to provide answers, offering direct responses for specific queries and detailed, cited summaries for open-ended questions.\", _jsx(\"br\", {}), _jsx(\"br\", {}), \"Each response includes both the LLM’s answer and the sources utilized. Furthermore, the endpoint supports streaming (by setting \", _jsx(_components.code, {\n children: \"stream\"\n }), \" true), delivering tokens as they are generated.\"]\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};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const{Card}={..._provideComponents(),...props.components};if(!Card)_missingMdxReference(`Card`,true);return _jsx(Card,{horizontal:`true`,arrow:`true`,title:`Get Your Vizlook API Key`,icon:`key`,href:`https://www.vizlook.com/dashboard/api-keys`,children:`Sign up and receive $10 free credit.`})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Answer","description":"The `/answer` endpoint leverages Vizlook search results and an LLM to provide answers, offering direct responses for specific queries and detailed, cited summaries for open-ended questions.\u003cbr />\u003cbr />Each response includes both the LLM's answer and the sources utilized. Furthermore, the endpoint supports streaming (by setting `stream` true), delivering tokens as they are generated.","openapi":"POST /answer","href":"/documentation/api-reference/answer"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"requestBody":"22b88808-0253-405f-b610-c08cd60a0152","responses":{"200":"d83dc8ca-b355-44bf-83fc-fa990e95adce"},"x-codeSamples":[{"lang":"bash","source":"curl -X POST 'https://api.vizlook.com/answer' \\\n -H 'x-api-key: YOUR_VIZLOOK_API_KEY' \\\n -H 'Content-Type: application/json' \\\n -d '{\n \"query\": \"What is ChatGPT?\",\n \"contentOptions\": {\n \"includeTranscription\": true\n }\n }'"},{"lang":"python","source":"# pip install vizlook\nfrom vizlook import Vizlook\n\nvizlook = Vizlook(api_key=\"YOUR_VIZLOOK_API_KEY\")\n\nresponse = vizlook.answer(\n \"What is ChatGPT?\",\n include_transcription=True,\n)\n\nprint(\"response with original API field name: \")\nprint(response.to_dict())\n\nprint(\"response with snake case field name: \")\nprint(response.to_dict(use_api_field_name=False))\n\nprint(\"get field value with snake case key from pydantic model: \")\nprint(response.answer)"},{"lang":"javascript","source":"// npm install @vizlook/sdk\nimport Vizlook from \"@vizlook/sdk\";\n\nconst vizlook = new Vizlook({\n apiKey: \"YOUR_VIZLOOK_API_KEY\",\n});\n\nconst response = await vizlook.answer(\"What is ChatGPT?\", {\n includeTranscription: true,\n});\nconsole.log(\"Answer:\", response.answer);\nconsole.log(\"Citations:\", response.citations);"}],"method":"post","type":"path","servers":["6610980d-6390-4849-a7d9-bf236f88f65a"],"security":["659a6027-bc96-4701-91db-c1d75ce2eb05"],"path":"/answer","baseUrlOptions":["https://api.vizlook.com"],"title":"","description":"The `/answer` endpoint leverages Vizlook search results and an LLM to provide answers, offering direct responses for specific queries and detailed, cited summaries for open-ended questions.\u003cbr />\u003cbr />Each response includes both the LLM's answer and the sources utilized. Furthermore, the endpoint supports streaming (by setting `stream` true), delivering tokens as they are generated.","codeSamples":[{"lang":"bash","source":"curl -X POST 'https://api.vizlook.com/answer' \\\n -H 'x-api-key: YOUR_VIZLOOK_API_KEY' \\\n -H 'Content-Type: application/json' \\\n -d '{\n \"query\": \"What is ChatGPT?\",\n \"contentOptions\": {\n \"includeTranscription\": true\n }\n }'"},{"lang":"python","source":"# pip install vizlook\nfrom vizlook import Vizlook\n\nvizlook = Vizlook(api_key=\"YOUR_VIZLOOK_API_KEY\")\n\nresponse = vizlook.answer(\n \"What is ChatGPT?\",\n include_transcription=True,\n)\n\nprint(\"response with original API field name: \")\nprint(response.to_dict())\n\nprint(\"response with snake case field name: \")\nprint(response.to_dict(use_api_field_name=False))\n\nprint(\"get field value with snake case key from pydantic model: \")\nprint(response.answer)"},{"lang":"javascript","source":"// npm install @vizlook/sdk\nimport Vizlook from \"@vizlook/sdk\";\n\nconst vizlook = new Vizlook({\n apiKey: \"YOUR_VIZLOOK_API_KEY\",\n});\n\nconst response = await vizlook.answer(\"What is ChatGPT?\", {\n includeTranscription: true,\n});\nconsole.log(\"Answer:\", response.answer);\nconsole.log(\"Citations:\", response.citations);"}],"requestExampleLanguages":["bash","python","javascript"],"requiredOnlyExamples":true,"requestExampleType":"codeSamples","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"content":{"application/json":{"schema":{"required":["query"],"type":"object","properties":{"query":{"description":"The query to answer.","type":"string","example":"What is ChatGPT?","isRequired":true,"uniqueKey":"query","typeLabel":"string"},"stream":{"description":"Enable streaming mode. If true, the response is returned as a server-sent events (SSE) stream.","type":"boolean","example":true,"uniqueKey":"stream","typeLabel":"boolean"},"contentOptions":{"description":"Configure what answer citations include.","type":"object","properties":{"includeTranscription":{"description":"Whether to include video transcription in the answer citations.","type":"boolean","example":true,"uniqueKey":"contentOptions.includeTranscription","typeLabel":"boolean"}},"uniqueKey":"contentOptions","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"query":"What is ChatGPT?","stream":true,"contentOptions":{"includeTranscription":true}}}},"exampleType":"generated"}},"required":true,"exampleType":"generated"},"responses":{"d83dc8ca-b355-44bf-83fc-fa990e95adce":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"answer":{"description":"The generated answer based on search results. if no search results, return empty string `\"\"`.","type":"string","example":"ChatGPT is an artificial intelligence (AI) chatbot developed by OpenAI and released in 2022. It is a generative AI tool that allows users to interact with it in a way that simulates natural conversation, responding to questions and requests.","uniqueKey":"answer","typeLabel":"string"},"citations":{"description":"Search results used to generate the answer.","type":"array","items":{"type":"object","properties":{"url":{"description":"The video page URL.","type":"string","example":"https://www.youtube.com/watch?v=2FMBSblpcrc","uniqueKey":"citations.items.[INDEX].url","typeLabel":"string"},"title":{"description":"The video title.","type":"string","example":"How to use one paper towel | Joe Smith | TEDxConcordiaUPortland","uniqueKey":"citations.items.[INDEX].title","typeLabel":"string"},"description":{"description":"The video description.","type":"string","example":"R. P. Joe Smith served as a District Attorney in Umatilla County and nearly won a race for Oregon Attorney General without taking a single contribution over $99.99.","uniqueKey":"citations.items.[INDEX].description","typeLabel":"string"},"thumbnail":{"description":"The video thumbnail image.","type":"object","properties":{"url":{"description":"image URL","type":"string","example":"https://i.ytimg.com/vi/2FMBSblpcrc/sddefault.jpg","uniqueKey":"citations.items.[INDEX].thumbnail.url","typeLabel":"string"},"width":{"description":"image width","type":"integer","example":640,"uniqueKey":"citations.items.[INDEX].thumbnail.width","typeLabel":"integer"},"height":{"description":"image height","type":"integer","example":480,"uniqueKey":"citations.items.[INDEX].thumbnail.height","typeLabel":"integer"}},"uniqueKey":"citations.items.[INDEX].thumbnail","typeLabel":"object"},"author":{"description":"The information of video author.","type":"object","properties":{"name":{"description":"author name","type":"string","example":"TEDx Talks","uniqueKey":"citations.items.[INDEX].author.name","typeLabel":"string"},"url":{"oneOf":[{"description":"author detail URL","type":"string","example":"https://www.youtube.com/@tedx","uniqueKey":"citations.items.[INDEX].author.url.oneOf.0","typeLabel":"string"},{"description":"author detail URL","type":"null","example":"https://www.youtube.com/@tedx","uniqueKey":"citations.items.[INDEX].author.url.oneOf.1","typeLabel":"null"}],"uniqueKey":"citations.items.[INDEX].author.url","typeLabel":"string | null"},"avatar":{"description":"author avatar URL","type":"string","example":"https://yt3.ggpht.com/1gDPO-4YPWFErfn3yQBnv0yxpkmiud1m5CrorApkOqUYdNd9FrZQ9xB9C9VmDt4EsgArnlwqAQc=s88-c-k-c0x00ffffff-no-rj","uniqueKey":"citations.items.[INDEX].author.avatar","typeLabel":"string"}},"uniqueKey":"citations.items.[INDEX].author","typeLabel":"object"},"publishedDate":{"description":"Video published date, ISO timestamp string","type":"string","example":"2012-04-18T04:26:13.000Z","uniqueKey":"citations.items.[INDEX].publishedDate","typeLabel":"string"},"duration":{"description":"Video duration in seconds","type":"integer","example":268,"uniqueKey":"citations.items.[INDEX].duration","typeLabel":"integer"},"favicon":{"description":"The URL of the favicon for the search result's domain.","type":"string","example":"https://www.youtube.com/s/desktop/f788da0a/img/logos/favicon_48x48.png","uniqueKey":"citations.items.[INDEX].favicon","typeLabel":"string"},"score":{"oneOf":[{"description":"relevance score for query","type":"number","example":0.6847141,"uniqueKey":"citations.items.[INDEX].score.oneOf.0","typeLabel":"number"},{"description":"relevance score for query","type":"null","example":0.6847141,"uniqueKey":"citations.items.[INDEX].score.oneOf.1","typeLabel":"null"}],"uniqueKey":"citations.items.[INDEX].score","typeLabel":"number | null"},"highlights":{"description":"The video clip that best matches the query. It only one video clip now.","type":"array","items":{"description":"The video clip that best matches the query.","type":"object","properties":{"startTime":{"description":"Start time of the video clip in seconds.","type":"integer","example":47,"uniqueKey":"citations.items.[INDEX].highlights.items.[INDEX].startTime","typeLabel":"integer"},"endTime":{"description":"End time of the video clip in seconds.","type":"integer","example":84,"uniqueKey":"citations.items.[INDEX].highlights.items.[INDEX].endTime","typeLabel":"integer"},"visualDescription":{"description":"Visual description of the video clip.","type":"string","example":"Joe Smith stands center stage, demonstrating various ways people grab paper towels. He mimes pulling two or three trifold paper towels, then several tear-off sheets which he crumbles, then sheets from a self-cutting dispenser which he also crumples. He then demonstrates using recycled paper towels, indicating that people take more because they are less absorbent. He bends over a white basin, then stands up, pointing his finger upwards and smiling, emphasizing that everything can be done with 'one towel'.","uniqueKey":"citations.items.[INDEX].highlights.items.[INDEX].visualDescription","typeLabel":"string"},"audioTranscription":{"oneOf":[{"description":"Audio transcription of the video clip.","type":"string","example":"Now there are all kinds of paper towel dispensers. There's the trifold. People typically take two or three.\nThere's the one that cuts it that you have to tear off. People go one, two, three, four, tear, this much, right?\nThere's the one that cuts itself. People go, one, two, three, four.\nOr there's the same thing, but recycled paper. You have to get five of those because they're not as absorbent, of course.\nThe fact is, you can do it all with one towel.","uniqueKey":"citations.items.[INDEX].highlights.items.[INDEX].audioTranscription.oneOf.0","typeLabel":"string"},{"description":"Audio transcription of the video clip.","type":"null","example":"Now there are all kinds of paper towel dispensers. There's the trifold. People typically take two or three.\nThere's the one that cuts it that you have to tear off. People go one, two, three, four, tear, this much, right?\nThere's the one that cuts itself. People go, one, two, three, four.\nOr there's the same thing, but recycled paper. You have to get five of those because they're not as absorbent, of course.\nThe fact is, you can do it all with one towel.","uniqueKey":"citations.items.[INDEX].highlights.items.[INDEX].audioTranscription.oneOf.1","typeLabel":"null"}],"uniqueKey":"citations.items.[INDEX].highlights.items.[INDEX].audioTranscription","typeLabel":"string | null"}},"uniqueKey":"citations.items.[INDEX].highlights.items.[INDEX]","typeLabel":"object"},"uniqueKey":"citations.items.[INDEX].highlights","typeLabel":"object[]"},"transcription":{"oneOf":[{"description":"The video transcription with visual and auditory when set `contentOptions.includeTranscription` as `true`, otherwise null.","type":"object","properties":{"videoClips":{"description":"Video clips with visual descriptions.","type":"array","items":{"description":"The video clip with visual description.","type":"object","properties":{"startTime":{"description":"Start time of the video clip in seconds.","type":"integer","example":0,"uniqueKey":"citations.items.[INDEX].transcription.oneOf.0.videoClips.items.[INDEX].startTime","typeLabel":"integer"},"endTime":{"description":"End time of the video clip in seconds.","type":"integer","example":7,"uniqueKey":"citations.items.[INDEX].transcription.oneOf.0.videoClips.items.[INDEX].endTime","typeLabel":"integer"},"visualDescription":{"description":"Visual description of the video clip.","type":"string","example":"The video opens with a grey background featuring the red 'TEDx' logo, followed by 'ConcordiaUPortland' in black text. Below it, 'x = independently organized TED event' is in smaller red text. The text 'BECOMING EXTRAORDINARY' appears briefly, then a yellow-green rectangular banner with an orange bird icon and the text 'UNCONVENTIONALGUIDES.COM' fades in. The background gradually changes from grey to white and then to a darker shade before transitioning to black.","uniqueKey":"citations.items.[INDEX].transcription.oneOf.0.videoClips.items.[INDEX].visualDescription","typeLabel":"string"}},"uniqueKey":"citations.items.[INDEX].transcription.oneOf.0.videoClips.items.[INDEX]","typeLabel":"object"},"uniqueKey":"citations.items.[INDEX].transcription.oneOf.0.videoClips","typeLabel":"object[]"},"audioClips":{"description":"Audio clips with transcriptions.","type":"array","items":{"description":"The video clip with audio transcription.","type":"object","properties":{"startTime":{"description":"Start time of the video clip in seconds.","type":"integer","example":11,"uniqueKey":"citations.items.[INDEX].transcription.oneOf.0.audioClips.items.[INDEX].startTime","typeLabel":"integer"},"endTime":{"description":"End time of the video clip in seconds.","type":"integer","example":26,"uniqueKey":"citations.items.[INDEX].transcription.oneOf.0.audioClips.items.[INDEX].endTime","typeLabel":"integer"},"transcription":{"description":"Transcription of the audio clip.","type":"string","example":"571 million, 230,000 pounds of paper towels are used by Americans every year.","uniqueKey":"citations.items.[INDEX].transcription.oneOf.0.audioClips.items.[INDEX].transcription","typeLabel":"string"},"speakerId":{"description":"The speaker ID of the audio clip, such as 'speaker_1'. If the speaker is identified, it will be set to the speaker's name.","type":"string","example":"Joe Smith","uniqueKey":"citations.items.[INDEX].transcription.oneOf.0.audioClips.items.[INDEX].speakerId","typeLabel":"string"}},"uniqueKey":"citations.items.[INDEX].transcription.oneOf.0.audioClips.items.[INDEX]","typeLabel":"object"},"uniqueKey":"citations.items.[INDEX].transcription.oneOf.0.audioClips","typeLabel":"object[]"}},"uniqueKey":"citations.items.[INDEX].transcription.oneOf.0","typeLabel":"object"},{"description":"The video transcription with visual and auditory when set `contentOptions.includeTranscription` as `true`, otherwise null.","type":"null","properties":{"videoClips":{"description":"Video clips with visual descriptions.","type":"array","items":{"description":"The video clip with visual description.","type":"object","properties":{"startTime":{"description":"Start time of the video clip in seconds.","type":"integer","example":0},"endTime":{"description":"End time of the video clip in seconds.","type":"integer","example":7},"visualDescription":{"description":"Visual description of the video clip.","type":"string","example":"The video opens with a grey background featuring the red 'TEDx' logo, followed by 'ConcordiaUPortland' in black text. Below it, 'x = independently organized TED event' is in smaller red text. The text 'BECOMING EXTRAORDINARY' appears briefly, then a yellow-green rectangular banner with an orange bird icon and the text 'UNCONVENTIONALGUIDES.COM' fades in. The background gradually changes from grey to white and then to a darker shade before transitioning to black."}}}},"audioClips":{"description":"Audio clips with transcriptions.","type":"array","items":{"description":"The video clip with audio transcription.","type":"object","properties":{"startTime":{"description":"Start time of the video clip in seconds.","type":"integer","example":11},"endTime":{"description":"End time of the video clip in seconds.","type":"integer","example":26},"transcription":{"description":"Transcription of the audio clip.","type":"string","example":"571 million, 230,000 pounds of paper towels are used by Americans every year."},"speakerId":{"description":"The speaker ID of the audio clip, such as 'speaker_1'. If the speaker is identified, it will be set to the speaker's name.","type":"string","example":"Joe Smith"}}}}},"uniqueKey":"citations.items.[INDEX].transcription.oneOf.1","typeLabel":"null"}],"uniqueKey":"citations.items.[INDEX].transcription","typeLabel":"object | null"}},"uniqueKey":"citations.items.[INDEX]","typeLabel":"object"},"uniqueKey":"citations","typeLabel":"object[]"},"dollarCost":{"description":"Dollar cost of the request.","type":"object","properties":{"total":{"description":"Total dollar cost for your request.","type":"number","example":0.01,"uniqueKey":"dollarCost.total","typeLabel":"number"}},"uniqueKey":"dollarCost","typeLabel":"object"}},"example":{"answer":"ChatGPT is an artificial intelligence (AI) chatbot developed by OpenAI and released in 2022. It is a generative AI tool that allows users to interact with it in a way that simulates natural conversation, responding to questions and requests.","citations":[{"url":"https://www.youtube.com/watch?v=j5vQ6oXSZpU","title":"What makes OpenAI's new GPT-5 different from past versions?","description":"OpenAI on Thursday launched GPT-5, the latest generation of the artificial intelligence technology that powers ChatGPT. OpenAI said the new model is faster and smarter than ever before. Technology journalist Jacob Ward joins CBS News to discuss the release.\n\nCBS News 24/7 is the premier anchored streaming news service from CBS News and Stations that is available free to everyone with access to the internet and is the destination for breaking news, live events, original reporting and storytelling, and programs from CBS News and Stations' top anchors and correspondents working locally, nationally and around the globe. It is available on more than 30 platforms across mobile, desktop and connected TVs for free, as well as CBSNews.com and Paramount+ and live in 91 countries.","thumbnail":{"url":"https://i.ytimg.com/vi/j5vQ6oXSZpU/sddefault.jpg","width":640,"height":480},"author":{"name":"CBS News","url":"https://www.youtube.com/@cbsnews","avatar":"https://yt3.ggpht.com/ytc/AIdro_niBFv49gSx4rr1afMZU_Pv7SeuPKO2SMHvv0Ar7OKxM4o=s88-c-k-c0x00ffffff-no-rj"},"publishedDate":"2025-08-07T21:07:09.000Z","duration":359,"favicon":"https://www.youtube.com/s/desktop/f788da0a/img/logos/favicon_48x48.png","score":0.8580227,"highlights":[{"startTime":0,"endTime":23,"visualDescription":"A male presenter in a dark long-sleeved shirt and jeans stands in a modern, brightly lit office space with plants and wooden accents. He gestures with his hands as he speaks. The background shows a large white screen displaying 'GPT-5'. An inset video then appears, showing a woman looking at a laptop, which displays a 'ChatGPT 5' interface. The interface shows a schedule planning assistant, detailing a day's schedule from coffee with Grant to a flight departure, and includes 'Two quick email actions' and a 'Light packing list'. The woman nods and smiles. Overlapping text on screen announces 'OPENAI RELEASES GPT-5 FIFTH GENERATION OF THE A.I. TECHNOLOGY THAT POWERS CHATGPT'.","audioTranscription":"Welcome into CBS News 24/7, OpenAI launches GPT-5, it's the latest generation of the artificial intelligence technology that powers ChatGPT.\nOpenAI says the new model is faster and smarter than ever before, it comes more than two years after the release of its predecessor, and expectations are high."}],"transcription":{"videoClips":[{"startTime":0,"endTime":23,"visualDescription":"A male presenter in a dark long-sleeved shirt and jeans stands in a modern, brightly lit office space with plants and wooden accents. He gestures with his hands as he speaks. The background shows a large white screen displaying 'GPT-5'. An inset video then appears, showing a woman looking at a laptop, which displays a 'ChatGPT 5' interface. The interface shows a schedule planning assistant, detailing a day's schedule from coffee with Grant to a flight departure, and includes 'Two quick email actions' and a 'Light packing list'. The woman nods and smiles. Overlapping text on screen announces 'OPENAI RELEASES GPT-5 FIFTH GENERATION OF THE A.I. TECHNOLOGY THAT POWERS CHATGPT'."},{"startTime":24,"endTime":43,"visualDescription":"A male tech journalist, Jacob Ward, wearing a plaid shirt and dark pants, stands opposite a female presenter in a light blue suit. They are on a brightly lit studio set with a large purple background displaying 'CBS NEWS TECHWATCH' in white bold letters with circuit board graphics. The female presenter holds a tablet and gestures while speaking. A smaller screen to the left shows the previous segment with the man presenting in the modern office, and then a graphic that says 'Introducing ChatGPT'."}],"audioClips":[{"startTime":1,"endTime":10,"transcription":"Welcome into CBS News 24/7, OpenAI launches GPT-5, it's the latest generation of the artificial intelligence technology that powers ChatGPT.","speakerId":"speaker_1"},{"startTime":11,"endTime":23,"transcription":"OpenAI says the new model is faster and smarter than ever before, it comes more than two years after the release of its predecessor, and expectations are high.","speakerId":"speaker_1"},{"startTime":24,"endTime":35,"transcription":"So I want to bring in Jacob Ward, technology journalist, host of The Rip Current podcast.","speakerId":"speaker_1"},{"startTime":35,"endTime":38,"transcription":"Thanks for being here, also the author of The Loop, How Technology is Creating World Without Choices, and How to Fight Back.","speakerId":"speaker_1"},{"startTime":38,"endTime":43,"transcription":"Okay, first things first, we're talking about this release of ChatGPT-5.","speakerId":"speaker_1"}]}}],"dollarCost":{"total":0.01}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"answer":"ChatGPT is an artificial intelligence (AI) chatbot developed by OpenAI and released in 2022. It is a generative AI tool that allows users to interact with it in a way that simulates natural conversation, responding to questions and requests.","citations":[{"url":"https://www.youtube.com/watch?v=j5vQ6oXSZpU","title":"What makes OpenAI's new GPT-5 different from past versions?","description":"OpenAI on Thursday launched GPT-5, the latest generation of the artificial intelligence technology that powers ChatGPT. OpenAI said the new model is faster and smarter than ever before. Technology journalist Jacob Ward joins CBS News to discuss the release.\n\nCBS News 24/7 is the premier anchored streaming news service from CBS News and Stations that is available free to everyone with access to the internet and is the destination for breaking news, live events, original reporting and storytelling, and programs from CBS News and Stations' top anchors and correspondents working locally, nationally and around the globe. It is available on more than 30 platforms across mobile, desktop and connected TVs for free, as well as CBSNews.com and Paramount+ and live in 91 countries.","thumbnail":{"url":"https://i.ytimg.com/vi/j5vQ6oXSZpU/sddefault.jpg","width":640,"height":480},"author":{"name":"CBS News","url":"https://www.youtube.com/@cbsnews","avatar":"https://yt3.ggpht.com/ytc/AIdro_niBFv49gSx4rr1afMZU_Pv7SeuPKO2SMHvv0Ar7OKxM4o=s88-c-k-c0x00ffffff-no-rj"},"publishedDate":"2025-08-07T21:07:09.000Z","duration":359,"favicon":"https://www.youtube.com/s/desktop/f788da0a/img/logos/favicon_48x48.png","score":0.8580227,"highlights":[{"startTime":0,"endTime":23,"visualDescription":"A male presenter in a dark long-sleeved shirt and jeans stands in a modern, brightly lit office space with plants and wooden accents. He gestures with his hands as he speaks. The background shows a large white screen displaying 'GPT-5'. An inset video then appears, showing a woman looking at a laptop, which displays a 'ChatGPT 5' interface. The interface shows a schedule planning assistant, detailing a day's schedule from coffee with Grant to a flight departure, and includes 'Two quick email actions' and a 'Light packing list'. The woman nods and smiles. Overlapping text on screen announces 'OPENAI RELEASES GPT-5 FIFTH GENERATION OF THE A.I. TECHNOLOGY THAT POWERS CHATGPT'.","audioTranscription":"Welcome into CBS News 24/7, OpenAI launches GPT-5, it's the latest generation of the artificial intelligence technology that powers ChatGPT.\nOpenAI says the new model is faster and smarter than ever before, it comes more than two years after the release of its predecessor, and expectations are high."}],"transcription":{"videoClips":[{"startTime":0,"endTime":23,"visualDescription":"A male presenter in a dark long-sleeved shirt and jeans stands in a modern, brightly lit office space with plants and wooden accents. He gestures with his hands as he speaks. The background shows a large white screen displaying 'GPT-5'. An inset video then appears, showing a woman looking at a laptop, which displays a 'ChatGPT 5' interface. The interface shows a schedule planning assistant, detailing a day's schedule from coffee with Grant to a flight departure, and includes 'Two quick email actions' and a 'Light packing list'. The woman nods and smiles. Overlapping text on screen announces 'OPENAI RELEASES GPT-5 FIFTH GENERATION OF THE A.I. TECHNOLOGY THAT POWERS CHATGPT'."},{"startTime":24,"endTime":43,"visualDescription":"A male tech journalist, Jacob Ward, wearing a plaid shirt and dark pants, stands opposite a female presenter in a light blue suit. They are on a brightly lit studio set with a large purple background displaying 'CBS NEWS TECHWATCH' in white bold letters with circuit board graphics. The female presenter holds a tablet and gestures while speaking. A smaller screen to the left shows the previous segment with the man presenting in the modern office, and then a graphic that says 'Introducing ChatGPT'."}],"audioClips":[{"startTime":1,"endTime":10,"transcription":"Welcome into CBS News 24/7, OpenAI launches GPT-5, it's the latest generation of the artificial intelligence technology that powers ChatGPT.","speakerId":"speaker_1"},{"startTime":11,"endTime":23,"transcription":"OpenAI says the new model is faster and smarter than ever before, it comes more than two years after the release of its predecessor, and expectations are high.","speakerId":"speaker_1"},{"startTime":24,"endTime":35,"transcription":"So I want to bring in Jacob Ward, technology journalist, host of The Rip Current podcast.","speakerId":"speaker_1"},{"startTime":35,"endTime":38,"transcription":"Thanks for being here, also the author of The Loop, How Technology is Creating World Without Choices, and How to Fight Back.","speakerId":"speaker_1"},{"startTime":38,"endTime":43,"transcription":"Okay, first things first, we're talking about this release of ChatGPT-5.","speakerId":"speaker_1"}]}}],"dollarCost":{"total":0.01}}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"659a6027-bc96-4701-91db-c1d75ce2eb05":{"apiKeyAuth":{"type":"apiKey","name":"x-api-key","in":"header","description":"API key must be provided via `x-api-key` header.","scopes":[]}}},"servers":{"6610980d-6390-4849-a7d9-bf236f88f65a":{"url":"https://api.vizlook.com"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","name":"x-api-key","in":"header","description":"API key must be provided via `x-api-key` header.","scopes":[]},"schema":{"title":"x-api-key","type":"string","description":"API key must be provided via `x-api-key` header.","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"apiKeyAuth","name":"x-api-key"}],"title":"apiKeyAuth"}]},"originalFileLocation":"documentation/api-reference/openapi.json"},"subdomain":"maxai","siteName":"Vizlook","title":"Answer - Vizlook","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2025-11-13T07:48:56.305Z","originalFileLocation":"documentation/api-reference/answer.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=\"The /answer endpoint leverages Vizlook search results and an LLM to provide answers, offering direct responses for specific queries and detailed, cited summaries for open-ended questions.Each response includes both the LLM\u0026#x27;s answer and the sources utilized. Furthermore, the endpoint supports streaming (by setting stream true), delivering tokens as they are generated.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Vizlook\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/maxai/CViB7rHaybTnkGSi/_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=\"/mintlify-assets/_mintlify/favicons/maxai/CViB7rHaybTnkGSi/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/maxai/CViB7rHaybTnkGSi/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/maxai/CViB7rHaybTnkGSi/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/maxai/CViB7rHaybTnkGSi/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/maxai/CViB7rHaybTnkGSi/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/maxai/CViB7rHaybTnkGSi/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/maxai/CViB7rHaybTnkGSi/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/maxai/CViB7rHaybTnkGSi/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Answer - Vizlook\">\u003cmeta data-mint-head property=\"og:description\" content=\"The /answer endpoint leverages Vizlook search results and an LLM to provide answers, offering direct responses for specific queries and detailed, cited summaries for open-ended questions.Each response includes both the LLM\u0026#x27;s answer and the sources utilized. Furthermore, the endpoint supports streaming (by setting stream true), delivering tokens as they are generated.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Vizlook\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.vizlook.com/documentation/api-reference/answer\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://maxai.mintlify.app/_mintlify/api/og/v2?division=API+Reference\u0026amp;title=Answer\u0026amp;description=The+%60%2Fanswer%60+endpoint+leverages+Vizlook+search+results+and+an+LLM+to+provide+answers%2C+offering+direct+responses+for+specific+queries+and+detailed%2C+cited+summar\u0026amp;theme=c12d0bb9eb7f8b5999b35fe2\u0026amp;signature=81923e6c2710f3ef0d341dec54c7c3d9b9f72aa84d69e94a33d497b27acc2c5a\">\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=\"Answer - Vizlook\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"The /answer endpoint leverages Vizlook search results and an LLM to provide answers, offering direct responses for specific queries and detailed, cited summaries for open-ended questions.Each response includes both the LLM\u0026#x27;s answer and the sources utilized. Furthermore, the endpoint supports streaming (by setting stream true), delivering tokens as they are generated.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://maxai.mintlify.app/_mintlify/api/og/v2?division=API+Reference\u0026amp;title=Answer\u0026amp;description=The+%60%2Fanswer%60+endpoint+leverages+Vizlook+search+results+and+an+LLM+to+provide+answers%2C+offering+direct+responses+for+specific+queries+and+detailed%2C+cited+summar\u0026amp;theme=c12d0bb9eb7f8b5999b35fe2\u0026amp;signature=81923e6c2710f3ef0d341dec54c7c3d9b9f72aa84d69e94a33d497b27acc2c5a\">\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=\"/mintlify-assets/_mintlify/favicons/maxai/CViB7rHaybTnkGSi/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Vizlook\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#2563EB\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.vizlook.com/documentation/api-reference/answer\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/documentation/api-reference/answer.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.vizlook.com/#organization\",\"name\":\"Vizlook\",\"url\":\"https://docs.vizlook.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/maxai/o9Qb4RVdnxqLUMwp/logo/logo.png?fit=max\u0026auto=format\u0026n=o9Qb4RVdnxqLUMwp\u0026q=85\u0026s=c57f6202b02bd5169a75c2a6efce44d9\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.vizlook.com#website\",\"name\":\"Vizlook\",\"url\":\"https://docs.vizlook.com\",\"publisher\":{\"@id\":\"https://docs.vizlook.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.vizlook.com/documentation/api-reference/answer#webpage\",\"url\":\"https://docs.vizlook.com/documentation/api-reference/answer\",\"name\":\"Answer\",\"description\":\"The /answer endpoint leverages Vizlook search results and an LLM to provide answers, offering direct responses for specific queries and detailed, cited summaries for open-ended questions.Each response includes both the LLM's answer and the sources utilized. Furthermore, the endpoint supports streaming (by setting stream true), delivering tokens as they are generated.\",\"dateModified\":\"2025-11-13T07:48:56.305Z\",\"isPartOf\":{\"@id\":\"https://docs.vizlook.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.vizlook.com/documentation/api-reference/answer#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.vizlook.com/documentation/api-reference/answer#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"API Reference\",\"item\":\"https://docs.vizlook.com/documentation/api-reference/search\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Answer\",\"item\":\"https://docs.vizlook.com/documentation/api-reference/answer\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.vizlook.com/documentation/api-reference/answer#apireference\",\"headline\":\"Answer\",\"name\":\"Answer\",\"description\":\"The /answer endpoint leverages Vizlook search results and an LLM to provide answers, offering direct responses for specific queries and detailed, cited summaries for open-ended questions.Each response includes both the LLM's answer and the sources utilized. Furthermore, the endpoint supports streaming (by setting stream true), delivering tokens as they are generated.\",\"url\":\"https://docs.vizlook.com/documentation/api-reference/answer\",\"mainEntityOfPage\":{\"@id\":\"https://docs.vizlook.com/documentation/api-reference/answer#webpage\"},\"dateModified\":\"2025-11-13T07:48:56.305Z\",\"publisher\":{\"@id\":\"https://docs.vizlook.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.vizlook.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Vizlook\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Vizlook","nav":{"global":{"anchors":[{"anchor":"GitHub","icon":"github","href":"https://github.com/vizlook"}]},"tabs":[{"tab":"Documentation","groups":[{"group":"Getting Started","pages":[{"title":"Introduction","href":"/documentation/introduction"},{"title":"Quickstart","href":"/documentation/quickstart"}]},{"group":"API Reference","pages":[{"title":"Search","openapi":"POST /search","description":"The `/search` endpoint lets you intelligently search a list of videos that precisely ranked by the most relevant moments found within their content.","href":"/documentation/api-reference/search"},{"title":"Answer","openapi":"POST /answer","href":"/documentation/api-reference/answer"},{"title":"Get Video Contents","description":"The `/videos` endpoint gets the visual and audio transcriptions, video summaries, and metadata for a list of URLs.\u003cbr />\u003cbr />The system will quickly return results from the cache. For uncached videos, you can configure whether to perform real-time crawling.","openapi":"POST /videos","href":"/documentation/api-reference/get-video-contents"}]},{"group":"Platform","pages":[{"title":"Rate Limits","href":"/documentation/rate-limits"},{"title":"Error Codes","href":"/documentation/error-codes"},{"title":"Pricing","href":"/documentation/pricing"},{"title":"Demo","url":"https://tubeseek.vizlook.com","href":"/documentation/demo"},{"title":"Privacy Policy","url":"https://www.vizlook.com/protocols/privacy-policy","href":"/documentation/privacy-policy"},{"title":"Terms of Service","url":"https://www.vizlook.com/protocols/terms-of-service","href":"/documentation/terms-of-service"}]}]},{"tab":"SDKs","pages":[{"title":"SDKs","href":"/sdks/python"}]}]},"basePath":"","title":"Answer - Vizlook","buildId":"dpl_G9nrg4qeJSZtah1Ziwbc2n6WkLch","deploymentId":"dpl_G9nrg4qeJSZtah1Ziwbc2n6WkLch","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-B7XKH4J3.js","utils-lOYzL7z-.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-DF6jUUIM.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-Dpsj5f7C.js","snippetPresets-CYeiDe8v.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-CUFz1YZ_.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-D8H_iLS4.js","shallow-DdluZBHX.js","getApiPlaygroundDisplay-B9922vev.js","CodeSnippet-CMoRNGYs.js","CodeSnippets-DwyrPHuw.js","Page-DSVu9Ucl.js","getPastedJson-G-zIvlHh.js","icon-B03fnEy0.js","MethodPill-CW7teklc.js","DuplicateIcon-CtO8eekd.js","createIcon-DZTKdM_A.js","DynamicMarkdown-D5M2At0B.js","SectionHeading-C_2NaA2U.js","axios-vUo_bRtp.js","Markdown-D7QRHV3m.js","clsx-D1Z-ELXV.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-lvhuD9Du.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-CKfC4ywL.js"]}