PHPackages                             getfreeproxy/sdk - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [HTTP & Networking](/categories/http)
4. /
5. getfreeproxy/sdk

ActiveLibrary[HTTP & Networking](/categories/http)

getfreeproxy/sdk
================

A lightweight PHP client for the Freeproxy API

1.0.1(5mo ago)11MITPHPPHP >=8.0

Since Nov 19Pushed 5mo agoCompare

[ Source](https://github.com/gfpcom/freeproxy-php)[ Packagist](https://packagist.org/packages/getfreeproxy/sdk)[ Docs](https://developer.getfreeproxy.com/)[ RSS](/packages/getfreeproxy-sdk/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (2)DependenciesVersions (3)Used By (0)

Freeproxy PHP Client
====================

[](#freeproxy-php-client)

A small, dependency-free PHP client for the Freeproxy API. Focused on clear, typed models and a fluent QueryBuilder API.

Requirements
------------

[](#requirements)

Freeproxy PHP Client
====================

[](#freeproxy-php-client-1)

A small, dependency-free PHP client for the Freeproxy API. Focused on clear, typed models and a fluent QueryBuilder API.

Requirements
------------

[](#requirements-1)

- PHP 8.0+
- cURL extension

Installation
------------

[](#installation)

Install via Composer:

```
composer require getfreeproxy/sdk
```

Or include this repository in your project and run `composer dump-autoload`.

Quick Start
-----------

[](#quick-start)

```
require 'vendor/autoload.php';

use Getfreeproxy\Sdk\Client;

$client = new Client(getenv('FREEPROXY_API_KEY'));
$proxies = $client->query();
foreach ($proxies as $p) {
    echo $p->proxyUrl . PHP_EOL;
}
```

### Querying with filters

[](#querying-with-filters)

```
use Getfreeproxy\Sdk\QueryBuilder;

$qb = QueryBuilder::create()->country('US')->protocol('https')->page(1);
$proxies = $client->query($qb);
```

Exceptions
----------

[](#exceptions)

- `Getfreeproxy\Sdk\Exception\ApiException`
- `Getfreeproxy\Sdk\Exception\UnauthorizedException`
- `Getfreeproxy\Sdk\Exception\InvalidParameterException`

These wrap API errors and network problems. Inspect `getApiErrorCode()` on `ApiException` for the provider's error code when available.

Notes
-----

[](#notes)

- The client uses cURL by default and supports a `timeout` option via the constructor.
- The API requires a Bearer token set as the constructor `apiKey` or via `FREEPROXY_API_KEY` environment variable in examples.

Examples
--------

[](#examples)

See the `examples/usage.php` for a quick demonstration.

License
-------

[](#license)

MIT License - see LICENSE file for details

Support
-------

[](#support)

For API documentation, visit:

###  Health Score

32

—

LowBetter than 72% of packages

Maintenance71

Regular maintenance activity

Popularity3

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity41

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~14 days

Total

2

Last Release

165d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/019496c422e073851a263bbac3bae53e1e30d2e1054e253610f4eba0e2ff6368?d=identicon)[getfreeproxy](/maintainers/getfreeproxy)

---

Top Contributors

[![gfpcom](https://avatars.githubusercontent.com/u/197474439?v=4)](https://github.com/gfpcom "gfpcom (6 commits)")

---

Tags

httpphpapiclientproxyfreeproxygetfreeproxy

### Embed Badge

![Health badge](/badges/getfreeproxy-sdk/health.svg)

```
[![Health](https://phpackages.com/badges/getfreeproxy-sdk/health.svg)](https://phpackages.com/packages/getfreeproxy-sdk)
```

###  Alternatives

[php-curl-class/php-curl-class

PHP Curl Class makes it easy to send HTTP requests and integrate with web APIs.

3.3k9.5M353](/packages/php-curl-class-php-curl-class)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)