Developer API

Getting Started

Welcome to the TreasureBot API. Our RESTful API allows developers to integrate recycling data, user engagement tools, and sustainability metrics into their applications. Follow the steps below to get started:

curl -X POST "https://api.treasurebot.io/v1/auth/token" \
    -H "Content-Type: application/json" \
    -d '{"client_id": "YOUR_CLIENT_ID", "client_secret": "YOUR_CLIENT_SECRET"}'

// Example using fetch API
async function getToken() {
    const response = await fetch('https://api.treasurebot.io/v1/auth/token', {
        method: 'POST',
        headers: {
            'Content-Type': 'application/json'
        },
        body: JSON.stringify({
            client_id: 'YOUR_CLIENT_ID',
            client_secret: 'YOUR_CLIENT_SECRET'
        })
    });
    
    const data = await response.json();
    return data.access_token;
}

Available SDKs

Use our official software development kits to integrate with TreasureBot more easily:

Core Endpoints

Explore the main endpoints available in the TreasureBot API:

{
    "email": "user@example.com",
    "first_name": "John",
    "last_name": "Doe",
    "password": "secure_password",
    "region": "eu-west",
    "opt_in_newsletter": true
}

{
    "user_id": "usr_12345",
    "points": 25,
    "action_type": "recycle",
    "material_type": "plastic_bottle",
    "location_id": "loc_berlin_001"
}

Example Implementation

Here's a simple example of integrating TreasureBot's Green Points system into your application:

// Initialize TreasureBot client
const treasureBot = new TreasureBot({
    apiKey: 'YOUR_API_KEY',
    region: 'eu-west'
});

// Award points to user when they recycle
async function awardRecyclingPoints(userId, materialType, quantity) {
    try {
        const pointsAwarded = await treasureBot.points.award({
            userId,
            action: 'recycle',
            materialType,
            quantity,
            timestamp: new Date().toISOString()
        });
        
        console.log(`User awarded ${pointsAwarded} Green Points!`);
        
        // Update user interface with new points total
        updateUserPointsDisplay(userId);
        
        return pointsAwarded;
    } catch (error) {
        console.error('Failed to award points:', error);
        return 0;
    }
}

// Get user's sustainability impact statistics
async function getUserImpactStats(userId) {
    const stats = await treasureBot.users.getStatistics(userId);
    
    // Display impact metrics to the user
    updateImpactDashboard({
        totalPoints: stats.total_green_points,
        co2Saved: stats.co2_savings_kg,
        materialsRecycled: stats.total_materials_recycled,
        treesEquivalent: stats.trees_saved_equivalent
    });
}

Rate Limits & Pricing

Our API is available in multiple tiers to accommodate different usage needs:

Request Early Access

Our API is currently in limited beta testing. Submit your details below to join our early access program and be among the first to integrate TreasureBot's recycling technology into your applications.

Our team reviews applications weekly. If selected, you'll receive developer credentials and documentation within 5 business days.

API Development Roadmap

Here's our planned timeline for API feature releases and improvements:

Developer Community & Support

Join our growing community of sustainability-focused developers and get the help you need:

Success Stories

See how innovative companies are using TreasureBot's API to drive sustainability: