{"openapi":"3.1.0","info":{"title":"SemiData 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 free API key (100 req/day).","contact":{"email":"chris.cagle@youfirstseo.com"},"license":{"name":"Commercial"}},"servers":[{"url":"https://semidata.dev","description":"Production (Cloudflare Workers + D1)"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"X-API-Key","description":"Free tier: 100 req/day. Request at api.youfirstseo.com"},"X402Payment":{"type":"apiKey","in":"header","name":"X-Payment","description":"x402 micropayment — $0.005 USDC on Base mainnet. No signup required."}}},"paths":{"/v1/signals":{"get":{"operationId":"getSignals","summary":"Regulatory signals","description":"Federal Register regulatory signals on semiconductor-critical materials: export controls, sanctions, import restrictions. LLM-structured with importance scoring.","tags":["Supply Chain Intelligence"],"parameters":[{"name":"material","in":"query","description":"Material name (e.g. Gallium, Germanium, Cobalt, Rare Earth Metals)","schema":{"type":"string"}},{"name":"type","in":"query","description":"Signal type: export_control, sanction, import_restriction, policy","schema":{"type":"string"}},{"name":"importance","in":"query","description":"Importance level: high, medium, low","schema":{"type":"string","enum":["high","medium","low"]}},{"name":"country","in":"query","description":"ISO-2 country code (e.g. CN, RU, US)","schema":{"type":"string"}},{"name":"since","in":"query","description":"ISO date filter — records published after this date","schema":{"type":"string","format":"date"}},{"name":"limit","in":"query","description":"Max results (default 50, max 200)","schema":{"type":"integer","default":50,"maximum":200}}],"responses":{"200":{"description":"Array of regulatory signals with material, type, importance, summary, and source URL"}}}},"/v1/deposits":{"get":{"operationId":"getDeposits","summary":"Mineral deposit records","description":"USGS MRDS mineral deposit data. 1,233 deposits for gallium, germanium, cobalt, lithium, silicon, rare earths, and indium.","tags":["Supply Chain Intelligence"],"parameters":[{"name":"commodity","in":"query","description":"Mineral commodity (e.g. Gallium, Cobalt, Lithium)","schema":{"type":"string"}},{"name":"country","in":"query","description":"ISO-2 country code","schema":{"type":"string"}},{"name":"state","in":"query","description":"US state abbreviation (for US deposits)","schema":{"type":"string"}},{"name":"status","in":"query","description":"Deposit status: Active, Inactive, Prospect","schema":{"type":"string"}},{"name":"active_only","in":"query","description":"Filter to active deposits only","schema":{"type":"boolean"}},{"name":"min_score","in":"query","description":"Minimum USGS development score","schema":{"type":"number"}}],"responses":{"200":{"description":"Array of mineral deposit records with location, commodity, status, and USGS scores"}}}},"/v1/edgar":{"get":{"operationId":"getEdgarFilings","summary":"SEC filings with supply chain signals","description":"SEC EDGAR 8-K, 10-K, and 10-Q filings processed with LLM to extract supply chain signals, sentiment, and material mentions.","tags":["Supply Chain Intelligence"],"parameters":[{"name":"material","in":"query","description":"Material mentioned in filing","schema":{"type":"string"}},{"name":"entity","in":"query","description":"Company/filer name","schema":{"type":"string"}},{"name":"form","in":"query","description":"SEC form type: 8-K, 10-K, 10-Q","schema":{"type":"string"}},{"name":"importance","in":"query","description":"Extracted importance: high, medium, low","schema":{"type":"string"}},{"name":"sentiment","in":"query","description":"Supply chain sentiment: bullish, bearish, neutral","schema":{"type":"string","enum":["bullish","bearish","neutral"]}},{"name":"since","in":"query","description":"Filter filings after this date","schema":{"type":"string","format":"date"}}],"responses":{"200":{"description":"Array of SEC filings with LLM-extracted signals, sentiment, and material tags"}}}},"/v1/entities":{"get":{"operationId":"getEntities","summary":"Restricted entity screening","description":"Consolidated Screening List: BIS Entity List, OFAC SDN, Military End User list, and CMIC list. 6,438 entities. Use for supplier due diligence.","tags":["Supply Chain Intelligence"],"parameters":[{"name":"name","in":"query","description":"Entity name search (partial match)","schema":{"type":"string"}},{"name":"country","in":"query","description":"ISO-2 country code","schema":{"type":"string"}},{"name":"list_name","in":"query","description":"Source list (e.g. Entity List, SDN List, Military End User)","schema":{"type":"string"}},{"name":"q","in":"query","description":"Full-text search across name and aliases","schema":{"type":"string"}}],"responses":{"200":{"description":"Array of restricted entities with name, country, list source, and aliases"}}}},"/v1/tradeflows":{"get":{"operationId":"getTradeFlows","summary":"Trade flow volumes","description":"UN Comtrade annual export volumes by country and HS code for semiconductor-critical materials. Response includes data_year — public API lags 2–3 years.","tags":["Supply Chain Intelligence"],"parameters":[{"name":"material","in":"query","description":"Material name (e.g. Gallium, Cobalt (powders), Lithium carbonate)","schema":{"type":"string"}},{"name":"reporter","in":"query","description":"Exporting country name (e.g. China, Germany, Chile)","schema":{"type":"string"}},{"name":"hs_code","in":"query","description":"HS-6 commodity code (e.g. 280491 for Gallium)","schema":{"type":"string"}},{"name":"min_value","in":"query","description":"Minimum trade value in USD","schema":{"type":"number"}}],"responses":{"200":{"description":"Trade flow records with data_year, reporter, material, trade_value_usd, and net_weight_kg"}}}},"/v1/mcp":{"get":{"operationId":"getMcpManifest","summary":"MCP server manifest","description":"Model Context Protocol server manifest. Add this URL to your agent MCP config for automatic tool discovery. Public — no auth required.","tags":["Agent Integration"],"security":[],"responses":{"200":{"description":"MCP manifest JSON with 5 tools: search_regulatory_signals, search_mineral_deposits, search_sec_filings, search_restricted_entities, get_trade_flows"}}}}}}