Go to App

VPN Locations

GET/api/public/vpn/locations

Retrieve all available VPN locations that can be used for export routing. Use VPN locations to access geo-restricted content on platforms that limit visibility based on the requester's country.

💡
Public endpoint

This endpoint is public and does not require authentication.

Query Parameters

ParameterTypeDescription

pageintegerPage number (default: 1) limitintegerItems per page (default: 10, max: 30)

bash
curl https://exportcomments.com/api/public/vpn/locations
Response200
json
[
{
"name": "Germany",
"code": "de",
"servers": 240,
"running": true
},
{
"name": "Norway",
"code": "no",
"servers": 62,
"running": false
},
{
"name": "United Kingdom",
"code": "gb",
"servers": 440,
"running": false
},
{
"name": "United States",
"code": "us",
"servers": 1970,
"running": true
}
]

Response fields

ParameterTypeDescription

namerequiredstringCountry name. Pass it as options.vpn. coderequiredstringLowercase ISO 3166-1 alpha-2 country code. serversrequiredintegerNumber of servers available in the country. runningrequiredbooleantrue when a tunnel to this location is already up. An export through a running location skips the connect wait, which takes up to a minute for the others.

Usage

Pass the VPN location name in the options.vpn field when creating an export job:

json
{
"url": "https://www.youtube.com/watch?v=example",
"options": {
"vpn": "Norway"
}
}
💡
When to use VPN locations

VPN locations are useful when exporting content that is region-locked or when the platform serves different results based on the requester's geographic location. Fetch the list of available locations first and use the name value exactly as returned.