Getting Started

Overview

Oolel Maps provides a RESTful API for geocoding, search, navigation, and address management across West Africa. All endpoints return JSON and support French, Arabic, and English via the language parameter.

https://api.oolel.com

Head to the registration page and create a free developer account. You will need to provide your name, email address, and optionally your company name.

After logging in, navigate to the API Keys section of your dashboard. Click "Create New Key" and give it a descriptive name (e.g. "Production" or "Development"). Copy and store your key securely — you will not be able to see it again after creation.

Use your API key in the Authorization header with a Bearer prefix. Here is a simple forward geocoding request:

curl -X GET "https://api.oolel.com/geocoding/forward?q=Tevragh+Zeina+Nouakchott" \
  -H "Authorization: Bearer YOUR_API_KEY"

Authentication

All API requests must include your API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

Requests without a valid API key will receive a 401 Unauthorized response.

Rate Limits

The free tier includes 10,000 requests per month. Rate limits are applied per API key with a maximum of 100 requests per minute. The following headers are included in every response:

X-RateLimit-Limit: 100
X-RateLimit-Remaining: 97
X-RateLimit-Reset: 1709683200

Error Handling

The API uses standard HTTP status codes. Error responses include a JSON body with a descriptive message:

{
  "statusCode": 400,
  "message": "Query parameter 'q' is required",
  "error": "Bad Request"
}