How to target specific countries and cities with mobile proxies
Country and city geolocation targeting comes as standard with all mobile data purchases. We support over 195 countries and every major city in the world.You can generate proxies which are geolocated to specific countries or cities through both our dashboard generator and through syntax generation in your API requests.
Country Targeting
When generating mobile proxies, you can specify the country using the ISO country code:
# Generate 5 proxies from the United Statescurl --request GET \ --url 'https://api.byteful.com/1.0/public/user/mobile/list?country_id=us&list_count=5' \ --header 'X-API-Public-Key: your_public_key' \ --header 'X-API-Private-Key: your_private_key'
This will return proxies exclusively from the specified country:
Notice that the city information is encoded in the proxy string (city_london).
Subdivision Targeting
You can also target specific subdivisions (states, provinces, regions) within countries:
# Generate 3 proxies from California, UScurl --request GET \ --url 'https://api.byteful.com/1.0/public/user/mobile/list?country_id=us&subdivision_id=us-ca&list_count=3' \ --header 'X-API-Public-Key: your_public_key' \ --header 'X-API-Private-Key: your_private_key'
Geo-targeting Accuracy
Country targeting for mobile proxies is reliable. State, city and ZIP targeting all work, but accuracy below country level is inherently more inconsistent for mobile IPs than for residential ones. It’s worth understanding why before you rely on it for critical workloads.
The reason comes down to how mobile networks are built. Large carriers like Verizon, AT&T and Vodafone run big, dynamic IP pools behind CGNAT (Carrier-Grade NAT). Those pools are linked to multiple regional gateways, so a single IP in one of these pools has no single fixed location. The same address can be in use by a customer in Texas and another in California at the same time.That makes attributing a mobile IP to one specific city or state genuinely difficult, and you’ll often see different geolocation databases disagree about where the same IP “lives”.How we handle this. We rely on at-point measurement, meaning we record where the IP was actually being used at the time we sampled it. That’s the most accurate signal available for a mobile IP, but it can differ from what other geolocation databases report. When our targeting disagrees with a third party tool, that’s usually a characteristic of these pools rather than an inaccuracy on either side.Why it usually doesn’t matter in practice. Most large websites already understand this behaviour and put less weight on the state, city or ZIP of a mobile IP. They lean primarily on country level signals along with other fingerprints, so unless you specifically need precise regional targeting, the practical impact of any mismatch is small.
Finding Available Cities
To discover which cities are available within a country, you can use the city search endpoint:
# List cities in the United Kingdomcurl --request GET \ --url 'https://api.byteful.com/1.0/public/user/city/search?country_id=gb&city_is_populous=true' \ --header 'X-API-Public-Key: your_public_key' \ --header 'X-API-Private-Key: your_private_key'
Combining Geolocation with Other Filters
For advanced targeting, you can combine geolocation with ISP/ASN targeting:
# Generate 3 proxies from AT&T (ASN 7018) in the UScurl --request GET \ --url 'https://api.byteful.com/1.0/public/user/mobile/list?country_id=us&asn_id=7018&list_count=3' \ --header 'X-API-Public-Key: your_public_key' \ --header 'X-API-Private-Key: your_private_key'
Dashboard Generation
You can also easily generate geotargeted proxies through our dashboard interface by selecting the desired country and city from the dropdown menus in the mobile proxy generator.For more information on generating mobile proxies, see the Generating Mobile Proxies guide.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Byteful Documentation","colors":{"primary":"#5547eb","light":"#a192ec","dark":"#5547eb"},"logo":{"light":"https://ping-proxies-strapi.ams3.digitaloceanspaces.com/public/uploads/ping_logo_b83f7f9c6b.webp","dark":"https://ping-proxies-strapi.ams3.cdn.digitaloceanspaces.com/public/uploads/byteful-white-logo.png"},"favicon":"https://mintcdn.com/pingproxies/jDaVCOuDPVpv6QiC/favicon.png?fit=max\u0026auto=format\u0026n=jDaVCOuDPVpv6QiC\u0026q=85\u0026s=5387ba98ccfda681a607c13a9a178666","navbar":{"links":[{"href":"mailto:support@byteful.com","label":"Support"},{"href":"mailto:developers@byteful.com","label":"Developer Help"}]},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"pingproxies","hasAudioNarration":false,"actualSubdomain":"pingproxies","customDomains":["documentation.byteful.com"],"gitSource":{"type":"github","owner":"trybyteful","repo":"ping-proxies-public-api-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{},"buildId":"6b01b7e7df2454ecbb6360f3","clientVersion":"0.0.4271","searchFilterCounts":[{"language":"default","tag":"Documentation","count":147},{"language":"default","tag":"API Reference","count":53},{"language":"default","tag":"API Introduction","count":35},{"language":"default","tag":"Integrations","count":23},{"language":"default","tag":"Core Objects","count":17},{"language":"default","tag":"Explainers","count":9},{"language":"default","tag":"Mobile Proxies","count":7},{"language":"default","tag":"Residential Proxies","count":7},{"language":"default","tag":"Getting Started","count":6},{"language":"default","tag":"Trust \u0026 Safety","count":6}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"site-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"body img:not(#navbar *){border-radius:16px}.code-tag{display:inline-block;padding:1px 5px;border-radius:4px;font-size:0.75em;font-weight:500;font-family:ui-monospace, 'SF Mono', SFMono-Regular, Menlo, Monaco, Consolas, monospace}.code-tag.success{background:#d1fae5;color:#065f46}.code-tag.error{background:#fee2e2;color:#991b1b}"}]}
{"page":{"pagePath":"general/geolocation-targeting-mobile","slug":"/general/geolocation-targeting-mobile","pageMetadata":{"title":"Geolocation Targeting","description":"How to target specific countries and cities with mobile proxies","href":"/general/geolocation-targeting-mobile"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"How to target specific countries and cities with mobile proxies\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,..._provideComponents(),...props.components},{CodeBlock,Heading,Note}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`Country and city geolocation targeting comes as standard with all mobile data purchases. We support over 195 countries and every major city in the world.`}),`\n`,_jsx(_components.p,{children:`You can generate proxies which are geolocated to specific countries or cities through both our dashboard generator and through syntax generation in your API requests.`}),`\n`,_jsx(Heading,{level:`2`,id:`country-targeting`,children:`Country Targeting`}),`\n`,_jsx(_components.p,{children:`When generating mobile proxies, you can specify the country using the ISO country code:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`5`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`5`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`# Generate 5 proxies from the United States`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --request`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` GET`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --url`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'https://api.byteful.com/1.0/public/user/mobile/list?country_id=us\u0026list_count=5'`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --header`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'X-API-Public-Key: your_public_key'`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --header`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'X-API-Private-Key: your_private_key'`})]}),`\n`]})})}),`\n`,_jsx(_components.p,{children:`This will return proxies exclusively from the specified country:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`10`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`10`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"data\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"socks5h://your_user_c_us_s_DDINPY7TQ0781XEO:your_password@mobile.byteful.com:8000\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"socks5h://your_user_c_us_s_XIINPY7TQ0781XEA:your_password@mobile.byteful.com:8000\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"socks5h://your_user_c_us_s_PPINPY7TQ0781XEB:your_password@mobile.byteful.com:8000\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"socks5h://your_user_c_us_s_QQINPY7TQ0781XEC:your_password@mobile.byteful.com:8000\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"socks5h://your_user_c_us_s_RRINPY7TQ0781XED:your_password@mobile.byteful.com:8000\"`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` ],`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"message\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Mobile list successfully created.\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`city-targeting`,children:`City Targeting`}),`\n`,_jsx(_components.p,{children:`For more precise targeting, you can generate proxies from specific cities:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`5`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`5`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`# Generate 3 proxies from London, UK`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --request`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` GET`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --url`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'https://api.byteful.com/1.0/public/user/mobile/list?country_id=gb\u0026city_alias=london\u0026list_count=3'`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --header`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'X-API-Public-Key: your_public_key'`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --header`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'X-API-Private-Key: your_private_key'`})]}),`\n`]})})}),`\n`,_jsx(_components.p,{children:`Response:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`8`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`8`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"data\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"socks5h://your_user_c_gb_city_london_s_DDINPY7TQ0781XEO:your_password@mobile.byteful.com:8000\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"socks5h://your_user_c_gb_city_london_s_XIINPY7TQ0781XEA:your_password@mobile.byteful.com:8000\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"socks5h://your_user_c_gb_city_london_s_PPINPY7TQ0781XEB:your_password@mobile.byteful.com:8000\"`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` ],`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"message\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Mobile list successfully created.\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`Notice that the city information is encoded in the proxy string (`,_jsx(_components.code,{children:`city_london`}),`).`]}),`\n`,_jsx(Heading,{level:`2`,id:`subdivision-targeting`,children:`Subdivision Targeting`}),`\n`,_jsx(_components.p,{children:`You can also target specific subdivisions (states, provinces, regions) within countries:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`5`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`5`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`# Generate 3 proxies from California, US`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --request`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` GET`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --url`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'https://api.byteful.com/1.0/public/user/mobile/list?country_id=us\u0026subdivision_id=us-ca\u0026list_count=3'`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --header`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'X-API-Public-Key: your_public_key'`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --header`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'X-API-Private-Key: your_private_key'`})]}),`\n`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`geo-targeting-accuracy`,children:`Geo-targeting Accuracy`}),`\n`,_jsx(Note,{children:_jsx(_components.p,{children:`Country targeting for mobile proxies is reliable. State, city and ZIP targeting all work, but accuracy below country level is inherently more inconsistent for mobile IPs than for residential ones. It’s worth understanding why before you rely on it for critical workloads.`})}),`\n`,_jsx(_components.p,{children:`The reason comes down to how mobile networks are built. Large carriers like Verizon, AT\u0026T and Vodafone run big, dynamic IP pools behind CGNAT (Carrier-Grade NAT). Those pools are linked to multiple regional gateways, so a single IP in one of these pools has no single fixed location. The same address can be in use by a customer in Texas and another in California at the same time.`}),`\n`,_jsx(_components.p,{children:`That makes attributing a mobile IP to one specific city or state genuinely difficult, and you’ll often see different geolocation databases disagree about where the same IP “lives”.`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`How we handle this.`}),` We rely on at-point measurement, meaning we record where the IP was actually being used at the time we sampled it. That’s the most accurate signal available for a mobile IP, but it can differ from what other geolocation databases report. When our targeting disagrees with a third party tool, that’s usually a characteristic of these pools rather than an inaccuracy on either side.`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Why it usually doesn’t matter in practice.`}),` Most large websites already understand this behaviour and put less weight on the state, city or ZIP of a mobile IP. They lean primarily on country level signals along with other fingerprints, so unless you specifically need precise regional targeting, the practical impact of any mismatch is small.`]}),`\n`,_jsx(Heading,{level:`2`,id:`finding-available-cities`,children:`Finding Available Cities`}),`\n`,_jsx(_components.p,{children:`To discover which cities are available within a country, you can use the city search endpoint:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`5`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`5`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`# List cities in the United Kingdom`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --request`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` GET`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --url`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'https://api.byteful.com/1.0/public/user/city/search?country_id=gb\u0026city_is_populous=true'`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --header`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'X-API-Public-Key: your_public_key'`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --header`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'X-API-Private-Key: your_private_key'`})]}),`\n`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`combining-geolocation-with-other-filters`,children:`Combining Geolocation with Other Filters`}),`\n`,_jsx(_components.p,{children:`For advanced targeting, you can combine geolocation with ISP/ASN targeting:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`5`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`5`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`# Generate 3 proxies from AT\u0026T (ASN 7018) in the US`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --request`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` GET`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --url`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'https://api.byteful.com/1.0/public/user/mobile/list?country_id=us\u0026asn_id=7018\u0026list_count=3'`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --header`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'X-API-Public-Key: your_public_key'`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --header`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'X-API-Private-Key: your_private_key'`})]}),`\n`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`dashboard-generation`,children:`Dashboard Generation`}),`\n`,_jsx(_components.p,{children:`You can also easily generate geotargeted proxies through our dashboard interface by selecting the desired country and city from the dropdown menus in the mobile proxy generator.`}),`\n`,_jsxs(_components.p,{children:[`For more information on generating mobile proxies, see the `,_jsx(_components.a,{href:`/general/generating-mobile-proxies`,children:`Generating Mobile Proxies`}),` guide.`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Geolocation Targeting","description":"How to target specific countries and cities with mobile proxies","href":"/general/geolocation-targeting-mobile"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Country Targeting","slug":"country-targeting","depth":2,"children":[]},{"title":"City Targeting","slug":"city-targeting","depth":2,"children":[]},{"title":"Subdivision Targeting","slug":"subdivision-targeting","depth":2,"children":[]},{"title":"Geo-targeting Accuracy","slug":"geo-targeting-accuracy","depth":2,"children":[]},{"title":"Finding Available Cities","slug":"finding-available-cities","depth":2,"children":[]},{"title":"Combining Geolocation with Other Filters","slug":"combining-geolocation-with-other-filters","depth":2,"children":[]},{"title":"Dashboard Generation","slug":"dashboard-generation","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/pingproxies/7505d9d366ea757e/ga.js"],"subdomain":"pingproxies","siteName":"Byteful Documentation","title":"Geolocation Targeting - Byteful Documentation","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-05-23T11:30:46.271Z","originalFileLocation":"general/geolocation-targeting-mobile.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"How to target specific countries and cities with mobile proxies\">\u003cmeta data-mint-head name=\"application-name\" content=\"Byteful Documentation\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/pingproxies/uWB3sfmJW5QuHyF3/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/pingproxies/uWB3sfmJW5QuHyF3/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/pingproxies/uWB3sfmJW5QuHyF3/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/pingproxies/uWB3sfmJW5QuHyF3/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/pingproxies/uWB3sfmJW5QuHyF3/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/pingproxies/uWB3sfmJW5QuHyF3/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/pingproxies/uWB3sfmJW5QuHyF3/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/pingproxies/uWB3sfmJW5QuHyF3/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/pingproxies/uWB3sfmJW5QuHyF3/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Geolocation Targeting - Byteful Documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"How to target specific countries and cities with mobile proxies\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Byteful Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://documentation.byteful.com/general/geolocation-targeting-mobile\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://pingproxies.mintlify.site/_mintlify/api/og/v2?division=Mobile+Proxies\u0026amp;title=Geolocation+Targeting\u0026amp;description=How+to+target+specific+countries+and+cities+with+mobile+proxies\u0026amp;theme=5f3efe6753c747b87bf62980\u0026amp;signature=2e1a87a6ea121a0ec7d668b7786435d2171ae3dd0825195cd1c5d89c311c9131\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Geolocation Targeting - Byteful Documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"How to target specific countries and cities with mobile proxies\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://pingproxies.mintlify.site/_mintlify/api/og/v2?division=Mobile+Proxies\u0026amp;title=Geolocation+Targeting\u0026amp;description=How+to+target+specific+countries+and+cities+with+mobile+proxies\u0026amp;theme=5f3efe6753c747b87bf62980\u0026amp;signature=2e1a87a6ea121a0ec7d668b7786435d2171ae3dd0825195cd1c5d89c311c9131\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/pingproxies/uWB3sfmJW5QuHyF3/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Byteful Documentation\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#5547eb\">\u003clink data-mint-head rel=\"canonical\" href=\"https://documentation.byteful.com/general/geolocation-targeting-mobile\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/general/geolocation-targeting-mobile.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://documentation.byteful.com/#organization\",\"name\":\"Byteful Documentation\",\"url\":\"https://documentation.byteful.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://ping-proxies-strapi.ams3.digitaloceanspaces.com/public/uploads/ping_logo_b83f7f9c6b.webp\"}},{\"@type\":\"WebSite\",\"@id\":\"https://documentation.byteful.com#website\",\"name\":\"Byteful Documentation\",\"url\":\"https://documentation.byteful.com\",\"publisher\":{\"@id\":\"https://documentation.byteful.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://documentation.byteful.com/general/geolocation-targeting-mobile#webpage\",\"url\":\"https://documentation.byteful.com/general/geolocation-targeting-mobile\",\"name\":\"Geolocation Targeting\",\"description\":\"How to target specific countries and cities with mobile proxies\",\"dateModified\":\"2026-05-23T11:30:46.271Z\",\"isPartOf\":{\"@id\":\"https://documentation.byteful.com#website\"},\"breadcrumb\":{\"@id\":\"https://documentation.byteful.com/general/geolocation-targeting-mobile#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://documentation.byteful.com/general/geolocation-targeting-mobile#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Documentation\",\"item\":\"https://documentation.byteful.com/general/what-is-a-proxy\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Mobile Proxies\",\"item\":\"https://documentation.byteful.com/general/explaining-mobile-proxies\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Geolocation Targeting\",\"item\":\"https://documentation.byteful.com/general/geolocation-targeting-mobile\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://documentation.byteful.com/general/geolocation-targeting-mobile#article\",\"headline\":\"Geolocation Targeting\",\"name\":\"Geolocation Targeting\",\"description\":\"How to target specific countries and cities with mobile proxies\",\"url\":\"https://documentation.byteful.com/general/geolocation-targeting-mobile\",\"mainEntityOfPage\":{\"@id\":\"https://documentation.byteful.com/general/geolocation-targeting-mobile#webpage\"},\"dateModified\":\"2026-05-23T11:30:46.271Z\",\"publisher\":{\"@id\":\"https://documentation.byteful.com/#organization\"},\"isPartOf\":{\"@id\":\"https://documentation.byteful.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Byteful Documentation\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Byteful Documentation\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/general/geolocation-targeting-mobile.md","siteName":"Byteful Documentation","nav":{"global":null,"tabs":[{"tab":"Documentation","groups":[{"group":"Getting Started","icon":"rocket","pages":[{"title":"Introduction","href":"/introduction"},{"title":"Account Registration","href":"/general/account-registration"},{"title":"Products \u0026 Purchasing","href":"/general/making-your-first-purchase"},{"title":"Startup Program","href":"/general/startup-program"},{"title":"Need Help?","href":"/need-help"}]},{"group":"Documentation","icon":"book","pages":[{"group":"Proxy Basics","icon":"book-open","pages":[{"title":"What is a Proxy?","href":"/general/what-is-a-proxy"},{"title":"Supported Protocols","href":"/general/supported-protocols"}]},{"group":"Static Proxies","icon":"server","pages":[{"title":"Datacenter Proxies","href":"/general/static-datacenter-proxies"},{"title":"Static Residential ISP Proxies","href":"/general/static-residential-isp-proxies"},{"title":"Listing and Exporting Proxies","href":"/general/listing-and-exporting-proxies"},{"title":"OS Fingerprinting","href":"/general/os-fingerprint-emulation"}]},{"group":"Residential Proxies","icon":"house","pages":[{"title":"Understanding Residential Proxies","href":"/general/explaining-residential-proxies"},{"title":"Generating Residential Proxies","href":"/general/generating-residential-proxies"},{"title":"Using Smartpath®","href":"/general/using-smartpath"},{"title":"Sticky vs Rotating Residential Proxies","href":"/general/sticky-vs-rotating-residential-proxies"},{"title":"Geolocation Targeting","href":"/general/geolocation-targeting"},{"title":"ISP / ASN Targeting","href":"/general/isp-asn-targeting"},{"title":"OS Targeting","href":"/general/os-targeting"}]},{"group":"Mobile Proxies","icon":"mobile","pages":[{"title":"Understanding Mobile Proxies","href":"/general/explaining-mobile-proxies"},{"title":"Generating Mobile Proxies","href":"/general/generating-mobile-proxies"},{"title":"Using Smartpath®","href":"/general/using-smartpath-mobile"},{"title":"Sticky vs Rotating Mobile Proxies","description":"Understanding the differences between sticky and rotating mobile proxies and their use cases","href":"/general/sticky-vs-rotating-mobile-proxies"},{"title":"Geolocation Targeting","href":"/general/geolocation-targeting-mobile"},{"title":"ISP / ASN Targeting","description":"Learn how to target specific internet service providers and ASNs with Byteful","href":"/general/isp-asn-targeting-mobile"},{"title":"OS Targeting","href":"/general/os-targeting-mobile"}]},{"group":"Proxy Authentication","icon":"lock","pages":[{"title":"Proxy Authentication Types","href":"/general/proxy-authentication-types"},{"title":"Creating a Proxy User","href":"/general/creating-a-proxy-user"},{"title":"Editing a Proxy User","href":"/general/editing-a-proxy-user"}]},{"group":"Service Management","icon":"gear","pages":[{"title":"Resizing your service","href":"/general/resizing-your-service"},{"title":"Changing your payment cycle","href":"/general/changing-payment-cycle"},{"title":"Service Cancellation","href":"/general/service-cancellation"},{"title":"Edit Payment Method","href":"/general/edit-payment-method"}]},{"group":"Analytics and Debugging","icon":"chart-line","pages":[{"title":"Observability Overview","href":"/general/observability-overview"},{"title":"Live Network Activity","href":"/general/live-network-activity"},{"title":"Debugging Proxy Errors","href":"/general/debugging-and-error-codes"}]},{"group":"Billing Management","icon":"credit-card","pages":[{"title":"Billing Address","href":"/general/billing-address"},{"title":"Invoices","href":"/general/invoices"},{"title":"Credit and Payment Transactions","href":"/general/credit-and-payment-transactions"},{"title":"Store Credit","href":"/general/store-credit"}]},{"group":"User Management","icon":"user","pages":[{"title":"Two-factor Authentication (2FA)","href":"/general/two-factor-authentication"},{"title":"Changing your email address","href":"/general/changing-your-email-address"},{"title":"Changing your password","href":"/general/changing-your-password"},{"title":"Forgotten Password","href":"/general/forgot-password"}]},{"group":"Organization Management","icon":"users","pages":[{"title":"Creating an Organization","href":"/general/organizations/creating-an-organization"},{"title":"Converting a Personal Workspace","href":"/general/organizations/converting-a-personal-workspace"},{"title":"Managing Team Members","href":"/general/organizations/managing-team-members"},{"title":"Requiring Two-factor Authentication","href":"/general/organizations/requiring-two-factor-authentication"},{"title":"Creating Fine-grained API Keys","href":"/general/organizations/creating-fine-grained-api-keys"}]},{"group":"Integrations","icon":"puzzle","pages":[{"title":"Integrating with a Browser","href":"/general/integration/browser-integrations"},{"title":"Integrating on Android or iOS","href":"/general/integration/android-iphone"},{"title":"Safari","sidebarTitle":"Safari","url":"https://byteful.com/blog/setting-up-proxies-in-safari","href":"/general/integration/safari"},{"title":"DuckDuckGo","sidebarTitle":"DuckDuckGo","url":"https://byteful.com/blog/duckduckgo-proxy-setup-guide","href":"/general/integration/duckduckgo"},{"title":"Microsoft Edge","sidebarTitle":"Microsoft Edge","url":"https://byteful.com/blog/setting-up-proxies-in-microsoft-edge","href":"/general/integration/microsoft-edge"},{"title":"FoxyProxy","sidebarTitle":"FoxyProxy","url":"https://byteful.com/blog/configure-foxyproxy-for-chrome-and-firefox","href":"/general/integration/foxyproxy"},{"title":"Shadowrocket","sidebarTitle":"Shadowrocket","url":"https://byteful.com/blog/shadowrocket-proxy-configuration","href":"/general/integration/shadowrocket"},{"title":"Proxifier","sidebarTitle":"Proxifier","url":"https://byteful.com/blog/set-up-proxies-with-proxifier","href":"/general/integration/proxifier"},{"title":"cURL","sidebarTitle":"cURL","url":"https://byteful.com/blog/curl-with-proxy","href":"/general/integration/curl"},{"title":"Proxy SwitchyOmega","sidebarTitle":"Proxy SwitchyOmega","url":"https://byteful.com/blog/proxy-switchyomega","href":"/general/integration/proxy-switchyomega"},{"title":"ClonBrowser","sidebarTitle":"ClonBrowser","url":"https://byteful.com/blog/clonbrowser","href":"/general/integration/clonbrowser"},{"title":"DICloak","sidebarTitle":"DICloak","url":"https://byteful.com/blog/dicloak","href":"/general/integration/dicloak"},{"title":"GoLogin","sidebarTitle":"GoLogin","url":"https://byteful.com/blog/gologin-proxy-setup","href":"/general/integration/gologin"},{"title":"Hayha","sidebarTitle":"Hayha","url":"https://byteful.com/blog/ping-proxies-hayha","href":"/general/integration/hayha"},{"title":"ixBrowser","sidebarTitle":"ixBrowser","url":"https://byteful.com/blog/ixbrowser-proxy-configuration","href":"/general/integration/ixbrowser"},{"title":"Lauth","sidebarTitle":"Lauth","url":"https://byteful.com/blog/integrating-ping-proxies-with-lauth","href":"/general/integration/lauth"},{"title":"MuLogin","sidebarTitle":"MuLogin","url":"https://byteful.com/blog/mulogin-proxy-setup","href":"/general/integration/mulogin"},{"title":"Multilogin","sidebarTitle":"Multilogin","url":"https://byteful.com/blog/multilogin","href":"/general/integration/multilogin"},{"title":"Nstbrowser","sidebarTitle":"Nstbrowser","url":"https://byteful.com/blog/nstbrowser","href":"/general/integration/nstbrowser"},{"title":"Octo Browser","sidebarTitle":"Octo Browser","url":"https://byteful.com/blog/octo-browser-proxy-setup","href":"/general/integration/octobrowser"},{"title":"SessionBox","sidebarTitle":"SessionBox","url":"https://byteful.com/blog/sessionbox","href":"/general/integration/sessionbox"},{"title":"Undetectable Browser","sidebarTitle":"Undetectable Browser","url":"https://byteful.com/blog/undetectable-browser-proxy-integration","href":"/general/integration/undetectable-browser"},{"title":"VMLogin","sidebarTitle":"VMLogin","url":"https://byteful.com/blog/vmlogin-proxy-setup","href":"/general/integration/vmlogin"}]}]},{"group":"Trust \u0026 Safety","icon":"lock","pages":[{"title":"Acceptable Usage Policy","href":"/general/acceptable-usage-policy"},{"title":"Abuse Reporting Policy","href":"/general/abuse-reporting-policy"},{"title":"Ethical Sourcing Guidelines","href":"/general/ethical-sourcing"},{"title":"Know Your Customer Policy","href":"/general/kyc-policy"},{"title":"Restricted Countries","href":"/general/restricted-countries"},{"title":"Restricted Domains \u0026 Ports","href":"/general/restricted-domains"}]},{"group":"Policies","icon":"pen","pages":[{"title":"Fair Usage Policy","href":"/general/anti-abuse-policy"},{"title":"Refund Policy","href":"/general/refund-policy"},{"title":"Proxy Replacement Policy","href":"/general/static-proxy-replacements"},{"title":"Sub-Processors","href":"/general/sub-processors"}]}]},{"tab":"API Introduction","pages":[{"title":"API Introduction","href":"/api-introduction"}]},{"tab":"API Examples","pages":[{"title":"API Examples","href":"/examples-index"}]},{"tab":"API Reference","pages":[{"title":"API Reference","href":"/api-reference/customer/retrieve-current-customer"}]},{"tab":"API Changelog","pages":[{"title":"API Changelog","href":"/api-changelog"}]},{"tab":"Product Updates","pages":[{"title":"Product Updates","href":"/product-updates"}]}]},"basePath":"","title":"Geolocation Targeting - Byteful Documentation","deploymentId":"dpl_Em2U4NQQ2N2DE3HPbPUJVZLnAtvc","buildId":"dpl_Em2U4NQQ2N2DE3HPbPUJVZLnAtvc","dynamics":[],"chunks":[]}