The official Javascript package of Greip API
Report Issue · Request Feature · Greip Website · Documentation
npm i greip.js --save
or
yarn add greip.js
<script src="https://cdn.jsdelivr.net/gh/Greipio/javascript/greip.bundle.js" type="text/javascript"></script>Please use our Node.js library instead.
There're two different ways to initialize the Greip object, let's dive into this:
import {
Lookup,
Threats,
GeoIP,
BulkLookup,
ASN,
BadWord,
Country,
EmailValidation,
PhoneValidation,
PaymentFraud,
IBANValidation,
} from 'greip.js';In CDN integration, you already have Greip as a global variable initialized automatically when the page loads.
You can start using it directly as follows:
Greip.GeoIP({
key: 'your-api-key',
// other options here
}).then((response) => {
console.log(response);
});Here's how you use the API Methods:
Use this method to retrieve the IP address of the visitor/user with its full information.
await GeoIP({
key: 'your-api-key',
})
.then((res: any) => {
console.log(res.data); // Log Response
})
.catch((error: any) => {
console.log(error);
});Use this method to retrieve threat intelligence information associated with a given IP address.
await Threats({
key: 'your-api-key',
ip: '1.1.1.1',
})
.then((res: any) => {
console.log(res.data); // Log Response
})
.catch((error: any) => {
console.log(error);
});Use this method to retrieve the information of a given IP address.
await Lookup({
key: 'your-api-key',
ip: '1.1.1.1',
})
.then((res: any) => {
console.log(res.data); // Log Response
})
.catch((error: any) => {
console.log(error);
});You can use this method to retrieve the information of multiple IP addresses (no need to use the Lookup method inside a loop).
await BulkLookup({
key: 'your-api-key',
ips: ['1.1.1.1', '2.2.2.2'],
})
.then((res: any) => {
console.log(res.data); // Log Response
})
.catch((error: any) => {
console.log(error);
});In this method, Greip will help you lookup any given AS Number and returning all data related to it, like: name, org (the organization name), country, domain, email, phone, totalIPs, list of all routes (v4 & v6) related the given AS Number, etc.
await ASN({
key: 'your-api-key',
asn: 'AS01',
})
.then((res: any) => {
console.log(res.data); // Log Response
})
.catch((error: any) => {
console.log(error);
});This method can be used to detect abuse of your website/app. It’s a great way to know more about your user inputs and whether they contain profanity (bad words) or not before releasing them to the public.
await BadWord({
key: 'your-api-key',
text: 'This is just normal sample text.',
})
.then((res: any) => {
console.log(res.data); // Log Response
})
.catch((error: any) => {
console.log(error);
});This method can help you retrieve information of the given country.
await Country({
key: 'your-api-key',
countryCode: 'SA',
})
.then((res: any) => {
console.log(res.data); // Log Response
})
.catch((error: any) => {
console.log(error);
});This method provides an additional layer of validation for your system. While validating email syntax is important, it is not sufficient.
This method goes beyond syntax validation by checking the domain’s validity, the availability of the Mail Service, detecting Disposable Email (Temporary Emails), etc. By utilising this method, you can ensure a more thorough validation process for email addresses.
await EmailValidation({
key: 'your-api-key',
email: 'name@domain.com',
})
.then((res: any) => {
console.log(res.data); // Log Response
})
.catch((error: any) => {
console.log(error);
});This method can be used as an extra-layer of your system for validating phone numbers. It validates phone number syntax and valid-possibility.
await PhoneValidation({
key: 'your-api-key',
phone: '123123123',
countryCode: 'US',
})
.then((res: any) => {
console.log(res.data); // Log Response
})
.catch((error: any) => {
console.log(error);
});Prevent financial losses by deploying AI-Powered modules.
await PaymentFraud({
key: 'your-api-key',
data: {
action: 'purchase',
website_domain: '',
website_name: '',
merchant_id: 21,
shipment_id: 1,
transaction_id: 100,
transaction_amount: 1000000,
transaction_currency: 'GBP',
cart_items: {
item_id: 1,
item_name: 'Product name',
item_quantity: 1,
item_price: '1100.55',
item_category_id: 1,
},
isDigitalProducts: true,
coupon: 'ASDF',
customer_id: 1,
customer_firstname: 'First',
customer_lastname: 'Last',
customer_pob: 'London',
customer_ip: '1.1.1.1',
customer_country: 'GB',
customer_region: 'London',
customer_city: 'London',
customer_zip: 'NW10 7PQ',
customer_street: '7 Coronation Road',
customer_street2: '',
customer_latitude: 0.123,
customer_longitude: 0.123,
customer_device_id: 'UNIQUE_DEVICE_ID',
customer_phone: '000000000',
customer_registration_date: 1677554670,
customer_balance: '1000.00',
customer_dob: '1997-19-05',
customer_email: 'name@domain.com',
customer_2fa: true,
customer_useragent: 'Mozill almaden sdfwer',
shipping_country: 'GB',
shipping_region: 'London',
shipping_city: 'London',
shipping_zip: 'NW10 7PQ',
shipping_street: '7 Coronation Road',
shipping_street2: '',
shipping_latitude: 0.123,
shipping_longitude: 0.123,
billing_country: 'GB',
billing_region: 'London',
billing_city: 'London',
billing_zip: 'NW10 7PQ',
billing_street: '7 Coronation Road',
billing_street2: '',
billing_latitude: 0.123,
billing_longitude: 0.123,
payment_type: 'applepay',
card_name: 'First Last',
card_number: '1234XXXXXXXX1234',
card_expiry: '29/05',
cvv_result: true,
},
})
.then((res: any) => {
console.log(res.data); // Log Response
})
.catch((error: any) => {
console.log(error);
});This method allows you to validate International Bank Account Numbers (IBANs) and retrieve additional information about the country associated with the IBAN.
await IBANValidation({
key: 'your-api-key',
iban: 'BY86AKBB10100000002966000000',
})
.then((res: any) => {
console.log(res); // Log Response
})
.catch((error: any) => {
console.log(error);
});You can find the full guide of this package by visiting our documentation page.
