FREE Public IP Address API

Introduction

The Public IP Address API is a quick and straightforward solution for identifying the public IPv4 and IPv6 addresses of customers who are accessing your services. Additionally, it includes proxy detection capabilities by analyzing the X-Forwarded-For (XFF) HTTP header field. Using proxy detection offered by the Public IP Address API, you can provide an additional layer of basic security by enabling you to identify potential proxy servers that may be masking the true identity and location of the user accessing your services.

This API endpoint is particularly appropriate for situations where you only need to collect your users' IP addresses for future business and customer analytics purposes. By utilizing the API, you can easily capture your users' IP addresses and use them to gain valuable insights into your customer base.

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.

Endpoints

IPv4 only API Endpoint

Use this endpoint to force API calls routed over the IPv4 network only

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

Dual-Stack API Endpoint

This endpoint has native IPv6 support and backs the API calls routed over both IPv4 and IPv6 networks

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

Request

This API doesn't require any request parameters.

Responses

200
Success

Sample Query

GET
https://api-bdc.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?