POST
/
api
/
v2
/
google
/
videos
Google Videos
curl --request POST \
  --url https://piloterr.com/api/v2/google/videos \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <x-api-key>' \
  --data '{
  "query": "<string>",
  "location": "<string>",
  "uule": "<string>",
  "gl": "<string>",
  "hl": "<string>",
  "page": 123,
  "num": 123
}'
{
    "organic_results": [
        {
            "date": "2 days ago",
            "link": "https://www.youtube.com/watch?v=jO2N0G1FQyw",
            "title": "The PERFECT 2 Days in Paris! Best Things to Do & Eat ...",
            "domain": "www.youtube.com",
            "source": "YouTube",
            "channel": "Naick & Kim",
            "snippet": "... Paris Food Tour - 18 Must-Try Dishes! (baguette, beef bourguignon, crepes & more) https://youtu.be/e82fDlJnLSo Want early access to ALL new ...",
            "duration": "22:05",
            "position": 1,
            "video_id": "jO2N0G1FQyw",
            "displayed_link": "www.youtube.com",
            "snippet_matched": [
                "paris"
            ]
        },
        {
            "date": "9 hours ago",
            "link": "https://www.reddit.com/r/MichaelJackson/comments/1n77gx2/paris_on_the_biopic/",
            "title": "Paris on the biopic : r/MichaelJackson",
            "domain": "www.reddit.com",
            "source": "Reddit",
            "channel": "9 hours ago",
            "snippet": "She mentioned that it would still be enjoyable for the fans—and while I realized some parts of the movie may be sugarcoated—I was just hoping ...",
            "duration": "3:01",
            "position": 2,
            "video_id": null,
            "displayed_link": "www.reddit.com",
            "snippet_matched": []
        },
        {
            "date": "Apr 12, 2025",
            "link": "https://www.youtube.com/watch?v=5sDjOtS6QDE&vl=en",
            "title": "63 ESSENTIAL Paris Tips in 15 Minutes",
            "domain": "www.youtube.com",
            "source": "YouTube",
            "channel": "Sophie Nadeau",
            "snippet": "Paris is the capital city of France and is one of the most popular places to visit in Europe (for good reason!). In this travel guide I'll ...",
            "duration": "15:33",
            "position": 3,
            "video_id": "5sDjOtS6QDE",
            "displayed_link": "www.youtube.com",
            "snippet_matched": [
                "paris"
            ]
        },
        {
            "date": "3 days ago",
            "link": "https://www.youtube.com/watch?v=aPrC0eXns9w",
            "title": "Why Paris Is Extending One Of Its Metro Lines... With A Cable ...",
            "domain": "www.youtube.com",
            "source": "YouTube",
            "channel": "The Tim Traveller",
            "snippet": "Paris (or more accurately, the southeastern suburb of Créteil) is about to open its first urban cable car line. But what made them build a ...",
            "duration": "4:19",
            "position": 4,
            "video_id": "aPrC0eXns9w",
            "displayed_link": "www.youtube.com",
            "snippet_matched": [
                "paris"
            ]
        },
        {
            "date": "1 month ago",
            "link": "https://www.youtube.com/watch?v=NbykpCSi8_0",
            "title": "6 Days in Paris, France - Our Full Itinerary",
            "domain": "www.youtube.com",
            "source": "YouTube",
            "channel": "Through My Lens",
            "snippet": "We spent six days exploring Paris and packed in as much as we could, from the big names like the Eiffel Tower, the Louvre, and Montmartre, ...",
            "duration": "47:32",
            "position": 5,
            "video_id": "NbykpCSi8_0",
            "displayed_link": "www.youtube.com",
            "snippet_matched": [
                "paris"
            ]
        },
        {
            "date": "6 hours ago",
            "link": "https://www.reddit.com/r/BollyBlindsNGossip/comments/1n7a19r/deepika_padukone_and_her_entourage_in_paris_to/",
            "title": "Deepika Padukone and her entourage in Paris to attend the ...",
            "domain": "www.reddit.com",
            "source": "Reddit",
            "channel": "6 hours ago",
            "snippet": "Yes, thats Shaleena only making her wear such garbage clothes. She styles Deepika all the time and she is currently in Paris too.",
            "duration": "0:13",
            "position": 6,
            "video_id": null,
            "displayed_link": "www.reddit.com",
            "snippet_matched": [
                "paris"
            ]
        },
        {
            "date": "1 month ago",
            "link": "https://www.youtube.com/watch?v=p7CqdOYuE_0",
            "title": "We Didn't Expect This in Paris – 7 Surprises You Should Know",
            "domain": "www.youtube.com",
            "source": "YouTube",
            "channel": "Les Frenchies",
            "snippet": "https://bit.ly/EpickaA... Paris Bathroom Finder App: ICI TOILETTES · https://play.google.co... · https://ici-toilettes.fr/ GET YOUR Paris ...",
            "duration": "23:13",
            "position": 7,
            "video_id": "p7CqdOYuE_0",
            "displayed_link": "www.youtube.com",
            "snippet_matched": [
                "paris"
            ]
        },
        {
            "date": "2 days ago",
            "link": "https://www.youtube.com/watch?v=3OnQBYESJFc",
            "title": "Paris Speaks French",
            "domain": "www.youtube.com",
            "source": "YouTube",
            "channel": "Loic Suberville",
            "snippet": "Went out into the streets of Paris to test some english skills. To be fair, most of us would fail the last test.",
            "duration": "8:06",
            "position": 8,
            "video_id": "3OnQBYESJFc",
            "displayed_link": "www.youtube.com",
            "snippet_matched": [
                "paris"
            ]
        },
        {
            "date": "Jul 6, 2025",
            "link": "https://www.youtube.com/watch?v=8JhsL0qjdME",
            "title": "Exploring Paris in Just 3 Days [Iconic Food Tour]",
            "domain": "www.youtube.com",
            "source": "YouTube",
            "channel": "Ordinary Adventures",
            "snippet": "... Paris France for the first time ever and have only three days to explore the city. Join us as we explore some of the most iconic Paris ...",
            "duration": "1:07:49",
            "position": 9,
            "video_id": "8JhsL0qjdME",
            "displayed_link": "www.youtube.com",
            "snippet_matched": [
                "paris"
            ]
        },
        {
            "date": "Jul 5, 2025",
            "link": "https://www.youtube.com/watch?v=CW3i-qWc3Z8",
            "title": "What's it REALLY like to live in Paris?",
            "domain": "www.youtube.com",
            "source": "YouTube",
            "channel": "Sophie Nadeau",
            "snippet": "3 PERFECT DAYS IN PARIS LIKE A LOCAL | market tour, cherry blossom, brocantes & delicious food 🌸🇫🇷 Sophie Nadeau",
            "duration": "18:39",
            "position": 10,
            "video_id": "CW3i-qWc3Z8",
            "displayed_link": "www.youtube.com",
            "snippet_matched": [
                "paris"
            ]
        }
    ],
    "search_parameters": {
        "q": "paris",
        "gl": "us",
        "hl": "en",
        "num": 10,
        "page": 1,
        "uule": null,
        "engine": "google_videos",
        "location": null
    }
}
​
x-api-key
string
required
This parameter specifies the private key you’ll need for Piloterr access.

