# 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"
    }
  }
}
```


---

# 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.serpdog.io/google-videos-api.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.
