API Docs

v1.0.0Latest
GET

Get Geolocations

Retrieve geolocations

Endpoint
GET /ask/geos
Request Query Parameters
Query parameters for fetching hashtags feed
Field
Type
Required
Description
search
string
No
Search term to fetch geolocations for
limit
number
No
Number of results to return
countryCode
string
No
Country code for filtering results (e.g. US, CA)
types
string
No
Comma-separated list of geolocation types to filter results (e.g. city, subdivision, country)
Example Request
curl -X GET "https://api.gateway.walee.ai/api/ask/geos" \
  -H "x-api-key: YOUR_API_KEY"
Success Response
Successful geolocations retrieval
200OK
{
  "success": true,
  "message": "Geolocations fetched successfully",
  "payload": {
    "data": [
      {
        "id": 51800,
        "type": [
          "city"
        ],
        "name": "London",
        "title": "London, United Kingdom",
        "country": {
          "id": 62149
        }
      },
      {
        "id": 297756,
        "type": [
          "city"
        ],
        "name": "Londrina",
        "title": "Londrina, Brazil",
        "country": {
          "id": 59470
        }
      }
    ]
  }
}
Error Response
Error retrieving geolocations
400Bad Request
{
  "success": false,
  "message": "Failed to fetch geolocations"
  "payload": {}
}
Error Response
Unexpected error occurred
500Internal Server Error
{
  "success": false,
  "message": "Something went wrong. Please try again later."
  "payload": {}
}