{"openapi":"3.1.0","info":{"title":"daigakujoho BtoAI Scout API","version":"1.1.0","description":"Decision-relevant Japanese university signals packaged for AI agents, search products, and data buyers. Open access is enabled during the growth phase."},"servers":[{"url":"https://daigakujoho.com"}],"paths":{"/api/btoai/release":{"get":{"summary":"Get the latest BtoAI release","description":"Returns the full structured BtoAI release during open access. API keys are still accepted for future paid mode, but they are not required while access_mode is open.","security":[{}],"responses":{"200":{"description":"BtoAI release payload"}}}},"/api/btoai/signals":{"get":{"summary":"Query BtoAI signals","parameters":[{"name":"q","in":"query","schema":{"type":"string"}},{"name":"signal_type","in":"query","schema":{"type":"string"}},{"name":"scope","in":"query","schema":{"type":"string"}},{"name":"university_id","in":"query","schema":{"type":"string"}},{"name":"prefecture","in":"query","schema":{"type":"string"}},{"name":"public_exposure","in":"query","schema":{"type":"string","enum":["summary","archive"]},"description":"Paid-mode only. Return delayed public summaries or archives instead of the default sample."},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":1000},"description":"Open-access requests can return the full current release. Paid-mode unauthenticated requests are capped to public samples."}],"security":[{}],"responses":{"200":{"description":"Filtered BtoAI signals"}}}},"/api/btoai/console/release":{"get":{"summary":"Export the current BtoAI release","description":"No-code and AI-friendly export endpoint. During open access it is public and supports JSON, CSV, and JSONL. In future paid mode it requires a buyer-console session cookie.","parameters":[{"name":"format","in":"query","schema":{"type":"string","enum":["json","csv","jsonl"]},"description":"Use jsonl for RAG ingestion, csv for spreadsheets, or json/default for application payloads."}],"security":[{}],"responses":{"200":{"description":"BtoAI release export"}}}},"/api/btoai/status":{"get":{"summary":"Get BtoAI release, queue, commercial, and schedule status","description":"Returns non-secret operational status for freshness checks: current website release, latest pulled worker release, queue counts, commercial configuration flags, and the next scheduled worker runs.","responses":{"200":{"description":"BtoAI operational status payload"}}}}},"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-key"},"BearerAuth":{"type":"http","scheme":"bearer"}}}}