Plantaerium by Realmdrop Logo

For developers/API

Plug into the
canonical record.

Programmatic access to one canonical record per cultivar — botanical identity, attributes, growth requirements, provenance. Built for catalog tooling, specifier apps, and integrations.

Request accessSee an example →

Bundled with Silver, Gold, and White subscriptions. Pricing scales with tier, rate limit, and override volume — typical Gold integrations land in the low-four-figures monthly.

Tiers

Who the API
is for.

Silver tier

Starter

For small businesses and retailers

  • Consolidated canonical record (read-only)
  • API key authentication via AuthRealm
  • Search and filter on every attribute
  • Change feed for syncing your catalog
  • No image URLs · no curated overrides
Most popular

Gold tier

For mid-sized businesses with larger catalogs

  • Everything in Silver
  • Curated admin overrides — deeper, cleaner data
  • Image URLs (signed, short-lived)
  • Higher rate limits for larger client bases
  • Email support

White tier

Enterprise

For industry leaders sharing catalogs with clients

  • Everything in Gold
  • Read + write your own tenant overrides
  • Share curated catalogs with downstream clients
  • Highest rate limits · custom feeds on request
  • SSO + audit log access · priority support

Built on PlantDB

Years of horticulture,
one API call away.

Botanical identity, growth requirements, bloom windows, foliage, provenance — every attribute reconciled across suppliers, filterable through a single endpoint.

Quickstart

A simple
example.

Fetch the canonical record for one cultivar by its display_code.

curl https://plantaerium.api.realmdrop.com/api/v1/plants/SYR-002 \
  -H "Authorization: Bearer $PLANTAERIUM_API_KEY"
Response
{
  "realmdrop_id": 1012,
  "display_code": "SYR-002",
  "botanical_name": "Syringa vulgaris",
  "cultivar_name": "Madame Lemoine",
  "hardiness_zones": [3, 7],
  "mature_height_ft": [10, 15],
  "mature_width_ft": [6, 12],
  "bloom_months": [5],
  "bloom_colors": ["white"],
  "light_requirement": "full_sun",
  "image_urls": [
    "https://images.plantaerium.com/SYR-002/01.jpg?sig=…"
  ]
}

Search

Trigram search across every alias (botanical, cultivar, trade name). Filter on attribute ranges with the same one endpoint.

curl 'https://plantaerium.api.realmdrop.com/api/v1/plants/search?q=hydrangea&zone_min=4&zone_max=8' \
  -H "Authorization: Bearer $PLANTAERIUM_API_KEY"

Change feed

Poll for cultivars updated since your last sync. Returns updated entities with the canonical projection — diff client-side, or treat each entry as a full upsert.

curl 'https://plantaerium.api.realmdrop.com/api/v1/plants/changes?since=2026-04-15T00:00:00Z' \
  -H "Authorization: Bearer $PLANTAERIUM_API_KEY"

The fine print

Boring tokens.
Predictable failures.

Bearer auth from AuthRealm, transparent rate limits, stable JSON error codes. The dev-facing details are boring on purpose — so your integration stays boring too.

Auth

Bearer tokens.
Backend only.

All API requests carry a bearer token issued by AuthRealm. Tokens are scoped to your tier (Silver, Gold or White) plus any opt-in feature scopes (image-write, change-feed, etc.). Never embed the token in a client; ship it from your backend.

Header
Authorization: Bearer <PLANTAERIUM_API_KEY>

Rate limits

600/min on Gold.
3,000+ on White.

White scales on request. Each response includes X-RateLimit-Remaining and a Retry-After header on 429.

Errors

HTTP codes.
Stable JSON body.

The body is always JSON with a stable code field.

Error shape
{
  "code": "scope_required",
  "message": "This route requires plantaerium:gold-read.",
  "request_id": "req_2025-04-21T12:34:56.789Z_a1b2"
}

Tooling

SDKs &
OpenAPI.

Coming soon

Python SDK

pip install plantaerium — typed client, retry/backoff, change-feed cursor helpers.

Coming soon

OpenAPI spec

Self-served at /openapi.json once your tier is provisioned. Generate clients in any language.

Ready to integrate?

We’ll set up your keys.
You’ll be querying in an hour.

API access is bundled with Silver, Gold, and White subscriptions. Get in touch and we’ll walk you through the data model and tailor a plan that fits.

Contact us