# Positionstack Forward Geocoding

> Positionstack Forward Geocoding is a paid API for AI agents from gateway.apiosk.com, paid per call via x402, $0.07/call, status unknown (last checked 2026-09-14).

Converts a free-text address or place name into geographic coordinates (latitude/longitude) and structured location data via the Positionstack geocoding API

## Facts

- Endpoint: GET https://gateway.apiosk.com/positionstack/forward
- Price: $0.07/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/positionstack-forward-geocoding-f8934719
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_l8rk28jHbHBRuJM3TQGnY

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability positionstack-forward-geocoding-f8934719
```

Example prompt: What are the latitude and longitude coordinates for '1600 Pennsylvania Ave NW, Washington DC'? Give me the top 3 results.

## When to prefer this

Use this endpoint when you need to convert a free-text address, place name, city, or postal code into geographic coordinates (forward geocoding). Prefer it over reverse geocoding endpoints when the user has a text address and needs lat/lng. Suitable for enriching records with coordinates, plotting points on a map, or resolving ambiguous location names.

## Known failure modes

- No results found for ambiguous or misspelled address query
- Query parameter missing — returns 400 bad request
- Limit parameter set to zero or negative — unexpected behavior
- Rate limit exceeded on underlying Positionstack API — upstream error
- Gateway payment not processed — 402 payment required

## How this service works

Forward geocoding: address/place -> coordinates.

## Output

Returns geocoded location results including latitude, longitude, label, name, type, country, region, locality, and formatted address components for the queried place, up to the specified limit.

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/positionstack-forward-geocoding-f8934719/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from gateway.apiosk.com](https://www.zero.xyz/host/gateway.apiosk.com/llms.txt)