DEVELOPER API

Plant Identification API for Photo-Based Plant ID

Build plant photo recognition into your own app, workflow, or customer portal. The Plant Identification API accepts a plant image, checks visible traits, and returns practical JSON fields such as common name, scientific name, family, care notes, lookalikes, and next-step guidance.

Photo input
JSON output
API keys
POST /api/plant/identify
curl -X POST https://api.plantidentify.org/api/plant/identify \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -F "[email protected]" \
  -F "lang=en"

How the Plant Identifier API Workflow Works

The public workflow mirrors the browser identifier: upload a clear plant image, authenticate the request, and use the structured result inside your product.

1

Create an API key

Sign in, open API Keys, and create a key for your integration. Keep the key server-side and rotate it if access changes.

2

Send a plant photo

Submit a JPG, PNG, or WEBP image from your app. Clear leaves, flowers, stems, or whole-plant photos produce more useful matches.

3

Parse the JSON result

Read likely common name, scientific name, family, care context, confidence, lookalikes, and suggested next photo from the response.

4

Show a useful next step

Use the response to guide users toward confirmation, care checks, safety review, or a second image when the match is uncertain.

Example Plant Identification API Request and Output

Use this example to plan request handling, result cards, logging, and user-facing fallback states before you connect production traffic.

Request
POST https://api.plantidentify.org/api/plant/identify
Authorization: Bearer YOUR_TOKEN
Content-Type: multipart/form-data

image: monstera.jpg
lang: en
context: plant
Response
{
  "success": true,
  "data": {
    "common_name": "Monstera",
    "scientific_name": "Monstera deliciosa",
    "family": "Araceae",
    "confidence": 0.86,
    "care": {
      "light": "Bright indirect light",
      "watering": "Water when top soil dries"
    },
    "lookalikes": ["Split-leaf philodendron", "Rhaphidophora"],
    "next_step": "Upload a full leaf and stem photo if you need stronger confirmation."
  }
}
Implementation note: Treat the result as a guided match, not a botanical guarantee. Show uncertainty, ask for better photos when needed, and avoid using one API response for edible, medical, or toxicity decisions.

What Your App Can Receive

The API is designed for product teams that need more than a visual guess. Output fields support search, user education, care workflows, and follow-up prompts.

Plant names

Return a readable common name plus a scientific name when the image contains enough evidence for a likely match.

Family and lookalikes

Expose family context and similar plants so users can compare candidates instead of seeing a single hard guess.

Care context

Show light, watering, and practical care notes when they are available for the likely plant match.

Safety notes

Surface cautious safety context for pets, children, handling, or sensitive use cases without replacing expert advice.

Next-photo guidance

Suggest whether a leaf, flower, stem, bark, or whole-plant image would help confirm a difficult identification.

Structured JSON

Use predictable response fields for mobile apps, garden tools, nursery intake forms, education products, and internal workflows.

Best-Fit API Use Cases

The Plant Identifier API works best when your product needs a fast photo-based shortlist and practical user guidance.

Gardening and plant care apps

Let users identify a houseplant, flower, tree, weed, or succulent before showing reminders, care plans, or plant profiles.

Nursery and ecommerce intake

Use photo identification to route customer questions, label plant photos, or collect better context before support replies.

Education and citizen-science tools

Help students and community users turn a field photo into a likely plant name, evidence checklist, and follow-up observation.

Internal image triage

Pre-fill plant names and categories for moderation queues, knowledge bases, or manual review dashboards.

Accuracy, Privacy, and Edge Cases

Photo-based plant recognition is useful, but the surrounding product should handle uncertainty and sensitive decisions carefully.

Case Recommended handling
Blurry or distant photo Return a retry prompt and ask for a closer image with better light.
Several plants in one image Ask the user to crop or retake the photo around one subject.
Possible edible or toxic plant Show a warning and require confirmation from a qualified local source.
Low confidence result Display likely matches, lookalikes, and the next best photo rather than hiding uncertainty.

Plant Identification API FAQs

Yes. The Plant Identification API accepts a plant photo and returns structured JSON with likely names, family, care context, lookalikes, and next-step guidance when available.

Use JPG, PNG, or WEBP images with one clear plant subject. Photos with sharp leaves, flowers, stems, bark, or whole-plant views produce more useful results than dark or distant images.

Yes. Keep the API key on your server or protected backend, send the image from your app to your backend, and return only the fields your mobile UI needs.

When the likely plant match supports it, the result can include light, watering, care, safety, lookalike, and next-photo context. Availability depends on the image and candidate plant.

No. Plant identification from a photo depends on image quality, visible traits, growth stage, and similar species. Show confidence, candidates, and follow-up guidance in your product.

No. Use the API as a first-pass identification aid only. For edible plants, toxicity, allergies, medical use, pets, or pesticide decisions, require qualified local verification.

After signing in, use the API Keys page to create and manage keys for your account. Rotate keys when access changes and avoid exposing them in public client-side code.

Build Plant Photo Identification Into Your Product

Create an API key, test the photo workflow, and return practical plant ID results inside your own app or internal tool.