BigDataCloud Launches the First-Ever GraphQL-Based Geolocation API Service

BigDataCloud Launches the First-Ever GraphQL-Based Geolocation API Service

BigDataCloud January 8, 2024


We're thrilled to announce the launch of the GraphQL API services for our API Packages. This new feature is set to change the way you interact with geolocation data, offering enhanced efficiency, power, and flexibility.  

BigDataCloud is proud to pioneer the integration of GraphQL technology with geolocation API services. We are the first IP geolocation service provider to introduce GraphQL-based IP geolocation API and Reverse Geocoding API service, setting a new industry standard for geolocation and user data validation data services.

Why GraphQL?

In the digital era, the need for precise and speedy data retrieval is paramount. Traditional REST APIs have served us well, but as our data demands grow more complex, the necessity for a more dynamic solution becomes clear. Enter GraphQL: a query language that empowers developers to pull exactly what they need from a vast pool of data with a single query. Given that BigDataCloud's geolocation APIs deliver extensive datasets, our GraphQL service is ideal when your application requires only specific data points, ensuring efficiency and precision.

The Power of One Query

One of GraphQL's standout features is its ability to reduce the need for multiple requests. By fetching multiple resources through one query, not only is performance enhanced, but data retrieval becomes more predictable. The strong type system within GraphQL ensures the integrity of the data, and its self-documenting nature streamlines development processes, making it an ideal choice for scalable modern applications.

A Playground for Developers to build and test BigDataCloud’s GraphQL APIs

We are not just providing an API; we are also offering a playground. The BigDataCloud interactive GraphQL playground is designed for developers to construct, refine, and test their queries. With full access to our detailed schema documentation, you'll understand every field and type at your disposal.

Ready to Explore?

Whether you are looking to enhance your existing application with precise geolocation data or you want to build something entirely new, our GraphQL API is here to provide the data backbone you need.

How to Get Started

To explore the GraphQL schema and to start experimenting in the playground, you'll need an active BigDataCloud account.

(If you do not have an account, please proceed to our Sign Up page.)



Method 1:

Once you have an account, visit the GraphQL section of any one of the API Package pages:

 Screenshot of the GraphQL section in the API package page.

Here is the screenshot of the GraphQL section of the IP geolocation API Package. 

In the GraphQL API section, you can click on the Preview GraphQL Schema to view the class diagram of the IP Geolocation API package, or click on the Access GraphQL Playground button to directly use the GraphQL Playground.

Screenshot of the popup dialog box revealing the class diagram of GraphQL API.

Here is the screenshot of the preview of the GraphQL schema. 

When you click on the Access GraphQL Playground button, if you are not already logged in, you will be redirected to the login page.

Method 2:

When you log in to your account, you are redirected to your subscription page. 

Here, you can click on the button with Vertical Ellipsis Icon on the right or the button below the Plan details to open a drop down menu. The menu has a link to the respective GraphQL playground page. Click on the link to open the Playground page of the respective API package in a new browser tab.

Screenshot of BigDataCloud's account page with key buttons highlighted with red boxes.


Using GraphQL Playground

The GraphQL Playground page automatically retrieves your API key and applies to the GraphQL endpoint. Following are the API endpoints of the respective API packages:

  •[API Key]

  •[API Key]

  •[API Key]

  •[API Key]

Screenshot of GraphQL playground showing the query and its output.

Here is the screenshot of the GraphQL Playground page of the IP geolocation API Package.

The playground is based on the standard GraphQL playground UI of  and has the standard features and functionalities. On the left, you can write your query structure and on the right you get the output of the query when you click on the Play button.

Screenshot of GraphQL playground showing the GraphQL schema documentation sidebar.

Here is the screenshot of the GraphQL Documentation UI of the IP geolocation API Package. 

If you click on the green Docs button on the right-hand side then the sidebar UI will slide to reveal the detailed documentation of the fields and types of the classes used in the GraphQL. You can click on each field and type to view their detailed description and use them in your query. You can also search the documentation for the fields you are interested in.

You can also click on the Switch Package dropdown menu to switch between different API packages.

If you learn about GraphQL, we recommend you go through the tutorial available on the official GraphQL website.