Classify PDF Document

POST

https://api.ggkp.org/classify

Classification

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.

Processing:

Extracts text content from the uploaded PDF

Analyzes content using AI models trained on GGKP taxonomy

Returns classifications organized by taxonomy branch

Includes confidence scores and reasoning for each classification

Filtering:

Use domain parameter to restrict classifications to a specific GGKP platform's taxonomy subset

Use taxonomy parameter to limit which branches are evaluated

Use threshold to filter out low-confidence results

Request

Authorization

API Key

Add parameter in header

api-key

Example:

api-key: ********************

Body Params multipart/form-dataRequired

Responses

🟢200

application/json

Successful classification

Body

🟠400

🟠401

🟠413

🟠422

🔴500

🔴503

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api.ggkp.org/classify' \
--header 'api-key: <api-key>' \
--form 'file=@""' \
--form 'domain="GEF ISLANDS"' \
--form 'taxonomy="Sectors, Themes, Regions"' \
--form 'threshold="0.9"' \
--form 'max_results="3"' \
--form 'include_scores="true"'

Response Example

200 - Success

{
    "status": "success",
    "data": {
        "sectors": [
            {
                "name": "Manufacturing",
                "score": 0.95,
                "reasoning": "Document discusses industrial production processes and manufacturing efficiency"
            },
            {
                "name": "Energy",
                "score": 0.87,
                "reasoning": "References to energy consumption and renewable energy transitions"
            }
        ],
        "themes": [
            {
                "name": "Circular Economy",
                "score": 0.92,
                "reasoning": "Focus on waste reduction, recycling, and resource efficiency"
            }
        ],
        "regions": [
            {
                "name": "Asia Pacific",
                "score": 0.88,
                "reasoning": "Case studies and data primarily from Asian countries"
            }
        ],
        "stakeholders": [
            {
                "name": "Private Sector",
                "score": 0.91,
                "reasoning": "Addresses business implementation and corporate sustainability"
            }
        ],
        "target_audiences": [
            {
                "name": "Policy Makers",
                "score": 0.85,
                "reasoning": "Contains policy recommendations and regulatory guidance"
            }
        ],
        "knowledge_types": [
            {
                "name": "Case Study",
                "score": 0.94,
                "reasoning": "Document presents real-world implementation examples"
            }
        ]
    },
    "meta": {
        "config": {
            "active_taxonomy": [
                "Sectors",
                "Themes",
                "Regions",
                "Stakeholders",
                "Target Audiences",
                "Knowledge Types"
            ],
            "threshold": 0.9,
            "max_results": 3,
            "domain": null
        },
        "total_time": 2.45,
        "timings": {
            "sectors": 0.42,
            "themes": 0.38,
            "regions": 0.35,
            "stakeholders": 0.41,
            "target_audiences": 0.39,
            "knowledge_types": 0.5
        }
    }
}

Delete Products

Generate Body and Summary