{"openapi":"3.1.0","info":{"title":"Hunter & Closer Public Knowledge API","version":"1.0.0","description":"Read-only public endpoints for verified company facts, services, answers, comparisons and machine-readable context. These endpoints do not provide live prices or contractual offers.","contact":{"name":"Marco Hilburger","email":"info@huntercloser.de"},"license":{"name":"Website terms","url":"https://huntercloser.de/impressum"}},"servers":[{"url":"https://huntercloser.de"}],"components":{"schemas":{"Error":{"type":"object","required":["error","message"],"properties":{"error":{"type":"string"},"message":{"type":"string"}}},"Collection":{"type":"object","required":["schemaVersion"],"properties":{"schemaVersion":{"type":"string"},"count":{"type":"integer","minimum":0}},"additionalProperties":true},"RetrievalContext":{"type":"object","required":["schemaVersion","query","count","results"],"properties":{"schemaVersion":{"type":"string"},"query":{"type":"string"},"count":{"type":"integer","minimum":0,"maximum":25},"results":{"type":"array","maxItems":25,"items":{"type":"object","additionalProperties":true}}}}}},"paths":{"/api/knowledge":{"get":{"operationId":"getKnowledgeDataset","summary":"Get the complete public knowledge dataset","responses":{"200":{"description":"Public company and service dataset","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Collection"}}}}}}},"/api/context":{"get":{"operationId":"searchPublicContext","summary":"Search public answers, claims, entities, industries, services and comparisons","parameters":[{"name":"q","in":"query","required":true,"description":"Search query (2–200 characters)","schema":{"type":"string","minLength":2,"maxLength":200}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":25,"default":10}}],"responses":{"200":{"description":"Ranked public retrieval context","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RetrievalContext"}}}},"400":{"description":"Missing, short or oversized query","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/claims":{"get":{"operationId":"listClaims","summary":"List verified and conditional claims","responses":{"200":{"description":"Claim registry"}}}},"/api/claims/{id}":{"get":{"operationId":"getClaim","summary":"Get one claim by stable ID","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Claim record"},"404":{"description":"Claim not found"}}}},"/api/answers":{"get":{"operationId":"listAnswers","summary":"List direct answer records","responses":{"200":{"description":"Answer index"}}}},"/api/answers/{slug}":{"get":{"operationId":"getAnswer","summary":"Get one direct answer by canonical slug","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Question and accepted answer graph"},"404":{"description":"Answer not found"}}}},"/api/entities":{"get":{"operationId":"listEntities","summary":"List public entities with stable IDs","responses":{"200":{"description":"Entity registry","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Collection"}}}}}}},"/api/industries":{"get":{"operationId":"listIndustries","summary":"List public industry contexts","responses":{"200":{"description":"Industry context registry","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Collection"}}}}}}},"/ai-index.json":{"get":{"operationId":"getAiContentIndex","summary":"Get the AI content and citation index","responses":{"200":{"description":"AI discovery index"}}}},"/knowledge-graph.jsonld":{"get":{"operationId":"getKnowledgeGraph","summary":"Get the complete JSON-LD entity graph","responses":{"200":{"description":"JSON-LD knowledge graph"}}}}},"x-hunter-closer":{"dateModified":"2026-07-30","language":"de-DE","canonicalSource":"https://huntercloser.de/ai","limitations":["No live prices","No guaranteed availability","No guaranteed rankings","No branch offices outside Passau are implied"]}}