Saudi Short Address API

Add Short Address lookups to your checkout, delivery app or ERP. Send a Google Maps link, coordinates or a Short Address — or search by place name — and get the full national address back as JSON.

5 free lookups when you sign up — no card needed.

How it works

  1. Sign up and create an API key in your account.
  2. Send a POST request to /api/v1/lookup with your key.
  3. Read the Short Address, building number, street, district, city, postal code and additional number from the JSON response.

Full reference and code samples: API documentation.

What's new in MyShortAddress

  • Every map link works — Google Maps pins, places and businesses, links copied from the browser, Apple Maps and Waze.
  • Always an answer — no Short Address on the exact spot? You get the nearest registered building's, within 100 m, with the distance shown.
  • Search by place name — type a shop, company, mall or landmark and pick it from the list. See search by place name.
  • Pay only for new addresses — no Short Address found? No credit. The same address again within 7 days? Free.

Start with 5 free lookups, no card needed. See pricing.

What it costs

Each successful lookup uses one lookup from your pack; failed calls are free. Your team uses the same lookups on the website. See pricing.

Limits

Up to 120 requests a minute per account.

Questions and answers

Which inputs does the API accept?

A Google Maps link, coordinates (latitude, longitude) or a Short Address.

Can I try it for free?

Yes. The 5 free lookups you get when you sign up work for the API too.

More guides