# Pyszne — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Find and explore restaurants on Pyszne.pl by searching by name or location, then get detailed delivery information and restaurant specifics to help you order food. Discover nearby dining options and compare restaurants with their delivery details all in one place.

**Category:** Food & Dining | **Website:** [www.pyszne.pl/](https://www.pyszne.pl/) | **Docs:** [parse.bot/marketplace/39d0a490-da36-4322-bb07-8be57eefb826/pyszne-pl-api](https://parse.bot/marketplace/39d0a490-da36-4322-bb07-8be57eefb826/pyszne-pl-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-pyszne-pl-api-39d0a490/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_restaurant_details

Get operational delivery data for a specific restaurant at a given delivery address: current availability, busyness, estimated delivery time window, star rating, minimum order value, and delivery fee. The restaurant_id comes from search_restaurants results[*].partner_id or list_restaurants restaurants[*].id.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `address` | string | No | Delivery address for availability and fee calculation. Geocoded to coordinates server-side. |
| `restaurant_id` | string | Yes | Restaurant partner ID from search_restaurants results[*].partner_id or list_restaurants restaurants[*].id |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-pyszne-pl-api-39d0a490/get_restaurant_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"address":"<string>","restaurant_id":"<string>"}'
```

### list_restaurants

List all available restaurants near a delivery address with ratings, delivery ETAs, fees, and cuisine types. Returns restaurants sorted by the platform's default ranking. Each restaurant object carries an id usable with get_restaurant_details for operational delivery data.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `address` | string | No | Delivery address to list restaurants near. Geocoded to coordinates server-side. |
| `limit` | integer | No | Maximum number of restaurants to return |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-pyszne-pl-api-39d0a490/list_restaurants \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"address":"<string>","limit":"<integer>"}'
```

### search_restaurants

Full-text autocomplete search over restaurants and dishes near a delivery address. Returns a mixed list of Restaurant and Dish/Cuisine matches. Each Restaurant match includes a partner_id usable with get_restaurant_details; Dish and Cuisine matches are name-only suggestions without a direct restaurant link. Results are ranked by relevance to the query at the resolved coordinates.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `address` | string | No | Delivery address to search near. Geocoded to coordinates server-side. |
| `limit` | integer | No | Maximum number of results to return |
| `query` | string | No | Restaurant or dish name to search for |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-pyszne-pl-api-39d0a490/search_restaurants \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"address":"<string>","limit":"<integer>","query":"<string>"}'
```