POST /api/search — compare item prices across platforms

Send a natural-language query — in Arabic or English — and PRIXO returns a ranked price comparison for the matched dish across every platform that carries it. The response includes real delivery totals with fees and VAT factored in, so you can see exactly what you would pay before you order.

Endpoint

POST /api/search

Authentication

Not required. This endpoint is fully public.

Rate limit

No rate limit applies to this endpoint.

Request

Set Content-Type: application/json and send a JSON body with a single query field.

Body parameters

string

required

A natural-language search query in Arabic or English. You can include the restaurant name, dish name, or both. For example: "شاورما ماما نورة" or "mama noura shawarma".

Example request

{ "query": "شاورما ماما نورة" }

curl -X POST https://prixo.ai/api/search \
  -H "Content-Type: application/json" \
  -d '{"query": "شاورما ماما نورة"}'

Response

The response is a JSON object with the top-level fields intent, matches, emptyReason, and discoveredViaGoogle.

Top-level fields

object

The structured search intent that PRIXO extracted from your query.

Show intent fields

string

The restaurant name extracted from the query.

string

The dish or menu item extracted from the query.

number

The quantity implied by the query. Defaults to 1 when no quantity is mentioned.

array

An array of brand matches. Each entry pairs a matched restaurant brand with a full price comparison across platforms. May be empty when no results are found — see emptyReason.

Show matches[n] fields

object

The matched restaurant brand.

Show brand fields

string

Unique identifier for the brand in the PRIXO database.

string

Display name of the restaurant brand.

boolean

true if this entry represents a chain with multiple branches. false for single-location restaurants.

object

The price comparison result for the matched item at this brand.

Show comparison fields

array

Platforms sorted from cheapest to most expensive total. Each entry represents one platform.

Show ranked[n] fields

string

Platform identifier. One of "hungerstation", "keeta", or "jahez".

number

The full amount you pay, including item price, delivery fee, and VAT, in Saudi Riyals (SAR).

number

The price of the item itself, before fees, in SAR.

number

The delivery fee charged by this platform, in SAR.

string

How reliable this price data is. One of "high", "medium", or "low".

string

Verification status of the price. One of "verified", "unverified", or "stale".

string

The platform with the lowest total. One of "hungerstation", "keeta", or "jahez".

number

The SAR difference between the cheapest and most expensive platform total. Shows how much you save by picking the winner.

string | null

Explains why matches is empty. null when results were found. See the Empty reason values section below.

boolean

true when the restaurant was not in the PRIXO database and was discovered via a Google Maps lookup instead. Prices may be limited or unavailable for Google-discovered restaurants.

Example response

{
  "intent": {
    "restaurant": "ماما نورة",
    "item": "شاورما",
    "quantity": 1
  },
  "matches": [
    {
      "brand": {
        "id": "brand_mama_noura_01",
        "name": "ماما نورة",
        "is_brand": true
      },
      "comparison": {
        "ranked": [
          {
            "platform": "hungerstation",
            "total": 15.5,
            "itemPrice": 10.5,
            "deliveryFee": 5.0,
            "confidence": "high",
            "status": "verified"
          },
          {
            "platform": "keeta",
            "total": 17.0,
            "itemPrice": 11.0,
            "deliveryFee": 6.0,
            "confidence": "medium",
            "status": "verified"
          },
          {
            "platform": "jahez",
            "total": 18.0,
            "itemPrice": 10.5,
            "deliveryFee": 7.5,
            "confidence": "high",
            "status": "verified"
          }
        ],
        "winner": "hungerstation",
        "savings": 2.5
      }
    }
  ],
  "emptyReason": null,
  "discoveredViaGoogle": false
}

Empty reason values

When matches is an empty array, emptyReason tells you why:

Value	Meaning
`restaurant_not_found`	PRIXO could not match any restaurant to your query, even via Google. Try a different spelling or the restaurant’s full name.
`item_not_in_db`	The restaurant was found but the specific dish is not yet in the PRIXO database. You can help by submitting a price snapshot.
`no_prices_yet`	The dish exists in the database but no community prices have been submitted for it yet. Be the first to contribute a snapshot.

All prices are in Saudi Riyals (SAR) and include VAT where applicable. PRIXO does not add any markup — totals reflect what the delivery platforms charge.

Queries work best when you include both the restaurant name and the dish name. Single-word queries like "شاورما" still work but may return multiple brand matches.

Overview

Endpoints

POST /api/search — compare item prices across platforms

Endpoint

Authentication

Rate limit

Request

Body parameters

Example request

Response

Top-level fields

Example response

Empty reason values

​Endpoint

​Authentication

​Rate limit

​Request

​Body parameters

​Example request

​Response

​Top-level fields

​Example response

​Empty reason values

Endpoint

Authentication

Rate limit

Request

Body parameters

Example request

Response

Top-level fields

Example response

Empty reason values