> ## Documentation Index > Fetch the complete documentation index at: https://docs.athenahq.ai/llms.txt > Use this file to discover all available pages before exploring further. # Rechercher des faits de marque > Recherche sémantique dans les faits de marque approuvés d’un site web. Combine similarité vectorielle et recherche plein texte pour atteindre aussi les faits non classés dans un pilier. Recherche uniquement les faits affichés dans la base de connaissances ; les faits générés par l’analyse Oracle sont exclus. Renvoie le texte du fait, sa confiance, son URL source, sa citation et le pilier publié auquel il appartient (null si non classé). Également disponible comme outil MCP `search_brand_facts`. ## OpenAPI ````yaml fr/api-reference/openapi.json get /api/v1/knowledge-base/facts/search openapi: 3.1.0 info: title: API AthenaHQ description: >- L’API AthenaHQ permet de gérer vos sites et prompts par programme pour l’optimisation de contenu par IA. version: 1.0.0 contact: email: support@athenahq.ai servers: - url: https://api.athenahq.ai description: Serveur de production security: - apiKey: [] tags: - name: Basics description: Opérations API principales pour gérer sites et prompts - name: Metrics description: Points de terminaison de métriques et analyses de visibilité IA - name: Billing description: Points de facturation et crédits pour gérer la consommation - name: Team Management description: Points de terminaison de gestion des membres et invitations - name: Groups description: Points de terminaison de gestion des groupes de sites - name: Content description: >- Points de terminaison Content Hub : onglets, URL suivies et détail des prompts par URL. - name: Pitch Workspace description: >- Points de terminaison des rapports Pitch Workspace : exécutions à l’échelle de l’organisation avec concurrents, prompts, attributs et métriques agrégées. - name: Knowledge Base description: >- Endpoints de lecture de la base de connaissances de la marque — faits approuvés et piliers qui les organisent. paths: /api/v1/knowledge-base/facts/search: get: tags: - Knowledge Base summary: Rechercher des faits de marque description: >- Recherche sémantique dans les faits de marque approuvés d’un site web. Combine similarité vectorielle et recherche plein texte pour atteindre aussi les faits non classés dans un pilier. Recherche uniquement les faits affichés dans la base de connaissances ; les faits générés par l’analyse Oracle sont exclus. Renvoie le texte du fait, sa confiance, son URL source, sa citation et le pilier publié auquel il appartient (null si non classé). Également disponible comme outil MCP `search_brand_facts`. operationId: searchBrandFacts parameters: - name: website_id in: query required: true schema: type: string format: uuid description: Site web dont lire la base de connaissances. - name: query in: query required: true schema: type: string minLength: 1 maxLength: 200 description: Requête de recherche en langage naturel. - name: pillar_id in: query required: false schema: type: string format: uuid description: Limite aux faits classés dans ce pilier. - name: top_k in: query required: false schema: type: integer minimum: 1 maximum: 50 default: 10 description: Nombre maximal de faits à renvoyer. responses: '200': description: >- Réponse réussie avec les faits correspondants, meilleures correspondances en premier content: application/json: schema: type: object properties: facts: type: array items: $ref: '#/components/schemas/BrandFactSearchResult' required: - facts '400': description: Requête incorrecte — paramètres invalides content: application/json: schema: $ref: '#/components/schemas/Error' examples: missing_website_id: value: error: website_id is required missing_query: value: error: query is required invalid_top_k: value: error: top_k must be between 1 and 50 '401': description: Non autorisé — clé API invalide ou absente content: application/json: schema: $ref: '#/components/schemas/Error' '403': description: >- Interdit — aucun accès au site, ou base de connaissances non activée pour l’organisation content: application/json: schema: $ref: '#/components/schemas/Error' examples: unauthorized_website: value: error: Unauthorized access to this website kb_not_enabled: value: error: Knowledge Base is not enabled for this organization security: - apiKey: [] components: schemas: BrandFactSearchResult: type: object properties: id: type: string format: uuid text: type: string description: Énoncé du fait. confidence: type: - string - 'null' enum: - high - medium - low - null description: Niveau de confiance attribué à l’ingestion, ou null si non évalué. source_url: type: - string - 'null' description: URL d’extraction du fait, enregistrée sans protocole. source_quote: type: - string - 'null' description: Citation textuelle de la source qui étaye le fait. pillar: $ref: '#/components/schemas/BrandFactPillar' required: - id - text - confidence - source_url - source_quote - pillar Error: type: object description: Objet de réponse d’erreur required: - error properties: error: type: string description: Message expliquant l’erreur example: Unauthorized BrandFactPillar: type: - object - 'null' description: Pilier publié du fait, ou null s’il n’est pas classé. properties: id: type: string format: uuid name: type: string required: - id - name securitySchemes: apiKey: type: apiKey in: header name: x-api-key description: >- Clé API d’authentification. Créez-en une [ici](https://app.athenahq.ai/organization?tab=api). ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.