> For the complete documentation index, see [llms.txt](https://docs.serpdog.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.serpdog.io/google-videos-api.md).

# Google Videos API

Here is the list of default parameters for this API : \ <br>

<table><thead><tr><th align="center">Parameters</th><th width="359.31735691019077" align="center">Description</th></tr></thead><tbody><tr><td align="center">api_key<br><br><mark style="color:red;">required</mark></td><td align="center">This is your API key.</td></tr><tr><td align="center">q<br><br><mark style="color:red;">required</mark></td><td align="center"><p>Type: <code>String</code></p><p><br>Google Search Query</p></td></tr><tr><td align="center">num</td><td align="center">Type: <code>Number(Integer)</code><br><br>Number of results per page. </td></tr><tr><td align="center">gl</td><td align="center"><p>Type: <code>String</code><br></p><p>Default: <code>"us"</code><br>  Name of the country. The name should be in <a href="https://en.wikipedia.org/wiki/List_of_ISO_3166_country_codes">ISO 3166 Alpha-2</a> format.</p></td></tr><tr><td align="center">hl</td><td align="center">Type: <code>String</code><br><br>Default: <code>"en_us"</code><br><br>The language of the requested results.</td></tr><tr><td align="center">page</td><td align="center">Type: <code>Number(Integer)</code><br><code>[0,10,20....]</code><br><br>Default: <code>0</code><br>(Enter 10 for 2nd-page results, 20 for 3rd, etc .)<br>The page number to get targeted search results.</td></tr><tr><td align="center">lr</td><td align="center">Type: <code>String</code><br><br>Limit the search to one or multiple languages.<br>It is used as <mark style="color:red;"><code>lang_{language code}</code></mark><em>.</em> For example <em>- "</em>lang_us".</td></tr><tr><td align="center">uule</td><td align="center">Type: <code>String</code><br><br>Used to encode a place an exact location(with latitude and longitude) into a value used in a cookie, an URL, or an HTTP header.</td></tr><tr><td align="center">duration</td><td align="center"><p>Type: <code>String</code><br><br>Use this as <code>"d/w/m/mn/y"</code><br>where n is from <code>0-10</code>.</p><p><mark style="color:red;"><code>d</code></mark> - the previous 24 hours,  <mark style="color:red;"><code>w</code></mark> - the previous seven days, <mark style="color:red;"><code>m</code></mark> - the previous month, <mark style="color:red;"><code>mn</code></mark> - the previous n number of months, <mark style="color:red;"><code>y</code></mark> - past year</p><p><br>The <code>duration</code> parameter requests search results from a specified time period (quick date range).</p></td></tr><tr><td align="center">nfpr</td><td align="center"><p>Type: <code>Boolean</code></p><p><br>Default: <code>0</code><br>It excludes the result from an auto-corrected query that is spelled wrong. It can be set to <mark style="color:red;"><code>1</code></mark> to exclude these results or <mark style="color:red;"><code>0</code></mark> to include them.</p></td></tr><tr><td align="center">tbs</td><td align="center"><p>Type: <code>String</code></p><p><br>to be searched - An advanced parameter to filter search results. </p></td></tr><tr><td align="center">safe</td><td align="center"><p>Type: String<br><code>[active/off]</code><br></p><p>Default: <code>off</code><br>To filter the adult content set <code>safe</code> to <mark style="color:red;"><code>active</code></mark> or to disable it set it <mark style="color:red;"><code>off</code></mark>.</p></td></tr><tr><td align="center">html</td><td align="center">Type: <code>Boolean</code><br><br>Default: <code>false</code><br>To render response as raw HTML.</td></tr></tbody></table>

### API Example:

{% tabs %}
{% tab title="cURL" %}

```json
cURL "https://api.serpdog.io/videos?&api_key=APIKEY&q=football&gl=us"
```

{% endtab %}

{% tab title="Node JS" %}

```javascript
const axios = require('axios');

axios.get('https://api.serpdog.io/videos?api_key=APIKEY&q=football&gl=us')
  .then(response => {
    console.log(response.data);
  })
  .catch(error => {
    console.log(error);
  });
```

{% endtab %}

{% tab title="Python" %}

```python
import requests
payload = {'api_key': 'APIKEY', 'q':'football' , 'gl':'us'}
resp = requests.get('https://api.serpdog.io/videos', params=payload)
print (resp.text)
```

{% endtab %}

{% tab title="Java" %}

```java
try {
 String url = "https://api.serpdog.io/videos?api_key=APIKEY&q=football&gl=us";
 URL urlForGetRequest = new URL(url);
 String readLine = null;
 HttpURLConnection conection = (HttpURLConnection) urlForGetRequest.openConnection();
 conection.setRequestMethod("GET");
 int responseCode = conection.getResponseCode();
 if (responseCode == HttpURLConnection.HTTP_OK) {
 BufferedReader in = new BufferedReader(new InputStreamReader(conection.getInputStream()));
 StringBuffer response = new StringBuffer();
 while ((readLine = in.readLine()) != null) {
 response.append(readLine);
 }
 in.close();
 System.out.println(response.toString());
} else {
 throw new Exception("Error in API Call");
 }
} catch (Exception ex) {
 ex.printStackTrace();
}
```

{% endtab %}

{% tab title="Ruby" %}

```ruby
require 'net/http'
require 'json'
params = {
 :api_key => "APIKEY",
 :q => "football",
 :gl => "us"
}
uri = URI('https://api.serpdog.io/videos')
uri.query = URI.encode_www_form(params)
website_content = Net::HTTP.get(uri)
print(website_content)
```

{% endtab %}

{% tab title="PHP" %}

```php
<?php
$url = "https://api.serpdog.io/videos?api_key=APIKEY&q=football&gl=us";
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, TRUE);
curl_setopt($ch, CURLOPT_HEADER, FALSE);
curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, 0);
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, 0);
$response = curl_exec($ch);
curl_close($ch);
print_r($response);
```

{% endtab %}
{% endtabs %}

```json
{
  "meta": {
    "api_key": "APIKEY",
    "q": "football",
    "gl": "us"
  },
  "video_results": [
    {
      "title": "NFL \"Backyard Football\" Moments - YouTube",
      "thumbnail": "data:image/gif;base64,R0lGODlhAQABAIAAAP///////yH5BAEKAAEALAAAAAABAAEAAAICTAEAOw==",
      "link": "https://www.youtube.com/watch?v=ET0G1FYxWqc",
      "displayed_link": "www.youtube.com › watch",
      "time": "14:04",
      "rank": "1"
    },
    {
      "title": "First NFL Africa Camp gives young athletes chance to show off ...",
      "thumbnail": "data:image/gif;base64,R0lGODlhAQABAIAAAP///////yH5BAEKAAEALAAAAAABAAEAAAICTAEAOw==",
      "link": "https://www.nfl.com/news/first-nfl-africa-camp-gives-young-athletes-chance-to-show-off-football-skills",
      "displayed_link": "www.nfl.com › news › first-nfl-africa-camp-gives-young-...",
      "time": "",
      "rank": "2"
    },
    {
      "title": "£10 vs £4,000 Football (WORLD'S MOST EXPENSIVE ...",
      "thumbnail": "data:image/gif;base64,R0lGODlhAQABAIAAAP///////yH5BAEKAAEALAAAAAABAAEAAAICTAEAOw==",
      "link": "https://www.youtube.com/watch?v=WIOz9svLs_U",
      "displayed_link": "www.youtube.com › watch",
      "time": "17:12",
      "rank": "3"
    },
    {
      "title": "Sky Sports Football - YouTube",
      "link": "https://www.youtube.com/channel/UCNAf1k0yIjyGu3k9BwAg3lg",
      "displayed_link": "www.youtube.com › channel",
      "time": "",
      "rank": "4"
    },
    {
      "title": "Revenge Moments in Football - YouTube",
      "thumbnail": "data:image/gif;base64,R0lGODlhAQABAIAAAP///////yH5BAEKAAEALAAAAAABAAEAAAICTAEAOw==",
      "link": "https://www.youtube.com/watch?v=z7WzDlanZmg",
      "displayed_link": "www.youtube.com › watch",
      "time": "8:41",
      "rank": "5"
    },
    {
      "title": "Texas skyrockets into top 10 after landing Arch Manning - ESPN",
      "thumbnail": "data:image/gif;base64,R0lGODlhAQABAIAAAP///////yH5BAEKAAEALAAAAAABAAEAAAICTAEAOw==",
      "link": "https://www.espn.com/college-football/insider/story/_/id/34136150/2023-college-football-recruiting-class-rankings-texas-skyrockets-top-10-landing-arch-manning",
      "displayed_link": "www.espn.com › college-football › insider › story › 2023...",
      "time": "2:13",
      "rank": "6"
    },
    {
      "title": "1 in a Trillion Football Moments - YouTube",
      "thumbnail": "data:image/gif;base64,R0lGODlhAQABAIAAAP///////yH5BAEKAAEALAAAAAABAAEAAAICTAEAOw==",
      "link": "https://www.youtube.com/watch?v=HL8Er3cP2b4&vl=en",
      "displayed_link": "www.youtube.com › watch",
      "time": "6:32",
      "rank": "7"
    },
    {
      "title": "Financial Football - Practical Money Skills",
      "thumbnail": "data:image/gif;base64,R0lGODlhAQABAIAAAP///////yH5BAEKAAEALAAAAAABAAEAAAICTAEAOw==",
      "link": "https://www.practicalmoneyskills.com/play/financial_football",
      "displayed_link": "www.practicalmoneyskills.com › play › financial_footb...",
      "time": "1:21",
      "rank": "8"
    },
    {
      "title": "PFT Mailbag: Can Deshaun Watson save his reputation?",
      "thumbnail": "data:image/gif;base64,R0lGODlhAQABAIAAAP///////yH5BAEKAAEALAAAAAABAAEAAAICTAEAOw==",
      "link": "https://www.youtube.com/watch?v=1xqZaDt0j1E",
      "displayed_link": "www.youtube.com › watch",
      "time": "11:36",
      "rank": "9"
    },
    {
      "title": "Chelsea must learn from Man United mistakes when replacing ...",
      "thumbnail": "data:image/gif;base64,R0lGODlhAQABAIAAAP///////yH5BAEKAAEALAAAAAABAAEAAAICTAEAOw==",
      "link": "https://www.espn.com/soccer/chelsea-engchelsea/story/4689969/chelsea-must-learn-from-man-united-mistakes-when-replacing-marina-granovskaiathe-most-powerful-woman-in-football",
      "displayed_link": "www.espn.com › soccer › chelsea-engchelsea › story › ch...",
      "time": "1:32",
      "rank": "10"
    }
  ],
  "pagination": {
    "current": "1",
    "next": "https://www.google.com/search?q=football&lr=&hl=en&gl=us&tbm=vid&ei=pJq4YtPiFvahiLMP7eyOmAI&start=10&sa=N&ved=2ahUKEwjTxJqt1cv4AhX2EGIAHW22AyMQ8NMDegQIARBg",
    "page_no": {
      "2": "https://www.google.com/search?q=football&lr=&hl=en&gl=us&tbm=vid&ei=pJq4YtPiFvahiLMP7eyOmAI&start=10&sa=N&ved=2ahUKEwjTxJqt1cv4AhX2EGIAHW22AyMQ8tMDegQIARBO",
      "3": "https://www.google.com/search?q=football&lr=&hl=en&gl=us&tbm=vid&ei=pJq4YtPiFvahiLMP7eyOmAI&start=20&sa=N&ved=2ahUKEwjTxJqt1cv4AhX2EGIAHW22AyMQ8tMDegQIARBQ",
      "4": "https://www.google.com/search?q=football&lr=&hl=en&gl=us&tbm=vid&ei=pJq4YtPiFvahiLMP7eyOmAI&start=30&sa=N&ved=2ahUKEwjTxJqt1cv4AhX2EGIAHW22AyMQ8tMDegQIARBS",
      "5": "https://www.google.com/search?q=football&lr=&hl=en&gl=us&tbm=vid&ei=pJq4YtPiFvahiLMP7eyOmAI&start=40&sa=N&ved=2ahUKEwjTxJqt1cv4AhX2EGIAHW22AyMQ8tMDegQIARBU",
      "6": "https://www.google.com/search?q=football&lr=&hl=en&gl=us&tbm=vid&ei=pJq4YtPiFvahiLMP7eyOmAI&start=50&sa=N&ved=2ahUKEwjTxJqt1cv4AhX2EGIAHW22AyMQ8tMDegQIARBW",
      "7": "https://www.google.com/search?q=football&lr=&hl=en&gl=us&tbm=vid&ei=pJq4YtPiFvahiLMP7eyOmAI&start=60&sa=N&ved=2ahUKEwjTxJqt1cv4AhX2EGIAHW22AyMQ8tMDegQIARBY",
      "8": "https://www.google.com/search?q=football&lr=&hl=en&gl=us&tbm=vid&ei=pJq4YtPiFvahiLMP7eyOmAI&start=70&sa=N&ved=2ahUKEwjTxJqt1cv4AhX2EGIAHW22AyMQ8tMDegQIARBa",
      "9": "https://www.google.com/search?q=football&lr=&hl=en&gl=us&tbm=vid&ei=pJq4YtPiFvahiLMP7eyOmAI&start=80&sa=N&ved=2ahUKEwjTxJqt1cv4AhX2EGIAHW22AyMQ8tMDegQIARBc",
      "10": "https://www.google.com/search?q=football&lr=&hl=en&gl=us&tbm=vid&ei=pJq4YtPiFvahiLMP7eyOmAI&start=90&sa=N&ved=2ahUKEwjTxJqt1cv4AhX2EGIAHW22AyMQ8tMDegQIARBe"
    }
  },
  "serpdog_pagination": {
    "current": "1",
    "page_no": {
      "2": "https://api.serpdog.io/videos?api_key=APIKEY&q=football&gl=us&start=10",
      "3": "https://api.serpdog.io/videos?api_key=APIKEY&q=football&gl=us&start=20",
      "4": "https://api.serpdog.io/videos?api_key=APIKEY&q=football&gl=us&start=30",
      "5": "https://api.serpdog.io/videos?api_key=APIKEY&q=football&gl=us&start=40",
      "6": "https://api.serpdog.io/videos?api_key=APIKEY&q=football&gl=us&start=50",
      "7": "https://api.serpdog.io/videos?api_key=APIKEY&q=football&gl=us&start=60",
      "8": "https://api.serpdog.io/videos?api_key=APIKEY&q=football&gl=us&start=70",
      "9": "https://api.serpdog.io/videos?api_key=APIKEY&q=football&gl=us&start=80",
      "10": "https://api.serpdog.io/videos?api_key=APIKEY&q=football&gl=us&start=90"
    }
  }
}
```
