File size: 2,986 Bytes
d60fb7f
a586e92
 
 
 
 
 
 
d60fb7f
a586e92
6fccf23
 
 
 
 
d60fb7f
 
a586e92
6fccf23
a586e92
6fccf23
35802a2
6fccf23
a586e92
6fccf23
a586e92
6fccf23
a586e92
6fccf23
a586e92
 
 
6fccf23
 
 
 
 
a586e92
6fccf23
 
 
 
 
 
 
 
 
 
 
 
a586e92
6fccf23
 
 
a586e92
 
 
 
 
6fccf23
a586e92
6fccf23
a586e92
6fccf23
a586e92
6fccf23
a586e92
6fccf23
a586e92
6fccf23
a586e92
6fccf23
35802a2
6fccf23
a586e92
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
---
title: "YouTube Autocomplete"
short_description: "YouTube search suggestions by language and region."
emoji: "🔎"
colorFrom: "blue"
colorTo: "indigo"
sdk: "static"
app_file: "index.html"
pinned: false
license: "mit"
tags:
  - smolagents
  - tool
  - flashdata
  - youtube-suggestions
---

# YouTube Autocomplete

Get YouTube autocomplete suggestions for a query prefix. Choose a language and region, and return the suggested search phrases.

[API documentation](https://flashdata.dev/docs/sources/youtube_suggestions?utm_source=hugging-face&utm_medium=integration&utm_campaign=intent_gtm_2026q4&utm_content=youtube-autocomplete-topics-flashdata) · [Get an API key](https://flashdata.dev/signup?utm_source=hugging-face&utm_medium=integration&utm_campaign=intent_gtm_2026q4&utm_content=youtube_suggestions-task) · [Pricing](https://flashdata.dev/pricing?utm_source=hugging-face&utm_medium=integration&utm_campaign=intent_gtm_2026q4&utm_content=youtube_suggestions-task)

Requires your own FlashData API key and paid Credits. The Python tool is free to install.

## Try the inputs

Edit the JSON in this Space, generate a Python call, and inspect the included sample response or paste your own JSON. This page runs locally in your browser; it does not run a data query or collect your API key.

## Run with Python

Use Python 3.10 or newer:

```sh
python -m pip install "smolagents==1.26.0" "langchain-flashdata==0.2.1"
```

Review [tool.py](tool.py) before enabling `trust_remote_code`. Run locally with your key:

```python
import getpass
import os
from smolagents import load_tool

os.environ["FLASHDATA_API_KEY"] = getpass.getpass("FlashData API key: ")
tool = load_tool("flashdata-dev/youtube-autocomplete-topics-flashdata", trust_remote_code=True)
result = tool(**{'language': 'en', 'query': 'AI agents', 'region': 'US'})
print(result)
```

The same loaded tool can be used with smolagents. A direct Python call does not require a model.

## Inputs

| Parameter | Required / default | Details |
| --- | --- | --- |
| `query` | Required | YouTube search prefix. |
| `language` | 'en' | language |
| `region` | 'US' | region |

See [input-schema.json](input-schema.json) for full validation rules. Optional `None` values are omitted; adapter defaults apply.

## Output

Read `results.0`. Fields: suggested phrase strings. Optional fields may be absent.

[example.json](example.json) contains a recorded response and its original request, not a new result for the input shown in the Space.

## Limits and cost

Suggestions are not search-volume estimates or popularity rankings.

Each data request uses FlashData Credits. Check [current pricing](https://flashdata.dev/pricing?utm_source=hugging-face&utm_medium=integration&utm_campaign=intent_gtm_2026q4&utm_content=youtube_suggestions-task) before running. Any model or hosting charges are separate.

For an uncertain timeout, check your FlashData Jobs before retrying; this tool does not automatically retry paid submissions.