Arachnid Cache API Readonly

GET /health 60 req/min

Mongo connectivity report.

curl -s https://search.arachnid.info/health

GET /cache/stats 10 req/min

Counts, staleness, and storage metrics.

curl -s https://search.arachnid.info/cache/stats

GET /cache/collections 10 req/min

Group by key prefix with counts and example keys.

curl -s "https://search.arachnid.info/cache/collections"

GET /cache/search 20 req/min

Wildcard search over keys (only * wildcard is supported).

• pattern (required) — e.g. wsc:*, *weather*
• limit (1-1000, default 100)
• skip (>=0, default 0)
• show_stale (bool, default false)

curl -s "https://search.arachnid.info/cache/search?pattern=wsc:*&limit=50"

GET /cache/key/{key} 30 req/min

Fetch exact key. Use ?include_metadata=true to include cache timestamps.

curl -s "https://search.arachnid.info/cache/key/inat:taxon_id:argiope aurantia"

GET /cache/prefix/{prefix} 20 req/min

Fetch entries by key prefix.

• limit, skip, values_only

curl -s "https://search.arachnid.info/cache/prefix/inat:images?limit=10"

GET /species/search 120 req/min

Autocomplete-ready species metadata sourced from the Mongo species_index collection (with alias support via species_alias_index).

• q — partial species/genus/family text
• limit (1-50, default 10)

curl -s "https://search.arachnid.info/species/search?q=grammostola"

GET /species/{name} 30 req/min

Species aggregations assembled from cached keys (WSC, iNaturalist, GBIF, weather, Species+/CITES).

curl -s "https://search.arachnid.info/species/Argiope aurantia"

POST /species/previews 20 req/min

Bulk fetch cached species summaries for up to 100 names (images, GBIF/iNat ids, weather snapshot, CITES).

curl -s -X POST -H "Content-Type: application/json" -d '{"names":["Phidippus audax","Argiope aurantia"]}' https://search.arachnid.info/species/previews

GET /genus/{name} 30 req/min

CSV-backed summaries for an entire genus, including species list, counts, and distribution highlights.

curl -s "https://search.arachnid.info/genus/Grammostola"

GET /family/{name} 20 req/min

Family-wide snapshot sourced from species.csv with genus counts, representative species, and distribution buckets.

curl -s "https://search.arachnid.info/family/Theraphosidae"

POST /usage/event 240 req/min

Internal endpoint used by the web client to record searches, views, copy actions, and observation clicks.

• event_type — search, view, copy, observation_click, or pageview
• metadata — JSON object describing the event (fields vary by type)

GET /usage/stats 20 req/min

Aggregated usage data used by the public stats dashboard.

• hours (1-8760, default 72, or all for full history)
• limit (1-50, default 10)

curl -s "https://search.arachnid.info/usage/stats?hours=168"