Myplantnet Pl@ntNet API
★ Only Publicly Available OpenAPI DocumentAI/MLVisionapiKey16 EndpointsREST
For Agents
Identify plants, plant diseases, and plant varieties from photos and check API quota using a Pl@ntNet api-key query parameter.
Use for: I need to identify a plant from a photo, Find what disease is affecting a tomato leaf in this image, Check how much Pl@ntNet quota we have left this month, List the regional Pl@ntNet projects available
Not supported: Does not handle generic image classification, animal identification, or text generation — use for plant, plant disease, and plant variety identification from images only.
Jentic publishes the only available OpenAPI specification for Pl@ntNet API, keeping it validated and agent-ready. Pl@ntNet is a citizen-science platform that identifies plants from photos using a community-trained image-classification model. The API exposes 16 endpoints covering plant identification (by URL or upload), disease and variety identification, species and project listings, image embeddings, and quota and subscription introspection. Authentication is an api-key query parameter on https://my-api.plantnet.org, with quota tracking via /v2/quota and /v2/quota/daily.
Install Jentic One Beta
Connect the Pl@ntNet API to your agent
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Pl@ntNet API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.
1
Step 1: Jentic One Host machine
# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh2
Step 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.
Capabilities
What an agent can do with Pl@ntNet API.
Identify plants from a list of image URLs via GET /v2/identify/{project} for URL-friendly batch flows
Identify plants from uploaded image files via POST /v2/identify/{project} for direct camera input
Identify plant diseases from images via POST /v2/diseases/identify
Identify plant varieties from images via POST /v2/varieties/identify
List the supported projects (regional flora collections) via GET /v2/projects and the species in each project
Track API quota consumption via GET /v2/quota, GET /v2/quota/daily, and GET /v2/quota/history
Generate image embeddings via POST /v2/embeddings for downstream vector search and similarity workflows
Use Cases
Patterns agents use Pl@ntNet API for, with concrete tasks.
★ Mobile Plant Identification App
Power a consumer or field-research mobile app that identifies plants from a phone camera image. The app uploads the photo via POST /v2/identify/{project} and presents the top species candidates with confidence scores. Choosing the right project (e.g., western-europe, useful, weeds) tunes the model for the user's region, improving accuracy over a global default.
Call POST /v2/identify/western-europe with the user's uploaded JPEG and return the top three species candidates with confidence scores.
Crop Disease Detection
Detect plant disease from field photos via POST /v2/diseases/identify for agronomy and gardening applications. The integration pairs disease identification with /v2/diseases (the catalogue of identifiable diseases) to validate the response and surface the disease name, host species, and confidence to the grower.
Call POST /v2/diseases/identify with the uploaded leaf photo and join the response against GET /v2/diseases for the canonical disease description.
Quota-Aware Batch Identification
Run a large batch of plant identifications without exceeding the Pl@ntNet plan quota. The integration polls GET /v2/quota and GET /v2/quota/daily before each batch to determine remaining capacity, then calls GET /v2/identify/{project} with image URLs in chunks. /v2/quota/history feeds usage dashboards.
Call GET /v2/quota to check remaining identifications, batch the URL list into safe chunks, and call GET /v2/identify/{project} with each chunk.
Plant Image Vector Search
Build a similarity search index over a herbarium or field-photo archive using POST /v2/embeddings. Each image is converted to a vector and stored in a vector database; future queries embed the query image and retrieve the nearest neighbours. This unlocks 'find similar specimens' without retraining a custom model.
Iterate over the herbarium archive, call POST /v2/embeddings for each image, and write the resulting vectors into a vector database keyed by specimen ID.
AI Agent Botanical Concierge
An AI agent acts as a botanical concierge for citizen scientists. It searches Jentic for Pl@ntNet operations, loads the identify and diseases-identify schemas, checks quota, and runs identification on images attached to a chat message. Jentic isolates the api-key query parameter so the agent never sees the raw secret in URLs.
Search Jentic for 'identify a plant from a photo', execute POST /v2/identify/western-europe, and return the top species candidate with confidence score.
Key Endpoints
16 endpoints — jentic publishes the only available openapi specification for pl@ntnet api, keeping it validated and agent-ready.
METHOD
PATH
DESCRIPTION
POST
/v2/identify/{project}
Identify a plant from uploaded images
GET
/v2/identify/{project}
Identify a plant from image URLs
POST
/v2/diseases/identify
Identify a plant disease from images
POST
/v2/varieties/identify
Identify a plant variety from images
GET
/v2/projects
List supported regional projects
GET
/v2/quota
Check quota consumption
POST
/v2/embeddings
Generate image embeddings
GET
/v2/_status
Check API health
POST
/v2/identify/{project}
Identify a plant from uploaded images
GET
/v2/identify/{project}
Identify a plant from image URLs
POST
/v2/diseases/identify
Identify a plant disease from images
POST
/v2/varieties/identify
Identify a plant variety from images
GET
/v2/projects
List supported regional projects
GET
/v2/quota
Check quota consumption
POST
/v2/embeddings
Generate image embeddings
GET
/v2/_status
Check API health
Why Jentic?
Three things that make agents converge on Jentic-routed access.
Credential isolation
Pl@ntNet api-key values are stored encrypted in the Jentic vault (MAXsystem). Agents call Pl@ntNet through Jentic and the api-key is appended to the URL at execution time — it never appears in prompts, agent context, or request logs.
Intent-based discovery
Agents search by intent (e.g., 'identify a plant from a photo') and Jentic returns matching Pl@ntNet operations such as POST /v2/identify/{project} and POST /v2/diseases/identify with their multipart upload schemas, so the agent can run identification without reading docs.
Time to first call
Direct Pl@ntNet integration: 1-2 days for multipart upload handling, project selection, and quota tracking. Through Jentic: under 30 minutes — search, load, execute.
Related APIs
Alternatives and complements available in the Jentic catalogue.
FAQs
Specific to using Pl@ntNet API through Jentic.
Why is there no official OpenAPI spec for Pl@ntNet API?
Pl@ntNet does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call Pl@ntNet API via structured tooling. It is validated against the live API and kept up to date. Get started at https://app.jentic.com/sign-up.
What authentication does the Pl@ntNet API use?
The Pl@ntNet API uses an `api-key` query parameter on every request. Through Jentic, the api-key is stored in the encrypted vault and appended to the URL at execution time, so the raw key never appears in agent context or in request logs.
Can I identify plants from a photo with the Pl@ntNet API?
Yes. Either call GET /v2/identify/{project} with image URLs as query parameters or POST /v2/identify/{project} with a multipart upload. The response returns the top candidate species with scores; choose the regional project that best matches the photo location for higher accuracy.
How do I check my Pl@ntNet quota through Jentic?
Search Jentic for 'check Pl@ntNet quota', load the GET /v2/quota schema, and execute it. For finer detail, also call GET /v2/quota/daily and GET /v2/quota/history — useful for batching large identification jobs without exceeding the plan limit.
Does Pl@ntNet identify plant diseases?
Yes. POST /v2/diseases/identify accepts uploaded images and returns identified diseases with confidence scores. Pair with GET /v2/diseases for the canonical disease catalogue and host-species metadata.
What are the rate limits for the Pl@ntNet API?
Pl@ntNet enforces plan-based quotas rather than per-second rate limits. Use GET /v2/quota and GET /v2/quota/daily before large batches and back off when the remaining count nears zero. Contact Pl@ntNet support to upgrade plans for higher monthly identification budgets.
GET STARTED