PHPackages                             neutrinoapi/neutrinoapi\_php\_sdk - 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. neutrinoapi/neutrinoapi\_php\_sdk

Abandoned → [neutrino\_api/neutrino\_api\_client](/?search=neutrino_api%2Fneutrino_api_client)ArchivedLibrary[API Development](/categories/api)

neutrinoapi/neutrinoapi\_php\_sdk
=================================

The general-purpose API

3.4.5(6y ago)663.6k↑16.7%4[1 issues](https://github.com/NeutrinoAPI/NeutrinoAPI-PHP/issues)MITPHPPHP >=5.4.0

Since Nov 13Pushed 6y ago2 watchersCompare

[ Source](https://github.com/NeutrinoAPI/NeutrinoAPI-PHP)[ Packagist](https://packagist.org/packages/neutrinoapi/neutrinoapi_php_sdk)[ Docs](https://www.neutrinoapi.com/)[ RSS](/packages/neutrinoapi-neutrinoapi-php-sdk/feed)WikiDiscussions master Synced 1mo ago

READMEChangelogDependencies (3)Versions (2)Used By (0)

Getting started
===============

[](#getting-started)

The general-purpose API

Initialization
--------------

[](#initialization)

### Authentication

[](#authentication)

In order to setup authentication and initialization of the API client, you need the following information.

ParameterDescriptionuserIdYour user IDapiKeyYour API keyAPI client can be initialized as following.

```
$userId = 'userId'; // Your user ID
$apiKey = 'apiKey'; // Your API key

$client = new NeutrinoAPILib\NeutrinoAPIClient($userId, $apiKey);
```

Class Reference
===============

[](#class-reference)

List of Controllers
------------------------------------------------------------------

[](#list-of-controllers)

- [Imaging](#imaging)
- [Telephony](#telephony)
- [DataTools](#data_tools)
- [SecurityAndNetworking](#security_and_networking)
- [Geolocation](#geolocation)
- [ECommerce](#e_commerce)
- [WWW](#www)

[![Class: ](https://camo.githubusercontent.com/ec8022a6fb768aa7d81b8226237aadf63b8a726efab75a8314b224e54194c885/68747470733a2f2f617069646f63732e696f2f696d672f636c6173732e706e67 ".Imaging")](https://camo.githubusercontent.com/ec8022a6fb768aa7d81b8226237aadf63b8a726efab75a8314b224e54194c885/68747470733a2f2f617069646f63732e696f2f696d672f636c6173732e706e67) Imaging
--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

[](#-imaging)

### Get singleton instance

[](#get-singleton-instance)

The singleton instance of the `Imaging` class can be accessed from the API Client.

```
$imaging = $client->getImaging();
```

### [![Method: ](https://camo.githubusercontent.com/501a7bfa57a34ebbde43bfe00d7218a47c0a18eae15acb62480b8716f604ee87/68747470733a2f2f617069646f63732e696f2f696d672f6d6574686f642e706e67 ".Imaging.imageResize")](https://camo.githubusercontent.com/501a7bfa57a34ebbde43bfe00d7218a47c0a18eae15acb62480b8716f604ee87/68747470733a2f2f617069646f63732e696f2f696d672f6d6574686f642e706e67) imageResize

[](#-imageresize)

> Resize an image and output as either JPEG or PNG. See:

```
function imageResize(
        $imageUrl,
        $width,
        $height,
        $format = 'png')
```

#### Parameters

[](#parameters)

ParameterTagsDescriptionimageUrl`Required`The URL to the source imagewidth`Required`The width to resize to (in px) while preserving aspect ratioheight`Required`The height to resize to (in px) while preserving aspect ratioformat`Optional` `DefaultValue`The output image format, can be either png or jpg#### Example Usage

[](#example-usage)

```
$imageUrl = 'image-url';
$width = 19;
$height = 19;
$format = 'png';

$result = $imaging->imageResize($imageUrl, $width, $height, $format);
```

### [![Method: ](https://camo.githubusercontent.com/501a7bfa57a34ebbde43bfe00d7218a47c0a18eae15acb62480b8716f604ee87/68747470733a2f2f617069646f63732e696f2f696d672f6d6574686f642e706e67 ".Imaging.qRCode")](https://camo.githubusercontent.com/501a7bfa57a34ebbde43bfe00d7218a47c0a18eae15acb62480b8716f604ee87/68747470733a2f2f617069646f63732e696f2f696d672f6d6574686f642e706e67) qRCode

[](#-qrcode)

> Generate a QR code as a PNG image. See:

```
function qRCode(
        $content,
        $width = 256,
        $height = 256,
        $fgColor = '#000000',
        $bgColor = '#ffffff')
```

#### Parameters

[](#parameters-1)

ParameterTagsDescriptioncontent`Required`The content to encode into the QR code (e.g. a URL or a phone number)width`Optional` `DefaultValue`The width of the QR code (in px)height`Optional` `DefaultValue`The height of the QR code (in px)fgColor`Optional` `DefaultValue`The QR code foreground colorbgColor`Optional` `DefaultValue`The QR code background color#### Example Usage

[](#example-usage-1)

```
$content = 'content';
$width = 256;
$height = 256;
$fgColor = '#000000';
$bgColor = '#ffffff';

$result = $imaging->qRCode($content, $width, $height, $fgColor, $bgColor);
```

### [![Method: ](https://camo.githubusercontent.com/501a7bfa57a34ebbde43bfe00d7218a47c0a18eae15acb62480b8716f604ee87/68747470733a2f2f617069646f63732e696f2f696d672f6d6574686f642e706e67 ".Imaging.imageWatermark")](https://camo.githubusercontent.com/501a7bfa57a34ebbde43bfe00d7218a47c0a18eae15acb62480b8716f604ee87/68747470733a2f2f617069646f63732e696f2f696d672f6d6574686f642e706e67) imageWatermark

[](#-imagewatermark)

> Watermark one image with another image. See:

```
function imageWatermark(
        $imageUrl,
        $watermarkUrl,
        $opacity = 50,
        $format = 'png',
        $position = 'center',
        $width = null,
        $height = null)
```

#### Parameters

[](#parameters-2)

ParameterTagsDescriptionimageUrl`Required`The URL to the source imagewatermarkUrl`Required`The URL to the watermark imageopacity`Optional` `DefaultValue`The opacity of the watermark (0 to 100)format`Optional` `DefaultValue`The output image format, can be either png or jpgposition`Optional` `DefaultValue`The position of the watermark image, possible values are: center, top-left, top-center, top-right, bottom-left, bottom-center, bottom-rightwidth`Optional`If set resize the resulting image to this width (in px) while preserving aspect ratioheight`Optional`If set resize the resulting image to this height (in px) while preserving aspect ratio#### Example Usage

[](#example-usage-2)

```
$imageUrl = 'image-url';
$watermarkUrl = 'watermark-url';
$opacity = 50;
$format = 'png';
$position = 'center';
$width = 19;
$height = 19;

$result = $imaging->imageWatermark($imageUrl, $watermarkUrl, $opacity, $format, $position, $width, $height);
```

### [![Method: ](https://camo.githubusercontent.com/501a7bfa57a34ebbde43bfe00d7218a47c0a18eae15acb62480b8716f604ee87/68747470733a2f2f617069646f63732e696f2f696d672f6d6574686f642e706e67 ".Imaging.hTML5Render")](https://camo.githubusercontent.com/501a7bfa57a34ebbde43bfe00d7218a47c0a18eae15acb62480b8716f604ee87/68747470733a2f2f617069646f63732e696f2f696d672f6d6574686f642e706e67) hTML5Render

[](#-html5render)

> Render HTML content to PDF, JPG or PNG. See:

```
function hTML5Render(
        $content,
        $format = 'PDF',
        $pageSize = 'A4',
        $title = null,
        $margin = 0,
        $marginLeft = 0,
        $marginRight = 0,
        $marginTop = 0,
        $marginBottom = 0,
        $landscape = false,
        $zoom = 1,
        $grayscale = false,
        $mediaPrint = false,
        $mediaQueries = false,
        $forms = false,
        $css = null,
        $imageWidth = 1024,
        $imageHeight = null,
        $renderDelay = 0,
        $headerTextLeft = null,
        $headerTextCenter = null,
        $headerTextRight = null,
        $headerSize = 9,
        $headerFont = 'Courier',
        $headerFontSize = 11,
        $headerLine = false,
        $footerTextLeft = null,
        $footerTextCenter = null,
        $footerTextRight = null,
        $footerSize = 9,
        $footerFont = 'Courier',
        $footerFontSize = 11,
        $footerLine = false,
        $pageWidth = null,
        $pageHeight = null)
```

#### Parameters

[](#parameters-3)

ParameterTagsDescriptioncontent`Required`The HTML content. This can be either a URL to load HTML from or an actual HTML content stringformat`Optional` `DefaultValue`Which format to output, available options are: PDF, PNG, JPGpageSize`Optional` `DefaultValue`Set the document page size, can be one of: A0 - A9, B0 - B10, Comm10E, DLE or Lettertitle`Optional`The document titlemargin`Optional` `DefaultValue`The document margin (in mm)marginLeft`Optional` `DefaultValue`The document left margin (in mm)marginRight`Optional` `DefaultValue`The document right margin (in mm)marginTop`Optional` `DefaultValue`The document top margin (in mm)marginBottom`Optional` `DefaultValue`The document bottom margin (in mm)landscape`Optional` `DefaultValue`Set the document to lanscape orientationzoom`Optional` `DefaultValue`Set the zoom factor when rendering the page (2.0 for double size, 0.5 for half size)grayscale`Optional` `DefaultValue`Render the final document in grayscalemediaPrint`Optional` `DefaultValue`Use @media print CSS styles to render the documentmediaQueries`Optional` `DefaultValue`Activate all @media queries before rendering. This can be useful if you wan't to render the mobile version of a responsive websiteforms`Optional` `DefaultValue`Generate real (fillable) PDF forms from HTML formscss`Optional`Inject custom CSS into the HTML. e.g. 'body { background-color: red;}'imageWidth`Optional` `DefaultValue`If rendering to an image format (PNG or JPG) use this image width (in pixels)imageHeight`Optional`If rendering to an image format (PNG or JPG) use this image height (in pixels). The default is automatic which dynamically sets the image height based on the contentrenderDelay`Optional` `DefaultValue`Number of milliseconds to wait before rendering the page (can be useful for pages with animations etc)headerTextLeft`Optional`Text to print to the left-hand side header of each page. e.g. 'My header - Page {page\_number} of {total\_pages}'headerTextCenter`Optional`Text to print to the center header of each pageheaderTextRight`Optional`Text to print to the right-hand side header of each pageheaderSize`Optional` `DefaultValue`The height of your header (in mm)headerFont`Optional` `DefaultValue`Set the header font. Fonts available: Times, Courier, Helvetica, ArialheaderFontSize`Optional` `DefaultValue`Set the header font size (in pt)headerLine`Optional` `DefaultValue`Draw a full page width horizontal line under your headerfooterTextLeft`Optional`Text to print to the left-hand side footer of each page. e.g. 'My footer - Page {page\_number} of {total\_pages}'footerTextCenter`Optional`Text to print to the center header of each pagefooterTextRight`Optional`Text to print to the right-hand side header of each pagefooterSize`Optional` `DefaultValue`The height of your footer (in mm)footerFont`Optional` `DefaultValue`Set the footer font. Fonts available: Times, Courier, Helvetica, ArialfooterFontSize`Optional` `DefaultValue`Set the footer font size (in pt)footerLine`Optional` `DefaultValue`Draw a full page width horizontal line above your footerpageWidth`Optional`Set the PDF page width explicitly (in mm)pageHeight`Optional`Set the PDF page height explicitly (in mm)#### Example Usage

[](#example-usage-3)

```
$content = 'content';
$format = 'PDF';
$pageSize = 'A4';
$title = 'title';
$margin = 0;
$marginLeft = 0;
$marginRight = 0;
$marginTop = 0;
$marginBottom = 0;
$landscape = false;
$zoom = 1;
$grayscale = false;
$mediaPrint = false;
$mediaQueries = false;
$forms = false;
$css = 'css';
$imageWidth = 1024;
$imageHeight = 110;
$renderDelay = 0;
$headerTextLeft = 'header-text-left';
$headerTextCenter = 'header-text-center';
$headerTextRight = 'header-text-right';
$headerSize = 9;
$headerFont = 'Courier';
$headerFontSize = 11;
$headerLine = false;
$footerTextLeft = 'footer-text-left';
$footerTextCenter = 'footer-text-center';
$footerTextRight = 'footer-text-right';
$footerSize = 9;
$footerFont = 'Courier';
$footerFontSize = 11;
$footerLine = false;
$pageWidth = 110;
$pageHeight = 110;

$result = $imaging->hTML5Render($content, $format, $pageSize, $title, $margin, $marginLeft, $marginRight, $marginTop, $marginBottom, $landscape, $zoom, $grayscale, $mediaPrint, $mediaQueries, $forms, $css, $imageWidth, $imageHeight, $renderDelay, $headerTextLeft, $headerTextCenter, $headerTextRight, $headerSize, $headerFont, $headerFontSize, $headerLine, $footerTextLeft, $footerTextCenter, $footerTextRight, $footerSize, $footerFont, $footerFontSize, $footerLine, $pageWidth, $pageHeight);
```

[Back to List of Controllers](#list_of_controllers)

[![Class: ](https://camo.githubusercontent.com/ec8022a6fb768aa7d81b8226237aadf63b8a726efab75a8314b224e54194c885/68747470733a2f2f617069646f63732e696f2f696d672f636c6173732e706e67 ".Telephony")](https://camo.githubusercontent.com/ec8022a6fb768aa7d81b8226237aadf63b8a726efab75a8314b224e54194c885/68747470733a2f2f617069646f63732e696f2f696d672f636c6173732e706e67) Telephony
--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

[](#-telephony)

### Get singleton instance

[](#get-singleton-instance-1)

The singleton instance of the `Telephony` class can be accessed from the API Client.

```
$telephony = $client->getTelephony();
```

### [![Method: ](https://camo.githubusercontent.com/501a7bfa57a34ebbde43bfe00d7218a47c0a18eae15acb62480b8716f604ee87/68747470733a2f2f617069646f63732e696f2f696d672f6d6574686f642e706e67 ".Telephony.verifySecurityCode")](https://camo.githubusercontent.com/501a7bfa57a34ebbde43bfe00d7218a47c0a18eae15acb62480b8716f604ee87/68747470733a2f2f617069646f63732e696f2f696d672f6d6574686f642e706e67) verifySecurityCode

[](#-verifysecuritycode)

> Check if a security code from one of the verify APIs is valid. See:

```
function verifySecurityCode($securityCode)
```

#### Parameters

[](#parameters-4)

ParameterTagsDescriptionsecurityCode`Required`The security code to verify#### Example Usage

[](#example-usage-4)

```
$securityCode = 'security-code';

$result = $telephony->verifySecurityCode($securityCode);
```

### [![Method: ](https://camo.githubusercontent.com/501a7bfa57a34ebbde43bfe00d7218a47c0a18eae15acb62480b8716f604ee87/68747470733a2f2f617069646f63732e696f2f696d672f6d6574686f642e706e67 ".Telephony.hLRLookup")](https://camo.githubusercontent.com/501a7bfa57a34ebbde43bfe00d7218a47c0a18eae15acb62480b8716f604ee87/68747470733a2f2f617069646f63732e696f2f696d672f6d6574686f642e706e67) hLRLookup

[](#-hlrlookup)

> Connect to the global mobile cellular network and retrieve the status of a mobile device. See:

```
function hLRLookup(
        $number,
        $countryCode = null)
```

#### Parameters

[](#parameters-5)

ParameterTagsDescriptionnumber`Required`A phone numbercountryCode`Optional`ISO 2-letter country code, assume numbers are based in this country. If not set numbers are assumed to be in international format (with or without the leading + sign)#### Example Usage

[](#example-usage-5)

```
$number = 'number';
$countryCode = 'country-code';

$result = $telephony->hLRLookup($number, $countryCode);
```

### [![Method: ](https://camo.githubusercontent.com/501a7bfa57a34ebbde43bfe00d7218a47c0a18eae15acb62480b8716f604ee87/68747470733a2f2f617069646f63732e696f2f696d672f6d6574686f642e706e67 ".Telephony.phonePlayback")](https://camo.githubusercontent.com/501a7bfa57a34ebbde43bfe00d7218a47c0a18eae15acb62480b8716f604ee87/68747470733a2f2f617069646f63732e696f2f696d672f6d6574686f642e706e67) phonePlayback

[](#-phoneplayback)

> Make an automated call to any valid phone number and playback an audio message. See:

```
function phonePlayback(
        $number,
        $audioUrl)
```

#### Parameters

[](#parameters-6)

ParameterTagsDescriptionnumber`Required`The phone number to call. Must be in valid international formataudioUrl`Required`A URL to a valid audio file. Accepted audio formats are: - MP3
- WAV
- OGG

You can use the following MP3 URL for testing: #### Example Usage

[](#example-usage-6)

```
$number = 'number';
$audioUrl = 'audio-url';

$result = $telephony->phonePlayback($number, $audioUrl);
```

### [![Method: ](https://camo.githubusercontent.com/501a7bfa57a34ebbde43bfe00d7218a47c0a18eae15acb62480b8716f604ee87/68747470733a2f2f617069646f63732e696f2f696d672f6d6574686f642e706e67 ".Telephony.sMSVerify")](https://camo.githubusercontent.com/501a7bfa57a34ebbde43bfe00d7218a47c0a18eae15acb62480b8716f604ee87/68747470733a2f2f617069646f63732e696f2f696d672f6d6574686f642e706e67) sMSVerify

[](#-smsverify)

> Send a unique security code to any mobile device via SMS. See:

```
function sMSVerify(
        $number,
        $codeLength = 5,
        $securityCode = null,
        $countryCode = null,
        $languageCode = 'en')
```

#### Parameters

[](#parameters-7)

ParameterTagsDescriptionnumber`Required`The phone number to send a verification code tocodeLength`Optional` `DefaultValue`The number of digits to use in the security code (must be between 4 and 12)securityCode`Optional`Pass in your own security code. This is useful if you have implemented TOTP or similar 2FA methods. If not set then we will generate a secure random codecountryCode`Optional`ISO 2-letter country code, assume numbers are based in this country. If not set numbers are assumed to be in international format (with or without the leading + sign)languageCode`Optional` `DefaultValue`The language to send the verification code in, available languages are: - de - German
- en - English
- es - Spanish
- fr - French
- it - Italian
- pt - Portuguese
- ru - Russian

#### Example Usage

[](#example-usage-7)

```
$number = 'number';
$codeLength = 5;
$securityCode = 110;
$countryCode = 'country-code';
$languageCode = 'en';

$result = $telephony->sMSVerify($number, $codeLength, $securityCode, $countryCode, $languageCode);
```

### [![Method: ](https://camo.githubusercontent.com/501a7bfa57a34ebbde43bfe00d7218a47c0a18eae15acb62480b8716f604ee87/68747470733a2f2f617069646f63732e696f2f696d672f6d6574686f642e706e67 ".Telephony.sMSMessage")](https://camo.githubusercontent.com/501a7bfa57a34ebbde43bfe00d7218a47c0a18eae15acb62480b8716f604ee87/68747470733a2f2f617069646f63732e696f2f696d672f6d6574686f642e706e67) sMSMessage

[](#-smsmessage)

> Send a free-form message to any mobile device via SMS. See:

```
function sMSMessage(
        $number,
        $message,
        $countryCode = null)
```

#### Parameters

[](#parameters-8)

ParameterTagsDescriptionnumber`Required`The phone number to send a message tomessage`Required`The SMS message to send. Messages are truncated to a maximum of 150 characters for ASCII content OR 70 characters for UTF contentcountryCode`Optional`ISO 2-letter country code, assume numbers are based in this country. If not set numbers are assumed to be in international format (with or without the leading + sign)#### Example Usage

[](#example-usage-8)

```
$number = 'number';
$message = 'message';
$countryCode = 'country-code';

$result = $telephony->sMSMessage($number, $message, $countryCode);
```

### [![Method: ](https://camo.githubusercontent.com/501a7bfa57a34ebbde43bfe00d7218a47c0a18eae15acb62480b8716f604ee87/68747470733a2f2f617069646f63732e696f2f696d672f6d6574686f642e706e67 ".Telephony.phoneVerify")](https://camo.githubusercontent.com/501a7bfa57a34ebbde43bfe00d7218a47c0a18eae15acb62480b8716f604ee87/68747470733a2f2f617069646f63732e696f2f696d672f6d6574686f642e706e67) phoneVerify

[](#-phoneverify)

> Make an automated call to any valid phone number and playback a unique security code. See:

```
function phoneVerify(
        $number,
        $codeLength = 6,
        $securityCode = null,
        $playbackDelay = 800,
        $countryCode = null,
        $languageCode = 'en')
```

#### Parameters

[](#parameters-9)

ParameterTagsDescriptionnumber`Required`The phone number to send the verification code tocodeLength`Optional` `DefaultValue`The number of digits to use in the security code (between 4 and 12)securityCode`Optional`Pass in your own security code. This is useful if you have implemented TOTP or similar 2FA methods. If not set then we will generate a secure random codeplaybackDelay`Optional` `DefaultValue`The delay in milliseconds between the playback of each security codecountryCode`Optional`ISO 2-letter country code, assume numbers are based in this country. If not set numbers are assumed to be in international format (with or without the leading + sign)languageCode`Optional` `DefaultValue`The language to playback the verification code in, available languages are: - de - German
- en - English
- es - Spanish
- fr - French
- it - Italian
- pt - Portuguese
- ru - Russian

#### Example Usage

[](#example-usage-9)

```
$number = 'number';
$codeLength = 6;
$securityCode = 110;
$playbackDelay = 800;
$countryCode = 'country-code';
$languageCode = 'en';

$result = $telephony->phoneVerify($number, $codeLength, $securityCode, $playbackDelay, $countryCode, $languageCode);
```

[Back to List of Controllers](#list_of_controllers)

[![Class: ](https://camo.githubusercontent.com/ec8022a6fb768aa7d81b8226237aadf63b8a726efab75a8314b224e54194c885/68747470733a2f2f617069646f63732e696f2f696d672f636c6173732e706e67 ".DataTools")](https://camo.githubusercontent.com/ec8022a6fb768aa7d81b8226237aadf63b8a726efab75a8314b224e54194c885/68747470733a2f2f617069646f63732e696f2f696d672f636c6173732e706e67) DataTools
---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

[](#-datatools)

### Get singleton instance

[](#get-singleton-instance-2)

The singleton instance of the `DataTools` class can be accessed from the API Client.

```
$dataTools = $client->getDataTools();
```

### [![Method: ](https://camo.githubusercontent.com/501a7bfa57a34ebbde43bfe00d7218a47c0a18eae15acb62480b8716f604ee87/68747470733a2f2f617069646f63732e696f2f696d672f6d6574686f642e706e67 ".DataTools.emailValidate")](https://camo.githubusercontent.com/501a7bfa57a34ebbde43bfe00d7218a47c0a18eae15acb62480b8716f604ee87/68747470733a2f2f617069646f63732e696f2f696d672f6d6574686f642e706e67) emailValidate

[](#-emailvalidate)

> Parse, validate and clean an email address. See:

```
function emailValidate(
        $email,
        $fixTypos = false)
```

#### Parameters

[](#parameters-10)

ParameterTagsDescriptionemail`Required`An email addressfixTypos`Optional` `DefaultValue`Automatically attempt to fix typos in the address#### Example Usage

[](#example-usage-10)

```
$email = 'email';
$fixTypos = false;

$result = $dataTools->emailValidate($email, $fixTypos);
```

### [![Method: ](https://camo.githubusercontent.com/501a7bfa57a34ebbde43bfe00d7218a47c0a18eae15acb62480b8716f604ee87/68747470733a2f2f617069646f63732e696f2f696d672f6d6574686f642e706e67 ".DataTools.userAgentInfo")](https://camo.githubusercontent.com/501a7bfa57a34ebbde43bfe00d7218a47c0a18eae15acb62480b8716f604ee87/68747470733a2f2f617069646f63732e696f2f696d672f6d6574686f642e706e67) userAgentInfo

[](#-useragentinfo)

> Parse, validate and get detailed user-agent information from a user agent string. See:

```
function userAgentInfo($userAgent)
```

#### Parameters

[](#parameters-11)

ParameterTagsDescriptionuserAgent`Required`A user agent string#### Example Usage

[](#example-usage-11)

```
$userAgent = 'user-agent';

$result = $dataTools->userAgentInfo($userAgent);
```

### [![Method: ](https://camo.githubusercontent.com/501a7bfa57a34ebbde43bfe00d7218a47c0a18eae15acb62480b8716f604ee87/68747470733a2f2f617069646f63732e696f2f696d672f6d6574686f642e706e67 ".DataTools.badWordFilter")](https://camo.githubusercontent.com/501a7bfa57a34ebbde43bfe00d7218a47c0a18eae15acb62480b8716f604ee87/68747470733a2f2f617069646f63732e696f2f696d672f6d6574686f642e706e67) badWordFilter

[](#-badwordfilter)

> Detect bad words, swear words and profanity in a given text. See:

```
function badWordFilter(
        $content,
        $censorCharacter = null)
```

#### Parameters

[](#parameters-12)

ParameterTagsDescriptioncontent`Required`The content to scan. This can be either a URL to load content from or an actual content stringcensorCharacter`Optional`The character to use to censor out the bad words found#### Example Usage

[](#example-usage-12)

```
$content = 'content';
$censorCharacter = 'censor-character';

$result = $dataTools->badWordFilter($content, $censorCharacter);
```

### [![Method: ](https://camo.githubusercontent.com/501a7bfa57a34ebbde43bfe00d7218a47c0a18eae15acb62480b8716f604ee87/68747470733a2f2f617069646f63732e696f2f696d672f6d6574686f642e706e67 ".DataTools.convert")](https://camo.githubusercontent.com/501a7bfa57a34ebbde43bfe00d7218a47c0a18eae15acb62480b8716f604ee87/68747470733a2f2f617069646f63732e696f2f696d672f6d6574686f642e706e67) convert

[](#-convert)

> A powerful unit conversion tool. See:

```
function convert(
        $fromValue,
        $fromType,
        $toType)
```

#### Parameters

[](#parameters-13)

ParameterTagsDescriptionfromValue`Required`The value to convert from (e.g. 10.95)fromType`Required`The type of the value to convert from (e.g. USD)toType`Required`The type to convert to (e.g. EUR)#### Example Usage

[](#example-usage-13)

```
$fromValue = 'from-value';
$fromType = 'from-type';
$toType = 'to-type';

$result = $dataTools->convert($fromValue, $fromType, $toType);
```

### [![Method: ](https://camo.githubusercontent.com/501a7bfa57a34ebbde43bfe00d7218a47c0a18eae15acb62480b8716f604ee87/68747470733a2f2f617069646f63732e696f2f696d672f6d6574686f642e706e67 ".DataTools.phoneValidate")](https://camo.githubusercontent.com/501a7bfa57a34ebbde43bfe00d7218a47c0a18eae15acb62480b8716f604ee87/68747470733a2f2f617069646f63732e696f2f696d672f6d6574686f642e706e67) phoneValidate

[](#-phonevalidate)

> Parse, validate and get location information about a phone number. See:

```
function phoneValidate(
        $number,
        $countryCode = null,
        $ip = null)
```

#### Parameters

[](#parameters-14)

ParameterTagsDescriptionnumber`Required`A phone number. This can be in international format (E.164) or local format. If passing local format you should use the 'country-code' or 'ip' options as wellcountryCode`Optional`ISO 2-letter country code, assume numbers are based in this country. If not set numbers are assumed to be in international format (with or without the leading + sign)ip`Optional`Pass in a users IP address and we will assume numbers are based in the country of the IP address#### Example Usage

[](#example-usage-14)

```
$number = 'number';
$countryCode = 'country-code';
$ip = 'ip';

$result = $dataTools->phoneValidate($number, $countryCode, $ip);
```

[Back to List of Controllers](#list_of_controllers)

[![Class: ](https://camo.githubusercontent.com/ec8022a6fb768aa7d81b8226237aadf63b8a726efab75a8314b224e54194c885/68747470733a2f2f617069646f63732e696f2f696d672f636c6173732e706e67 ".SecurityAndNetworking")](https://camo.githubusercontent.com/ec8022a6fb768aa7d81b8226237aadf63b8a726efab75a8314b224e54194c885/68747470733a2f2f617069646f63732e696f2f696d672f636c6173732e706e67) SecurityAndNetworking
----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

[](#-securityandnetworking)

### Get singleton instance

[](#get-singleton-instance-3)

The singleton instance of the `SecurityAndNetworking` class can be accessed from the API Client.

```
$securityAndNetworking = $client->getSecurityAndNetworking();
```

### [![Method: ](https://camo.githubusercontent.com/501a7bfa57a34ebbde43bfe00d7218a47c0a18eae15acb62480b8716f604ee87/68747470733a2f2f617069646f63732e696f2f696d672f6d6574686f642e706e67 ".SecurityAndNetworking.iPProbe")](https://camo.githubusercontent.com/501a7bfa57a34ebbde43bfe00d7218a47c0a18eae15acb62480b8716f604ee87/68747470733a2f2f617069646f63732e696f2f696d672f6d6574686f642e706e67) iPProbe

[](#-ipprobe)

> Analyze and extract provider information for an IP address. See:

```
function iPProbe($ip)
```

#### Parameters

[](#parameters-15)

ParameterTagsDescriptionip`Required`IPv4 or IPv6 address#### Example Usage

[](#example-usage-15)

```
$ip = 'ip';

$result = $securityAndNetworking->iPProbe($ip);
```

### [![Method: ](https://camo.githubusercontent.com/501a7bfa57a34ebbde43bfe00d7218a47c0a18eae15acb62480b8716f604ee87/68747470733a2f2f617069646f63732e696f2f696d672f6d6574686f642e706e67 ".SecurityAndNetworking.emailVerify")](https://camo.githubusercontent.com/501a7bfa57a34ebbde43bfe00d7218a47c0a18eae15acb62480b8716f604ee87/68747470733a2f2f617069646f63732e696f2f696d672f6d6574686f642e706e67) emailVerify

[](#-emailverify)

> SMTP based email address verification. See:

```
function emailVerify(
        $email,
        $fixTypos = false)
```

#### Parameters

[](#parameters-16)

ParameterTagsDescriptionemail`Required`An email addressfixTypos`Optional` `DefaultValue`Automatically attempt to fix typos in the address#### Example Usage

[](#example-usage-16)

```
$email = 'email';
$fixTypos = false;

$result = $securityAndNetworking->emailVerify($email, $fixTypos);
```

### [![Method: ](https://camo.githubusercontent.com/501a7bfa57a34ebbde43bfe00d7218a47c0a18eae15acb62480b8716f604ee87/68747470733a2f2f617069646f63732e696f2f696d672f6d6574686f642e706e67 ".SecurityAndNetworking.iPBlocklist")](https://camo.githubusercontent.com/501a7bfa57a34ebbde43bfe00d7218a47c0a18eae15acb62480b8716f604ee87/68747470733a2f2f617069646f63732e696f2f696d672f6d6574686f642e706e67) iPBlocklist

[](#-ipblocklist)

> The IP Blocklist API will detect potentially malicious or dangerous IP addresses. See:

```
function iPBlocklist($ip)
```

#### Parameters

[](#parameters-17)

ParameterTagsDescriptionip`Required`An IPv4 or IPv6 address#### Example Usage

[](#example-usage-17)

```
$ip = 'ip';

$result = $securityAndNetworking->iPBlocklist($ip);
```

### [![Method: ](https://camo.githubusercontent.com/501a7bfa57a34ebbde43bfe00d7218a47c0a18eae15acb62480b8716f604ee87/68747470733a2f2f617069646f63732e696f2f696d672f6d6574686f642e706e67 ".SecurityAndNetworking.hostReputation")](https://camo.githubusercontent.com/501a7bfa57a34ebbde43bfe00d7218a47c0a18eae15acb62480b8716f604ee87/68747470733a2f2f617069646f63732e696f2f696d672f6d6574686f642e706e67) hostReputation

[](#-hostreputation)

> Check the reputation of an IP address, domain name, FQDN or URL against a comprehensive list of blacklists and blocklists. See:

```
function hostReputation(
        $host,
        $listRating = 3)
```

#### Parameters

[](#parameters-18)

ParameterTagsDescriptionhost`Required`An IP address, domain name, FQDN or URL. If you supply a domain/URL it will be checked against the URI DNSBL listslistRating`Optional` `DefaultValue`Only check lists with this rating or better#### Example Usage

[](#example-usage-18)

```
$host = 'host';
$listRating = 3;

$result = $securityAndNetworking->hostReputation($host, $listRating);
```

[Back to List of Controllers](#list_of_controllers)

[![Class: ](https://camo.githubusercontent.com/ec8022a6fb768aa7d81b8226237aadf63b8a726efab75a8314b224e54194c885/68747470733a2f2f617069646f63732e696f2f696d672f636c6173732e706e67 ".Geolocation")](https://camo.githubusercontent.com/ec8022a6fb768aa7d81b8226237aadf63b8a726efab75a8314b224e54194c885/68747470733a2f2f617069646f63732e696f2f696d672f636c6173732e706e67) Geolocation
--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

[](#-geolocation)

### Get singleton instance

[](#get-singleton-instance-4)

The singleton instance of the `Geolocation` class can be accessed from the API Client.

```
$geolocation = $client->getGeolocation();
```

### [![Method: ](https://camo.githubusercontent.com/501a7bfa57a34ebbde43bfe00d7218a47c0a18eae15acb62480b8716f604ee87/68747470733a2f2f617069646f63732e696f2f696d672f6d6574686f642e706e67 ".Geolocation.geocodeReverse")](https://camo.githubusercontent.com/501a7bfa57a34ebbde43bfe00d7218a47c0a18eae15acb62480b8716f604ee87/68747470733a2f2f617069646f63732e696f2f696d672f6d6574686f642e706e67) geocodeReverse

[](#-geocodereverse)

> Convert a geographic coordinate (latitude and longitude) into a real world address. See:

```
function geocodeReverse(
        $latitude,
        $longitude,
        $languageCode = 'en',
        $zoom = 'address')
```

#### Parameters

[](#parameters-19)

ParameterTagsDescriptionlatitude`Required`The location latitude in decimal degrees formatlongitude`Required`The location longitude in decimal degrees formatlanguageCode`Optional` `DefaultValue`The language to display results in, available languages are: - de, en, es, fr, it, pt, ru

zoom`Optional` `DefaultValue`The zoom level to respond with: - address - the most precise address available
- street - the street level
- city - the city level
- state - the state level
- country - the country level

#### Example Usage

[](#example-usage-19)

```
$latitude = 'latitude';
$longitude = 'longitude';
$languageCode = 'en';
$zoom = 'address';

$result = $geolocation->geocodeReverse($latitude, $longitude, $languageCode, $zoom);
```

### [![Method: ](https://camo.githubusercontent.com/501a7bfa57a34ebbde43bfe00d7218a47c0a18eae15acb62480b8716f604ee87/68747470733a2f2f617069646f63732e696f2f696d672f6d6574686f642e706e67 ".Geolocation.iPInfo")](https://camo.githubusercontent.com/501a7bfa57a34ebbde43bfe00d7218a47c0a18eae15acb62480b8716f604ee87/68747470733a2f2f617069646f63732e696f2f696d672f6d6574686f642e706e67) iPInfo

[](#-ipinfo)

> Get location information about an IP address and do reverse DNS (PTR) lookups. See:

```
function iPInfo(
        $ip,
        $reverseLookup = false)
```

#### Parameters

[](#parameters-20)

ParameterTagsDescriptionip`Required`IPv4 or IPv6 addressreverseLookup`Optional` `DefaultValue`Do a reverse DNS (PTR) lookup. This option can add extra delay to the request so only use it if you need it#### Example Usage

[](#example-usage-20)

```
$ip = 'ip';
$reverseLookup = false;

$result = $geolocation->iPInfo($ip, $reverseLookup);
```

### [![Method: ](https://camo.githubusercontent.com/501a7bfa57a34ebbde43bfe00d7218a47c0a18eae15acb62480b8716f604ee87/68747470733a2f2f617069646f63732e696f2f696d672f6d6574686f642e706e67 ".Geolocation.geocodeAddress")](https://camo.githubusercontent.com/501a7bfa57a34ebbde43bfe00d7218a47c0a18eae15acb62480b8716f604ee87/68747470733a2f2f617069646f63732e696f2f696d672f6d6574686f642e706e67) geocodeAddress

[](#-geocodeaddress)

> Geocode an address, partial address or just the name of a place. See:

```
function geocodeAddress(
        $address,
        $countryCode = null,
        $languageCode = 'en',
        $fuzzySearch = false)
```

#### Parameters

[](#parameters-21)

ParameterTagsDescriptionaddress`Required`The address, partial address or name of a place to try and locatecountryCode`Optional`The ISO 2-letter country code to be biased towards (the default is no country bias)languageCode`Optional` `DefaultValue`The language to display results in, available languages are: - de, en, es, fr, it, pt, ru

fuzzySearch`Optional` `DefaultValue`If no matches are found for the given address, start performing a recursive fuzzy search until a geolocation is found. This option is recommended for processing user input or implementing auto-complete. We use a combination of approximate string matching and data cleansing to find possible location matches#### Example Usage

[](#example-usage-21)

```
$address = 'address';
$countryCode = 'country-code';
$languageCode = 'en';
$fuzzySearch = false;

$result = $geolocation->geocodeAddress($address, $countryCode, $languageCode, $fuzzySearch);
```

[Back to List of Controllers](#list_of_controllers)

[![Class: ](https://camo.githubusercontent.com/ec8022a6fb768aa7d81b8226237aadf63b8a726efab75a8314b224e54194c885/68747470733a2f2f617069646f63732e696f2f696d672f636c6173732e706e67 ".ECommerce")](https://camo.githubusercontent.com/ec8022a6fb768aa7d81b8226237aadf63b8a726efab75a8314b224e54194c885/68747470733a2f2f617069646f63732e696f2f696d672f636c6173732e706e67) ECommerce
---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

[](#-ecommerce)

### Get singleton instance

[](#get-singleton-instance-5)

The singleton instance of the `ECommerce` class can be accessed from the API Client.

```
$eCommerce = $client->getECommerce();
```

### [![Method: ](https://camo.githubusercontent.com/501a7bfa57a34ebbde43bfe00d7218a47c0a18eae15acb62480b8716f604ee87/68747470733a2f2f617069646f63732e696f2f696d672f6d6574686f642e706e67 ".ECommerce.bINLookup")](https://camo.githubusercontent.com/501a7bfa57a34ebbde43bfe00d7218a47c0a18eae15acb62480b8716f604ee87/68747470733a2f2f617069646f63732e696f2f696d672f6d6574686f642e706e67) bINLookup

[](#-binlookup)

> Perform a BIN (Bank Identification Number) or IIN (Issuer Identification Number) lookup. See:

```
function bINLookup(
        $binNumber,
        $customerIp = null)
```

#### Parameters

[](#parameters-22)

ParameterTagsDescriptionbinNumber`Required`The BIN or IIN number (the first 6 digits of a credit card number)customerIp`Optional`Pass in the customers IP address and we will return some extra information about them#### Example Usage

[](#example-usage-22)

```
$binNumber = 'bin-number';
$customerIp = 'customer-ip';

$result = $eCommerce->bINLookup($binNumber, $customerIp);
```

[Back to List of Controllers](#list_of_controllers)

[![Class: ](https://camo.githubusercontent.com/ec8022a6fb768aa7d81b8226237aadf63b8a726efab75a8314b224e54194c885/68747470733a2f2f617069646f63732e696f2f696d672f636c6173732e706e67 ".WWW")](https://camo.githubusercontent.com/ec8022a6fb768aa7d81b8226237aadf63b8a726efab75a8314b224e54194c885/68747470733a2f2f617069646f63732e696f2f696d672f636c6173732e706e67) WWW
--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------

[](#-www)

### Get singleton instance

[](#get-singleton-instance-6)

The singleton instance of the `WWW` class can be accessed from the API Client.

```
$wWW = $client->getWWW();
```

### [![Method: ](https://camo.githubusercontent.com/501a7bfa57a34ebbde43bfe00d7218a47c0a18eae15acb62480b8716f604ee87/68747470733a2f2f617069646f63732e696f2f696d672f6d6574686f642e706e67 ".WWW.uRLInfo")](https://camo.githubusercontent.com/501a7bfa57a34ebbde43bfe00d7218a47c0a18eae15acb62480b8716f604ee87/68747470733a2f2f617069646f63732e696f2f696d672f6d6574686f642e706e67) uRLInfo

[](#-urlinfo)

> Parse, analyze and retrieve content from the supplied URL. See:

```
function uRLInfo(
        $url,
        $fetchContent = false,
        $ignoreCertificateErrors = false,
        $timeout = 20)
```

#### Parameters

[](#parameters-23)

ParameterTagsDescriptionurl`Required`The URL to probefetchContent`Optional` `DefaultValue`If this URL responds with html, text, json or xml then return the response. This option is useful if you want to perform further processing on the URL content (e.g. with the HTML Extract or HTML Clean APIs)ignoreCertificateErrors`Optional` `DefaultValue`Ignore any TLS/SSL certificate errors and load the URL anywaytimeout`Optional` `DefaultValue`Timeout in seconds. Give up if still trying to load the URL after this number of seconds#### Example Usage

[](#example-usage-23)

```
$url = 'url';
$fetchContent = false;
$ignoreCertificateErrors = false;
$timeout = 20;

$result = $wWW->uRLInfo($url, $fetchContent, $ignoreCertificateErrors, $timeout);
```

### [![Method: ](https://camo.githubusercontent.com/501a7bfa57a34ebbde43bfe00d7218a47c0a18eae15acb62480b8716f604ee87/68747470733a2f2f617069646f63732e696f2f696d672f6d6574686f642e706e67 ".WWW.hTMLClean")](https://camo.githubusercontent.com/501a7bfa57a34ebbde43bfe00d7218a47c0a18eae15acb62480b8716f604ee87/68747470733a2f2f617069646f63732e696f2f696d672f6d6574686f642e706e67) hTMLClean

[](#-htmlclean)

> Clean and sanitize untrusted HTML. See:

```
function hTMLClean(
        $content,
        $outputType)
```

#### Parameters

[](#parameters-24)

ParameterTagsDescriptioncontent`Required`The HTML content. This can be either a URL to load HTML from or an actual HTML content stringoutputType`Required`The level of sanitization, possible values are: **plain-text**: reduce the content to plain text only (no HTML tags at all) **simple-text**: allow only very basic text formatting tags like b, em, i, strong, u **basic-html**: allow advanced text formatting and hyper links **basic-html-with-images**: same as basic html but also allows image tags **advanced-html**: same as basic html with images but also allows many more common HTML tags like table, ul, dl, pre#### Example Usage

[](#example-usage-24)

```
$content = 'content';
$outputType = 'output-type';

$result = $wWW->hTMLClean($content, $outputType);
```

### [![Method: ](https://camo.githubusercontent.com/501a7bfa57a34ebbde43bfe00d7218a47c0a18eae15acb62480b8716f604ee87/68747470733a2f2f617069646f63732e696f2f696d672f6d6574686f642e706e67 ".WWW.browserBot")](https://camo.githubusercontent.com/501a7bfa57a34ebbde43bfe00d7218a47c0a18eae15acb62480b8716f604ee87/68747470733a2f2f617069646f63732e696f2f696d672f6d6574686f642e706e67) browserBot

[](#-browserbot)

> Browser bot can extract content, interact with keyboard and mouse events, and execute JavaScript on a website. See:

```
function browserBot(
        $url,
        $timeout = 30,
        $delay = 3,
        $selector = null,
        $exec = null,
        $userAgent = null,
        $ignoreCertificateErrors = false)
```

#### Parameters

[](#parameters-25)

ParameterTagsDescriptionurl`Required`The URL to loadtimeout`Optional` `DefaultValue`Timeout in seconds. Give up if still trying to load the page after this number of secondsdelay`Optional` `DefaultValue`Delay in seconds to wait before capturing any page data, executing selectors or JavaScriptselector`Optional`Extract content from the page DOM using this selector. Commonly known as a CSS selector, you can find a good reference [here](https://www.w3schools.com/cssref/css_selectors.asp)exec`Optional` `Collection`Execute JavaScript on the page. Each array element should contain a valid JavaScript statement in string form. If a statement returns any kind of value it will be returned in the 'exec-results' response. For your convenience you can also use the following special shortcut functions:  sleep(seconds); Just wait/sleep for the specified number of seconds. click('selector'); Click on the first element matching the given selector. focus('selector'); Focus on the first element matching the given selector. keys('characters'); Send the specified keyboard characters. Use click() or focus() first to send keys to a specific element. enter(); Send the Enter key. tab(); Send the Tab key.

 Example:  [ "click('#button-id')", "sleep(1)", "click('.field-class')", "keys('1234')", "enter()" ]

userAgent`Optional`Override the browsers default user-agent string with this oneignoreCertificateErrors`Optional` `DefaultValue`Ignore any TLS/SSL certificate errors and load the page anyway#### Example Usage

[](#example-usage-25)

```
$url = 'url';
$timeout = 30;
$delay = 3;
$selector = 'selector';
$exec = array('exec');
$userAgent = 'user-agent';
$ignoreCertificateErrors = false;

$result = $wWW->browserBot($url, $timeout, $delay, $selector, $exec, $userAgent, $ignoreCertificateErrors);
```

[Back to List of Controllers](#list_of_controllers)

###  Health Score

31

—

LowBetter than 68% of packages

Maintenance17

Infrequent updates — may be unmaintained

Popularity34

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity52

Maturing project, gaining track record

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

2369d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/3c7b974cacc559dcf823edb1c633c84c61db1e9c589ad7eba8610079acc1ae5f?d=identicon)[neutrinoapi](/maintainers/neutrinoapi)

---

Tags

apisdkneutrino-api

###  Code Quality

Code StylePHP\_CodeSniffer

### Embed Badge

![Health badge](/badges/neutrinoapi-neutrinoapi-php-sdk/health.svg)

```
[![Health](https://phpackages.com/badges/neutrinoapi-neutrinoapi-php-sdk/health.svg)](https://phpackages.com/packages/neutrinoapi-neutrinoapi-php-sdk)
```

###  Alternatives

[bandwidth/sdk

Bandwidth's set of APIs

16948.8k1](/packages/bandwidth-sdk)[messagemedia/messages-sdk

The MessageMedia Messages API provides a number of endpoints for building powerful two-way messaging applications.

13390.6k](/packages/messagemedia-messages-sdk)

PHPackages © 2026

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