{"openapi":"3.1.0","info":{"title":"AI Data Archive","version":"1.0.0","description":"Machine-readable archive of open-licensed scholarly literature (Europe PMC, OpenAlex), normalized to structured JSON with full license/attribution metadata. Discovery and search are free; document content is paid per request via the x402 HTTP payment protocol (USDC)."},"servers":[{"url":"https://api.ishob.com"}],"paths":{"/api/catalog":{"get":{"summary":"Catalog (free)","parameters":[{"name":"topic","in":"query","required":false,"schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer"}}],"responses":{"200":{"description":"Catalog page"}}}},"/api/topics":{"get":{"summary":"Topics (free)","responses":{"200":{"description":"Topics"}}}},"/api/search":{"get":{"summary":"Search (free)","parameters":[{"name":"q","in":"query","required":false,"schema":{"type":"string"}},{"name":"topic","in":"query","required":false,"schema":{"type":"string"}},{"name":"year_from","in":"query","required":false,"schema":{"type":"integer"}},{"name":"year_to","in":"query","required":false,"schema":{"type":"integer"}},{"name":"license","in":"query","required":false,"schema":{"type":"string"}},{"name":"fulltext","in":"query","required":false,"schema":{"type":"boolean"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer"}}],"responses":{"200":{"description":"Results"},"400":{"description":"Invalid query"}}}},"/api/stats":{"get":{"summary":"Totals (free)","responses":{"200":{"description":"Stats"}}}},"/api/document/{id}":{"get":{"summary":"Document metadata + abstract + rights (paid)","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^(?:pmc-\\d{1,12}|pmid-\\d{1,12}|doi-[0-9a-f]{20}|oa-w\\d{1,15})$"}}],"x-payment":{"protocol":"x402","version":2,"scheme":"exact","network":"eip155:8453","asset":"USDC","price_usd":"0.001"},"responses":{"200":{"description":"Content (JSON) with license + attribution; PAYMENT-RESPONSE header carries the settlement receipt"},"400":{"description":"Invalid id"},"402":{"description":"Payment required. PAYMENT-REQUIRED header (base64 JSON) lists accepted payment requirements"},"404":{"description":"Not found (no payment requested)"}}}},"/api/document/{id}/fulltext":{"get":{"summary":"Structured full text (paid)","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^(?:pmc-\\d{1,12}|pmid-\\d{1,12}|doi-[0-9a-f]{20}|oa-w\\d{1,15})$"}}],"x-payment":{"protocol":"x402","version":2,"scheme":"exact","network":"eip155:8453","asset":"USDC","price_usd":"0.01"},"responses":{"200":{"description":"Content (JSON) with license + attribution; PAYMENT-RESPONSE header carries the settlement receipt"},"400":{"description":"Invalid id"},"402":{"description":"Payment required. PAYMENT-REQUIRED header (base64 JSON) lists accepted payment requirements"},"404":{"description":"Not found (no payment requested)"}}}},"/api/document/{id}/references":{"get":{"summary":"References (paid)","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^(?:pmc-\\d{1,12}|pmid-\\d{1,12}|doi-[0-9a-f]{20}|oa-w\\d{1,15})$"}}],"x-payment":{"protocol":"x402","version":2,"scheme":"exact","network":"eip155:8453","asset":"USDC","price_usd":"0.002"},"responses":{"200":{"description":"Content (JSON) with license + attribution; PAYMENT-RESPONSE header carries the settlement receipt"},"400":{"description":"Invalid id"},"402":{"description":"Payment required. PAYMENT-REQUIRED header (base64 JSON) lists accepted payment requirements"},"404":{"description":"Not found (no payment requested)"}}}},"/api/topic/{slug}/content":{"get":{"summary":"Topic JSONL bundle (paid)","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-z0-9-]{1,64}$"}}],"x-payment":{"protocol":"x402","version":2,"scheme":"exact","network":"eip155:8453","asset":"USDC","price_usd":"0.5"},"responses":{"200":{"description":"Content (JSON) with license + attribution; PAYMENT-RESPONSE header carries the settlement receipt"},"400":{"description":"Invalid id"},"402":{"description":"Payment required. PAYMENT-REQUIRED header (base64 JSON) lists accepted payment requirements"},"404":{"description":"Not found (no payment requested)"}}}}}}