---
title: "List StubHub events in one category near a location"
method: GET
path: "/stubhub/category-events"
tags: ["StubHub"]
---

# List StubHub events in one category near a location

`GET /stubhub/category-events`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/stubhub/category-events`
- Auth: API key in header `x-api-key`

Lists paginated events in a single StubHub category (a sport league, team, or a top-level vertical -- use stubhub-categories to discover category ids) filtered by location, radius, and date range. A zero count with an empty events list is a valid no-results response.

## Query parameters

- `category_id` integer, required
- `lat` number, required
- `lon` number, required
- `from` string
- `to` string
- `page` integer
- `radius_miles` integer
- `include_parking_passes` boolean

## Headers

- `x-api-key` string, required

## Response `200`

OK

- StubhubCategoryEventsResponseDoc
  - `code` integer
  - `data` StubhubCategoryEventsResponse
    - `category_id` integer
    - `count` integer
    - `events` StubhubCategoryEvent[]
      - `country` string
      - `date` string
      - `day_of_week` string
      - `distance_miles` string
      - `event_id` integer
      - `has_active_listings` boolean
      - `is_date_confirmed` boolean
      - `is_multiday_event` boolean
      - `is_parking_pass` boolean
      - `is_time_confirmed` boolean
      - `name` string
      - `time` string
      - `url` string
      - `venue_city` string
      - `venue_name` string
      - `venue_state` string
    - `fetched_at` string
    - `page` integer
    - `page_size` integer
    - `source_url` string
    - `total_count` integer
  - `msg` string

## Other responses

- `400`: Bad Request
- `503`: Service Unavailable

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/0497899e2016?raw)