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

curl --request GET \
  --url 'https://api.poix.io/search?location=51.5074,0.1278&locationRadius=10km&type=video' \
  --header 'Authorization: Bearer <token>'

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:

index.ts

const API_URL = 'https://api.poix.io';

const response = await fetch(
  API_URL + '/search?location=51.5074,0.1278&locationRadius=10km&type=video'
);

const data = await response.json();

Response

The API will return a JSON object containing an array of video items. Each item includes:

• videoId: The unique identifier for the video
• title: The title of the video
• description: A brief description of the video
• thumbnails: Various thumbnail images for the video
• channelTitle: The title of the channel that uploaded the video

// Example response
{
    "regionCode": "US",
    "totalResults": 227525,
    "resultsPerPage": 50,
    "nextPageToken": "CDIQAA",
    "data": [
        {
            "kind": "youtube#video",
            "videoId": "EwDMEOwuj-w",
            "publishedAt": "2021-07-13T23:32:40Z",
            "channelId": "UCq0YzIwOg3zYLWqe4Nl-tog",
            "title": "The Way To Alagadda - A Song from the SCP Wiki",
           ...

For a complete list of returned fields, please refer to the API documentation.

Technical Details

• The location parameter uses the format latitude,longitude. For London, we use the coordinates 51.5074,0.1278.
• The locationRadius parameter specifies the geographic area in which to search. It must be used in conjunction with the location parameter.
• The type parameter must be set to video 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.