Get Geo Suggestions - Leadfeeder API

Resolves a typed city name or postal code into geographic coordinates. The returned latitude / longitude can be used to populate the value.lat / value.lon of the Geo Filter (field: geo, operator: within). Results can be scoped to one or more countries via country_codes, and search_fields limits which address fields the text may match; when omitted, both cities and postal codes are searched.

Credit Note: This endpoint does not consume credits.

INFO

Requires the companies:read OAuth2 scope.

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200OK

application/json

Matching location suggestions

Bodyapplication/json

Example

{
    "data": [
        {
            "type": "geo_suggestion",
            "id": "9b3f0a1c-2b7e-4e6f-9c1b-7f1a2c3d4e5f",
            "attributes": {
                "city": "London",
                "postal_code": null,
                "country_code": "GB",
                "latitude": 51.51,
                "longitude": -0.13
            }
        },
        {
            "type": "geo_suggestion",
            "id": "1c2d3e4f-5a6b-7c8d-9e0f-1a2b3c4d5e6f",
            "attributes": {
                "city": "Long Beach",
                "postal_code": null,
                "country_code": "US",
                "latitude": 33.77,
                "longitude": -118.19
            }
        },
        {
            "type": "geo_suggestion",
            "id": "2a3b4c5d-6e7f-8a9b-0c1d-2e3f4a5b6c7d",
            "attributes": {
                "city": "Frankfurt am Main",
                "postal_code": "60311",
                "country_code": "DE",
                "latitude": 50.11,
                "longitude": 8.68
            }
        }
    ],
    "meta": {
        "request_id": "cf054205-dd8c-4473-8689-07c30fe0789f"
    }
}

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠429

🔴500Server Error

🔴503Service Unavailable

🔴504Gateway Timeout