Glossary
Welcome to the 2extract.com glossary. This page provides definitions for the common terms you will encounter while using our services. Click on any term to expand its definition.
Actor
The entity that performs an action within your account. An actor can be a registered user (e.g., you@example.com
), an API Token (e.g., API Token: "My Scraper"
), or the System
itself (for automated actions). You can see the actor for each event in your Event Log.
ASN (Autonomous System Number)
A unique number assigned to an Internet Service Provider (ISP). Targeting by ASN (-asn-[number]
) allows you to get IP addresses from a specific network provider, such as Comcast or AT&T.
Authorized IPs (IP Whitelist)
A security feature that restricts proxy access to a list of pre-approved IP addresses. Requests from IPs not on this list will be rejected, even with valid credentials. This can be configured for each individual Proxy.
Balance
Your central account wallet in USD. Funds are added via top-ups and are used to pay for Pay-As-You-Go traffic and any overage from subscription plans. You can manage it on your Billing page.
Carrier
A mobile network operator (e.g., T-Mobile, Verizon, Vodafone). Carrier targeting (-carrier-[name]
) is a feature exclusive to Mobile Proxies.
tag (Correlation Tag)
A custom parameter (-tag-[your_tag]
) you can add to your proxy username. The tag you send is returned in the X-2extract-Tag
response header, helping you correlate asynchronous requests with their responses.
Mobile Proxy
An IP address from a real mobile device on a 3G/4G/5G cellular network. Mobile proxies offer the highest level of trust and are ideal for targeting mobile-first websites and social media.
Pay-As-You-Go (PAYG)
A flexible billing plan where you are charged only for the traffic you consume. The cost is deducted from your main account Balance.
Proxy
Your personal, configurable gateway to our network. Each proxy you create has its own unique credentials, plan, security settings, and usage statistics. This allows you to manage different projects independently.
Residential Proxy
An IP address from a real desktop or laptop device connected to a genuine home Wi-Fi or cable network (ISP). These proxies are highly trusted and excellent for most web scraping tasks.
Rotation
The process of changing the IP address used for your requests.
- Per-Request Rotation (Default): You get a new IP for every request.
- Sticky Session: You keep the same IP for multiple requests.
Session
A series of requests made from the same IP address. You can create a Sticky Session using the -session-[id]
parameter.
Status
The current state of your proxy:
- Active: The proxy is running and ready to use.
- Inactive: The proxy has been manually paused by you and will not accept connections.
- Suspended: The proxy has been automatically stopped, either due to reaching a usage limit or a zero account balance.
Subscription
A recurring billing plan (e.g., "Starter 30GB") that provides a set amount of traffic for a fixed monthly fee. Subscription plans will be available in a future update.
Target Whitelist
A security feature for a specific Proxy that allows it to connect only to a predefined list of domains or hostnames (e.g., google.com
, *.wikipedia.org
).
Username Parameters
Special suffixes (like -country-de
or -session-user123
) that you can add to your proxy's username to control its behavior (e.g., geo-targeting, session type) in real-time for each request.