PHPackages                             enrich-data/enrich-api-php - 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. [API Development](/categories/api)
4. /
5. enrich-data/enrich-api-php

AbandonedArchivedLibrary[API Development](/categories/api)

enrich-data/enrich-api-php
==========================

Enrich API PHP.

2.0.0(7y ago)29MITPHPPHP >=5.4.0

Since Sep 7Pushed 1y ago1 watchersCompare

[ Source](https://github.com/enrich-data/enrich-api-php)[ Packagist](https://packagist.org/packages/enrich-data/enrich-api-php)[ Docs](https://github.com/enrich-data/enrich-api-php)[ RSS](/packages/enrich-data-enrich-api-php/feed)WikiDiscussions master Synced 6d ago

READMEChangelogDependencies (1)Versions (11)Used By (0)

enrich-api-php
==============

[](#enrich-api-php)

The Enrich API PHP wrapper. Enrich, Search and Verify data from your PHP services.

Copyright 2017 Crisp IM SAS. See LICENSE for copying information.

- **😘 Maintainer**: [@valeriansaliou](https://github.com/valeriansaliou)

Usage
-----

[](#usage)

Install the library with Composer.

Then, import it:

```
require __DIR__."/vendor/autoload.php";
```

Construct a new authenticated Enrich client with your `user_id` and `secret_key` tokens.

```
$client = new Enrich();

$client->authenticate("ui_xxxxxx", "sk_xxxxxx");
```

Then, consume the client eg. to enrich an email address:

```
$data = $client->enrich->person([
  "email" => "valerian@crisp.chat"
]);
```

Authentication
--------------

[](#authentication)

To authenticate against the API, get your tokens (`user_id` and `secret_key`).

Then, pass those tokens **once** when you instanciate the Enrich client as following:

```
// Make sure to replace 'user_id' and 'secret_key' with your tokens
$client->authenticate("user_id", "secret_key");
```

Data Discovery
--------------

[](#data-discovery)

**When Enrich doesn't know about a given data point, eg. an email that was never enriched before, it launches a discovery. Discoveries can take a few seconds, and sometimes more than 10 seconds.**

This library implements a retry logic with a timeout if the discovery takes too long, or if the item wasn't found.

Thus, you can expect some requests, especially the Enrich requests, to take more time than expected. This is normal, and is not a performance issue on your side, or on our side. Under the hood, when you request a data point (eg. enrich a person given an email) that doesn't yet exist in our databases, the Enrich API returns the HTTP response `201 Created`. Then, this library will poll the enrich resource for results, with intervals of a few seconds. The API will return `404 Not Found` as the discovery is still processing and no result is yet known at this point. Once a result is found, the API will reply with `200 OK` and return discovered data. If the discovery fails and no data can be aggregated for this email, the library aborts the retry after some time (less than 20 seconds), and returns a `not_found` error.

If a requested data point is already known by the Enrich API, it will be immediately returned, which won't induce any delay.

Resource Methods
----------------

[](#resource-methods)

This library implements all methods the Enrich API provides.

### Verify API

[](#verify-api)

#### Validate an Email

[](#validate-an-email)

- **Method:** `$client->verify->validateEmail($query)`

```
$data = $client->verify->validateEmail([
  "email" => "valerian@crisp.chat"
]);
```

### Enrich API

[](#enrich-api)

#### Enrich a Person

[](#enrich-a-person)

- **Method:** `$client->enrich->person($query)`

```
$data = $client->enrich->person([
  "email" => "valerian@crisp.chat"
]);
```

#### Enrich a Company

[](#enrich-a-company)

- **Method:** `$client->enrich->company($query)`

```
$data = $client->enrich->company([
  "domain" => "crisp.chat"
]);
```

#### Enrich a Network

[](#enrich-a-network)

- **Method:** `$client->enrich->network($query)`

```
$data = $client->enrich->network([
  "ip" => "178.62.89.169"
]);
```

###  Health Score

29

—

LowBetter than 59% of packages

Maintenance28

Infrequent updates — may be unmaintained

Popularity7

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity64

Established project with proven stability

 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 ~48 days

Recently: every ~71 days

Total

9

Last Release

2789d ago

Major Versions

1.2.0 → 2.0.02018-09-27

### Community

Maintainers

![](https://www.gravatar.com/avatar/97c7e2be9d73643826fe240ed575864d436c3432f15ed595c6e7ebee119be208?d=identicon)[valeriansaliou](/maintainers/valeriansaliou)

---

Top Contributors

[![valeriansaliou](https://avatars.githubusercontent.com/u/1451907?v=4)](https://github.com/valeriansaliou "valeriansaliou (22 commits)")

### Embed Badge

![Health badge](/badges/enrich-data-enrich-api-php/health.svg)

```
[![Health](https://phpackages.com/badges/enrich-data-enrich-api-php/health.svg)](https://phpackages.com/packages/enrich-data-enrich-api-php)
```

###  Alternatives

[twilio/sdk

A PHP wrapper for Twilio's API

1.6k92.9M272](/packages/twilio-sdk)[knplabs/github-api

GitHub API v3 client

2.2k15.8M187](/packages/knplabs-github-api)[facebook/php-business-sdk

PHP SDK for Facebook Business

90121.9M34](/packages/facebook-php-business-sdk)[meilisearch/meilisearch-php

PHP wrapper for the Meilisearch API

73813.7M114](/packages/meilisearch-meilisearch-php)[google/common-protos

Google API Common Protos for PHP

173103.7M50](/packages/google-common-protos)[hubspot/api-client

Hubspot API client

23414.2M16](/packages/hubspot-api-client)

PHPackages © 2026

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