restugbk/get-contact

PHP Class for fetching GetContact phone number tags (Unofficial)

v1.0.0 2026-01-09 18:57 UTC

Requires

• php: >=7.4

Requires (Dev)

• phpunit/phpunit: ^9.0 || ^10.0

MIT

• restugbk

README

[Un-Official] A lightweight, Un-Official PHP Library for validating phone numbers and retrieving tags from the GetContact API. Designed to be framework-agnostic, efficient, and easy to integrate.

⚡ Get Contact Demo

An interactive demo site for contact information lookup and phone number identification services.

Live Demo: Visit Get Contact Demo

📦 Installation

Install the package via Composer:

composer require restugbk/get-contact

1. Basic Initialization

use Restugbk\GetContact;

$token    = 'YOUR_TOKEN';
$finalKey = 'YOUR_FINAL_KEY';

$getContact = new GetContact($token, $finalKey);

2. Validate Number of Tags

$number = '081234567890';

$response = $getContact->checkNumber($number);

if ($response['success']) {
    echo "Validated Number: " . $response['number'] . "\n";
    echo "Tags: " . implode(', ', $response['tags']) . "\n";
} else {
    echo "Error: " . $response['message'] . "\n";
}

3. Search Profile by Validated Number

$number = '081234567890';

$response = $getContact->searchNumber($number);

if ($response['success']) {
    echo "Validated Number: " . $response['number'] . "\n";
    echo "Profile: " . implode(', ', $response['profile']) . "\n";
} else {
    echo "Error: " . $response['message'] . "\n";
}

📋 Data Structure Reference

The checkNumber() method returns an array with the following keys:

Key	Type	Description
success	Boolean	Indicates whether the request was successful.
number	String	Normalized phone number (e.g., [phone]).
tags	Array	List of tags associated with the number.
raw	Array	Full raw response from the API (decrypted JSON).

🔑 How to Get Token

Requirements: Android with ROOT-rights (or emulator).

1. Install and login into GetContact app.
2. Open file manager on your phone and navigate to:

   /data/data/app.source.getcontact/shared_prefs/GetContactSettingsPref.xml

3. Inside the file, you will find:

   YOUR_TOKEN = TOKEN / CHAT_TOKEN
   YOUR_FINAL_KEY = FINAL_KEY

⚠️ Note

If TOKEN, CHAT_TOKEN, or FINAL_KEY are missing.

Try updating the GetContact app to the latest version and log in with your account. Perform a search to trigger the CAPTCHA. This CAPTCHA cannot be bypassed using this repository due to technical limitations. After solving the CAPTCHA and confirming that the account can fetch Tags, you can downgrade the app to version 6.0.0. Follow the steps above to resolve the issue.

📄 License

This open-source software is distributed under the MIT License. See LICENSE for more information.

🛠 Support

If you found this project helpful, please give it a ⭐ star!

For issues and questions, please create an issue in the GitHub repository.