# REST API

{% hint style="info" %}
If you want to try the REST API, please contact us at **<developer@getgeoflow.com>** and share what you would like to build with it, along with any other necessary information.

If your request is accepted, you will receive an API Key and further instructions.
{% endhint %}

### Base REST URL

```
https://getgeoflow.com/beta/api
```

### Authentication

```
Authorization: Bearer <TOKEN>
```

{% hint style="warning" %}
**Developer Warning**: Never share your API key with anyone or add it to client-side code. Where possible, use environment variables in your backend to keep your API key secure.
{% endhint %}

### Rate Limit

25 Requests per Second

### Available Endpoints

<table><thead><tr><th>Endpoint Name</th><th width="222.33333333333331">Endpoint Path</th><th>Endpoint Description</th><th data-hidden></th></tr></thead><tbody><tr><td>Get Visitor IP</td><td>/get-visitor-ip</td><td>Get the IP address for a visitor or online device.</td><td></td></tr><tr><td>Get Visitor Data</td><td>/get-visitor-data</td><td>Get the data associated with a specific IP address.</td><td></td></tr><tr><td>Add Website</td><td>/add-website/:accountID</td><td>Add a single website to your account.</td><td></td></tr><tr><td>Delete Website</td><td>/delete-website/:siteID</td><td>Delete a single website from your account.</td><td></td></tr><tr><td>Update Website</td><td>/edit-website/:siteID</td><td>Update a single website that is in your account.</td><td></td></tr><tr><td>List Websites</td><td>/list-websites/:accountID</td><td>List all the websites that are in your account.</td><td></td></tr><tr><td>Get Website</td><td>/get-website/:siteID</td><td>Get a single website that is in your account.</td><td></td></tr></tbody></table>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://developers.getgeoflow.com/geoflow-docs/advanced/api.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.