{ "openapi": "3.0.1", "info": { "title": "iNaturalist Scraper — Observations, Taxa & Species", "description": "Scrape iNaturalist by taxon name, place, or keyword. Extract species, location, photo, observer, quality grade, and taxonomy for biodiversity research, conservation, and wildlife monitoring. No API key, no login.", "version": "1.0", "x-build-id": "x4bipCpAbEanNAFV7" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/logiover~inaturalist-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-logiover-inaturalist-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/logiover~inaturalist-scraper/runs": { "post": { "operationId": "runs-sync-logiover-inaturalist-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/logiover~inaturalist-scraper/run-sync": { "post": { "operationId": "run-sync-logiover-inaturalist-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": { "mode": { "title": "Mode", "enum": [ "observations", "taxa", "observationDetail" ], "type": "string", "description": "Scraping mode: 'observations' (search observations), 'taxa' (search species/taxa), or 'observationDetail' (single observation by ID).", "default": "observations" }, "query": { "title": "Search Query", "type": "string", "description": "Free-text search term (e.g. 'lion', 'eagle'). Used in observations and taxa modes. Leave empty to browse all." }, "iconicTaxon": { "title": "Iconic Taxon (major group)", "enum": [ "", "Mammalia", "Aves", "Reptilia", "Amphibia", "Actinopterygii", "Mollusca", "Arachnida", "Insecta", "Plantae", "Fungi", "Chromista", "Protozoa", "Animalia" ], "type": "string", "description": "Restrict observations to a major group of life. This is the fastest way to filter (e.g. all mammals, all birds). Leave empty for all groups. If you also set Taxon Name, both filters are combined, so they must describe the same group (for example Aves + Corvus, not Aves + Panthera).", "default": "" }, "taxonName": { "title": "Taxon Name (any rank)", "type": "string", "description": "Scientific or common name at ANY rank — species ('Panthera leo'), genus ('Panthera'), family, order, or class ('Mammalia'). It is resolved to a taxon id, so higher taxa work too. Leave empty for no taxon filter. When combined with Iconic Taxon, the two filters must be taxonomically compatible." }, "placeId": { "title": "Place ID", "type": "integer", "description": "iNaturalist place ID to filter observations geographically (e.g. 1=USA, 6986=Kenya). Optional." }, "qualityGrade": { "title": "Quality Grade", "enum": [ "", "research", "needs_id", "casual" ], "type": "string", "description": "Filter by observation quality. Leave as 'All' for everything.", "default": "research" }, "observationId": { "title": "Observation ID", "type": "integer", "description": "For 'observationDetail' mode — specific iNaturalist observation ID to fetch." }, "maxResults": { "title": "Max Results", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Maximum number of records to scrape. The observations endpoint caps paging at 10000. Default 200.", "default": 200 }, "proxyConfig": { "title": "Proxy Configuration", "type": "object", "description": "Apify proxy settings. Automatic proxy is recommended; the actor also falls back to a direct connection if the proxy is unavailable.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } }