npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

proxifly

v2.0.2

Published

Proxifly is a service to get free HTTPS proxies and check your public IP

Downloads

157

Readme

🌐 Proxifly Works in Node AND browser environments

Yes, this module works in both Node and browser environments, including compatibility with Webpack and Browserify!

🦄 Features

  • Getting proxy lists
    • An API to get HTTP, HTTPS, and SOCKS proxies
    • Easily filter by country, speed, and anonymity level
    • Request multiple proxies at a time
  • Check your public IP
    • Blazingly fast public IP check
    • Use this to confirm you are connected through the proxy!
    • Use option extended=true to see country, city, zip code, and latitude/longitude for the IP as well.

🔑 Getting an API key

You can use so much of proxifly for free, but if you want to do some advanced stuff, you'll need an API key. You can get one by signing up for a Proxifly account.

📦 Install Proxifly

Option 1: Install via npm

Install with npm if you plan to use proxifly in a Node project or in the browser.

npm install proxifly

If you plan to use proxifly in a browser environment, you will probably need to use Webpack, Browserify, or a similar service to compile it.

const proxifly = new (require('proxifly'))({
  // Not required, but having one removes limits (get your key at https://proxifly.dev).
  apiKey: 'api_test_key'
});

Option 2: Install via CDN

Install with CDN if you plan to use Proxifly only in a browser environment.

<script src="https://cdn.jsdelivr.net/npm/proxifly@latest/dist/index.min.js"></script>
<script type="text/javascript">
  var proxifly = new Proxifly({
    // Not required, but having one removes limits (get your key at https://proxifly.dev).
    apiKey: 'api_test_key'
  });
</script>

Option 3: Use without installation

You can use proxifly in a variety of ways that require no installation, such as curl in terminal/shell. See the Use without installation section below.

⚡️ Using Proxifly

After you have followed the install step, you can start using proxifly to get proxy lists and check your public IP!

getProxy()

Retrieves a fully filterable list of proxies in either json or plain text.

var options = {
  protocol: 'http', // http | socks4 | socks5
  anonymity: 'elite', // transparent | anonymous | elite
  country: 'US', // https://www.nationsonline.org/oneworld/country_code_list.htm
  https: true, // true | false
  speed: 10000, // 0 - 60000
  format: 'json', // json | text
  quantity: 1, // 1 - 20
};

proxifly.getProxy(options)
.then(proxy => {
  console.log('getProxy:', proxy);
  // If you specify a quantity greater than 1, the response will be an array!
  // In this case, you can access by calling response[0].ipPort, response[1].ipPort, etc...
})
.catch(e => {
  console.error(e);
})

options

The options for getProxy(options) are as follows.

  • protocol string, array (optional): Filter by the protocol
    • Values: http, socks4, socks5
    • Default: http
  • anonymity string, array (optional): Filter by anonymity level.
    • Values: transparent, anonymous, elite (elite is the most anonymous)
    • Default: null (no filter, any anonymity)
  • country string, array (optional): Filter by country.
    • Values: US, CA, RU... (see full list at https://www.nationsonline.org/oneworld/country_code_list.htm)
    • Default: null (no filter, any country)
  • https boolean (optional): Filter by https/SSL.
    • Values: true, false
    • Default: null (no filter, any level of https)
  • speed number (optional): Filter by speed, value is in milliseconds taken to connect.
    • Values: 0 - 60000
    • Default: null (no filter, any speed)
    • Note: Specifying a very low number (less than ~400) will return significantly fewer results
  • format string (optional): The response type.
    • Values: json, text
    • Default: json
  • quantity number (optional): The number of proxies to be returned. Any number greater than 1 will be returned in an array.
    • Values: 1 - 20
    • Default: 1
    • Note: Without an API key, you cannot return more than 1 result.

For most options like protocol, anonymity, and country, you can provide an array where each element in the array will act as OR logic. For example:

var options = {
  protocol: ['http', 'socks4'],
  anonymity: ['anonymous', 'elite'],
  country: ['US', 'GB', 'RU'],
}

This filter will call the API for any proxies that are either of protocol (http OR socks4) AND of anonymity (anonymous OR elite) AND from (US OR GB OR RU)!

Example output

Here is a sample response for the .getProxy() method. This is the output you will see when extended=true:

{
  proxy: 'socks4://103.99.110.222:5678',
  protocol: 'socks4',
  ip: '103.99.110.222',
  port: 5678,
  https: false,
  anonymity: 'transparent',
  score: 1,
  geolocation: { country: 'IN', city: 'Unknown' }
}

getPublicIp()

Get your public IP with a simple api call.

var options = {
  mode: 'IPv4', // IPv4 | IPv6
  format: 'json', // json | text
};

proxifly.getPublicIp(options)
.then(proxy => {
  console.log('getPublicIp:', response);
  console.log('My IP is:', response.ip);
  console.log('My country is:', response.country);
})
.catch(e => {
  console.error(e);
})

options

The options for getProxy(options) are as follows.

  • mode string (optional): IPv4 IP or IPv6 IP?
    • Values: IPv4, IPv6
    • Default: IPv4
  • format string (optional): The response type.
    • Values: json, text
    • Default: json

Example output

Here is a sample response for the .getPublicIp() method. This is the output you will see when extended=true:

{
  ip: '104.173.192.180',
  geolocation: {
    country: 'US',
    city: 'Los Angeles',
    latitude: 34.0544,
    longitude: -118.2441
  }
}

For a more in-depth documentation of this library and the Proxifly service, please visit the official Proxifly website.

🔧 Use without installation

Use Proxifly with curl

# Get public IP
# Standard
curl -X POST https://api.proxifly.dev/get-public-ip
# With options
curl -d "format=text&mode=ipv4" -X POST https://api.proxifly.dev/get-public-ip
# With options (alternative)
curl -d '{"format": "text", "mode": "ipv4"}' -H 'Content-Type: application/json' https://api.proxifly.dev/get-public-ip

# Get a proxy
# Standard
curl -X POST https://api.proxifly.dev/get-proxy
# With options
curl -d "format=text&protocol=http&quantity=3" -X POST https://api.proxifly.dev/get-proxy
# With options (alternative)
curl -d '{"format": "text", "protocol": ["http", "socks4"], "quantity": 3}' -H 'Content-Type: application/json' https://api.proxifly.dev/get-proxy

📝 What Can Proxifly do?

Proxifly is a free proxy api that helps you get free proxy lists and check your public IP.

🗨️ Final Words

If you are still having difficulty, we would love for you to post a question to the Proxifly issues page. It is much easier to answer questions that include your code and relevant files! So if you can provide them, we'd be extremely grateful (and more likely to help you find the answer!)

📚 Projects Using this Library

Somiibo: A Social Media Bot with an open-source module library. JekyllUp: A website devoted to sharing the best Jekyll themes. Slapform: A backend processor for your HTML forms on static sites. SoundGrail Music App: A resource for producers, musicians, and DJs. Hammock Report: An API for exploring and listing backyard products.

Ask us to have your project listed! :)