{
  "schema_version": "tw-procurement-ai-offer-v1",
  "product_id": "tw_procurement_supplier_signals",
  "title": "Taiwan Procurement & Supplier Signals API",
  "service_name": "Taiwan Supplier & Tender Intelligence",
  "buyer_summary": "Official-source Taiwan public procurement notices and awards packaged for market research, supplier activity discovery, tender monitoring, and AI-agent buyer workflows.",
  "primary_buyer_jobs": [
    "Find companies already active in Taiwan public-sector procurement.",
    "Identify incumbent suppliers and agencies around a Taiwan market segment.",
    "Validate whether a Taiwan supplier or sector is worth deeper paid research.",
    "Give AI assistants structured supplier candidates with lineage and limitations."
  ],
  "coverage_snapshot": {
    "notices_loaded": 32998,
    "awards_loaded": 26724,
    "total_loaded_rows": 59722,
    "earliest_loaded_record_date": "2017-05-23",
    "loaded_through_note": "Currently loaded Supabase rows from selected Public Construction Commission open-data files; not a full-market procurement registry.",
    "updated_at": "2026-07-08T00:00:00.000Z"
  },
  "source_trust": {
    "provider": "Public Construction Commission, Taiwan",
    "source_type": "official public open data",
    "source_language": "zh-Hant",
    "source_note": "Original Chinese source fields are preserved for audit use; English summaries are buyer-facing interpretations, not certified translations."
  },
  "language_strategy": {
    "source_language": "zh-Hant",
    "buyer_language": "en",
    "original_fields_preserved": true,
    "english_query_supported": true,
    "query_examples": [
      "IT services",
      "software",
      "AI",
      "construction",
      "medical",
      "education"
    ],
    "translation_note": "English summaries are template-based buyer-facing interpretations of structured source fields; they are not certified translations."
  },
  "free_validation": {
    "preview_url": "https://api.sourcestrand.com/v1/preview/tw-procurement/agent-research?q=IT%20services",
    "sample_url": "https://api.sourcestrand.com/samples/tw-procurement-supplier-signal.json",
    "expected_preview_shape": [
      "agent_summary",
      "supplier_candidates",
      "sample_records",
      "paid_unlock",
      "data_lineage",
      "limitations"
    ]
  },
  "paid_endpoints": [
    {
      "method": "GET",
      "url_template": "https://api.sourcestrand.com/v1/paid/tw-procurement/agent-research?q={keyword}",
      "price": "$0.01",
      "best_first_paid_step": true
    },
    {
      "method": "GET",
      "url_template": "https://api.sourcestrand.com/v1/paid/tw-procurement/tender-search?q={keyword}",
      "price": "$0.03"
    },
    {
      "method": "GET",
      "url_template": "https://api.sourcestrand.com/v1/paid/tw-procurement/company-activity?business_id={business_id}",
      "price": "$0.05"
    },
    {
      "method": "GET",
      "url_template": "https://api.sourcestrand.com/v1/paid/tw-procurement/supplier-pack?business_id={business_id}",
      "price": "$0.25"
    }
  ],
  "purchase_rationale": {
    "buyer_question": "Which companies, agencies, tenders, and incumbent suppliers show observable Taiwan public-sector procurement activity?",
    "why_pay_now": [
      "$0.01 is a low-friction paid validation step after the free preview.",
      "The paid agent package returns more rows and more supplier candidates than the free preview.",
      "Responses preserve official-source lineage, limitations, retrieval timestamps, and hashes for downstream audit.",
      "English buyer summaries and English query expansion reduce the translation burden for global market research workflows."
    ],
    "best_fit_buyers": [
      "International market research teams studying Taiwan public-sector demand.",
      "B2B sales teams looking for Taiwan accounts with observed government procurement activity.",
      "AI assistants that need structured supplier candidates, paid unlock metadata, and copy-ready handoff fields."
    ],
    "not_for": [
      "Supplier recommendations or procurement advice.",
      "Credit scoring, legal clearance, or investment advice.",
      "A complete guarantee that no other Taiwan public procurement activity exists."
    ],
    "paid_response_delta": {
      "preview_limit": 10,
      "preview_sample_records": 3,
      "preview_supplier_candidates": 3,
      "paid_agent_research_limit": 20,
      "paid_sample_records": 10,
      "paid_supplier_candidates": 10,
      "paid_adds": [
        "More matched tender and award rows for the same buyer query.",
        "More sample records for evidence review before deeper company activity or supplier-pack calls.",
        "More supplier candidate groups surfaced from award rows.",
        "agent_handoff metadata for buyer agents to preserve lineage, limitations, retrieved_at, and source_hash."
      ],
      "upgrade_path": [
        {
          "endpoint": "/v1/paid/tw-procurement/agent-research?q=",
          "price": "$0.01",
          "when_to_use": "First paid step after preview when an AI agent or analyst needs a structured research package."
        },
        {
          "endpoint": "/v1/paid/tw-procurement/tender-search?q=",
          "price": "$0.03",
          "when_to_use": "Use for broader keyword, agency, supplier, case name, or case number discovery."
        },
        {
          "endpoint": "/v1/paid/tw-procurement/company-activity?business_id=",
          "price": "$0.05",
          "when_to_use": "Use when a Taiwan business_id is available and the buyer wants company-level activity."
        },
        {
          "endpoint": "/v1/paid/tw-procurement/supplier-pack?business_id=",
          "price": "$0.25",
          "when_to_use": "Use after a target supplier is selected and a richer activity pack is worth requesting."
        }
      ]
    },
    "recommended_paid_call": {
      "endpoint": "/v1/paid/tw-procurement/agent-research?q=IT%20services",
      "price": "$0.01",
      "buyer_hint_header": "x-buyer-hint: partner-or-campaign-name"
    }
  },
  "x402_purchase": {
    "protocol": "x402",
    "buyer_hint_header": "x-buyer-hint: partner-or-campaign-name",
    "payment_header_behavior": "Paid routes return HTTP 402 with PAYMENT-REQUIRED and machine-readable x402 accepts when no valid payment header is provided.",
    "safety_note": "The buyer client signs locally. Do not send wallet private keys to this API."
  },
  "advice_boundary": "Factual public procurement discovery only; not procurement advice, supplier recommendation, legal advice, credit scoring, investment advice, or a risk clearance."
}