https://github.com/helgesverre/telefonkatalog
Query public Norwegian phone numbers to retrieve structured personal data.
https://github.com/helgesverre/telefonkatalog
Last synced: 24 days ago
JSON representation
Query public Norwegian phone numbers to retrieve structured personal data.
- Host: GitHub
- URL: https://github.com/helgesverre/telefonkatalog
- Owner: HelgeSverre
- License: mit
- Created: 2023-09-15T15:32:40.000Z (about 2 years ago)
- Default Branch: main
- Last Pushed: 2024-04-29T17:01:25.000Z (over 1 year ago)
- Last Synced: 2024-12-29T14:29:40.282Z (10 months ago)
- Language: PHP
- Size: 1.66 MB
- Stars: 7
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
# Telefonkatalog: A Package for Norwegian Phone Directory Data Retrieval
## Overview
Laravel Telefonkatalog is a package designed for scraping data from phone directories. It returns the extracted data as
a list of `Person` objects, making it easier for developers to integrate phone number information into their
applications.
This package is specifically tailored for Norwegian developers looking to incorporate auto-fill functionality into forms
on a small scale.
### Important Note
This package is not designed for large-scale phone number scraping, as it does not provide any protection or bypass
against captchas, anti-botting software, IP-blocking, or rate-limiting. It is exclusively intended for low-traffic web
apps requiring occasional auto-fill features in customer/user forms.
## Supported Phone Directories
This package currently scrapes data from these phone directories:
- [1881.no](https://1881.no)
- [1890.no](https://1890.no)
- [Gulesider.no](https://gulesider.no)
## Installation
Install the package via Composer:
```bash
composer require helgesverre/telefonkatalog
```
## Usage
Import the facade, and call the method, no need to make things complicated.
```php
use HelgeSverre\Telefonkatalog\Facades\Telefonkatalog;
// Search by name across all data sources
$people = Telefonkatalog::search('helge sverre');
// Find the first result matching a phone number
$person = Telefonkatalog::find('95965871');
```
### Return value.
- `find("number or name")` returns a single `Person` object.
- `search("number or name")` returns many `Person` objects as a laravel collection.
### Example:
```php
HelgeSverre\Telefonkatalog\Data\Person {
+phone: "95965871"
+name: "Helge Sverre Hessevik Liseth"
+address: "Vognstølen 29"
+city: "Bergen"
+postalCode: "5096"
+url: "https://www.gulesider.no/oppslag/77190505/person"
+source: "Gulesider.no"
}
```
## License
The MIT License (MIT). Please see [License File](LICENSE.md) for more information.