POST geo

geocode_parse

1 credit

Parse a freeform address string into structured components (street, city, postal code, state, country)

Endpoint

POST /api/v1/tools/geo/geocode_parse

Body Parameters

address string required

Example

input Request

{
    "address": "123 Main St, Springfield, IL 62704, US"
}

output Response

{
    "city": "Springfield",
    "state": "IL",
    "street": "123 Main St",
    "country": "US",
    "postal_code": "62704"
}

Response Format

HTTP/1.1 200 OK SUCCESS

{
  "success": true,
  "data": {
    "city": "Springfield",
    "state": "IL",
    "street": "123 Main St",
    "country": "US",
    "postal_code": "62704"
},
  "meta": {
    "tool": "geocode_parse",
    "credits_consumed": 1
  }
}

HTTP/1.1 422 Unprocessable Entity ERROR

{
  "success": false,
  "data": null,
  "error": {
    "code": "validation_error",
    "message": "The given data was invalid."
  }
}

Code Examples

Request Example

lightbulb Developer Tip

Credits are deducted before execution. If the upstream tool fails, credits are automatically refunded to your account.