GET /api/places — find nearby restaurants in Riyadh

Find restaurants near any point in Riyadh by passing GPS coordinates and an optional keyword. PRIXO queries its own restaurant database first, then supplements results with Google Maps discoveries — giving you a combined list that includes ratings, neighbourhoods, and unique place identifiers you can pass to other endpoints.

Endpoint

GET /api/places

Authentication

Not required. This endpoint is fully public.

Rate limit

No rate limit applies to this endpoint.

Query parameters

number

required

The latitude of the search centre point. Must be a valid decimal coordinate within Saudi Arabia. Example: 24.7136.

number

required

The longitude of the search centre point. Must be a valid decimal coordinate within Saudi Arabia. Example: 46.6753.

number

The search radius in metres. Defaults to 1500 when omitted. Increase this for sparser areas or decrease it when you want results within walking distance.

string

Filter results by restaurant name or cuisine type. Accepts Arabic and English. When omitted, all restaurants within the radius are returned.

string

The language for place names in the response. Accepts "ar" (Arabic) or "en" (English). Defaults to "ar".

Example request

GET /api/places?lat=24.7136&lng=46.6753&radius=2000&keyword=شاورما

curl "https://prixo.ai/api/places?lat=24.7136&lng=46.6753&radius=2000&keyword=%D8%B4%D8%A7%D9%88%D8%B1%D9%85%D8%A7"

Response

The response is a JSON object containing a places array and a count integer.

Top-level fields

array

A list of restaurants within the search radius that match the keyword, sorted by relevance. Combines PRIXO database entries and Google Maps discoveries.

Show places[n] fields

string

The PRIXO-assigned identifier for this restaurant. Use this ID when querying other endpoints that accept a place identifier.

string

The restaurant’s display name, in the language requested via the lang parameter.

number

Latitude of the restaurant’s location.

number

Longitude of the restaurant’s location.

number | null

Average rating on a 0–5 scale. null if no rating data is available.

string | null

The Riyadh neighbourhood or district this restaurant is in — for example "العليا" or "النزهة". null if the area could not be determined.

string | null

The Google Maps place identifier, prefixed with ChIJ. Present for all Google-discovered restaurants and for PRIXO database entries that have been matched to Google. null for unmatched PRIXO-only entries.

boolean

true when the result represents a multi-branch chain rather than a single location.

number

The total number of places returned in this response.

Example response

{
  "places": [
    {
      "id": "place_mama_noura_olaya_01",
      "name": "ماما نورة",
      "lat": 24.715,
      "lng": 46.680,
      "rating": 4.5,
      "area": "العليا",
      "google_place_id": "ChIJd8BlQ2BxxkcRVIkwfJGbKOQ",
      "is_brand": false
    },
    {
      "id": "place_shawarmaji_02",
      "name": "شاورماجي",
      "lat": 24.711,
      "lng": 46.675,
      "rating": 4.2,
      "area": "العليا",
      "google_place_id": "ChIJN1t_tDeuEmsRUsoyG83frY4",
      "is_brand": true
    }
  ],
  "count": 2
}

Source of results

Results combine two sources. PRIXO database places have verified price data and community snapshots attached to them. Google Maps discovered places appear in the list but may not yet have any price data — you can be the first to submit a snapshot for them.You can tell the two apart by checking whether a google_place_id is present without a matching PRIXO entry elsewhere in the platform, but the simplest approach is to attempt a /api/search query for the specific place and check the discoveredViaGoogle flag in the response.

For best coverage in dense areas, keep radius at or below 2000. Very large radii (above 5000) may return results in different areas of Riyadh that are not practically reachable in a single delivery session.

Overview

Endpoints

GET /api/places — find nearby restaurants in Riyadh

Endpoint

Authentication

Rate limit

Query parameters

Example request

Response

Top-level fields

Example response

Source of results

​Endpoint

​Authentication

​Rate limit

​Query parameters

​Example request

​Response

​Top-level fields

​Example response

​Source of results

Endpoint

Authentication

Rate limit

Query parameters

Example request

Response

Top-level fields

Example response

Source of results