{
  "schema_version": "sourcestrand-product-offer-v1",
  "product_id": "tw_trade_import_export_pack",
  "title": "Taiwan Trade Import/Export Buyer Pack",
  "service_name": "Taiwan Trade Import Export Buyer Pack",
  "buyer_summary": "Which Taiwan importer/exporter, customs, and HS-country trade streams help a buyer or AI assistant identify cross-border supplier leads and product-category demand context?",
  "canonical_base_url": "https://api.sourcestrand.com",
  "primary_buyer_jobs": [
    "Global sourcing teams looking for Taiwan exporter or importer context before supplier outreach.",
    "AI agents matching product categories or HS groups to Taiwan trade and company follow-up streams.",
    "Market-entry analysts who need trade momentum context before a procurement or company lookup."
  ],
  "free_validation": {
    "preview_url": "https://api.sourcestrand.com/v1/preview/tw-data-packs/trade-import-export",
    "expected_preview_shape": [
      "product",
      "package_scope",
      "streams",
      "sample_records",
      "concrete_sample_records",
      "record_backed_pack",
      "agent_specific_contracts",
      "entity_linking_contract",
      "change_feed_preview",
      "supplier_candidate_workflow",
      "stream_readiness",
      "coverage_summary",
      "freshness_policy",
      "agent_cache",
      "buyer_action_pack",
      "paid_unlock",
      "data_lineage",
      "limitations"
    ],
    "agent_tools_url": "https://api.sourcestrand.com/agent-tools.json",
    "route_intent_url_template": "https://api.sourcestrand.com/v1/agent/route-intent?query={buyer_question}",
    "change_feed_preview_url": "https://api.sourcestrand.com/v1/preview/changes/tw-data-packs?pack=trade-import-export&since={iso_datetime}",
    "dossier_preview_url": "https://api.sourcestrand.com/v1/preview/tw-company/dossier?query={business_id_or_name}"
  },
  "agent_purchase_hint": {
    "recommended_base_url": "https://api.sourcestrand.com",
    "recommended_network": "eip155:8453",
    "buyer_hint_header": "x-buyer-hint: partner-or-campaign-name",
    "pay_when": [
      "The free preview matches the buyer task and the agent needs the complete record-backed buyer pack.",
      "The buyer wants to decide which Taiwan official-source streams should become the next paid data package.",
      "The buyer wants supplier candidates, sample record shapes, top fields, and next endpoint paths in one agent handoff.",
      "The response will be used to brief a human analyst or agent workflow with lineage and limitations preserved."
    ],
    "do_not_pay_when": [
      "A complete customs transaction download.",
      "Supplier ranking, sanctions screening, or trade compliance clearance.",
      "Legal, tax, accounting, investment, procurement, or customs advice."
    ]
  },
  "paid_endpoints": [
    {
      "method": "GET",
      "url_template": "https://api.sourcestrand.com/v1/paid/tw-data-packs/trade-import-export",
      "price": "$0.03",
      "best_first_paid_step": true
    }
  ],
  "deeper_packs": [
    {
      "pack_id": "tw_procurement_supplier_lead_pack",
      "endpoint_template": "https://api.sourcestrand.com/v1/paid/tw-procurement/supplier-lead-pack?q={keyword}",
      "use_when": "The buyer has a product category, supplier keyword, or target sector and wants tender/award-backed supplier candidates."
    },
    {
      "pack_id": "tw_company_brief",
      "endpoint_template": "https://api.sourcestrand.com/v1/paid/tw-company/brief?business_id={business_id}",
      "use_when": "The buyer has a business_id from importer/exporter or public-company context and needs company-level enrichment."
    },
    {
      "pack_id": "tw_supplier_discovery_pack",
      "endpoint_template": "https://api.sourcestrand.com/v1/paid/tw-data-packs/supplier-discovery",
      "use_when": "The buyer wants broader supplier identity, factory, public-company, and market-entry streams around a trade topic."
    },
    {
      "pack_id": "tw_regulated_supplier_compliance_pack",
      "endpoint_template": "https://api.sourcestrand.com/v1/paid/tw-data-packs/regulated-supplier-compliance",
      "use_when": "The buyer's trade topic involves food, medical-device, or public nonconformity preflight."
    }
  ],
  "entity_linking_contract": {
    "schema_version": "taiwan-entity-linking-contract-v1",
    "identity_keys": [
      "business_id",
      "company_name_zh",
      "company_name_en",
      "stock_code",
      "factory_name_zh",
      "source_record_key"
    ],
    "normalization_steps": [
      "Preserve original source-language names.",
      "Normalize whitespace and punctuation only for matching.",
      "Treat business_id and stock_code as routing hints, not legal identity certification."
    ],
    "next_free_endpoint": "https://api.sourcestrand.com/v1/preview/tw-company/dossier?query={business_id_or_name}",
    "next_paid_endpoints": [
      "https://api.sourcestrand.com/v1/paid/tw-company/brief?business_id={business_id}",
      "https://api.sourcestrand.com/v1/paid/tw-procurement/company-activity?business_id={business_id}",
      "https://api.sourcestrand.com/v1/paid/tw-entity-graph/relationship-pack?business_id={business_id}",
      "https://api.sourcestrand.com/v1/paid/tw-semiconductor/company-pack?business_id={business_id}"
    ],
    "boundary": "Entity linking is for buyer workflow routing and enrichment. It is not legal identity certification, beneficial ownership proof, credit scoring, or supplier ranking."
  },
  "freshness_policy": {
    "cache_ttl_seconds": 21600,
    "stale_after_seconds": 16200,
    "safe_to_cache": true,
    "valid_until_basis": "Preview and product metadata are generated per request; agents should re-fetch when stale before paying."
  },
  "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, Bazaar discovery metadata, 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": "Informational record-backed buyer pack only; not legal, compliance, procurement, credit, investment, tax, accounting, or trading advice."
}