​
Body

​
Search Query

​
query
string
required
Parameter defines the query you want to search. You can use anything that you would use in a regular Google search. e.g. inurl:, site:, intitle:.

​
Geographic Location

​
location
string
Parameter defines from where you want the search to originate. If several locations match the location requested, we’ll pick the most popular one. You can use formats like New York, NY, Paris, France, Tokyo, Japan. It is recommended to specify location at the city level to simulate a real user’s search. If location is omitted, the search may take on the location of the proxy.Head to the Google Locations API if you need more precise control. Note: The location and uule parameters cannot be used together.
​
uule
string
Parameter is the Google encoded location you want to use for the search. Note: uule and location parameters cannot be used together.

​
Localization

​
gl
string
Parameter defines the country to use for the Google search. It’s a two-letter country code. (e.g., us for the United States, uk for United Kingdom, or fr for France). Head to the Google countries page for a full list of supported Google countries or the Countries API for a more precise search.
​
hl
string
Parameter defines the language to use for the Google search. It’s a two-letter language code. (e.g., en for English, es for Spanish, or fr for French). Head to the Google languages page for a full list of supported Google languages or the Languages API for a more precise search.

​
Pagination

​
page
integer
Parameter defines the result offset. It skips the given number of results. It’s used for pagination.
​
num
integer
Parameter defines the maximum number of results to return. (e.g., 10 (default) returns 10 results, 40 returns 40 results, and 100 returns 100 results).

