iNaturalist Observations Scraper
Pricing
Pay per event
Go to Apify Store
iNaturalist Observations Scraper
Export public iNaturalist observations by taxon, place, project, date, bounding box, or radius for research, GIS, and reports.
iNaturalist Observations Scraper
Pricing
Pay per event
Export public iNaturalist observations by taxon, place, project, date, bounding box, or radius for research, GIS, and reports.
You can access the iNaturalist Observations Scraper programmatically from your own applications by using the Apify API. You can also choose the language preference from below. To use the Apify API, you’ll need an Apify account and your API token, found in API & Integrations in Apify Console.
{ "openapi": "3.0.1", "info": { "version": "0.1", "x-build-id": "nD9PViGR6fiumk5nU" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/automation-lab~inaturalist-observations-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-automation-lab-inaturalist-observations-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/automation-lab~inaturalist-observations-scraper/runs": { "post": { "operationId": "runs-sync-automation-lab-inaturalist-observations-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/automation-lab~inaturalist-observations-scraper/run-sync": { "post": { "operationId": "run-sync-automation-lab-inaturalist-observations-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "maxItems": { "title": "Maximum observations", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Maximum number of public iNaturalist observations to save to the dataset.", "default": 20 }, "searchQuery": { "title": "Search text", "type": "string", "description": "Optional full-text search query passed as q to the iNaturalist observations API, for example a species/common name or place phrase." }, "taxonId": { "title": "Taxon ID", "minimum": 1, "type": "integer", "description": "Optional iNaturalist taxon_id. Example: 48662 for monarch butterfly." }, "placeId": { "title": "Place ID", "minimum": 1, "type": "integer", "description": "Optional iNaturalist place_id. Example: 1 for United States." }, "projectId": { "title": "Project ID or slug", "type": "string", "description": "Optional iNaturalist project ID or slug to restrict observations to a project." }, "userId": { "title": "Observer username", "type": "string", "description": "Optional iNaturalist username to export observations from one observer." }, "qualityGrade": { "title": "Quality grade", "enum": [ "any", "research", "needs_id", "casual" ], "type": "string", "description": "Filter by iNaturalist quality grade. Choose any to leave quality_grade unset.", "default": "research" }, "dateFrom": { "title": "Observed from", "type": "string", "description": "Earliest observed date in YYYY-MM-DD format." }, "dateTo": { "title": "Observed until", "type": "string", "description": "Latest observed date in YYYY-MM-DD format." }, "nelat": { "title": "Bounding box northeast latitude", "type": "number", "description": "Optional bounding-box northeast latitude. Use together with nelng, swlat, and swlng." }, "nelng": { "title": "Bounding box northeast longitude", "type": "number", "description": "Optional bounding-box northeast longitude." }, "swlat": { "title": "Bounding box southwest latitude", "type": "number", "description": "Optional bounding-box southwest latitude." }, "swlng": { "title": "Bounding box southwest longitude", "type": "number", "description": "Optional bounding-box southwest longitude." }, "lat": { "title": "Radius center latitude", "type": "number", "description": "Optional radius-search center latitude. Use together with lng and radiusKm." }, "lng": { "title": "Radius center longitude", "type": "number", "description": "Optional radius-search center longitude. Use together with lat and radiusKm." }, "radiusKm": { "title": "Radius in kilometers", "minimum": 0.1, "maximum": 1000, "type": "number", "description": "Optional radius in kilometers around lat/lng." }, "includePhotos": { "title": "Include photo URLs", "type": "boolean", "description": "When enabled, output includes an array of normalized large photo URLs for each observation.", "default": true }, "sort": { "title": "Sort by", "enum": [ "observed_on", "created_at", "species_guess", "votes", "id" ], "type": "string", "description": "Sort field accepted by the iNaturalist observations API.", "default": "observed_on" }, "order": { "title": "Sort direction", "enum": [ "desc", "asc" ], "type": "string", "description": "Sort newest/highest first or oldest/lowest first.", "default": "desc" } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } }}OpenAPI is a standard for designing and describing RESTful APIs, allowing developers to define API structure, endpoints, and data formats in a machine-readable way. It simplifies API development, integration, and documentation.
OpenAPI is effective when used with AI agents and GPTs by standardizing how these systems interact with various APIs, for reliable integrations and efficient communication.
By defining machine-readable API specifications, OpenAPI allows AI models like GPTs to understand and use varied data sources, improving accuracy. This accelerates development, reduces errors, and provides context-aware responses, making OpenAPI a core component for AI applications.
You can download the OpenAPI definitions for iNaturalist Observations Scraper from the options below:
If you’d like to learn more about how OpenAPI powers GPTs, read our blog post.
You can also check out our other API clients: