Goodearth Wildlife Catalog
goodearth_wildlife_catalogWhich animals are actually recorded around this ground.
Birds, mammals, amphibians and reptiles observed near here, ranked by how often each has been seen — so the answer for a Vermont lakeshore is not the answer for a Georgia orchard, and neither is a roster someone typed.
Species are a landscape fact. A nine-hectare field contains almost no observations of anything, so the search widens to the surrounding country and the response reports how wide it looked; treating that footprint as the farm would be the dishonest version.
The ranking measures observers as much as animals — a roadside is better recorded than a back field — so the counts travel with the answer.
Pass a scientific name as species and this answers with that animal's
life-cycle phenophases instead — nest building, nestlings, fledged young,
calls or song, emergence above ground. Those come from USA-NPN, which
publishes them; they are not written into this service. Roughly half the
species recorded around a farm have them, and one that does not returns an
empty list rather than a guess, because "not tracked" and "does nothing"
are different claims.
Set with_events to get those phenophases for EVERY species in the list at
once, as habit_events. Ask for it before writing a roster: an agent left
to name events from memory writes "rut onset" and "southbound flights",
words this service has never used, where NPN says "Nest building" and
"Fledged young". It costs one upstream call per species, which is why it
is off by default.
The event name is not load-bearing. A wildlife row is dated by its
DRIVER — heat, daylight, an interval, a calendar date — and the label is
the grower's own words. habit_events is a courtesy to a caller looking
for the right word, never a list of the only acceptable ones: "Big Night
crossing" is a real thing a salamander does and no catalogue holds it.
Good Earth times an event you set. It does not publish natural history.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| npub | No | Required. Your Nostr public key (npub1...) for credit billing. | |
| block | Yes | The ground to answer for: a block you have saved — its id, its name, one of its aliases, or any part of its name that only one block has (e.g. "Meadow" for "Lower Meadow"). If several match, the error lists them with their ids. Blocks may overlap; each answers for its own ground. Save one with block_save first; geometry travels once, not on every call. | |
| species | No | Optional. A scientific name from a previous catalogue answer, e.g. 'Strix varia'. Given one, this returns that animal's life-cycle phenophases instead of the regional list. | |
| dpop_token | No | ||
| with_events | No | Include each species' known phenophases as `habit_events`, so a roster can be written from the published vocabulary rather than from memory. Costs one upstream call per species. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||