Positionstack Integration

Official Positionstack API Documentation · Pricing and plan features · FAQ

Use your KeyPool team token to make a single forward or reverse geocoding request. The configured provider access is on Positionstack's Free plan. Positionstack currently lists 100 included requests per month per Free account, for personal, noncommercial use, with HTTPS access. That published allowance is not a promise of remaining requests through KeyPool.

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"

Reverse Geocoding

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

Free-plan scope

Pass one address or place name in query to GET /v1/forward, or one latitude,longitude pair to GET /v1/reverse. Responses use the provider's default JSON format. A lookup can return several candidate places; keep their returned labels and any confidence values visible when choosing among them. Geocoding does not establish a device's location or guarantee a precise match.

Positionstack lists alternate output formats, multiple languages, embeddable maps, and batch requests under paid plans. Those operations are unavailable through this Free-plan integration. Other optional provider parameters and enrichment modules are not established as Free-plan entitlements here. A quota or plan error means the request did not return geocoding results.

Interactive API Reference

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