Skip to main content

How to work with Residential and Mobile Proxies via API

Basic usage

Credentials:
  • Proxy host: pool.infatica.io or IP 192.158.1.38
  • Proxy port: 10000
  • Proxy type: HTTPS/SOCKS5 (autodetected)
  • Proxy user: xxx
  • Proxy password: xxx

192.158.1.38 - this IP is listed as an example, it`s not a working IP address. It must be taken from a personal account.

Attention:

For simultaneous requests, use different ports in the range 10000-10999.

Important note: Each IP address port corresponds to a unique IP address (e.g. 123.45.6:10005 and 123.45.6:10006 are different IPs).

User & password:

The API tool uses only 1 login in your plan, which you can find in your Infatica account. Your other proxy logins from the proxy lists will not be used for the API.

How to find your proxy login for API

  1. Go to My Services on the left side menu:

dashboard-services

  1. Scroll down to the Generate Proxy List section and click the API Tool button:

dashboard-services-no-list

  1. You will then be taken to a page for working with the API.

Your proxy login and password are in the Proxy User and Proxy Password fields. Use only this login and password to work with the API.

dashboard registration

Host formats:

IP:

  • HTTPS proxy URL: http://xxx:xxx@192.158.1.38:10000
  • SOCKS5 proxy URL: socks5://xxx:xxx@192.158.1.38:10000

Domain:

  • HTTPS proxy URL: http://xxx:xxx@pool.infatica.io:10000
  • SOCKS5 proxy URL: socks5://xxx:xxx@pool.infatica.io:10000

You can use any of these host formats (IP or domain), and you can generate the format you need in your personal account.

Curl command line sample:

curl -v -x xxx:xxx@pool.infatica.io:10000 https://www.google.com
note

For each request, a new exit IP address is allocated from the global IP pool.

Restrict exit IPs to a specific country

info

You can add country data to the login info as follows: xxx_c_US

Here, US is a two-letter country code as per ISO 3166-1:

Country codes (click here to expand)
CodeCountry nameCodeCountry nameCodeCountry name
ADAndorraGLGreenlandNONorway
AEUnited Arab EmiratesGMGambiaNPNepal
AFAfghanistanGNGuineaNRNauru
AGAntigua and BarbudaGPGuadeloupeNUNiue
AIAnguillaGQEquatorial GuineaNZNew Zealand
ALAlbaniaGRGreeceOMOman
AMArmeniaGSSouth Georgia and the South Sandwich IslandsPAPanama
AOAngolaGTGuatemalaPEPeru
AQAntarcticaGUGuamPFFrench Polynesia
ARArgentinaGWGuinea-BissauPGPapua New Guinea
ASAmerican SamoaGYGuyanaPHPhilippines
ATAustriaHKHong KongPKPakistan
AUAustraliaHMHeard Island and McDonald IslandsPLPoland
AWArubaHNHondurasPMSaint Pierre and Miquelon
AXÅland IslandsHRCroatiaPNPitcairn
AZAzerbaijanHTHaitiPRPuerto Rico
BABosnia and HerzegovinaHUHungaryPSPalestine, State of
BBBarbadosIDIndonesiaPTPortugal
BDBangladeshIEIrelandPWPalau
BEBelgiumILIsraelPYParaguay
BFBurkina FasoIMIsle of ManQAQatar
BGBulgariaINIndiaRERéunion
BHBahrainIOBritish Indian Ocean TerritoryRORomania
BIBurundiIQIraqRSSerbia
BJBeninIRIran (Islamic Republic of)RURussian Federation
BLSaint BarthélemyISIcelandRWRwanda
BMBermudaITItalySASaudi Arabia
BNBrunei DarussalamJEJerseySBSolomon Islands
BOBolivia (Plurinational State of)JMJamaicaSCSeychelles
BQBonaire, Sint Eustatius and SabaJOJordanSDSudan
BRBrazilJPJapanSESweden
BSBahamasKEKenyaSGSingapore
BTBhutanKGKyrgyzstanSHSaint Helena, Ascension and Tristan da Cunha
BVBouvet IslandKHCambodiaSISlovenia
BWBotswanaKIKiribatiSJSvalbard and Jan Mayen
BYBelarusKMComorosSKSlovakia
BZBelizeKNSaint Kitts and NevisSLSierra Leone
CACanadaKPKorea (Democratic People's Republic of)SMSan Marino
CCCocos (Keeling) IslandsKRKorea, Republic ofSNSenegal
CDCongo, Democratic Republic of theKWKuwaitSOSomalia
CFCentral African RepublicKYCayman IslandsSRSuriname
CGCongoKZKazakhstanSSSouth Sudan
CHSwitzerlandLALao People's Democratic RepublicSTSao Tome and Principe
CICôte d'IvoireLBLebanonSVEl Salvador
CKCook IslandsLCSaint LuciaSXSint Maarten (Dutch part)
CLChileLILiechtensteinSYSyrian Arab Republic
CMCameroonLKSri LankaSZEswatini
CNChinaLRLiberiaTCTurks and Caicos Islands
COColombiaLSLesothoTDChad
CRCosta RicaLTLithuaniaTFFrench Southern Territories
CUCubaLULuxembourgTGTogo
CVCabo VerdeLVLatviaTHThailand
CWCuraçaoLYLibyaTJTajikistan
CXChristmas IslandMAMoroccoTKTokelau
CYCyprusMCMonacoTLTimor-Leste
CZCzechiaMDMoldova, Republic ofTMTurkmenistan
DEGermanyMEMontenegroTNTunisia
DJDjiboutiMFSaint Martin (French part)TOTonga
DKDenmarkMGMadagascarTRTürkiye
DMDominicaMHMarshall IslandsTTTrinidad and Tobago
DODominican RepublicMKNorth MacedoniaTVTuvalu
DZAlgeriaMLMaliTWTaiwan, Province of China
ECEcuadorMMMyanmarTZTanzania, United Republic of
EEEstoniaMNMongoliaUAUkraine
EGEgyptMOMacaoUGUganda
EHWestern SaharaMPNorthern Mariana IslandsUMUnited States Minor Outlying Islands
EREritreaMQMartiniqueUSUnited States of America
ESSpainMRMauritaniaUYUruguay
ETEthiopiaMSMontserratUZUzbekistan
FIFinlandMTMaltaVAHoly See
FJFijiMUMauritiusVCSaint Vincent and the Grenadines
FKFalkland Islands (Malvinas)MVMaldivesVEVenezuela (Bolivarian Republic of)
FMMicronesia (Federated States of)MWMalawiVGVirgin Islands (British)
FOFaroe IslandsMXMexicoVIVirgin Islands (U.S.)
FRFranceMYMalaysiaVNViet Nam
GAGabonMZMozambiqueVUVanuatu
GBUnited Kingdom of Great Britain and Northern IrelandNANamibiaWFWallis and Futuna
GDGrenadaNCNew CaledoniaWSSamoa
GEGeorgiaNENigerYEYemen
GFFrench GuianaNFNorfolk IslandYTMayotte
GGGuernseyNGNigeriaZASouth Africa
GHGhanaNINicaraguaZMZambia
GIGibraltarNLNetherlandsZWZimbabwe

Curl command line sample:

curl -v -x xxx_c_US:xxx@pool.infatica.io:10000 https://www.google.com

Restrict exit IPs to a specific subdivision

info

You can add subdivision data to the login info as follows : xxx_sd_ID

The list with ID of subdivisions you can find here.

Curl command line sample:

curl -v -x xxx_sd_1906:xxx@pool.infatica.io:10000 https://www.google.com

Restrict exit IPs to a specific city

info

You can add city data to the login info as follows: xxx_city_Paris

You can specify both country and city at the same time like: xxx_c_US_city_New-York.

Curl command line sample:

curl -v -x xxx_city_Paris:xxx@pool.infatica.io:10000 https://www.google.com
City names:

Spaces in city names (e.g. New York) must be replaced with the minus sign (-). For example:

curl -v -x xxx_city_New-York:xxx@pool.infatica.io:10000 https://www.google.com

Restrict exit IPs to a specific ISP

info

You can add ISP data to the login info as follows : xxx_isp_ID

The list with ID of ISPs you can find here.

Curl command line sample:

curl -v -x xxx_isp_51811:xxx@pool.infatica.io:10000 https://www.google.com

Restrict exit IPs to a specific ASN

info

You can add ASN data to the login info as follows : xxx_asn_12389

Curl command line sample:

curl -v -x xxx_asn_12389:xxx@pool.infatica.io:10000 https://www.google.com

Session control

Session ID

info

If you need to initiate requests from the same IP more than once (reuse the same IP), you can add a session ID to the login as follows: xxx_s_100

In this case, 100 is your session ID. You can use any alpha-numeric string as a session ID.

If you repeat the session ID in the subsequent requests, you’ll get the same exit IP as long as it stays online.

Time limit for inactive sessions - 60 minutes.

Curl command line sample:

curl -v -x xxx_c_US_s_100:xxx@pool.infatica.io:10000 https://www.google.com

Session time

If you need to set up the session time (rotation), you can add a session time to the login with session ID as follows: xxx_s_100_ttl_30s

The ttl parameter goes along with the session ID and allows you to set the session time. The suffixes s (seconds), m (minutes), h (hours) can be used in this parameter. After the specified time has elapsed, a request within that session will cause it to be re-created, resulting in the assignment of a new IP address (it's an alternative method to set a custom rotation time for each session).

Example with a TTL of 10 seconds:

curl -v -x xxx_c_US_s_100_ttl_10s:xxx@pool.infatica.io:10000 https://www.google.com

Example with a TTL of 15 minutes:

curl -v -x xxx_c_US_s_100_ttl_15m:xxx@pool.infatica.io:10000 https://www.google.com

Example with a TTL of with 1 hour:

curl -v -x xxx_c_US_s_100_ttl_1h:xxx@pool.infatica.io:10000 https://www.google.com

Different geotargeting combinations

info

You can also specify different targeting combinations - country, city, ISP, ASN, session - at the same time.

Example with country, city, ASN, session.

curl -v -x xxx_c_US_city_New-York_asn_12271_s_100:xxx@pool.infatica.io:10000 https://www.google.com

Example with country, city, session.

curl -v -x xxx_c_US_city_New-York_s_100:xxx@pool.infatica.io:10000 https://www.google.com

Example with country, ASN.

curl -v -x xxx_c_US_asn_12271:xxx@pool.infatica.io:10000 https://www.google.com