​
Response

​
Google Videos
object
{
    "organic_results": [
        {
            "date": "2 days ago",
            "link": "https://www.youtube.com/watch?v=jO2N0G1FQyw",
            "title": "The PERFECT 2 Days in Paris! Best Things to Do & Eat ...",
            "domain": "www.youtube.com",
            "source": "YouTube",
            "channel": "Naick & Kim",
            "snippet": "... Paris Food Tour - 18 Must-Try Dishes! (baguette, beef bourguignon, crepes & more) https://youtu.be/e82fDlJnLSo Want early access to ALL new ...",
            "duration": "22:05",
            "position": 1,
            "video_id": "jO2N0G1FQyw",
            "displayed_link": "www.youtube.com",
            "snippet_matched": [
                "paris"
            ]
        },
        {
            "date": "9 hours ago",
            "link": "https://www.reddit.com/r/MichaelJackson/comments/1n77gx2/paris_on_the_biopic/",
            "title": "Paris on the biopic : r/MichaelJackson",
            "domain": "www.reddit.com",
            "source": "Reddit",
            "channel": "9 hours ago",
            "snippet": "She mentioned that it would still be enjoyable for the fans—and while I realized some parts of the movie may be sugarcoated—I was just hoping ...",
            "duration": "3:01",
            "position": 2,
            "video_id": null,
            "displayed_link": "www.reddit.com",
            "snippet_matched": []
        },
        {
            "date": "Apr 12, 2025",
            "link": "https://www.youtube.com/watch?v=5sDjOtS6QDE&vl=en",
            "title": "63 ESSENTIAL Paris Tips in 15 Minutes",
            "domain": "www.youtube.com",
            "source": "YouTube",
            "channel": "Sophie Nadeau",
            "snippet": "Paris is the capital city of France and is one of the most popular places to visit in Europe (for good reason!). In this travel guide I'll ...",
            "duration": "15:33",
            "position": 3,
            "video_id": "5sDjOtS6QDE",
            "displayed_link": "www.youtube.com",
            "snippet_matched": [
                "paris"
            ]
        },
        {
            "date": "3 days ago",
            "link": "https://www.youtube.com/watch?v=aPrC0eXns9w",
            "title": "Why Paris Is Extending One Of Its Metro Lines... With A Cable ...",
            "domain": "www.youtube.com",
            "source": "YouTube",
            "channel": "The Tim Traveller",
            "snippet": "Paris (or more accurately, the southeastern suburb of Créteil) is about to open its first urban cable car line. But what made them build a ...",
            "duration": "4:19",
            "position": 4,
            "video_id": "aPrC0eXns9w",
            "displayed_link": "www.youtube.com",
            "snippet_matched": [
                "paris"
            ]
        },
        {
            "date": "1 month ago",
            "link": "https://www.youtube.com/watch?v=NbykpCSi8_0",
            "title": "6 Days in Paris, France - Our Full Itinerary",
            "domain": "www.youtube.com",
            "source": "YouTube",
            "channel": "Through My Lens",
            "snippet": "We spent six days exploring Paris and packed in as much as we could, from the big names like the Eiffel Tower, the Louvre, and Montmartre, ...",
            "duration": "47:32",
            "position": 5,
            "video_id": "NbykpCSi8_0",
            "displayed_link": "www.youtube.com",
            "snippet_matched": [
                "paris"
            ]
        },
        {
            "date": "6 hours ago",
            "link": "https://www.reddit.com/r/BollyBlindsNGossip/comments/1n7a19r/deepika_padukone_and_her_entourage_in_paris_to/",
            "title": "Deepika Padukone and her entourage in Paris to attend the ...",
            "domain": "www.reddit.com",
            "source": "Reddit",
            "channel": "6 hours ago",
            "snippet": "Yes, thats Shaleena only making her wear such garbage clothes. She styles Deepika all the time and she is currently in Paris too.",
            "duration": "0:13",
            "position": 6,
            "video_id": null,
            "displayed_link": "www.reddit.com",
            "snippet_matched": [
                "paris"
            ]
        },
        {
            "date": "1 month ago",
            "link": "https://www.youtube.com/watch?v=p7CqdOYuE_0",
            "title": "We Didn't Expect This in Paris – 7 Surprises You Should Know",
            "domain": "www.youtube.com",
            "source": "YouTube",
            "channel": "Les Frenchies",
            "snippet": "https://bit.ly/EpickaA... Paris Bathroom Finder App: ICI TOILETTES · https://play.google.co... · https://ici-toilettes.fr/ GET YOUR Paris ...",
            "duration": "23:13",
            "position": 7,
            "video_id": "p7CqdOYuE_0",
            "displayed_link": "www.youtube.com",
            "snippet_matched": [
                "paris"
            ]
        },
        {
            "date": "2 days ago",
            "link": "https://www.youtube.com/watch?v=3OnQBYESJFc",
            "title": "Paris Speaks French",
            "domain": "www.youtube.com",
            "source": "YouTube",
            "channel": "Loic Suberville",
            "snippet": "Went out into the streets of Paris to test some english skills. To be fair, most of us would fail the last test.",
            "duration": "8:06",
            "position": 8,
            "video_id": "3OnQBYESJFc",
            "displayed_link": "www.youtube.com",
            "snippet_matched": [
                "paris"
            ]
        },
        {
            "date": "Jul 6, 2025",
            "link": "https://www.youtube.com/watch?v=8JhsL0qjdME",
            "title": "Exploring Paris in Just 3 Days [Iconic Food Tour]",
            "domain": "www.youtube.com",
            "source": "YouTube",
            "channel": "Ordinary Adventures",
            "snippet": "... Paris France for the first time ever and have only three days to explore the city. Join us as we explore some of the most iconic Paris ...",
            "duration": "1:07:49",
            "position": 9,
            "video_id": "8JhsL0qjdME",
            "displayed_link": "www.youtube.com",
            "snippet_matched": [
                "paris"
            ]
        },
        {
            "date": "Jul 5, 2025",
            "link": "https://www.youtube.com/watch?v=CW3i-qWc3Z8",
            "title": "What's it REALLY like to live in Paris?",
            "domain": "www.youtube.com",
            "source": "YouTube",
            "channel": "Sophie Nadeau",
            "snippet": "3 PERFECT DAYS IN PARIS LIKE A LOCAL | market tour, cherry blossom, brocantes & delicious food 🌸🇫🇷 Sophie Nadeau",
            "duration": "18:39",
            "position": 10,
            "video_id": "CW3i-qWc3Z8",
            "displayed_link": "www.youtube.com",
            "snippet_matched": [
                "paris"
            ]
        }
    ],
    "search_parameters": {
        "q": "paris",
        "gl": "us",
        "hl": "en",
        "num": 10,
        "page": 1,
        "uule": null,
        "engine": "google_videos",
        "location": null
    }
}