# GGKP Knowledge Brokerage API

## Docs
- [Overview](https://docs.api.ggkp.org/613242m0.md): 
- [Use Cases](https://docs.api.ggkp.org/1983063m0.md): 
- [Security](https://docs.api.ggkp.org/1993213m0.md): 
- [FAQ](https://docs.api.ggkp.org/1993189m0.md): 

## API Docs
- Taxonomy [Retrieve Master Taxonomy](https://docs.api.ggkp.org/27406346e0.md): Retrieves the complete master taxonomy with all terms and hierarchical relationships. The taxonomy includes Sectors, Themes, Regions, Actors, Knowledge types, and more.
- Taxonomy [Retrieve Taxonomy by Term ID](https://docs.api.ggkp.org/27406347e0.md): Retrieves a specific taxonomy term by its unique identifier.
- Taxonomy [Retrieve Domain-Specific Taxonomy](https://docs.api.ggkp.org/27406348e0.md): Retrieves taxonomy terms specific to a named domain (e.g., Green Industry Platform, Green Finance Platform). Use this to get a filtered taxonomy relevant to a specific GGKP domain.
- Search [Federated Search](https://docs.api.ggkp.org/27406349e0.md): Executes a federated search across all connected databases and content management systems. Returns results ranked by relevance.
- Search [Semantic Search](https://docs.api.ggkp.org/27406350e0.md): Performs AI-powered semantic search across indexed content using natural language queries. Returns contextually relevant results based on meaning rather than just keyword matching.
- Search [List Connected Sources](https://docs.api.ggkp.org/27406351e0.md): Retrieves a list of all connected data sources in the federated search network.
- Search [Register New Source](https://docs.api.ggkp.org/27406352e0.md): Registers a new data source in the federated search network. Requires the 'Upload Source' permission.
- Search [Upload Knowledge Products](https://docs.api.ggkp.org/27406353e0.md): Uploads and indexes knowledge products for a registered source. Products become searchable across the platform. Requires the 'Upload Products' permission.
- Search [List Products by Source](https://docs.api.ggkp.org/27406354e0.md): Retrieves all knowledge products for a specific source. Requires the 'List Products' permission.
- Search [Delete Products](https://docs.api.ggkp.org/27406355e0.md): Deletes one or more knowledge products from the index.
- Classifier [Classify PDF Document](https://docs.api.ggkp.org/27406555e0.md): Automatically classifies a PDF document using the GGKP taxonomy. The classifier analyzes document content and assigns relevant taxonomy terms across multiple categories (Sectors, Themes, Regions, Stakeholders, Target Audiences, Knowledge Types) with confidence scores.
- Classifier [Generate Body and Summary](https://docs.api.ggkp.org/27406357e0.md): Uses AI to generate a comprehensive body text and summary for a knowledge product. Useful for creating metadata from PDFs or sparse content.
- Bots [Generic Bot](https://docs.api.ggkp.org/27406359e0.md): General-purpose endpoint to execute an extended search query that : 1) retrieves knowledge products via Semantic and Federated Search 2) passes them to the internal GGKP AI Model based on Mistral-3 8b 3) instructs the model to behave according to system_prompt and to compile a response for the user_type target audience 4) generates an answer that includes the search results. This is the endpoint that powers up all the GGKP Intelligent Librarians and bots.