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

> Access data from songkick.com.

**Category:** Entertainment | **Website:** [www.songkick.com/](https://www.songkick.com/) | **Docs:** [parse.bot/marketplace/691816d5-5dd1-4d4a-bf06-8cc541060b5c/songkick-com-api](https://parse.bot/marketplace/691816d5-5dd1-4d4a-bf06-8cc541060b5c/songkick-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-songkick-com-api-691816d5/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_city_events

Retrieve paginated upcoming events for a city. Resolves the city name via search to its Songkick metro area, then returns up to 50 events per page with venue, lineup, ticket info, and status. Event IDs from results can be passed to get_event_details for full detail. Two upstream requests per call (city lookup + events page). When min_date is supplied, only events starting on or after that date are included in the response.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `city` | string | Yes | City name to search for (e.g. "New York", "London", "Edinburgh"). Resolves to the top matching Songkick metro area. |
| `min_date` | string | No | ISO date (YYYY-MM-DD) to filter events. Only events starting on or after this date are returned. |
| `page` | integer | No | Page number for pagination (50 events per page). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-songkick-com-api-691816d5/get_city_events \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"city":"<string>","min_date":"<string>","page":"<integer>"}'
```

### get_event_details

Retrieve full details for a single concert or event by its numeric Songkick event ID. Returns venue address and coordinates, performer lineup with billing, ticket pricing, and ticket provider links. Event IDs are obtained from search_concerts results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `event_id` | string | Yes | Numeric Songkick event ID (e.g. from search_concerts results). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-songkick-com-api-691816d5/get_event_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"event_id":"<string>"}'
```

### search_concerts

Full-text search across Songkick's catalog of artists, upcoming events, venues, and cities. Returns categorized results ranked by relevance. Use event IDs from results to fetch full details via get_event_details.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search term — artist name, city name, venue name, or event name. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-songkick-com-api-691816d5/search_concerts \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```