Country from headers - v0 by Vercel

Getting Country Information from Headers in Next.js

Vercel provides several geolocation headers that you can use to determine a visitor's country. The most direct way is to use the x-vercel-ip-country header 12.

Using Request Headers in Next.js App Router

Here's how you can access the country information in a Next.js App Router route handler:

export function GET(request: Request) {
  const country = request.headers.get('x-vercel-ip-country');
  return new Response(`Visitor from: ${country || 'Unknown country'}`);
}

Complete Example

Here's a more complete example that creates an API endpoint to return country information:

Available Geolocation Headers

Vercel provides several geolocation headers 2:

x-vercel-ip-country: Two-character ISO 3166-1 country code
x-vercel-ip-continent: Two-character continent code (AF, AN, AS, EU, NA, OC, SA)
x-vercel-ip-city: City name
x-vercel-ip-country-region: Region code
x-vercel-ip-latitude: Latitude coordinate
x-vercel-ip-longitude: Longitude coordinate

Using in Middleware

You can also access geolocation information in Edge Middleware using the geo object 3:

import { NextResponse } from 'next/server';
import type { NextRequest } from 'next/server';

export function middleware(request: NextRequest) {
  // Access country from the geo object
  const country = request.geo?.country || 'Unknown';
  
  // Add country to request headers
  const response = NextResponse.next();
  response.headers.set('x-country', country);
  
  return response;
}

These headers are only available when your application is deployed on Vercel, and will not be present in local development unless you mock them.