Find videos in specific location
This guide demonstrates how to use the YouTube Data API to search for videos from a specific location, in this case, London.
API Endpoint
Query Parameters
Parameter | Type | Description | Required |
---|---|---|---|
location | string | The location coordinates (latitude,longitude) | Yes |
locationRadius | string | The radius from the location to search within | Yes |
type | string | The type of resource to search for | Yes |
Example Usage
To search for videos from London, you can make the following API call:
Response
The API will return a JSON object containing an array of video items. Each item includes:
videoId
: The unique identifier for the videotitle
: The title of the videodescription
: A brief description of the videothumbnails
: Various thumbnail images for the videochannelTitle
: The title of the channel that uploaded the video
For a complete list of returned fields, please refer to the API documentation.
Technical Details
- The
location
parameter uses the formatlatitude,longitude
. For London, we use the coordinates51.5074,0.1278
. - The
locationRadius
parameter specifies the geographic area in which to search. It must be used in conjunction with thelocation
parameter. - The
type
parameter must be set tovideo
when using location-based search.
Error Handling
If the API call fails, it will return an appropriate HTTP status code along with an error message in the response body. Common errors include:
- 400 Bad Request: Invalid query parameters
- 403 Forbidden: Token is missing or invalid
Always handle potential errors in your code to ensure a smooth user experience.
Note
Location-based search may not always return results exactly within the specified radius. The API uses the location and radius as a hint to return relevant results, but may include videos from a slightly larger area if necessary to provide a good set of results.