TicketSea
Find live events worldwide and link each seller's tickets. Some ticket links are affiliate links.
사용해야 할까요
품질 및 안전성
A
도구 정의와 프로토콜 준수에 대한 자동 분석을 기반으로 합니다.
컨텍스트 비용
~5,786토큰 (도구 정의)
~11.2 KB일반적인 응답 크기
상당한 주의 영향 (128k 컨텍스트의 4.52%)
이는 서버의 도구가 모델의 컨텍스트에 로드될 때마다 소비되는 대략적인 토큰 수입니다. 수치가 높을수록 다른 작업에 사용할 수 있는 주의가 줄어듭니다.
설치
원클릭 설치
`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개