Positionstack Integration¶

Official Positionstack API Documentation

Positionstack provides forward and reverse geocoding APIs. Use KeyPool to call Positionstack with your team token and a stable base URL.

Endpoint¶

{YOUR_KEYPOOL_BASE_URL}/v1/positionstack

Authentication¶

Send your KeyPool team token as a bearer token. Do not pass an upstream access_key query parameter.

Authorization: Bearer {KEYPOOL_TOKEN}

Quick Start¶

Forward Geocoding¶

curl -G "${KEYPOOL_BASE_URL}/v1/positionstack/v1/forward" \
  -H "Authorization: Bearer ${KEYPOOL_TOKEN}" \
  --data-urlencode "query=1600 Pennsylvania Ave NW, Washington, DC" \
  --data-urlencode "limit=1"

Reverse Geocoding¶

curl -G "${KEYPOOL_BASE_URL}/v1/positionstack/v1/reverse" \
  -H "Authorization: Bearer ${KEYPOOL_TOKEN}" \
  --data-urlencode "query=38.897675,-77.036547" \
  --data-urlencode "limit=1"

Common Parameters¶

Parameter	Purpose
`query`	Address, place name, or coordinate pair
`country`	Optional country filter
`region`	Optional region filter
`limit`	Maximum number of records

Interactive API Reference¶

For in-browser testing, see API Reference -> Positionstack.