vizlook 0.1.1

The official Python library for the Vizlook API

Vizlook

The official Vizlook Python SDK.

Install

pip install vizlook

Usage

from vizlook import Vizlook, AsyncVizlook

vizlook = Vizlook(api_key=os.environ.get("VIZLOOK_API_KEY"))

Performs a video search on the Vizlook system.

response = vizlook.search(
    "how to be productive",
    max_results=5,
    start_published_date="2025-08-19T15:01:36.000Z",
    contain_spoken_text="a lot of people don't do a lot of things",
    contain_screen_text="I struggle a lot with like",
    include_transcription=True,
    include_summary=True,
)

print("response with original API field name: ", response.to_dict())
print("response with snake case field name: ", response.to_dict(use_api_field_name=False))
print("get field value with snake case key from pydantic model: ", response.results)

Generates an answer to a query.

response = vizlook.answer("how to be productive", include_transcription=True)

Streams an answer to a query.

stream = vizlook.stream_answer("how to be productive")
answer = ""

for chunk in stream:
    # response with original API key
    chunk_dict = chunk.to_dict()
    chunk_type = chunk_dict.get("type")

    if chunk_type == "answer-chunk":
        answer += chunk_dict.get("data", "")
    if chunk_type == "data-citations":
        print("Citations: ", chunk_dict.get("data").get("citations"))
    if chunk_type == "data-cost":
        print("Cost: ", chunk_dict.get("data").get("dollarCost"))
    if chunk_type == "error":
        print("Error: ", chunk_dict.get("data").get("errorText"))

print("Answer: ", answer)

Retrieves contents of videos based on specified URLs.

response = vizlook.get_video_contents(
    "https://www.youtube.com/watch?v=QdBokRd2ahw",
    crawl_mode="Always",
    include_transcription=True,
    include_summary=True,
)

Documentation

https://docs.vizlook.com

API

https://docs.vizlook.com/documentation/api-reference/search

Contributing

Feel free to submit pull requests. For larger-scale changes, though, it's best to open an issue first so we can deliberate on your plans.