Find videos in specific location

​

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

​

Example Usage

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

• 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",
           ...

​

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

• 400 Bad Request: Invalid query parameters
• 403 Forbidden: Token is missing or invalid

​

Note