FetchPan API

openapi: 3.1.0
info:
  title: FetchPan API
  version: '2026-11-07'
  description: 'GENERATED FROM DOCUMENTATION by API Evangelist on 2026-11-07: 15 operation(s) read from 6 public documentation page(s) (each operation
    names its page in x-source). This is not the provider''s published contract; FetchPan has published no machine-readable contract that the
    pipeline could find. Engine: local.'
  x-evidence-tiers:
    code-example: 3
    documentation: 12
    pages-with-code: 5
    pages-read: 6
  x-generated-from: documentation
  x-provenance: generated
  x-authored-by: API Evangelist
  x-generated: '2026-11-07'
  x-generator: generate-contract-from-docs.py
  x-engine: local
  x-sources:
  - https://fetchpan.com/developers
  - https://fetchpan.com/llms-full.txt
  - https://fetchpan.com/ja/developers
  - https://fetchpan.com/ko/developers
  - https://fetchpan.com/vi/developers
  - https://fetchpan.com/zh/developers
paths:
  /account:
    get:
      operationId: get_account
      tags:
      - Account
      summary: Balance and recent orders and downloads.
      x-source: https://fetchpan.com/developers
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /hosts:
    get:
      operationId: get_hosts
      tags:
      - Hosts
      summary: Supported sites with live status.
      x-source: https://fetchpan.com/developers
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /jobs:
    post:
      operationId: post_jobs
      tags:
      - Jobs
      summary: Start a job.
      x-source: https://fetchpan.com/developers
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostJobsRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /jobs/{id}:
    get:
      operationId: get_jobs_id
      tags:
      - Jobs
      summary: Job status and offers.
      x-source: https://fetchpan.com/developers
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /jobs/{id}/download:
    post:
      operationId: post_jobs_id_download
      tags:
      - Jobs
      summary: Get the URL.
      x-source: https://fetchpan.com/developers
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostJobsIdDownloadRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /orders:
    post:
      operationId: post_orders
      tags:
      - Orders
      summary: Traffic packs; create a payment page.
      x-source: https://fetchpan.com/developers
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /packages:
    get:
      operationId: get_packages
      tags:
      - Packages
      summary: Traffic packs you can buy.
      x-source: https://fetchpan.com/developers
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /session:
    get:
      operationId: get_session
      tags:
      - Session
      summary: Account, balance and free limits.
      x-source: https://fetchpan.com/developers
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /sites:
    get:
      operationId: get_sites
      tags:
      - Sites
      summary: Supported sites with live status.
      x-source: https://fetchpan.com/developers
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /v1/web:
    get:
      operationId: get_v1_web
      tags:
      - Web
      summary: GET /v1/web
      x-source: https://fetchpan.com/developers
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: 'curl, aria2, a browser, anything). Free downloads: a few files a day, up to 2 GB, speed limited. Fast downloads use traffic
          from your balance. See Free vs Fast for the numbers. Free vs Fast → Prefer plain HTTP? The same token works on the website''s REST API.
          Base URL: https://fetchpan.com/v1/web, header Authorization: Bearer YOUR_TOKEN. POST /jobs Start a job. Body: {"url": "…", "password":
          "…"} G'
  /v1/web/jobs:
    post:
      operationId: post_v1_web_jobs
      tags:
      - Web
      summary: REST flow
      x-source: https://fetchpan.com/llms-full.txt
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostV1WebJobsRequest'
      responses:
        '201':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostV1WebJobsResponse'
      x-evidence:
        kind: documentation
  /v1/web/jobs/{id}:
    get:
      operationId: get_v1_web_jobs_id
      tags:
      - Web
      summary: REST flow
      x-source: https://fetchpan.com/llms-full.txt
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetV1WebJobsIdResponse'
      x-evidence:
        kind: documentation
  /v1/web/jobs/{id}/download:
    post:
      operationId: post_v1_web_jobs_id_download
      tags:
      - Web
      summary: REST flow
      x-source: https://fetchpan.com/llms-full.txt
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostV1WebJobsIdDownloadRequest'
      responses:
        '201':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostV1WebJobsIdDownloadResponse'
      x-evidence:
        kind: documentation
  '/v1/web、ヘッダー：Authorization:':
    get:
      operationId: get_v1_web_Authorization
      tags:
      - Web Authorization
      summary: 'GET /v1/web、ヘッダー：Authorization:'
      x-source: https://fetchpan.com/ja/developers
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: 'curl、aria2、ブラウザなど、方法は問いません）。 無料ダウンロード：1 日に数ファイルまで、最大 2 GB、速度制限あり。高速ダウンロードは残高の通信量を使います。具体的な数値は「無料と高速」をご覧ください。 無料と高速 → HTTP で直接使いたい場合は？
          同じトークンで、ウェブサイトの REST API も使えます。ベース URL：https://fetchpan.com/v1/web、ヘッダー：Authorization: Bearer YOUR_TOKEN POST /jobs ジョブを開始します。ボディ：{"url":
          "…", "password": "…"} GET /jobs/{id} ジョブのステータスとオファー (offers)。 POST /jobs/{id}/download URL を取得します。ボディ：{"tier": "free"} または {"tie'
  /v1/web，请求头:
    get:
      operationId: get_v1_web
      tags:
      - Web
      summary: GET /v1/web，请求头
      x-source: https://fetchpan.com/zh/developers
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: 'curl、aria2、浏览器都行）。 免费下载：每天几个文件，最大 2 GB，限速。极速下载用你余额里的流量。具体数字见“免费与极速”页面。 免费与极速 → 想直接用 HTTP？ 同一个令牌也可以用在网站的 REST API 上。基础地址：https://fetchpan.com/v1/web，请求头
          Authorization: Bearer YOUR_TOKEN。 POST /jobs 开始一个任务。请求体：{"url": "…", "password": "…"} GET /jobs/{id} 任务状态和可选方案。 POST /jobs/{id}/download
          获取地址。请求体：{"tier": "free"} 或 {"tier": "fast"} GET /session 账号、余额和免费额度。 GET /account 余额、最近的订单和下载。 GET /sites, GET'
components:
  schemas:
    PostJobsRequest:
      type: object
      properties:
        url:
          type: string
          description: The link to download.
        password:
          type: string
          description: Password for the link if needed.
      required:
      - url
    PostJobsIdDownloadRequest:
      type: object
      properties:
        tier:
          type: string
          description: Either "free" or "fast".
      required:
      - tier
    PostV1WebJobsRequest:
      type: object
      properties:
        url:
          type: string
          description: The link to download.
      required:
      - url
    PostV1WebJobsResponse:
      type: object
      properties:
        id:
          type: string
          description: Job identifier.
    GetV1WebJobsIdResponse:
      type: object
      properties:
        status:
          type: string
          description: Current status of the job (e.g., pending, succeeded).
        cost:
          type: string
          description: Cost information for a free or fast download.
    PostV1WebJobsIdDownloadRequest:
      type: object
      properties:
        tier:
          type: string
          description: Download tier, either "free" or "fast".
      required:
      - tier
    PostV1WebJobsIdDownloadResponse:
      type: object
      properties:
        url:
          type: string
          description: Direct download URL, valid for 12 hours.
tags:
- name: Account
- name: Hosts
- name: Jobs
- name: Orders
- name: Packages
- name: Session
- name: Sites
- name: Web
- name: Web Authorization