TicketSea
Find live events worldwide and link each seller's tickets. Some ticket links are affiliate links.
我該用這個嗎
品質與安全性
A
根據工具定義與協定合規性的自動化分析。
上下文成本
~5,786Token（工具定義）
~11.2 KB典型回應大小
顯著的注意力影響（128k 上下文的 4.52%）
這是每次將伺服器的工具載入模型上下文時所消耗的約略 token 數量。數量越高，可用於其他工作的注意力就越少。
安裝
一鍵安裝
將以下內容加入你的 `claude_desktop_config.json` 檔案：
{
"mcpServers": {
"ticketsea": {
"url": "https://ticketsea.com/mcp"
}
}
}遠端端點
https://ticketsea.com/mcpstreamable-http它能做什麼
工具清單
工具（6）
🟢 唯讀🟡 寫入🔴 刪除⚪ 未知
🟢search_catalog(city, from, limit, mode, offset, ...)
Use this when the user names an artist, team, venue or event and you need the matching TicketSea records. Ranked search with prefixes, aliases and labeled one-edit corrections. Artist and venue matches are worldwide; an event radius needs a city ID or a full City, Region, Country label. Results are cached listings, not live inventory, and this is a search by name, not a dated list of events.
輸入結構描述
{
"type": "object",
"properties": {
"city": {
"description": "City the user asked about: a TicketSea city ID or an exact City, Region, Country label. Required for a distance radius.",
"maxLength": 160,
"type": "string"
},
"from": {
"format": "date",
"type": "string"
},
"limit": {
"default": 5,
"maximum": 24,
"minimum": 1,
"type": "integer"
},
"mode": {
"default": "results",
"description": "suggest is a bounded autocomplete preview without pagination; short prefixes match names and aliases. Use results for full context matching and pagination.",
"enum": [
"results",
"suggest"
],
"type": "string"
},
"offset": {
"default": 0,
"maximum": 1000,
"minimum": 0,
"type": "integer"
},
"query": {
"description": "Artist, team, venue or event name, or the start of one.",
"maxLength": 120,
"type": "string"
},
"radius": {
"default": "anywhere",
"description": "Miles around city for event results.",
"enum": [
"75",
"200",
"anywhere"
],
"type": "string"
},
"sale": {
"description": "soon selects events whose public on-sale has not started yet. Give a specific query (an artist or a city name) with it; use radius 200 for local on-sales.",
"enum": [
"all",
"soon"
],
"type": "string"
},
"to": {
"format": "date",
"type": "string"
},
"type": {
"description": "Limit results to one record type.",
"enum": [
"all",
"artist",
"venue",
"event"
],
"type": "string"
}
},
"required": [],
"additionalProperties": false
}輸出結構描述
{
"type": "object",
"properties": {
"correctedQuery": {
"type": [
"string",
"null"
]
},
"groups": {
"items": {
"properties": {
"hasMore": {
"type": "boolean"
},
"items": {
"items": {
"properties": {
"checked": {
"description": "Original event retrieval Unix timestamp, not an inventory check",
"type": "integer"
},
"date": {
"type": "string"
},
"detail": {
"type": "string"
},
"image": {
"type": "string"
},
"kind": {
"type": "string"
},
"name": {
"type": "string"
},
"pricing": {
"description": "Informational published ranges, not current available offers. Prices may change moment to moment and are not guaranteed. Fees and taxes may be additional. When ranges is empty, omit the price line. Never combine primary/resale sellers or currencies.",
"properties": {
"inventoryVerified": {
"const": false,
"type": "boolean"
},
"label": {
"type": "string"
},
"notice": {
"type": "string"
},
"ranges": {
"items": {
"properties": {
"checkedAt": {
"type": "string"
},
"currency": {
"type": "string"
},
"feeInclusion": {
"const": "unknown",
"type": "string"
},
"label": {
"type": "string"
},
"maxMinor": {
"minimum": 1,
"type": "integer"
},
"minMinor": {
"minimum": 1,
"type": "integer"
},
"minorUnit": {
"maximum": 3,
"minimum": 0,
"type": "integer"
},
"provider": {
"type": "string"
},
"sourceType": {
"type": "string"
},
"validUntil": {
"description": "Expiry in Unix milliseconds. Discard at this time even if cached.",
"type": "integer"
}
},
"required": [
"provider",
"sourceType",
"currency",
"minMinor",
"maxMinor",
"minorUnit",
"checkedAt",
"validUntil",
"label",
"feeInclusion"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"label",
"ranges",
"notice",
"inventoryVerified"
],
"type": "object"
},
"slug": {
"type": "string"
},
"url": {
"description": "Relative canonical TicketSea URL",
"type": "string"
}
},
"required": [
"kind",
"slug",
"name",
"url",
"detail"
],
"type": "object"
},
"type": "array"
},
"label": {
"type": "string"
},
"nextOffset": {
"type": [
"integer",
"null"
]
},
"scanLimited": {
"type": "boolean"
},
"type": {
"type": "string"
}
},
"required": [
"type",
"label",
"items",
"hasMore",
"scanLimited"
],
"type": "object"
},
"type": "array"
},
"indexStale": {
"type": "boolean"
},
"indexUpdatedAt": {
"type": "string"
},
"location": {
"type": [
"string",
"null"
]
},
"notice": {
"type": "string"
},
"query": {
"type": "string"
},
"radius": {
"type": [
"number",
"null"
]
}
},
"required": [
"query",
"groups",
"indexUpdatedAt",
"indexStale",
"notice"
]
}🟢search_events(city, country, from, kind, limit, ...)
Use this when the user wants upcoming concerts, sports, theatre or other live events by performer or event name, city, country, category or dates. Returns cached provider listings in date order. Each event has its TicketSea page (url) and, when a fresh exact-event seller link exists, a tickets link to that seller's page. Not live inventory, and nothing is purchased. Use nextOffset to page, and narrow the filters when scanLimited is true.
輸入結構描述
{
"type": "object",
"properties": {
"city": {
"description": "City the user asked about, as an exact city name (case-insensitive), such as Seattle. Location is never inferred.",
"maxLength": 120,
"type": "string"
},
"country": {
"pattern": "^[A-Z]{2}$",
"type": "string"
},
"from": {
"format": "date",
"type": "string"
},
"kind": {
"enum": [
"music",
"sports",
"theatre",
"other"
],
"type": "string"
},
"limit": {
"default": 20,
"maximum": 50,
"minimum": 1,
"type": "integer"
},
"offset": {
"default": 0,
"maximum": 1000,
"minimum": 0,
"type": "integer"
},
"query": {
"description": "Artist, team, event or venue text.",
"maxLength": 120,
"type": "string"
},
"to": {
"format": "date",
"type": "string"
}
},
"required": [],
"additionalProperties": false
}輸出結構描述
{
"type": "object",
"properties": {
"coverage": {
"type": "string"
},
"events": {
"items": {
"properties": {
"city": {
"type": "string"
},
"country": {
"type": "string"
},
"date": {
"description": "Venue-local date; may be blank if unknown.",
"type": "string"
},
"dateTime": {
"description": "Provider absolute start timestamp when supplied.",
"type": [
"string",
"null"
]
},
"inventoryVerified": {
"const": false,
"type": "boolean"
},
"listingUpdatedAt": {
"description": "Original listing retrieval timestamp; not a stock check.",
"type": "string"
},
"localTime": {
"description": "Venue-local time; may be blank if unknown.",
"type": "string"
},
"name": {
"type": "string"
},
"onSale": {
"properties": {
"endAt": {
"type": [
"string",
"null"
]
},
"startAt": {
"type": [
"string",
"null"
]
},
"tbd": {
"type": "boolean"
}
},
"required": [
"startAt",
"endAt",
"tbd"
],
"type": "object"
},
"pricing": {
"description": "Informational published ranges, not current available offers. Prices may change moment to moment and are not guaranteed. Fees and taxes may be additional. When ranges is empty, omit the price line. Never combine primary/resale sellers or currencies.",
"properties": {
"inventoryVerified": {
"const": false,
"type": "boolean"
},
"label": {
"type": "string"
},
"notice": {
"type": "string"
},
"ranges": {
"items": {
"properties": {
"checkedAt": {
"type": "string"
},
"currency": {
"type": "string"
},
"feeInclusion": {
"const": "unknown",
"type": "string"
},
"label": {
"type": "string"
},
"maxMinor": {
"minimum": 1,
"type": "integer"
},
"minMinor": {
"minimum": 1,
"type": "integer"
},
"minorUnit": {
"maximum": 3,
"minimum": 0,
"type": "integer"
},
"provider": {
"type": "string"
},
"sourceType": {
"type": "string"
},
"validUntil": {
"description": "Expiry in Unix milliseconds. Discard at this time even if cached.",
"type": "integer"
}
},
"required": [
"provider",
"sourceType",
"currency",
"minMinor",
"maxMinor",
"minorUnit",
"checkedAt",
"validUntil",
"label",
"feeInclusion"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"label",
"ranges",
"notice",
"inventoryVerified"
],
"type": "object"
},
"publicSaleState": {
"description": "Schedule state, not inventory. registration means restricted registration access, not an open general sale.",
"type": "string"
},
"region": {
"type": "string"
},
"slug": {
"pattern": "^[a-z0-9-]{1,240}$",
"type": "string"
},
"stale": {
"type": "boolean"
},
"status": {
"type": "string"
},
"tickets": {
"description": "The first exact-event seller link for this performance, present only for a fresh, upcoming listing with a known seller page. The link opens the seller's page for this event through ticketsea.com/go/. It is not an availability check, and the event can have other sellers.",
"properties": {
"affiliate": {
"description": "TicketSea may earn a commission from this seller.",
"type": "boolean"
},
"official": {
"type": "boolean"
},
"seller": {
"type": "string"
},
"type": {
"description": "primary or resale.",
"type": "string"
},
"url": {
"format": "uri",
"type": "string"
}
},
"required": [
"url",
"seller",
"type",
"official",
"affiliate"
],
"type": "object"
},
"timezone": {
"description": "Provider timezone; may be blank if unknown. Do not invent one.",
"type": "string"
},
"url": {
"format": "uri",
"type": "string"
},
"venue": {
"type": "string"
}
},
"required": [
"slug",
"url",
"name",
"date",
"dateTime",
"localTime",
"timezone",
"venue",
"city",
"region",
"country",
"status",
"publicSaleState",
"onSale",
"listingUpdatedAt",
"stale",
"inventoryVerified"
],
"type": "object"
},
"maxItems": 50,
"type": "array"
},
"hasMore": {
"type": "boolean"
},
"nextOffset": {
"maximum": 1000,
"minimum": 0,
"type": [
"integer",
"null"
]
},
"notice": {
"type": "string"
},
"scanLimited": {
"type": "boolean"
},
"sources": {
"items": {
"properties": {
"available": {
"type": "boolean"
},
"countrySnapshots": {
"items": {
"properties": {
"country": {
"type": "string"
},
"listingUpdatedAt": {
"type": "string"
},
"stale": {
"type": "boolean"
}
},
"required": [
"country",
"listingUpdatedAt",
"stale"
],
"type": "object"
},
"type": "array"
},
"error": {
"type": "string"
},
"source": {
"type": "string"
}
},
"required": [
"source",
"available"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"events",
"nextOffset",
"hasMore",
"scanLimited",
"sources",
"coverage",
"notice"
]
}🟢get_event(slug)
Use this when you have an event's slug from a search result and need that event's current details: date, local time, venue, sale state, cancellation and any published price range. Returns the newest available snapshot; older details are returned explicitly marked stale.
輸入結構描述
{
"type": "object",
"properties": {
"slug": {
"description": "Exact event slug from a search result; not an artist or venue slug.",
"pattern": "^[a-z0-9-]{1,240}$",
"type": "string"
}
},
"required": [
"slug"
],
"additionalProperties": false
}輸出結構描述
{
"type": "object",
"properties": {
"city": {
"type": "string"
},
"country": {
"type": "string"
},
"date": {
"description": "Venue-local date; may be blank if unknown.",
"type": "string"
},
"dateTime": {
"description": "Provider absolute start timestamp when supplied.",
"type": [
"string",
"null"
]
},
"inventoryVerified": {
"const": false,
"type": "boolean"
},
"listingUpdatedAt": {
"description": "Original listing retrieval timestamp; not a stock check.",
"type": "string"
},
"localTime": {
"description": "Venue-local time; may be blank if unknown.",
"type": "string"
},
"name": {
"type": "string"
},
"notice": {
"type": "string"
},
"onSale": {
"properties": {
"endAt": {
"type": [
"string",
"null"
]
},
"startAt": {
"type": [
"string",
"null"
]
},
"tbd": {
"type": "boolean"
}
},
"required": [
"startAt",
"endAt",
"tbd"
],
"type": "object"
},
"pricing": {
"description": "Informational published ranges, not current available offers. Prices may change moment to moment and are not guaranteed. Fees and taxes may be additional. When ranges is empty, omit the price line. Never combine primary/resale sellers or currencies.",
"properties": {
"inventoryVerified": {
"const": false,
"type": "boolean"
},
"label": {
"type": "string"
},
"notice": {
"type": "string"
},
"ranges": {
"items": {
"properties": {
"checkedAt": {
"type": "string"
},
"currency": {
"type": "string"
},
"feeInclusion": {
"const": "unknown",
"type": "string"
},
"label": {
"type": "string"
},
"maxMinor": {
"minimum": 1,
"type": "integer"
},
"minMinor": {
"minimum": 1,
"type": "integer"
},
"minorUnit": {
"maximum": 3,
"minimum": 0,
"type": "integer"
},
"provider": {
"type": "string"
},
"sourceType": {
"type": "string"
},
"validUntil": {
"description": "Expiry in Unix milliseconds. Discard at this time even if cached.",
"type": "integer"
}
},
"required": [
"provider",
"sourceType",
"currency",
"minMinor",
"maxMinor",
"minorUnit",
"checkedAt",
"validUntil",
"label",
"feeInclusion"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"label",
"ranges",
"notice",
"inventoryVerified"
],
"type": "object"
},
"publicSaleState": {
"description": "Schedule state, not inventory. registration means restricted registration access, not an open general sale.",
"type": "string"
},
"region": {
"type": "string"
},
"slug": {
"pattern": "^[a-z0-9-]{1,240}$",
"type": "string"
},
"stale": {
"type": "boolean"
},
"status": {
"type": "string"
},
"tickets": {
"description": "The first exact-event seller link for this performance, present only for a fresh, upcoming listing with a known seller page. The link opens the seller's page for this event through ticketsea.com/go/. It is not an availability check, and the event can have other sellers.",
"properties": {
"affiliate": {
"description": "TicketSea may earn a commission from this seller.",
"type": "boolean"
},
"official": {
"type": "boolean"
},
"seller": {
"type": "string"
},
"type": {
"description": "primary or resale.",
"type": "string"
},
"url": {
"format": "uri",
"type": "string"
}
},
"required": [
"url",
"seller",
"type",
"official",
"affiliate"
],
"type": "object"
},
"timezone": {
"description": "Provider timezone; may be blank if unknown. Do not invent one.",
"type": "string"
},
"url": {
"format": "uri",
"type": "string"
},
"venue": {
"type": "string"
}
},
"required": [
"slug",
"url",
"name",
"date",
"dateTime",
"localTime",
"timezone",
"venue",
"city",
"region",
"country",
"status",
"publicSaleState",
"onSale",
"listingUpdatedAt",
"stale",
"inventoryVerified",
"notice"
]
}🟢get_ticket_links(slug)
Use this when the user wants to buy or compare tickets for one specific event. Returns the exact-event seller links from a fresh, upcoming snapshot (links), each labeled primary or resale, official and affiliate, and the other sellers the event's TicketSea page offers (otherSellers), such as resale marketplaces, each with a description of what the link is; some are a search for the event rather than its own page. Does not check stock or reserve tickets. Canceled, past and stale events return no links.
輸入結構描述
{
"type": "object",
"properties": {
"slug": {
"description": "Exact event slug from a search result; not an artist or venue slug.",
"pattern": "^[a-z0-9-]{1,240}$",
"type": "string"
}
},
"required": [
"slug"
],
"additionalProperties": false
}輸出結構描述
{
"type": "object",
"properties": {
"city": {
"type": "string"
},
"country": {
"type": "string"
},
"date": {
"description": "Venue-local date; may be blank if unknown.",
"type": "string"
},
"dateTime": {
"description": "Provider absolute start timestamp when supplied.",
"type": [
"string",
"null"
]
},
"handoffAvailable": {
"description": "At least one exact-event seller link exists; this does not mean tickets remain.",
"type": "boolean"
},
"inventoryVerified": {
"const": false,
"type": "boolean"
},
"links": {
"items": {
"properties": {
"affiliate": {
"type": "boolean"
},
"destination": {
"description": "REST only: the seller page the link leads to, for display; may be blank. Link people to url.",
"type": "string"
},
"inventoryVerified": {
"const": false,
"type": "boolean"
},
"official": {
"type": "boolean"
},
"purpose": {
"const": "external_event_checkout",
"type": "string"
},
"seller": {
"type": "string"
},
"type": {
"type": "string"
},
"url": {
"description": "Link to show the person: opens the seller's page for this event through ticketsea.com/go/.",
"format": "uri",
"type": "string"
}
},
"required": [
"url",
"seller",
"type",
"official",
"affiliate",
"purpose",
"inventoryVerified"
],
"type": "object"
},
"type": "array"
},
"listingUpdatedAt": {
"description": "Original listing retrieval timestamp; not a stock check.",
"type": "string"
},
"localTime": {
"description": "Venue-local time; may be blank if unknown.",
"type": "string"
},
"name": {
"type": "string"
},
"notice": {
"type": "string"
},
"onSale": {
"properties": {
"endAt": {
"type": [
"string",
"null"
]
},
"startAt": {
"type": [
"string",
"null"
]
},
"tbd": {
"type": "boolean"
}
},
"required": [
"startAt",
"endAt",
"tbd"
],
"type": "object"
},
"otherSellers": {
"description": "Other sellers the event's TicketSea page offers, such as resale marketplaces and box offices, in page order. detail is the page's own description of the link; some are a search for the event rather than a page for this exact performance. Empty for stale, canceled and past events.",
"items": {
"properties": {
"affiliate": {
"type": "boolean"
},
"detail": {
"type": "string"
},
"inventoryVerified": {
"const": false,
"type": "boolean"
},
"seller": {
"type": "string"
},
"url": {
"format": "uri",
"type": "string"
}
},
"required": [
"url",
"seller",
"detail",
"affiliate",
"inventoryVerified"
],
"type": "object"
},
"type": "array"
},
"pricing": {
"description": "Informational published ranges, not current available offers. Prices may change moment to moment and are not guaranteed. Fees and taxes may be additional. When ranges is empty, omit the price line. Never combine primary/resale sellers or currencies.",
"properties": {
"inventoryVerified": {
"const": false,
"type": "boolean"
},
"label": {
"type": "string"
},
"notice": {
"type": "string"
},
"ranges": {
"items": {
"properties": {
"checkedAt": {
"type": "string"
},
"currency": {
"type": "string"
},
"feeInclusion": {
"const": "unknown",
"type": "string"
},
"label": {
"type": "string"
},
"maxMinor": {
"minimum": 1,
"type": "integer"
},
"minMinor": {
"minimum": 1,
"type": "integer"
},
"minorUnit": {
"maximum": 3,
"minimum": 0,
"type": "integer"
},
"provider": {
"type": "string"
},
"sourceType": {
"type": "string"
},
"validUntil": {
"description": "Expiry in Unix milliseconds. Discard at this time even if cached.",
"type": "integer"
}
},
"required": [
"provider",
"sourceType",
"currency",
"minMinor",
"maxMinor",
"minorUnit",
"checkedAt",
"validUntil",
"label",
"feeInclusion"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"label",
"ranges",
"notice",
"inventoryVerified"
],
"type": "object"
},
"publicSaleState": {
"description": "Schedule state, not inventory. registration means restricted registration access, not an open general sale.",
"type": "string"
},
"region": {
"type": "string"
},
"slug": {
"pattern": "^[a-z0-9-]{1,240}$",
"type": "string"
},
"stale": {
"type": "boolean"
},
"status": {
"type": "string"
},
"tickets": {
"description": "The first exact-event seller link for this performance, present only for a fresh, upcoming listing with a known seller page. The link opens the seller's page for this event through ticketsea.com/go/. It is not an availability check, and the event can have other sellers.",
"properties": {
"affiliate": {
"description": "TicketSea may earn a commission from this seller.",
"type": "boolean"
},
"official": {
"type": "boolean"
},
"seller": {
"type": "string"
},
"type": {
"description": "primary or resale.",
"type": "string"
},
"url": {
"format": "uri",
"type": "string"
}
},
"required": [
"url",
"seller",
"type",
"official",
"affiliate"
],
"type": "object"
},
"timezone": {
"description": "Provider timezone; may be blank if unknown. Do not invent one.",
"type": "string"
},
"url": {
"format": "uri",
"type": "string"
},
"venue": {
"type": "string"
}
},
"required": [
"slug",
"url",
"name",
"date",
"dateTime",
"localTime",
"timezone",
"venue",
"city",
"region",
"country",
"status",
"publicSaleState",
"onSale",
"listingUpdatedAt",
"stale",
"inventoryVerified",
"notice",
"links",
"handoffAvailable"
]
}🟢prepare_event_visit(slug)
Use this when the user is planning a trip to one specific event and wants tickets together with a place to stay, parking or directions. One call returns the latest event details, every seller link for the event, the venue address, suggested stay dates and search links for hotels, parking, directions and things to do. Planning only; nothing is booked or saved. Stale or inactive events have no planning links.
輸入結構描述
{
"type": "object",
"properties": {
"slug": {
"description": "Exact event slug from a search result; not an artist or venue slug.",
"pattern": "^[a-z0-9-]{1,240}$",
"type": "string"
}
},
"required": [
"slug"
],
"additionalProperties": false
}輸出結構描述
{
"type": "object",
"properties": {
"city": {
"type": "string"
},
"country": {
"type": "string"
},
"date": {
"description": "Venue-local date; may be blank if unknown.",
"type": "string"
},
"dateTime": {
"description": "Provider absolute start timestamp when supplied.",
"type": [
"string",
"null"
]
},
"handoffAvailable": {
"description": "At least one exact-event seller link exists; this does not mean tickets remain.",
"type": "boolean"
},
"inventoryVerified": {
"const": false,
"type": "boolean"
},
"links": {
"items": {
"properties": {
"affiliate": {
"type": "boolean"
},
"destination": {
"description": "REST only: the seller page the link leads to, for display; may be blank. Link people to url.",
"type": "string"
},
"inventoryVerified": {
"const": false,
"type": "boolean"
},
"official": {
"type": "boolean"
},
"purpose": {
"const": "external_event_checkout",
"type": "string"
},
"seller": {
"type": "string"
},
"type": {
"type": "string"
},
"url": {
"description": "Link to show the person: opens the seller's page for this event through ticketsea.com/go/.",
"format": "uri",
"type": "string"
}
},
"required": [
"url",
"seller",
"type",
"official",
"affiliate",
"purpose",
"inventoryVerified"
],
"type": "object"
},
"type": "array"
},
"listingUpdatedAt": {
"description": "Original listing retrieval timestamp; not a stock check.",
"type": "string"
},
"localTime": {
"description": "Venue-local time; may be blank if unknown.",
"type": "string"
},
"name": {
"type": "string"
},
"notice": {
"type": "string"
},
"onSale": {
"properties": {
"endAt": {
"type": [
"string",
"null"
]
},
"startAt": {
"type": [
"string",
"null"
]
},
"tbd": {
"type": "boolean"
}
},
"required": [
"startAt",
"endAt",
"tbd"
],
"type": "object"
},
"otherSellers": {
"description": "Other sellers the event's TicketSea page offers, such as resale marketplaces and box offices, in page order. detail is the page's own description of the link; some are a search for the event rather than a page for this exact performance. Empty for stale, canceled and past events.",
"items": {
"properties": {
"affiliate": {
"type": "boolean"
},
"detail": {
"type": "string"
},
"inventoryVerified": {
"const": false,
"type": "boolean"
},
"seller": {
"type": "string"
},
"url": {
"format": "uri",
"type": "string"
}
},
"required": [
"url",
"seller",
"detail",
"affiliate",
"inventoryVerified"
],
"type": "object"
},
"type": "array"
},
"pricing": {
"description": "Informational published ranges, not current available offers. Prices may change moment to moment and are not guaranteed. Fees and taxes may be additional. When ranges is empty, omit the price line. Never combine primary/resale sellers or currencies.",
"properties": {
"inventoryVerified": {
"const": false,
"type": "boolean"
},
"label": {
"type": "string"
},
"notice": {
"type": "string"
},
"ranges": {
"items": {
"properties": {
"checkedAt": {
"type": "string"
},
"currency": {
"type": "string"
},
"feeInclusion": {
"const": "unknown",
"type": "string"
},
"label": {
"type": "string"
},
"maxMinor": {
"minimum": 1,
"type": "integer"
},
"minMinor": {
"minimum": 1,
"type": "integer"
},
"minorUnit": {
"maximum": 3,
"minimum": 0,
"type": "integer"
},
"provider": {
"type": "string"
},
"sourceType": {
"type": "string"
},
"validUntil": {
"description": "Expiry in Unix milliseconds. Discard at this time even if cached.",
"type": "integer"
}
},
"required": [
"provider",
"sourceType",
"currency",
"minMinor",
"maxMinor",
"minorUnit",
"checkedAt",
"validUntil",
"label",
"feeInclusion"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"label",
"ranges",
"notice",
"inventoryVerified"
],
"type": "object"
},
"publicSaleState": {
"description": "Schedule state, not inventory. registration means restricted registration access, not an open general sale.",
"type": "string"
},
"region": {
"type": "string"
},
"slug": {
"pattern": "^[a-z0-9-]{1,240}$",
"type": "string"
},
"stale": {
"type": "boolean"
},
"status": {
"type": "string"
},
"tickets": {
"description": "The first exact-event seller link for this performance, present only for a fresh, upcoming listing with a known seller page. The link opens the seller's page for this event through ticketsea.com/go/. It is not an availability check, and the event can have other sellers.",
"properties": {
"affiliate": {
"description": "TicketSea may earn a commission from this seller.",
"type": "boolean"
},
"official": {
"type": "boolean"
},
"seller": {
"type": "string"
},
"type": {
"description": "primary or resale.",
"type": "string"
},
"url": {
"format": "uri",
"type": "string"
}
},
"required": [
"url",
"seller",
"type",
"official",
"affiliate"
],
"type": "object"
},
"timezone": {
"description": "Provider timezone; may be blank if unknown. Do not invent one.",
"type": "string"
},
"url": {
"format": "uri",
"type": "string"
},
"venue": {
"type": "string"
},
"visit": {
"properties": {
"bookingCreated": {
"const": false,
"type": "boolean"
},
"instructions": {
"type": "string"
},
"planningAvailable": {
"description": "The event snapshot is fresh and upcoming; this does not confirm availability.",
"type": "boolean"
},
"suggestedStay": {
"properties": {
"checkIn": {
"format": "date",
"type": "string"
},
"checkOut": {
"format": "date",
"type": "string"
}
},
"required": [
"checkIn",
"checkOut"
],
"type": [
"object",
"null"
]
},
"travelLinks": {
"items": {
"properties": {
"affiliate": {
"type": "boolean"
},
"detail": {
"type": "string"
},
"title": {
"type": "string"
},
"url": {
"format": "uri",
"type": "string"
}
},
"required": [
"title",
"detail",
"url",
"affiliate"
],
"type": "object"
},
"type": "array"
},
"venueAddress": {
"properties": {
"city": {
"type": "string"
},
"country": {
"type": "string"
},
"name": {
"type": "string"
},
"postalCode": {
"type": "string"
},
"region": {
"type": "string"
},
"street": {
"type": "string"
}
},
"required": [
"name",
"street",
"city",
"region",
"postalCode",
"country"
],
"type": "object"
}
},
"required": [
"planningAvailable",
"venueAddress",
"suggestedStay",
"travelLinks",
"bookingCreated",
"instructions"
],
"type": "object"
}
},
"required": [
"slug",
"url",
"name",
"date",
"dateTime",
"localTime",
"timezone",
"venue",
"city",
"region",
"country",
"status",
"publicSaleState",
"onSale",
"listingUpdatedAt",
"stale",
"inventoryVerified",
"notice",
"links",
"handoffAvailable",
"visit"
]
}🟢get_service_status
Use this when a search fails or returns nothing unexpectedly and you need to know whether TicketSea's listings are current. Returns the latest snapshot time for each country. This is not a seller uptime or booking success measurement.
輸入結構描述
{
"type": "object",
"properties": {},
"required": [],
"additionalProperties": false
}輸出結構描述
{
"type": "object",
"properties": {
"bookingSupported": {
"const": false,
"type": "boolean"
},
"countrySnapshots": {
"items": {
"properties": {
"country": {
"type": "string"
},
"listingUpdatedAt": {
"type": "string"
},
"stale": {
"type": "boolean"
}
},
"required": [
"country",
"listingUpdatedAt",
"stale"
],
"type": "object"
},
"type": "array"
},
"hasRecentSnapshot": {
"type": "boolean"
},
"latestListingUpdatedAt": {
"type": [
"string",
"null"
]
},
"mode": {
"type": "string"
},
"notice": {
"type": "string"
},
"paymentSupported": {
"const": false,
"type": "boolean"
},
"service": {
"type": "string"
}
},
"required": [
"service",
"mode",
"latestListingUpdatedAt",
"hasRecentSnapshot",
"countrySnapshots",
"bookingSupported",
"paymentSupported",
"notice"
]
}社群
證據
近期觀測
已驗證未記錄版本6 個工具