For developers

The Plantaerium API

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

Request access See an example

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

Who the API is for

For specifiers and catalog tools

Full canonical record (silver + curated overrides)
API key authentication via AuthRealm
Search and filter on every attribute
Image URLs (signed, short-lived)
Change feed for syncing your catalog

White tier

Enterprise

For enterprise integrations

Everything in Gold
Per-tenant field overrides
Higher rate limits
Priority support · custom feeds on request
SSO + audit log access

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"

Authentication

All API requests carry a bearer token issued by AuthRealm. Tokens are scoped to your tier (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

Default Gold limit is 600 requests/minute per key; White starts at 3,000/minute and scales on request. Each response includesX-RateLimit-Remaining and aRetry-Afterheader on 429.

Errors

Standard HTTP codes; 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"
}

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?

API access is bundled with Gold and White subscriptions. Get in touch and we'll set up your keys, walk through the data model, and tailor a plan that fits.