TicketsData API

openapi: 3.1.0
info:
  title: TicketsData API
  version: '2026-10-19'
  description: 'GENERATED FROM DOCUMENTATION by API Evangelist on 2026-10-19: 3 operation(s) read from 7 public documentation page(s) (each operation
    names its page in x-source). This is not the provider''s published contract; TicketsData has published no machine-readable contract that the
    pipeline could find. Engine: local.'
  x-evidence-tiers:
    code-example: 0
    documentation: 3
    pages-with-code: 7
    pages-read: 7
  x-generated-from: documentation
  x-provenance: generated
  x-authored-by: API Evangelist
  x-generated: '2026-10-19'
  x-generator: generate-contract-from-docs.py
  x-engine: local
  x-sources:
  - https://ticketsdata.com/dedicated-api
  - https://ticketsdata.com/docs
  - https://ticketsdata.com/arbitrage
  - https://ticketsdata.com/market-pulse
  - https://ticketsdata.com/event-radar
  - https://ticketsdata.com/ticket-broker-software
  - https://ticketsdata.com/labels
servers:
- url: https://your-space.ticketsdata.com
paths:
  /events:
    get:
      operationId: get_events
      tags:
      - Events
      summary: Performer → event list
      description: Returns all upcoming events for a given performer, artist, venue, promoter, or organizer page URL.
      x-source: https://ticketsdata.com/docs
      parameters:
      - name: username
        in: query
        required: true
        schema:
          type: string
        description: Your TicketsData account email
      - name: password
        in: query
        required: true
        schema:
          type: string
        description: Your TicketsData account password
      - name: platform
        in: query
        required: true
        schema:
          type: string
        description: Platform to search
      - name: performer_url
        in: query
        required: false
        schema:
          type: string
        description: Artist/performer/organizer page URL (required for most platforms)
      - name: venue_url
        in: query
        required: false
        schema:
          type: string
        description: Dice.fm venue or promoter page URL (Dice only)
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetEventsResponse'
      x-evidence:
        kind: documentation
  /fetch:
    get:
      operationId: get_fetch
      tags:
      - Fetch
      summary: GET /fetch
      description: Fetch live ticket price and inventory data for a given marketplace URL or event ID.
      x-source: https://ticketsdata.com/dedicated-api
      parameters:
      - name: url
        in: query
        required: true
        schema:
          type: string
        description: Marketplace link or event ID to fetch.
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /match:
    get:
      operationId: get_match
      tags:
      - Match
      summary: Pro plan+ arbitrage cross-market
      description: Cross‑market intelligence report that matches an event across all platforms and returns arbitrage insights.
      x-source: https://ticketsdata.com/docs
      parameters:
      - name: username
        in: query
        required: true
        schema:
          type: string
        description: Your TicketsData account email
      - name: password
        in: query
        required: true
        schema:
          type: string
        description: Your TicketsData account password
      - name: event_url
        in: query
        required: true
        schema:
          type: string
        description: Full event URL from any supported marketplace
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetMatchResponse'
      x-evidence:
        kind: documentation
components:
  schemas:
    GetEventsResponse:
      type: object
      properties:
        status:
          type: integer
          description: HTTP status code
        body:
          type: object
          description: List of upcoming events for the performer
        response_s:
          type: number
          description: Elapsed seconds
        quota_remaining:
          type: integer
          description: Remaining API credits
    GetMatchResponse:
      type: object
      properties:
        status:
          type: string
          description: success or error
        match_type:
          type: string
          description: probable or exact
        match_confidence:
          type: number
          description: 0–100 confidence score
        match_reason:
          type: array
          description: Signals used to confirm the match
        event_details:
          type: object
          description: Resolved event date and venue
        matches:
          type: object
          description: Map of platform → matched event URL
        fetch_results:
          type: object
          description: Normalized listings and intelligence data
        response_s:
          type: number
          description: Total elapsed seconds
        quota_remaining:
          type: integer
          description: Remaining API credits
        reports_remaining:
          type: integer
          description: Remaining Market Intelligence reports
tags:
- name: Events
- name: Fetch
- name: Match