specification: API Commons Plans
specificationVersion: '0.1'
schema: https://raw.githubusercontent.com/api-evangelist/interface-research/main/schema/api-commons.yml#/$defs/Plans
provider: API-Sports
providerId: api-sports
created: '2026-05-04'
# Provenance stamped 2026-08-11: this artifact was written by the API Evangelist
# bulk sweep dated 2026-05-04, not harvested from the provider. See roadmap#35.
method: generated
# 2026-09-02 enrichment pass: this file is STILL the 2026-05-04 bulk-sweep scaffold.
# Its tier names, quotas and prices were never harvested from API-Sports and must not
# be read as published values. The real plans live at
# https://www.api-football.com/pricing, which answered HTTP 403 from a Cloudflare
# bot-management challenge ("Just a moment...") to every automated fetch on
# 2026-09-02 — browser, Googlebot and plain User-Agents alike — even though the same
# host's robots.txt is "Allow: /" with Content-Signal ai-input=yes. No apis.yml
# type: Plans pointer is emitted while this file holds scaffold numbers, so the
# scaffold is not scored as if API-Sports had published it.
modified: '2026-05-04'
tags:
  - Baseball
  - Basketball
  - Cricket
  - Football
  - Ice Hockey
  - MMA
  - Real-Time
  - Rugby
  - Sports Data
  - Statistics
  - Tennis
description: Machine-readable plans and pricing scaffold for this API provider. Conforms to the API Commons
  Plans schema. Tier limits and prices are scaffold defaults; replace with provider-published values.
plans:
  - id: api-sports-free
    name: Free
    type: freemium
    description: Free entry tier for the API-Sports API surface. Intended for evaluation, prototyping,
      and low-volume integrations. Real limits and pricing must be reconciled with the provider's published
      plan documentation.
    entries:
      - label: API Requests
        description: Monthly API request quota across all included endpoints
        name: api_requests
        type: quota
        metric: requests
        limit: 1000
        timeFrame: month
        geo: global
        domains: []
        unit: 1
        price: '0.00'
        userMultiplied: false
      - label: Rate Limit
        description: Maximum requests per minute on the free tier
        name: rate_limit
        type: rate
        metric: requests_per_minute
        limit: 10
        timeFrame: minute
        geo: global
        domains: []
        unit: 1
        price: '0.00'
        userMultiplied: false
    elements:
      - name: Public Documentation
      - name: Community Support
      - name: Sandbox Access
      - name: API-Football
      - name: API-Basketball
      - name: API-Baseball
      - name: API-Tennis
  - id: api-sports-pro
    name: Professional
    type: paid
    description: Production tier for API-Sports. Provides higher quotas, priority support, and access
      to the broader API portfolio. Pricing placeholder; align with the provider's pricing page.
    entries:
      - label: API Requests
        description: Monthly API request quota
        name: api_requests
        type: quota
        metric: requests
        limit: 100000
        timeFrame: month
        geo: global
        domains: []
        unit: 1
        price: TBD
        userMultiplied: false
      - label: Rate Limit
        description: Maximum requests per minute on the professional tier
        name: rate_limit
        type: rate
        metric: requests_per_minute
        limit: 100
        timeFrame: minute
        geo: global
        domains: []
        unit: 1
        price: '0.00'
        userMultiplied: false
      - label: Overage
        description: Per-request price after monthly quota is exceeded
        name: overage
        type: metered
        metric: requests
        limit: -1
        timeFrame: month
        geo: global
        domains: []
        unit: 1000
        price: TBD
        userMultiplied: false
    elements:
      - name: All Production Endpoints
      - name: Email Support
      - name: SLA Targets
      - name: Webhook Subscriptions
      - name: API-Football
      - name: API-Basketball
      - name: API-Baseball
      - name: API-Tennis
  - id: api-sports-enterprise
    name: Enterprise
    type: enterprise
    description: Custom-negotiated tier for API-Sports. Includes dedicated capacity, contractual SLAs,
      security review, data residency options, and named technical account management.
    entries:
      - label: API Requests
        description: Negotiated request volume; -1 indicates uncapped subject to fair use
        name: api_requests
        type: quota
        metric: requests
        limit: -1
        timeFrame: month
        geo: configurable
        domains: []
        unit: 1
        price: custom
        userMultiplied: false
      - label: Rate Limit
        description: Negotiated burst and steady-state rate
        name: rate_limit
        type: rate
        metric: requests_per_minute
        limit: 1000
        timeFrame: minute
        geo: configurable
        domains: []
        unit: 1
        price: custom
        userMultiplied: false
    elements:
      - name: Unlimited / Negotiated Volume
      - name: 24/7 Dedicated Support
      - name: Contractual SLA
      - name: Security & Compliance Review
      - name: Dedicated Account Manager
      - name: Custom Data Residency
      - name: API-Football
      - name: API-Basketball
      - name: API-Baseball
      - name: API-Tennis
maintainers:
  - FN: Kin Lane
    email: info@apievangelist.com
x-canonical:
  generated: '2026-10-08'
  vocabulary: all/0-working/economics/plans-canonical.yml
  models:
  - free
  - metered
  units:
  - rate
  - request
  plans:
  - name: Free
    access: freemium
    model: free
    model_how: derived
    units:
    - rate
    - request
    periods:
    - minute
    - month
  - name: Professional
    access: paid
    model: metered
    model_how: derived
    units:
    - rate
    - request
    periods:
    - minute
    - month
  - name: Enterprise
    access: enterprise
    model: free
    model_how: derived
    units:
    - rate
    - request
    periods:
    - minute
    - month