Data Portal
Research Data Portal
BIP / USDA APHIS compatible data access for research institutions
ApiaryBase member organizations can voluntarily share anonymized colony health data with approved research partners. Everything is summed per ZIP code — that is the finest detail that exists in any output — and any statistic drawn from fewer than five beekeepers is withheld automatically, regardless of consent level. No individual beekeeper, apiary, or hive is ever identifiable, and coordinates never leave the owner's own account.
Consent-scoped
Data comes only from members who have individually opted in. Consent belongs to the beekeeper — no admin can grant it on their behalf — and even full consent never lowers the ZIP-level, five-beekeeper minimum.
BIP Compatible
Output formats align with Bee Informed Partnership and USDA APHIS colony survey standards.
JWT Auth
Secure time-limited tokens issued against research partner API keys. No personal data in outputs.
Research Partner Access
Research partners authenticate with a pre-issued API key to receive a short-lived JWT bearer token for data access. To apply for research partner access, contact research@apiarybase.com with your institution and intended use.
Research Partner API Key — Issued by ApiaryBase to approved research institutions. Usage: Authorization: Bearer <token>
Available Endpoints
Base URL: /api/research
All endpoints require Authorization: Bearer <token>
GET Colony Loss Aggregate
Aggregated colony loss statistics by state, year, and season. Compatible with USDA APHIS survey format.
GET /api/research/v1/colony-losses?year=2024&state=VT&season=winter
GET Varroa Infestation Data
Monthly ZIP-level varroa aggregates — average mites per hundred bees, with count and beekeeper totals.
GET /api/research/v1/varroa?date_from=YYYY-MM-DD&date_to=YYYY-MM-DD&state=VT
GET Varroa ZIP Aggregates
ZIP-aggregated varroa rows for mapping — plain JSON, no coordinates; join zip_code to your own ZIP-centroid table.
GET /api/research/v1/varroa/map?date_from=YYYY-MM-DD&date_to=YYYY-MM-DD
GET Hive Health Summary
Monthly ZIP-level inspection aggregates — brood pattern scores and queen sightings across consented colonies.
GET /api/research/v1/hive-health?date_from=YYYY-MM-DD&date_to=YYYY-MM-DD&state=VT
GET Annual Survey Export
Annual loss report data aggregated by state, in a format compatible with the Bee Informed Partnership (BIP) survey. Add ?format=csv for CSV download.
GET /api/research/v1/annual-survey-export?year=2024&format=json
GET Management Practices Summary
Aggregated varroa treatment usage — management protocols used across organizations.
GET /api/research/v1/management-summary?year=2024&state=VT
GET Apiary Density
Apiary and beekeeper counts per ZIP code.
GET /api/research/v1/apiary-density?state=VT