API Documentation

Complete guide to integrating our Plant Data API into your applications

Interactive API Explorer

Try our API directly in your browser with our interactive Swagger documentation. Test endpoints, explore data structures, and see real responses.

🚀 Live API Documentation

Access our complete API documentation with interactive examples and real-time testing capabilities.

Open Swagger Docs

📦 Sample Data Preview

Preview our plant database without an API key. This sample shows 6 diverse plants from our collection.

Loading sample data...

Quick Start Guide

1. Get Your API Key

Sign up for free access to our Plant Data API. You'll receive an API key that gives you access to our organized plant database.

2. Make Your First Request

Here's a simple example to search for plants (e.g., 'Tomato'):

GET /api/v1/plants?search=Tomato
Host: your-domain.com
X-API-Key: YOUR_API_KEY

3. Response Format

All responses are in JSON format with detailed plant information:

{
  "data": [
    {
      "id": "uuid...",
      "name_common": "Tomato",
      "name_botanical": "Solanum lycopersicum",
      "family": "Solanaceae",
      "water_demand": "high"
    }
  ],
  "total": 1,
  "limit": 50,
  "offset": 0
}

API Features

Smart Search

Full-text search across common and botanical names to find exactly what you're looking for.

Growing Conditions

Filter plants by their specific needs including pH levels, temperature tolerance, and water demand.

RESTful Design

Standard HTTP methods, JSON responses, and clear error messages.

Fast & Reliable

Reliable API access with fast response times and structured data delivery.

About Our Plant Database

Our database aggregates and organizes planting data from publicly available agricultural resources and gardening information. We compile optimal sowing, planting, and harvesting times for plant varieties across different climate zones into an accessible format.

Our Mission

We believe that gardening information should be organized, accessible, and practical. Our mission is to compile and structure planting data to support gardeners, developers, and agricultural educators.

  • Comprehensive Data: Information covering vegetables, fruits, herbs, and nuts with detailed growing requirements
  • Climate-Specific: Planting times and recommendations organized by USDA hardiness zones
  • Developer-Friendly: Clean API access for building gardening applications and tools
  • Print-Ready: Generate printable calendars and reference posters for offline use

Our Values

Open Access: We believe gardening information should be accessible to everyone, from home gardeners to large-scale operations.

Accuracy First: We carefully organize data from reliable agricultural sources and clearly indicate regional variations.

Community Driven: Our database grows with input from gardeners, farmers, and agricultural experts worldwide.

Authentication

Our API uses API key authentication. Include your key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

Rate Limits

  • Free Tier: 1,000 requests per month
  • Pro Tier: 50,000 requests per month
  • Enterprise: Unlimited requests with dedicated support

Need Help?

Our API is designed to be intuitive, but we're here to help if you need assistance integrating our plant data into your application.

Get Started with API