PHPackages                             amazingbits/zipcode-finder - 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. [Utility & Helpers](/categories/utility)
4. /
5. amazingbits/zipcode-finder

ActiveLibrary[Utility & Helpers](/categories/utility)

amazingbits/zipcode-finder
==========================

A library to find addresses by passing zip-codes

1.0.1(2y ago)06MITPHP

Since Sep 12Pushed 2y ago1 watchersCompare

[ Source](https://github.com/amazingbits/zipcode-finder)[ Packagist](https://packagist.org/packages/amazingbits/zipcode-finder)[ RSS](/packages/amazingbits-zipcode-finder/feed)WikiDiscussions main Synced 1mo ago

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

Zip Code Finder
===============

[](#zip-code-finder)

This library generates an array with address informations by passing a zip code.

The zip code must be in this format: **00000-000** to work correctly.

The example file in root demonstrate how it works.

Thes library use the following APIs to search addresses by zipcode:

- [ViaCEP](https://viacep.com.br/)
- [CDN API CEP](https://apicep.com/api-de-consulta/)
- [OpenCEP](https://opencep.com/)

To use this library, just init Search class from namespace *Amazingbits\\ZipcodeFinder\\UseCase\\Search\\Search* and call the method *getAddressFromZipCode()* passing a zip code with this format: **00000-000**. It returns an array with: cep, street, district, city and state or false.

Click [here](https://github.com/amazingbits/zipcode-finder) to repository.

###  Health Score

20

—

LowBetter than 14% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity4

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity43

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

Unknown

Total

1

Last Release

979d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/a6e308a92029c4e99db63bdc1c702f7f246ed6d16198e1fb8ceff3a491100f3d?d=identicon)[amazingbits](/maintainers/amazingbits)

---

Top Contributors

[![amazingbits](https://avatars.githubusercontent.com/u/57224822?v=4)](https://github.com/amazingbits "amazingbits (5 commits)")

### Embed Badge

![Health badge](/badges/amazingbits-zipcode-finder/health.svg)

```
[![Health](https://phpackages.com/badges/amazingbits-zipcode-finder/health.svg)](https://phpackages.com/packages/amazingbits-zipcode-finder)
```

PHPackages © 2026

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