Skip to content

Commit 64572d7

Browse files
authored
Update README.md
1 parent 12340bb commit 64572d7

1 file changed

Lines changed: 13 additions & 4 deletions

File tree

README.md

Lines changed: 13 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -46,6 +46,15 @@ pip install ytfetcher
4646

4747
## Basic Usage
4848

49+
**Note:** When specifying the channel, you must provide the exact **channel handle** without the `@` symbol, channel URL, or channel display name.
50+
For example, use `TheOffice` instead of `@TheOffice` or `https://www.youtube.com/c/TheOffice`.
51+
52+
### How to find the channel handle for a YouTube channel
53+
54+
1. Go to the YouTube channel page.
55+
2. Look at the URL in your browser's address bar.
56+
3. The handle is the part that comes right after `https://www.youtube.com/@`
57+
4958
Ytfetcher uses **YoutubeV3 API** to get channel details and video id's so you have to create your API key from Google Cloud Console [In here](https://console.cloud.google.com/apis/api/youtube.googleapis.com).
5059

5160
Also keep in mind that you have a quota limit for **YoutubeV3 API**, but for basic usage quota isn't generally a concern.
@@ -237,7 +246,7 @@ ytfetcher from_channel <API_KEY> -c <CHANNEL_HANDLE> -m <MAX_RESULTS> -f <FORMAT
237246
Basic usage example:
238247

239248
```bash
240-
ytfetcher from_channel your-api-key -c "channelname" -m 20 -f json
249+
ytfetcher from_channel your-api-key -c <CHANNEL_HANDLE> -m 20 -f json
241250
```
242251

243252
### Output Example
@@ -261,7 +270,7 @@ ytfetcher from_channel your-api-key -c "channelname" -m 20 -f json
261270
### Using Webshare Proxy
262271

263272
```bash
264-
ytfetcher from_channel <API_KEY> -c "channel" -f json \
273+
ytfetcher from_channel <API_KEY> -c <CHANNEL_HANDLE> -f json \
265274
--webshare-proxy-username "<USERNAME>" \
266275
--webshare-proxy-password "<PASSWORD>"
267276

@@ -270,15 +279,15 @@ ytfetcher from_channel <API_KEY> -c "channel" -f json \
270279
### Using Custom Proxy
271280

272281
```bash
273-
ytfetcher from_channel <API_KEY> -c "channel" -f json \
282+
ytfetcher from_channel <API_KEY> -c <CHANNEL_HANDLE> -f json \
274283
--http-proxy "http://user:pass@host:port" \
275284
--https-proxy "https://user:pass@host:port"
276285

277286
```
278287

279288
### Using Custom HTTP Config
280289
```bash
281-
ytfetcher from_channel <API_KEY> -c "channel" \
290+
ytfetcher from_channel <API_KEY> -c <CHANNEL_HANDLE> \
282291
--http-timeout 4.2 \
283292
--http-headers "{'key': 'value'}" # Must be exact wrapper with double quotes with following single quotes.
284293
```

0 commit comments

Comments
 (0)