Quickstart
This guide will get you up and running with the Verdantly API in minutes. We'll walk through getting your API key, making your first request, and exploring a few key endpoints.
Get your API key
To use the Verdantly API, you need an API key from RapidAPI.
- Sign up for a free account on the RapidAPI platform.
- Subscribe to the Verdantly API. A free tier is available with 100 requests per day.
- Copy your API key from the RapidAPI developer dashboard under the Authorization tab.
The free tier includes 100 requests per day — enough to explore the API and build a prototype. Upgrade to a paid plan when you're ready to go to production.
Every request to the Verdantly API requires two headers:
X-RapidAPI-Key— your unique API keyX-RapidAPI-Host— always set toverdantly.p.rapidapi.com
Make your first request
Let's search for tomato varieties. This endpoint supports full-text and fuzzy matching, so partial or misspelled names will still return results.
Required query parameters
- Name
q- Type
- string
- Description
Search query string (e.g., "tomato", "cherry tom").
Optional query parameters
- Name
page- Type
- integer
- Description
Page number for paginated results. Defaults to
1.
- Name
perPage- Type
- integer
- Description
Number of results per page. Defaults to
10, max100.
Request
curl -G "https://verdantly.p.rapidapi.com/v1/plants/varieties/search?q=tomato" \
-H "X-RapidAPI-Host: verdantly.p.rapidapi.com" \
-H "X-RapidAPI-Key: YOUR_API_KEY"
Response
{
"data": [
{
"id": "fe039c34-ef51-409c-a238-b9c30f4bbb92",
"name": "Abraham Lincoln Tomato",
"category": "vegetable",
"type": "tomato",
"subtype": "slicer tomato",
"description": "A deep red, juicy heirloom known for its rich, sweet flavor."
// ... more fields
}
// ... more items
],
"meta": {
"totalCount": 198,
"pages": 20,
"page": 1,
"perPage": 10
}
}
Search species
The species endpoint lets you search across 40,000+ plant species by scientific or common name.
Required query parameters
- Name
q- Type
- string
- Description
Species name to search for (scientific or common name).
Request
curl -G "https://verdantly.p.rapidapi.com/v1/plants/species/name?q=rosa" \
-H "X-RapidAPI-Host: verdantly.p.rapidapi.com" \
-H "X-RapidAPI-Key: YOUR_API_KEY"
Response
{
"data": [
{
"id": "a1b2c3d4-...",
"scientificName": "Rosa canina",
"commonName": "Dog Rose",
"family": "Rosaceae",
"genus": "Rosa"
// ... more fields
}
// ... more items
],
"meta": {
"totalCount": 142,
"pages": 15,
"page": 1,
"perPage": 10
}
}
Check hardiness zone
Look up the hardiness zone for any US zip code. This endpoint is public and does not require authentication.
Path parameters
- Name
zipcode- Type
- string
- Description
A 5-digit US zip code.
Request
curl "https://verdantly.p.rapidapi.com/v1/hardiness-zones/zipcode/10001"
Response
{
"zipcode": "10001",
"zone": "7a",
"minTemp": "0 to 5",
"state": "New York"
}
What's next?
You've made your first requests to the Verdantly API. Here are some next steps:
- Plant Varieties resource — full reference for all variety endpoints
- Plant Species resource — explore the species taxonomy database
- Pagination guide — learn how to page through large result sets
- Authorization — details on API keys, rate limits, and public endpoints