43-wentorai-research-plugins-skills-domains-ecology-inaturalist-api

brycewang-stanford/Auto-Empirical-Research-SkillsEnvironment & NatureAudit pendingSnapshot 522c025ca9b8

Summary

This source did not publish a separate summary. Review SKILL.md before using the skill.

SKILL.md

iNaturalist API Guide

Overview

iNaturalist is a citizen science platform and social network for naturalists, jointly operated by the California Academy of Sciences and the National Geographic Society. The platform enables users to record and share observations of organisms in nature, which are then identified by the community and validated by computer vision models. With over 150 million observations of more than 400,000 species, iNaturalist is one of the largest biodiversity data sources in the world.

The iNaturalist API provides programmatic access to this massive observational dataset. Researchers can query observations by taxonomy, geography, time period, observer, and data quality grade. The API also provides access to taxonomic information, place boundaries, and project data. Research-grade observations (those with community-verified identifications) are automatically shared with GBIF for integration into the global biodiversity data infrastructure.

Ecologists, conservation biologists, evolutionary biologists, and citizen science coordinators use the iNaturalist API to analyze species distributions, track phenological patterns, study urban biodiversity, monitor invasive species, and validate species distribution models. The platform's broad geographic and taxonomic coverage makes it particularly valuable for large-scale ecological analyses.

Authentication

No authentication is required for read-only access to public data. The iNaturalist API v1 allows anonymous queries for observations, taxa, and places. Authentication via OAuth 2.0 is only needed for write operations such as creating observations, adding identifications, or managing projects.

For authenticated requests, register an application at https://www.inaturalist.org/oauth/applications and use the OAuth 2.0 flow to obtain an access token.

Core Endpoints

observations: Search Biodiversity Observations

Query the iNaturalist observation database with filters for taxonomy, geography, time, and data quality.

URL: GET https://api.inaturalist.org/v1/observations
:

Parameter	Type	Required	Description
taxon_id	int	No	iNaturalist taxon ID to filter by
place_id	int	No	Place ID to filter by geographic area
lat	float	No	Latitude for geographic search
lng	float	No	Longitude for geographic search
radius	int	No	Search radius in km (used with lat/lng)
d1	string	No	Start date (YYYY-MM-DD)
d2	string	No	End date (YYYY-MM-DD)
quality_grade	string	No	`research`, `needs_id`, or `casual`
per_page	int	No	Results per page (default 30, max 200)
page	int	No	Page number
order_by	string	No	Sort field: `created_at`, `observed_on`, `votes`

curl "https://api.inaturalist.org/v1/observations?taxon_id=3&quality_grade=research&place_id=1&per_page=10"

Parameter	Type	Required	Description
q	string	No	Name search query
taxon_id	int	No	Specific taxon ID
rank	string	No	Filter by rank: `species`, `genus`, etc.
is_active	bool	No	Filter for active/inactive taxa
per_page	int	No	Results per page (default 30, max 200)

curl "https://api.inaturalist.org/v1/taxa?q=monarch+butterfly&rank=species"

Parameter	Type	Required	Description
q	string	No	Place name search query
per_page	int	No	Results per page

curl "https://api.inaturalist.org/v1/places/autocomplete?q=Yellowstone"

import requests

params = {
    "taxon_id": 48484,  # Danaus plexippus (Monarch Butterfly)
    "quality_grade": "research",
    "per_page": 200,
    "order_by": "observed_on"
}

resp = requests.get("https://api.inaturalist.org/v1/observations", params=params)
data = resp.json()

for obs in data["results"]:
    if obs.get("location"):
        lat, lng = obs["location"].split(",")
        print(f"{obs['observed_on']}: ({lat}, {lng}) - {obs['taxon']['name']}")

import requests
from collections import Counter

params = {
    "taxon_id": 48484,
    "quality_grade": "research",
    "per_page": 200,
    "place_id": 1  # United States
}

resp = requests.get("https://api.inaturalist.org/v1/observations", params=params)
months = Counter()

for obs in resp.json()["results"]:
    if obs.get("observed_on"):
        month = obs["observed_on"][5:7]
        months[month] += 1

for month in sorted(months):
    print(f"Month {month}: {months[month]} observations")

# Search for Spotted Lanternfly observations in Pennsylvania
curl "https://api.inaturalist.org/v1/observations?taxon_id=325295&place_id=46&quality_grade=research&per_page=50"

43-wentorai-research-plugins-skills-domains-ecology-inaturalist-api

Summary

SKILL.md

iNaturalist API Guide

Overview

Authentication

Core Endpoints

observations: Search Biodiversity Observations

taxa: Taxonomic Information

places: Geographic Place Boundaries

Rate Limits

Common Patterns

Species Distribution Analysis

Phenology Tracking

Invasive Species Monitoring

References

Related skills