PHPackages                             zeeshan/inspector - 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 &amp; Helpers](/categories/utility)
4. /
5. zeeshan/inspector

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

zeeshan/inspector
=================

Inspector - A PHP library that fetches the social accounts, website, name, photos, employment history and other details possible for the user by his email.

v1.0(10y ago)60495MITPHP

Since Jun 23Pushed 7y ago5 watchersCompare

[ Source](https://github.com/zeeshanu/inspector)[ Packagist](https://packagist.org/packages/zeeshan/inspector)[ Docs](https://github.com/zeeshanu/)[ RSS](/packages/zeeshan-inspector/feed)WikiDiscussions master Synced today

READMEChangelog (1)Dependencies (1)Versions (3)Used By (0)

🔍 Inspector
===========

[](#mag-inspector)

Inspector - A PHP library that fetches the social accounts, website, name, photos, employment history and other details possible for the user by their email.

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

[](#installation)

You can install the library using the following ways:

Using Composer
--------------

[](#using-composer)

You can install this through [Composer](http://getcomposer.org/), a dependency manager for PHP. Just run the below command:

```
composer require zeeshanu/inspector

```

For further details you can find the package at [Packagist](https://packagist.org/packages/zeeshanu/inspector).

Manual way
----------

[](#manual-way)

- Copy `src` to your codebase, perhaps to the vendor directory.
- Add the `Zeeshan\Inspector\Inspector` class to your autoloader or require the file directly.

Getting Started
---------------

[](#getting-started)

I'm going to use the following email address to demonstrate the usage of this php wrapper.

>

```
// Your FulContact API key https://portal.fullcontact.com/signup
$apiKey = "";

$inspector = new Inspector($apiKey);
$person = $inspector->getProfile("ziishaned@gmail.com");

$person->getPhotos();
// An array of arrays where typename could be one of 'facebook', 'Gravatar', 'Twitter' etc
// [
//    [
//        "typeName" => "Facebook"
//        "url"      => "https://d2ojpxxtu63wzl.cloudfront.net/static/a2dcfe7a0136f34ace8c8fd378557a96_ce4301d022a5423869916af01ad8c2c//                       e11f7638b11958db47b89bf4ef7369ab7",
//    ],
//    [..],
//    [..],
//    [..],
// ]

$person->getContactInfo();
// An array of found contact info e.g websites and full name
// [
//    "websites" =>  [
//          [
//             "url" => "http://webxyz.com",
//          ],
//     ],
//     "fullName" => "Zeeshan Ahmed",
// ]

$person->getOrganizations();
// An array of organizations found in which he worked or currently working
// [
//    [
//        "name"        => "Company XYZ",
//        "startDate"   => "2014-07",
//        "title"       => "Software Engineer",
//        "current"     => true,
//    ],
//    [..],
// ]

$person->getDemographics();
// An array of information about the user location
// [
//    [
//        "locationDeduced" => [
//              "normalizedLocation" => "Pakistan",
//              "deducedLocation"    => "Pakistan",
//              "country" => [
//                  "name"  => "Pakistan",
//                  "code" => "PK",
//              ],
//              "continent" => [
//                  "deduced"   => true
//                  "name"      => "Asia"
//              ],
//              "likelihood" => true,
//        ],
//        "locationGeneral" => "Pakistan",
//        "gender" => "Male",
//    ],
// ]

$person->getSocialProfiles();
// An array of user social network links or information
// [
//    [
//        "bio"      => "Full Stack Web Engineer, Blogger, Freelancer, IT Enthusiast, Open Source and Web Lover, PHP and Javascript Fanatic",
//        "typeName" => "Twitter",
//        "url"      => "https://twitter.com/ziishaned",
//        "username" => "ziishaned",
//    ],
//    [..],
//    [..],
//    [..],
//    [..],
// ]

$person->getInterests();
// An array of user digital Footprint or user interests
// [
//    "Blogging", "Cloud Computing", "Software Development", "Cybersecurity", "Hacking",
// ]

$person->getEmail();
// User email address
// "ziishaned@gmail.com"
```

Feedback
--------

[](#feedback)

If you notice that there might be some improvements in code you can create a pull request or report an issue. You can also contact me at [](mailto:ziishaned@gmail.com).

Note
====

[](#note)

Please note that the library relies upon [FullContact API](https://portal.fullcontact.com/signup) and you will need an API key to use this package.

License
-------

[](#license)

The MIT License (MIT). Please see [License File](LICENSE.md) for more information.

###  Health Score

32

—

LowBetter than 69% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity21

Limited adoption so far

Community12

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

Unknown

Total

1

Last Release

3659d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/93f670b66ad848731a36e428e51d2ba2e50f881121257b4ce3e8783344673f09?d=identicon)[zeeshanahmad](/maintainers/zeeshanahmad)

---

Top Contributors

[![ziishaned](https://avatars.githubusercontent.com/u/16267321?v=4)](https://github.com/ziishaned "ziishaned (40 commits)")

---

Tags

php

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/zeeshan-inspector/health.svg)

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

###  Alternatives

[imanghafoori/laravel-anypass

A minimal yet powerful package to help you in development.

21422.6k](/packages/imanghafoori-laravel-anypass)

PHPackages © 2026

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