Geotargeting

curl -x https://network.joinmassive.com:65535 \
     -U '{PROXY_USERNAME}-country-US-zipcode-10001:{API_KEY}' \
     https://cloudflare.com/cdn-cgi/trace

​

Country, subdivision, city, zipcode

​

Geotargeting rules

• country key must always persist if any of the geo parameters is specified. Otherwise, HTTP 400 is returned.
• If more than one geo key is specified, the server finds an appropriate node strictly matching all the parameters. The only exception is zipcode: if specified, city key is ignored.
  • Details:
    • If both subdivision and zipcode are provided, the city is ignored.
    • If both zipcode and city are provided, the city is ignored.
    • If subdivision and city are provided, both are strictly matched.

​

Targeting multiple locations

curl -x https://network.joinmassive.com:65535 \
     -U '{PROXY_USERNAME}-country-US,GB,DE:{API_KEY}' \
     https://cloudflare.com/cdn-cgi/trace

​

Rules for multiple values

• One list per request. Only one parameter may hold a list. Passing a list in two parameters at once (for example several countries and several cities) returns HTTP 400.
• A list of countries can’t be narrowed. When country holds more than one value, subdivision, city, and zipcode may not be used, because the same region or city name can exist in more than one country. A single asn can still be combined with multiple countries.
• country is still required whenever any geo parameter is set.
• Up to 5 values per parameter. More than 5 returns HTTP 400.
• Duplicate and empty values are ignored — US,US counts as a single value.

​

Examples

curl -x https://network.joinmassive.com:65535 \
     -U '{PROXY_USERNAME}-country-US,GB,DE:{API_KEY}' \
     https://cloudflare.com/cdn-cgi/trace

curl -x https://network.joinmassive.com:65535 \
     -U '{PROXY_USERNAME}-country-US-city-New%20York,Chicago:{API_KEY}' \
     https://cloudflare.com/cdn-cgi/trace

​

Zipcode Notes

• United States: 5
• Canada: 3
• United Kingdom: 2-4
• Brazil: 5
• Ireland: 3
• Japan: 7 (specified for the first 6. The last digit defaults to 1)
• Netherlands: 4
• Portugal: 7 (accurate for the first 4. The last 3 often default to -001)
• Singapore: 2

​

Examples

​

Country

curl -x https://network.joinmassive.com:65535 \
     -U '{PROXY_USERNAME}-country-US:{API_KEY}' \
     https://cloudflare.com/cdn-cgi/trace

​

Country and city

curl -x https://network.joinmassive.com:65535 \
     -U '{PROXY_USERNAME}-country-US-city-New%20York:{API_KEY}' \
     https://cloudflare.com/cdn-cgi/trace

​

Country and subdivision

curl -x https://network.joinmassive.com:65535 \
     -U '{PROXY_USERNAME}-country-US-subdivision-NY:{API_KEY}' \
     https://cloudflare.com/cdn-cgi/trace

​

Country and zipcode

curl -x https://network.joinmassive.com:65535 \
     -U '{PROXY_USERNAME}-country-US-zipcode-10001:{API_KEY}' \
     https://cloudflare.com/cdn-cgi/trace