# Greip API API

> Greip API API on Apizie: 9 endpoints (ASNLookup endpoint: This method helps you lookup any AS Number. It returns the type, organisation details,…, This method helps you validate any BIN/IIN number and retrieve the full details related to the bank, brand,…, BulkLookup endpoint: Returns the geolocation data of multiple IP Addresses., Country endpoint: Returns the information of a specific country by passing the `countrCode`., …) returned as clean JSON through one API key. 9 endpoints are live now. Call it over REST at https://zieapi.vercel.app/v1/open-data:greip/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `open-data:greip`
- Category: Open Data
- Status: live
- Source: https://greip.io/contact
- Page: https://zieapi.vercel.app/api/open-data/greip
- OpenAPI: https://zieapi.vercel.app/api/open-data/greip/openapi.json

This documentation shows how to use Greip API, by highlighting the API methods, options and some other features that allow you to get the most of this API.

## Endpoints

### ASNLookup endpoint: This method helps you lookup any AS Number. It returns the type, organisation details,…
`GET https://zieapi.vercel.app/v1/open-data:greip/get-asnlookup`

| Parameter | Type | Required | Description |
|---|---|---|---|
| key | string | yes | Your API Key. Each user has a unique API Key that can be used to access the API functions. If you don't have an account yet, please create… |
| asn | string | yes | The AS Number you want to lookup |
| isList | string | no | Set this to true if you want to list all routes of both IPv4 and IPv6. |
| format | string | no | Sets the format of the API response. JSON is the default format. |

### This method helps you validate any BIN/IIN number and retrieve the full details related to the bank, brand,…
`GET https://zieapi.vercel.app/v1/open-data:greip/get-binlookup`

| Parameter | Type | Required | Description |
|---|---|---|---|
| key | string | yes | Your API Key. Each user has a unique API Key that can be used to access the API functions. If you don't have an account yet, please create… |
| bin | string | yes | The BIN/IIN you want to lookup/validate. |
| format | string | no | Sets the format of the API response. JSON is the default format. |

### BulkLookup endpoint: Returns the geolocation data of multiple IP Addresses.
`GET https://zieapi.vercel.app/v1/open-data:greip/get-bulk-lookup`

| Parameter | Type | Required | Description |
|---|---|---|---|
| key | string | yes | Your API Key. Each user has a unique API Key that can be used to access the API functions. If you don't have an account yet, please create… |
| ips | string | yes | The IP Addresses you want to lookup. It's a CSV (Comma Separated Values) |
| params | string | no | The modules you want to use of the request. It's a CSV (Comma Separated Values) |
| lang | string | no | Used to inform the API to retrieve the response in your native language. |
| format | string | no | Sets the format of the API response. JSON is the default format. |

### Country endpoint: Returns the information of a specific country by passing the `countrCode`.
`GET https://zieapi.vercel.app/v1/open-data:greip/get-country`

| Parameter | Type | Required | Description |
|---|---|---|---|
| key | string | yes | Your API Key. Each user has a unique API Key that can be used to access the API functions. If you don't have an account yet, please create… |
| CountryCode | string | yes | The Country Code of the country you want to fetch it's data. |
| params | string | no | The modules you want to use of the request. It's a CSV (Comma Separated Values) |
| lang | string | no | Used to inform the API to retrieve the response in your native language. |
| format | string | no | Sets the format of the API response. JSON is the default format. |

### Returns the geolocation data of the visitor.
`GET https://zieapi.vercel.app/v1/open-data:greip/get-geo-ip`

| Parameter | Type | Required | Description |
|---|---|---|---|
| key | string | yes | Your API Key. Each user has a unique API Key that can be used to access the API functions. If you don't have an account yet, please create… |
| params | string | no | The modules you want to use of the request. It's a CSV (Comma Separated Values) |
| lang | string | no | Used to inform the API to retrieve the response in your native language. |
| format | string | no | Sets the format of the API response. JSON is the default format. |

### Returns the geolocation data of a specific IP Address.
`GET https://zieapi.vercel.app/v1/open-data:greip/get-iplookup`

| Parameter | Type | Required | Description |
|---|---|---|---|
| key | string | yes | Your API Key. Each user has a unique API Key that can be used to access the API functions. If you don't have an account yet, please create… |
| ip | string | yes | The IP Address you want to lookup. |
| params | string | no | The modules you want to use of the request. It's a CSV (Comma Separated Values) |
| lang | string | no | Used to inform the API to retrieve the response in your native language. |
| format | string | no | Sets the format of the API response. JSON is the default format. |

### badWords endpoint: Detects whether user inputs contain profanity or not.
`GET https://zieapi.vercel.app/v1/open-data:greip/get-bad-words`

| Parameter | Type | Required | Description |
|---|---|---|---|
| key | string | yes | Your API Key. Each user has a unique API Key that can be used to access the API functions. If you don't have an account yet, please create… |
| text | string | yes | The text you want to check. |
| listBadWords | string | no | Set to `yes` to list the bad-words as an Array. |
| scoreOnly | string | no | Set to `yes` to return only the score of the text and whether it's safe or not. |
| format | string | no | Sets the format of the API response. JSON is the default format. |

### This method can be used as an extra-layer of your system for validating email addresses.
`GET https://zieapi.vercel.app/v1/open-data:greip/get-validate-email`

| Parameter | Type | Required | Description |
|---|---|---|---|
| key | string | yes | Your API Key. Each user has a unique API Key that can be used to access the API functions. If you don't have an account yet, please create… |
| email | string | yes | The Email Address you want to validate. |
| format | string | no | Sets the format of the API response. JSON is the default format. |

### This method can be used as an extra-layer of your system for validating phone numbers.
`GET https://zieapi.vercel.app/v1/open-data:greip/get-validate-phone`

| Parameter | Type | Required | Description |
|---|---|---|---|
| key | string | yes | Your API Key. Each user has a unique API Key that can be used to access the API functions. If you don't have an account yet, please create… |
| phone | string | yes | The Phone Number you want to validate. |
| countryCode | string | yes | The ISO 3166-1 alpha-2 format of the country code of the phone number. |
| format | string | no | Sets the format of the API response. JSON is the default format. |

## Example
```
curl "https://zieapi.vercel.app/v1/open-data:greip/get-asnlookup" \
  -H "x-api-key: $APIZIE_KEY"
```

## FAQ

### How do I call the Greip API API?
Create a free Apizie key, then send GET https://zieapi.vercel.app/v1/open-data:greip/get-asnlookup with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the Greip API API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card.

### Can AI agents use the Greip API API?
Yes. Add the Apizie MCP server (https://zieapi.vercel.app/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key open-data:greip.

### What is the status of the Greip API API?
Live: works with just an Apizie key