# Timeout — 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.

> Discover restaurants, events, attractions, and city guides across multiple locations with the Time Out API. Search for things to do, browse upcoming events and movies, explore new restaurant openings, find hotels, and access curated content like Time Out Market recommendations and cultural listings.

**Category:** Entertainment | **Website:** [timeout.com/](https://timeout.com/) | **Docs:** [parse.bot/marketplace/54be0789-55fc-409f-81cb-2e737a983a2b/timeout-com-api](https://parse.bot/marketplace/54be0789-55fc-409f-81cb-2e737a983a2b/timeout-com-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-timeout-com-api-54be0789/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_article_detail

Returns full content of an article including title, author, publish date, description, and embedded venue items.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `url` | string | Yes | Full URL of the article on timeout.com. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-timeout-com-api-54be0789/get_article_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"<string>"}'
```

### get_attractions

Returns attractions and points of interest for a city. Confirmed working for london and newyork; some cities may return empty listings.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `city` | string | No | City slug identifying which city to retrieve attractions for. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-timeout-com-api-54be0789/get_attractions \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"city":"<string>"}'
```

### get_cities

Returns the curated list of 10 major cities covered by Time Out with their slugs and URLs. The site covers additional cities beyond this list.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-timeout-com-api-54be0789/get_cities \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_city_guide_articles

Returns editorial travel articles from a city guide including day trips, walks, and accommodation recommendations.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `city` | string | No | City slug identifying which city to retrieve guide articles for. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-timeout-com-api-54be0789/get_city_guide_articles \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"city":"<string>"}'
```

### get_city_homepage

Returns featured content and articles for a city homepage including promoted deals, editorial picks, and featured articles.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `city` | string | No | City slug identifying which city's homepage to retrieve. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-timeout-com-api-54be0789/get_city_homepage \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"city":"<string>"}'
```

### get_culture_events

Returns culture and theater event listings including shows, comedy, and dance. Coverage is strongest for london.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `city` | string | No | City slug identifying which city to retrieve culture events for. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-timeout-com-api-54be0789/get_culture_events \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"city":"<string>"}'
```

### get_event_detail

Returns full details for a single event or venue page including name, description, address, and images. The URL must point to a valid timeout.com page.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `url` | string | Yes | Full URL of the event or venue page on timeout.com. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-timeout-com-api-54be0789/get_event_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"<string>"}'
```

### get_events

Returns event listings for a specific city sourced from the things-to-do section. Content coverage varies by city.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `city` | string | No | City slug identifying which city to retrieve events for. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-timeout-com-api-54be0789/get_events \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"city":"<string>"}'
```

### get_food_and_drink

Returns food and drink category articles and listings including restaurant reviews, deals, and editorial picks.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `city` | string | No | City slug identifying which city to retrieve food and drink listings for. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-timeout-com-api-54be0789/get_food_and_drink \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"city":"<string>"}'
```

### get_hotels

Returns hotel recommendations for a city. Confirmed working for london and newyork.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `city` | string | No | City slug identifying which city to retrieve hotel listings for. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-timeout-com-api-54be0789/get_hotels \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"city":"<string>"}'
```

### get_kids_events

Returns kids and family-friendly event listings. Coverage varies by city; confirmed working for london and chicago.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `city` | string | No | City slug identifying which city to retrieve kids events for. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-timeout-com-api-54be0789/get_kids_events \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"city":"<string>"}'
```

### get_movies

Returns cinema and movie listings including reviews and best-of lists. Confirmed working for london and newyork.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `city` | string | No | City slug identifying which city to retrieve movie listings for. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-timeout-com-api-54be0789/get_movies \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"city":"<string>"}'
```

### get_music_events

Returns live music event listings including gigs, festivals, and music articles.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `city` | string | No | City slug identifying which city to retrieve music events for. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-timeout-com-api-54be0789/get_music_events \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"city":"<string>"}'
```

### get_new_restaurant_openings

Returns information on new restaurant openings. Tries multiple URL patterns to find the best new restaurants article. Confirmed working for london; other cities may return an upstream error.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `city` | string | No | City slug. Confirmed working for london; other cities may not have a dedicated new openings page. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-timeout-com-api-54be0789/get_new_restaurant_openings \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"city":"<string>"}'
```

### get_restaurant_detail

Returns full details for a single restaurant including name, description, address, telephone, and price range when available.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `url` | string | Yes | Full URL of the restaurant page on timeout.com. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-timeout-com-api-54be0789/get_restaurant_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"<string>"}'
```

### get_restaurants

Returns restaurant recommendations for a city including cuisine categories, area guides, and deal promotions.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `city` | string | No | City slug identifying which city to retrieve restaurant listings for. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-timeout-com-api-54be0789/get_restaurants \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"city":"<string>"}'
```

### get_things_to_do

Returns 'Things To Do' listings for a specific city. Content coverage varies by city; some cities may return fewer or no listings.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `city` | string | No | City slug identifying which city to retrieve things to do for. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-timeout-com-api-54be0789/get_things_to_do \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"city":"<string>"}'
```

### get_time_out_market

Returns details about Time Out Market locations worldwide including current and upcoming venues.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-timeout-com-api-54be0789/get_time_out_market \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_whats_on_today

Returns daily updated 'What to Do Today' list for a city. Coverage varies by city; confirmed working for london and chicago.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `city` | string | No | City slug identifying which city to retrieve today's listings for. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-timeout-com-api-54be0789/get_whats_on_today \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"city":"<string>"}'
```

### search

Search across the Time Out site within a city. Returns listings matching the query from the city's content.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `city` | string | No | City slug to search within. |
| `query` | string | Yes | Search query string. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-timeout-com-api-54be0789/search \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"city":"<string>","query":"<string>"}'
```