Geotargeting
Geotargeting lets you route scraping requests through proxy servers located in specific countries and cities. The target website sees the request as coming from that geographic location, allowing you to access region-restricted content, view localized pricing, or verify geo-specific advertisements.
Set the proxyCountry parameter to an ISO 3166-1 alpha-3 country code (e.g., USA, GBR, AUS) and optionally the proxyCity parameter for finer granularity. When using geotargeting, the proxyType parameter is required - choose either DataCenter or Residential.
When To Use This
- Region-restricted content - Access websites or pages that are only available in certain countries (e.g., streaming catalogues, news articles, government portals).
- Price comparison and monitoring - View localized pricing for e-commerce products, flights, or hotels across different markets.
- Ad verification - Confirm that advertisements display correctly in target regions and markets.
- Localized search results - Scrape search engines to see region-specific rankings and results.
- Compliance testing - Verify that your website correctly serves different content based on visitor location.
Choosing a Proxy Type for Geotargeting
| Data Center | Residential | |
|---|---|---|
| Geolocation coverage | Limited countries | Extensive countries and cities |
| Credit cost | 5 per request | 10 per request |
| Best for | Popular countries with basic needs | Specific cities or countries with limited data center presence |
Use the Available Countries and Available Cities API endpoints to see which locations are currently supported for each proxy type.
Example: Country-Level Targeting (Australia)
GET https://api.scrapi.tech/v1/scrape?url=http://ip-api.com/json&proxyType=Residential&proxyCountry=AUS
POST https://api.scrapi.tech/v1/scrape
{
"url": "http://ip-api.com/json",
"proxyType": "Residential",
"proxyCountry": "AUS"
}Example: City-Level Targeting (Melbourne, Australia)
POST https://api.scrapi.tech/v1/scrape
{
"url": "http://ip-api.com/json",
"proxyType": "Residential",
"proxyCountry": "AUS",
"proxyCity": "Melbourne"
}Related Features
- Available Countries - List all supported country codes for geotargeting.
- Available Cities - List all supported cities within a country.
- Residential Proxy - Best proxy type for wide geolocation coverage.
- Data Center Proxy - Cheaper geotargeting with limited locations.
- Sessions - Maintain the same geo-located IP across multiple requests.
Testing
Test this request in the Playground or view the OpenAPI specification.