{"uid":"cap_Iu9pYoTBvLfdFU5yudwZh","slug":"species-range-and-biodiversity-records-41abbcc1","name":"Species Range and Biodiversity Records","description":"Countries where a species has been recorded with record counts, and the recent five-year reporting trend.","url":"https://biodiversity.x402tookit.com/species-range?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["name"],"properties":{"name":{"type":"string","description":"Scientific name, e.g. Puma concolor"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"asOf":{"type":["null","string"]},"query":{"type":["null","string"]},"source":{"type":["null","string"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"summary":{"type":["null","string"]},"verdict":{"type":["null","string"]},"degraded":{"type":["boolean","null"]},"taxonKey":{"type":["null","number"]},"countries":{"type":["array","null"],"items":{"type":"object","properties":{"country":{"type":["null","string"]},"records":{"type":["null","number"]}}}},"sourceUrl":{"type":["null","string"]},"disclaimer":{"type":["null","string"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"attribution":{"type":["null","string"]},"totalRecords":{"type":["null","number"]},"canonicalName":{"type":["null","string"]},"countriesShown":{"type":["null","number"]},"reportingChangePct":{"type":["null","number"]},"recentFiveYearRecords":{"type":["null","number"]},"previousFiveYearRecords":{"type":["null","number"]}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.03","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.03/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_0uwgQRV1WnjmvflFIi16O","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.03","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the countries where a species has been recorded with observation counts, plus the five-year reporting trend percentage.","exampleAgentPrompt":"Which countries have recorded Puma concolor and is the species being observed more or less frequently compared to five years ago?","exampleUseCases":[{"title":"Conservation range assessment","prompt":"I need to know which countries have recorded Panthera leo and how many observations each country has — also tell me if reporting has been going up or down over the last five years."},{"title":"Invasive species spread tracking","prompt":"Can you check which countries have documented Burmese pythons — scientific name Python bivittatus — and whether reports have been increasing recently?"},{"title":"Research species geographic scope","prompt":"For my ecology paper I need the full list of countries where Quercus robur has been recorded along with record counts and the recent five-year reporting trend."}],"resultDescription":"A JSON object containing: a list of countries with per-country observation record counts, the total record count, number of countries shown, the canonical accepted scientific name, GBIF taxon key, recent and previous five-year record counts, the percentage change in reporting between those periods, data source URL, attribution, and an optional natural-language summary and verdict on population trend. May also include a degraded flag and disclaimer if data is incomplete.","failureModes":["Species name not found in GBIF — returns null taxon key and empty countries list","Misspelled or ambiguous scientific name yields no results or wrong species","Degraded flag set to true when GBIF data is partially unavailable","Very rare or newly described species may have zero records and no trend data","Common name input not accepted — scientific name required"],"whenToPreferThis":"Use this endpoint when you need the geographic distribution of a species across countries with actual observation record counts and a quantitative trend signal. It is the right choice over a general species search when the user's goal is range mapping, population trend analysis, or country-level biodiversity reporting rather than name resolution or taxonomic lookup.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T00:35:01.470Z","isFirstParty":false,"canonicalSlug":"species-range-and-biodiversity-records-41abbcc1"}