Search events, view seatmaps, browse listings, and get browser checkout links on TixBit — from the terminal, your code, or an AI agent.
No API key required.
# Use instantly with npx (no install)
npx tixbit search "Hawks" --state GA
# Or install globally
npm install -g tixbit
tixbit search "Hawks" --state GA
# Or add to a project
npm install tixbittixbit search "Taylor Swift"
tixbit search "Hawks" --state GA --size 5
tixbit search --city "New York" --category nba-basketball
tixbit search --league NBA --parking excludetixbit browse --city Atlanta --state GA
tixbit browse --lat 33.749 --lng -84.388 --category CONCERTtixbit listings <event-id>
tixbit listings <event-id> --size 5 --sort asc# Get a checkout link for a listing
tixbit checkout <listing-id> --quantity 2This command only creates a https://www.tixbit.com/checkout/process link. The buyer opens it in a browser, signs in, reviews the order, and completes payment on TixBit.
tixbit seatmap <event-id>
tixbit seatmap <event-id> --section <section-name>Every command supports --json for machine-readable output:
Event IDs are normalized to public external IDs; provider prefixes are stripped from SDK/CLI results.
tixbit search "concert" --state NY --json
tixbit listings <event-id> --json
tixbit seatmap <event-id> --json
tixbit checkout <listing-id> --quantity 2 --json| Command | Description |
|---|---|
search [query] |
Search events by keyword, city, state, category, or date |
browse |
Browse upcoming events near a location |
listings <eventId> |
Get available ticket listings for an event |
checkout <listingId> |
Get a checkout link to buy tickets |
seatmap <eventId> |
Show the venue seating chart with all sections |
url <slug> |
Print the TixBit event page URL |
Use the client programmatically in a supported Node.js project:
import { TixBitClient } from "tixbit";
const tixbit = new TixBitClient();
// Search events
const { events } = await tixbit.searchEvents({
query: "Hawks",
state: "GA",
size: 5,
});
const event = events[0];
if (!event) throw new Error("No matching events");
// Get public event detail
const detail = await tixbit.getEvent(event.external_event_id);
// Get listings
const { listings } = await tixbit.getListings({
eventId: event.external_event_id,
});
const listing = listings[0];
if (!listing) throw new Error("No available listings");
// Get current public details for one listing
const listingDetail = await tixbit.getListing(listing.id);
// Create a checkout link
const checkout = tixbit.createCheckoutLink({
listingId: listingDetail.listing.id,
quantity: 2,
});
console.log(checkout.url);
// Open this TixBit URL in a browser to complete checkout.
// View seatmap
const seatmap = await tixbit.getSeatmap({
eventId: event.external_event_id,
});
console.log(seatmap.venue_name); // "State Farm Arena"
console.log(seatmap.section_names); // ["101", "102", ...]
// Browse nearby
const nearby = await tixbit.browse({
city: "Atlanta",
state: "GA",
});
// Event URL
const url = tixbit.eventUrl(event.external_event_id);| Option | Type | Default |
|---|---|---|
baseUrl |
string |
https://www.tixbit.com |
timeoutMs |
number |
15000 |
Public buyer discovery requires no API key.
| Param | Type | Description |
|---|---|---|
query |
string |
Free-text search |
city |
string |
City name |
state |
string |
2-letter state code |
category |
string |
Category slug (e.g. nba-basketball) |
league |
string |
League abbreviation |
categoryEventType |
string |
SPORT, CONCERT, THEATER, or ALL |
performerId |
string |
Public performer ID |
venueId |
string |
Public venue ID |
parkingFilter |
string |
exclude, only, or include |
nearLat / nearLng |
number |
Coordinates for manual location filtering |
locationMode |
string |
inferred, manual, or none |
startDate |
string |
ISO date — events on/after |
endDate |
string |
ISO date — events on/before |
page |
number |
Page number (default: 1) |
size |
number |
Results per page, max 200 (default: 25) |
The result includes normalized events plus page, size, nullable total/totalPages, hasNext, hasPrev, and totalExact pagination metadata.
Returns the sanitized public event detail for an external event ID or event slug.
| Param | Type | Description |
|---|---|---|
city |
string |
Preferred city |
state |
string |
Preferred state |
latitude |
number |
Latitude |
longitude |
number |
Longitude |
categoryEventType |
string |
SPORT, CONCERT, THEATER, or ALL |
page |
number |
Page number (default: 1) |
size |
number |
Number of results (default: 18) |
query |
string |
Optional free-text query |
category |
string |
Category slug |
league |
string |
League abbreviation |
context |
string |
homepage, events, or category |
recommendation |
string |
upcoming or trending |
parkingFilter |
string |
exclude, only, or include |
The result preserves the public browse endpoint's total, totalExact, hasMore, page, pageSize, and optional degraded metadata.
| Param | Type | Description |
|---|---|---|
eventId |
string |
External event ID |
size |
number |
Page size, max 100 (default: 50) |
page |
number |
Page number (default: 1) |
orderByDirection |
string |
asc or desc by price |
includeAll |
boolean |
Request all available listings |
refresh |
boolean |
Bypass cached listings for this request |
The result includes cache state, freshness, expiry, and pagination metadata when returned by the public endpoint.
Returns one sanitized public listing and any public disclosures for it.
Create a checkout URL for a listing. The user opens this in a browser to review and complete the purchase on TixBit. This SDK does not expose a purchase endpoint.
| Param | Type | Description |
|---|---|---|
listingId |
string |
Listing ID to purchase |
quantity |
number |
Number of tickets (1–8) |
Returns { url, listingId, quantity }.
| Param | Type | Description |
|---|---|---|
eventId |
string |
External event ID |
Returns venue info, section list, zone groupings, first-party asset URLs (background_image, coordinates_url), and per-section shape_path data for overlay rendering.
Returns the full URL to the event page on www.tixbit.com.
| Variable | Description | Default |
|---|---|---|
TIXBIT_BASE_URL |
Override the TixBit URL | https://www.tixbit.com |
- Runtime/tooling range: Node.js
^20.19.0 || >=22.12.0 - CI compatibility matrix: Node.js 20.19, 22, 24, and 26
Node.js 20 is end-of-life and remains in CI only as a compatibility floor. Node.js 22 and 24 are LTS releases; Node.js 26 is the current release line.