/youtube-geofind

Web-tool to search YouTube for geographically tagged videos by channel, topic, and location. Videos are viewable in a map and exportabled to CSV.

Primary LanguageJavaScriptMIT LicenseMIT

YouTube Geofind

Search by channel, topic, and location for geotagged videos. View in map and export results.

Example

What's unique about this tool? How can you use it?

  1. Find cool videos where you live or anywhere in the world!
    • What videos were posted by you in the last week? (find me, past 7 days)
    • What livestreams are running now in my state/country? (find me, radius 500 or 1000, live events only)
  2. Use it for investigative purposes, OSINT.
    • Channel searching allows you to check all the uploads on a channel for geotags and displays them in a map.
    • Topic searching allows you to check if any uploads found by regular searching or keywords have geotags (though, not many do).
    • Location searching allows you to find videos with geotags within your chosen radius and timeframe.
    • Export results to save your findings and use elsewhere.
    • Results can be directly opened in my new YouTube Metadata tool to give all details about that video and its author.
  3. Query API as noted below

Query API

The tool provides a pseudo-api with query parameters that allow manipulation of the page elements so that you can share a search you made or implement a linked custom search from your own site/tool.

Channel page

The following parameter(s) will work with just the channel page /youtube-geofind/

Parameter Accepted values
channels string, comma separated list of channel names or ids
e.g.
UChirEOpgFCupRAk5etXqPaA
vicenews,UChirEOpgFCupRAk5etXqPaA,thesamlivecast

Example(s)

Location & Topic pages

The following parameter(s) are shared by both the location /youtube-geofind/location and topic /youtube-geofind/topic pages.

Parameter Accepted values
keywords string, keywords exactly like you could put into YouTube search
sort string, may only be one of the specified values that show in the select box in the page. otherwise the select box will become blank
One of these only: date, relevance, viewCount, rating
timeframe string, may only be one of the specified values that show in the select box in the page. otherwise the select box will become blank
One of these only: any, hour-1, hour-3, hour-6, hour-12, hour-24, day-7, day-30, day-90, day-365, custom
start date-string of format yyyy-MM-dd. may only be used with timeframe=custom. must be before end date.
e.g. 2018-12-24
end date-string of format yyyy-MM-dd. may only be used with timeframe=custom. must be after start date.
e.g. 2018-12-26
pages integer, may only be one of the specified values that show in the select box in the page. otherwise the select box will become blank
One of these only: 1, 2, 3, 5, 7, 15
live boolean true or false
creativeCommons boolean true or false
hd boolean true or false
embeddable boolean true or false
syndicated boolean true or false

Example(s)

Location page

The following parameter(s) will work with just the location page /youtube-geofind/location

Parameter Accepted values
location string, comma separated latitude & longitude
e.g. 43.054098,-79.2281175
locationAddress string, exactly like anything you could put into Google Maps
e.g. the white house
radius integer, may only be one of the specified values that show in the select box in the page. otherwise, the select box will become blank
One of these only: 1, 2, 5, 10, 15, 20, 50, 100, 200, 500, 1000

Example(s)

All pages

This parameter is shared by all page types.

Parameter Accepted values
doSearch boolean
true to click the page's submit button
false don't click submit, might as well just omit the parameter

All of the examples above use this single parameter.