# get\_videos

{get\_videos} is used to include your desired videos into the array. You have handful of parameters at your disposal.

**Usage**

```
{get_videos parameters}
```

It can use following parameters

| Parameter Name | **Options**                                                                                                                                                                                                                                                 |
| -------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| assign         | Store the result(Array) to this variable                                                                                                                                                                                                                    |
| active         | <p>Get active videos:</p><ul><li>yes</li><li>no</li></ul>                                                                                                                                                                                                   |
| broadcast      | <p>Type of video:</p><ul><li>public</li><li>private</li></ul>                                                                                                                                                                                               |
| category       | <p>Specific category videos. Multiple categories should be separated with comma ‘,’:</p><ul><li>Category ID.</li></ul>                                                                                                                                      |
| count\_only    | <p>Set to true if you only want to count result:</p><ul><li>true</li><li>false</li></ul>                                                                                                                                                                    |
| date\_span     | <p>Get videos for specific time frame:</p><ul><li>all\_time</li><li>today</li><li>yesterday</li><li>this\_week</li><li>last\_week</li><li>this\_month</li><li>last\_month</li><li>this\_year</li><li>last\_year</li></ul>                                   |
| exclude        | <p>Exclude video from result:</p><ul><li>Video ID</li></ul>                                                                                                                                                                                                 |
| featured       | <p>Get featured video:</p><ul><li>yes</li><li>no</li></ul>                                                                                                                                                                                                  |
| limit          | <p>Number of results you want:</p><ul><li>Numercial Figure</li></ul>                                                                                                                                                                                        |
| nouser         | <p>It will exclude provided userid’s videos from result:</p><ul><li>User ID</li></ul>                                                                                                                                                                       |
| order          | <p>Sort your result. You also need to tell how to order your result. asc OR desc, e.g ‘videoid desc’</p><ul><li>videoid</li><li>title</li><li>date\_added</li><li>views</li><li>rating</li><li>last\_viewed</li><li>featured\_date</li><li>RAND()</li></ul> |
| show\_related  | <p>Set to if you want to show related videos. For this to work properly, also provide title & tags:</p><ul><li>true</li><li>false</li></ul>                                                                                                                 |
| status         | <p>Video Status:</p><ul><li>Successful</li><li>Processing</li><li>Failed</li></ul>                                                                                                                                                                          |
| tags           | <p>Video Tags. Multiple tags should be separated with comma ‘,’:</p><ul><li>Tags</li></ul>                                                                                                                                                                  |
| title          | <p>Video Title:</p><ul><li>Title</li></ul>                                                                                                                                                                                                                  |
| user           | <p>User specific videos:</p><ul><li>User ID</li></ul>                                                                                                                                                                                                       |
| videoid        | <p>Specific video with video id:</p><ul><li>Video ID</li></ul>                                                                                                                                                                                              |
| videokey       | <p>Specific video with video key:</p><ul><li>Video Key</li></ul>                                                                                                                                                                                            |

#### Examples

**Example 1**

```
{get_videos assign=custom_videos limit=10 featured="yes"}
```

Above code will get first 10 featured videos and stores the array in {$custom\_videos} varible. Now we will loop through the variable to display the videos.

```
{section name=cv_list from=$custom_videos}
	{include file="$style_dir/blocks/video.html" video=$custom_videos[cv_list]}
{/section}
```

\[post\_link id=”199″] and \[post\_link id=”237″]

**Example 2**

```
{get_videos assign=usr_feats active="yes" featured="yes" limit=5 order=" featured_date desc" user=1}
```

This will get first 5 active featured videos of user with ID “1” and will sort them according to their featured\_date from lasted to oldest. {$usr\_feats} contains loop. Time to display.

```
{section name=u_feat from=$usr_feats}
	{include file="$style_dir/blocks/video.html" video=$usr_feats[u_feat]}
{/section}
```

![](https://clipbucket.com/docs/wp-content/plugins/wp-postratings/images/loading.gif)Loading...


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.clipbucket.com/guides/functions/get_videos.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.