semidata-dev Supply Chain Intelligence API

openapi: 3.2.0
info:
  title: SemiData Supply Chain Intelligence API
  version: 1.0.0
  description: Semiconductor supply chain intelligence - export controls, mineral deposits, SEC filings, restricted entities, and trade flows for critical materials. Supports x402 micropayments ($0.005/request USDC on Base) or a free API key (100 req/day). Every response includes a meta block with data source, as_of date, and pagination.
  contact:
    email: chris.cagle@youfirstseo.com
  license:
    name: Commercial
servers:
- url: https://semidata.dev
  description: Production (Cloudflare Workers + D1)
security:
- ApiKeyAuth: []
- X402Payment: []
tags:
- name: Supply Chain Intelligence
paths:
  /v1/signals:
    get:
      operationId: get_regulatory_signals
      summary: Regulatory signals
      description: 'Federal Register regulatory signals on semiconductor-critical materials: export controls, sanctions, import restrictions, and strategic-reserve actions. LLM-structured with importance scoring. Source: US Federal Register (LLM-structured with Claude). As of: rolling - refreshed weekly.'
      tags:
      - Supply Chain Intelligence
      parameters:
      - name: material
        in: query
        description: 'Material name; matched within materials_mentioned, with synonym expansion (e.g. Gallium also matches GaN). Free-text values: Gallium, Germanium, Indium, Silicon, Rare Earth, Cobalt, Lithium, Tellurium, Selenium.'
        schema:
          type: string
      - name: type
        in: query
        description: signal_type to filter by.
        schema:
          type: string
          enum:
          - export_control
          - import_restriction
          - strategic_reserve
          - sanctions
          - supply_disruption
          - designation
          - regulatory_update
      - name: importance
        in: query
        description: strategic_importance level.
        schema:
          type: string
          enum:
          - high
          - medium
          - low
      - name: country
        in: query
        description: Country NAME (full name, e.g. "China", "Russia")  -  matched within countries_affected. Not an ISO code.
        schema:
          type: string
      - name: since
        in: query
        description: ISO date; records published on or after this date.
        schema:
          type: string
          format: date
      - name: sector
        in: query
        description: Filter to a tech vertical. quantum = quantum-relevant records (export controls on qubits, cryogenics, etc.). Omit for all.
        schema:
          type: string
          enum:
          - semiconductor
          - quantum
      - name: q
        in: query
        description: Full-text search across title, abstract, and summary.
        schema:
          type: string
      - name: limit
        in: query
        description: limit
        schema:
          type: integer
          default: 50
          maximum: 200
      - name: offset
        in: query
        description: offset
        schema:
          type: integer
          default: 0
      responses:
        '200':
          description: Regulatory signals with meta (source, as_of, total, pagination) and results[].
        '402':
          description: Payment required (no API key)  -  see x402 paymentRequirements.
        '429':
          description: Free-tier rate limit exceeded.
  /v1/deposits:
    get:
      operationId: get_mineral_deposits
      summary: Mineral deposit records
      description: 'USGS MRDS mineral deposit records for semiconductor-critical materials. 1,233 deposits. NOTE: this is a 2011 historical snapshot - use as_of in the response meta. Source: USGS Mineral Resources Data System (MRDS). As of: 2011 snapshot - MRDS is a static historical dataset, not live production data.'
      tags:
      - Supply Chain Intelligence
      parameters:
      - name: commodity
        in: query
        description: Commodity name with synonym expansion (e.g. Gallium, Lithium, Cobalt).
        schema:
          type: string
      - name: country
        in: query
        description: Country name (exact match), e.g. "United States", "China".
        schema:
          type: string
      - name: state
        in: query
        description: US state filter (exact match).
        schema:
          type: string
      - name: status
        in: query
        description: development_status (exact match).
        schema:
          type: string
          enum:
          - Producer
          - Past Producer
          - Prospect
          - Occurrence
          - Plant
      - name: min_score
        in: query
        description: Minimum semiconductor relevance score (1-10).
        schema:
          type: integer
      - name: active_only
        in: query
        description: Only return active producers/plants.
        schema:
          type: boolean
      - name: q
        in: query
        description: Full-text search (ranked) across site name, commodity, ore controls, and location.
        schema:
          type: string
      - name: limit
        in: query
        description: limit
        schema:
          type: integer
          default: 50
          maximum: 200
      - name: offset
        in: query
        description: offset
        schema:
          type: integer
          default: 0
      responses:
        '200':
          description: Mineral deposit records with meta (source, as_of, total, pagination) and results[].
        '402':
          description: Payment required (no API key)  -  see x402 paymentRequirements.
        '429':
          description: Free-tier rate limit exceeded.
  /v1/edgar:
    get:
      operationId: get_sec_filings
      summary: SEC filings with supply chain signals
      description: 'SEC EDGAR filings processed with an LLM to extract supply chain signals, sentiment, and material mentions. Source: SEC EDGAR (8-K, 10-K, 10-Q; LLM-extracted). As of: rolling - refreshed weekly.'
      tags:
      - Supply Chain Intelligence
      parameters:
      - name: material
        in: query
        description: Material mentioned in filing (synonym-expanded).
        schema:
          type: string
      - name: entity
        in: query
        description: Company / filer name (partial match).
        schema:
          type: string
      - name: form
        in: query
        description: SEC form type.
        schema:
          type: string
          enum:
          - 8-K
          - 10-K
          - 10-Q
      - name: importance
        in: query
        description: strategic_importance level.
        schema:
          type: string
          enum:
          - high
          - medium
          - low
      - name: sentiment
        in: query
        description: Supply chain sentiment.
        schema:
          type: string
          enum:
          - bullish
          - neutral
          - bearish
      - name: since
        in: query
        description: ISO date; filings on or after.
        schema:
          type: string
          format: date
      - name: sector
        in: query
        description: Filter to a tech vertical (quantum = quantum-relevant filings). Omit for all.
        schema:
          type: string
          enum:
          - semiconductor
          - quantum
      - name: q
        in: query
        description: Full-text search (ranked) across entity name, summary, materials, and companies.
        schema:
          type: string
      - name: limit
        in: query
        description: limit
        schema:
          type: integer
          default: 50
          maximum: 200
      - name: offset
        in: query
        description: offset
        schema:
          type: integer
          default: 0
      responses:
        '200':
          description: SEC filings with supply chain signals with meta (source, as_of, total, pagination) and results[].
        '402':
          description: Payment required (no API key)  -  see x402 paymentRequirements.
        '429':
          description: Free-tier rate limit exceeded.
  /v1/entities:
    get:
      operationId: get_restricted_entities
      summary: Restricted entity screening
      description: 'US Consolidated Screening List. Use for supplier / counterparty due diligence against export-control and sanctions lists. Source: US Consolidated Screening List (BIS Entity List, OFAC SDN, MEU, CMIC, DPL). As of: rolling - refreshed weekly.'
      tags:
      - Supply Chain Intelligence
      parameters:
      - name: name
        in: query
        description: Entity name or alias (partial match).
        schema:
          type: string
      - name: country
        in: query
        description: ISO-2 country code (e.g. CN, RU, IR).
        schema:
          type: string
      - name: list_name
        in: query
        description: Source list fragment, e.g. "Entity List", "SDN", "Military End User".
        schema:
          type: string
      - name: q
        in: query
        description: Full-text search across name, aliases, and addresses.
        schema:
          type: string
      - name: limit
        in: query
        description: limit
        schema:
          type: integer
          default: 50
          maximum: 200
      - name: offset
        in: query
        description: offset
        schema:
          type: integer
          default: 0
      responses:
        '200':
          description: Restricted entity screening with meta (source, as_of, total, pagination) and results[].
        '402':
          description: Payment required (no API key)  -  see x402 paymentRequirements.
        '429':
          description: Free-tier rate limit exceeded.
  /v1/tradeflows:
    get:
      operationId: get_trade_flows
      summary: Trade flow volumes
      description: 'UN Comtrade annual export volumes by country and HS code for semiconductor-critical materials. Source: UN Comtrade (annual). As of: public Comtrade data lags 2-3 years - see period / data_year in the response.'
      tags:
      - Supply Chain Intelligence
      parameters:
      - name: material
        in: query
        description: Material name (synonym-expanded), e.g. Gallium, Cobalt, Lithium.
        schema:
          type: string
      - name: reporter
        in: query
        description: Exporting country name (partial match), e.g. China, Chile, Germany.
        schema:
          type: string
      - name: hs_code
        in: query
        description: HS-6 commodity code, e.g. 280491 for gallium.
        schema:
          type: string
      - name: period
        in: query
        description: Year, e.g. "2022".
        schema:
          type: string
      - name: min_value
        in: query
        description: Minimum trade value in USD.
        schema:
          type: number
      - name: limit
        in: query
        description: limit
        schema:
          type: integer
          default: 100
          maximum: 500
      - name: offset
        in: query
        description: offset
        schema:
          type: integer
          default: 0
      responses:
        '200':
          description: Trade flow volumes with meta (source, as_of, total, pagination) and results[].
        '402':
          description: Payment required (no API key)  -  see x402 paymentRequirements.
        '429':
          description: Free-tier rate limit exceeded.
  /v1/funding:
    get:
      operationId: get_quantum_funding
      summary: Federal quantum R&D funding
      description: 'US federal contracts and grants for quantum technology (DOE, NSF, DARPA/DoD, and others), from USAspending.gov. Shows which organizations receive quantum-related federal money, how much, and from which agency. Use to track the quantum supply chain and policy push downstream of the 2026 quantum executive orders. Source: USAspending.gov (US Treasury) - federal awards. As of: rolling - refreshed monthly.'
      tags:
      - Supply Chain Intelligence
      parameters:
      - name: recipient
        in: query
        description: Recipient/organization name (partial match), e.g. IonQ, Rigetti, a university.
        schema:
          type: string
      - name: agency
        in: query
        description: Awarding agency or sub-agency (partial match), e.g. Energy, NSF, Defense, DARPA.
        schema:
          type: string
      - name: award_type
        in: query
        description: Award type.
        schema:
          type: string
          enum:
          - contract
          - grant
      - name: year
        in: query
        description: Fiscal/action year, e.g. "2025".
        schema:
          type: string
      - name: since
        in: query
        description: ISO date; awards on or after this action date.
        schema:
          type: string
          format: date
      - name: min_amount
        in: query
        description: Minimum award amount in USD.
        schema:
          type: number
      - name: q
        in: query
        description: Full-text search (ranked) across recipient, description, and agency.
        schema:
          type: string
      - name: limit
        in: query
        description: limit
        schema:
          type: integer
          default: 50
          maximum: 200
      - name: offset
        in: query
        description: offset
        schema:
          type: integer
          default: 0
      responses:
        '200':
          description: Federal quantum R&D funding with meta (source, as_of, total, pagination) and results[].
        '402':
          description: Payment required (no API key)  -  see x402 paymentRequirements.
        '429':
          description: Free-tier rate limit exceeded.
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key
      description: 'Free tier: 100 req/day. Request at semidata.dev'
    X402Payment:
      type: apiKey
      in: header
      name: X-Payment
      description: x402 micropayment  -  $0.005 USDC on Base mainnet. No signup.