FREE Public IP Address API

Introduction

The Public IP Address API provides a simple and efficient solution for identifying the public IPv4 and IPv6 addresses of users accessing your services. It also includes proxy detection, using analysis of the X-Forwarded-For (XFF) HTTP header to identify potential proxy servers that may be obscuring users’ true identities or locations. This additional functionality offers a basic yet valuable layer of security for your applications.

This API is particularly useful in scenarios where collecting users' IP addresses is essential for business purposes or customer analytics. By integrating the API, you can effortlessly capture IP address data and use it to gain actionable insights into your audience.

Important Notice: The API is free to use and imposes no throttling limits. However, responsible usage is expected. Excessive or unreasonable requests, such as repeatedly querying the same IP address at high volumes, are prohibited and may result in access being restricted. If you encounter errors or blocked connections despite following reasonable usage guidelines, please contact us for support.

Get Started

This API is part of the FREE API Package and is available in free and paid plans. Please visit the FREE API Package package page for limits and pricing information.

Endpoint

GET
/data/client-ip

Request

This API doesn't require any request parameters.

Responses

200
OK

Sample Query

GET
https://api.bigdatacloud.net/data/client-ip

Schema

application/json
ipStringstring
Returns the client’s IP address in a string format
ipTypestring
Returns the IP address type. Possible values: "IPv4"
proxyIpstring
Returns the IP address of the proxy server (omitted if no proxy detected)

Sample Response

JSON View
500
An error has occurred and did not complete your request. Please try again

Sample Response

JSON View
Was this page helpful?