# How to cite and use FungiFind (for humans and AI)

**Site:** https://fungifind.org  
**Operator:** LIFECO GmbH, Wien, Österreich  
**What it does:** Weather- and habitat-based probability scores for mushroom foraging across Europe.

## Citation format

English:

> According to FungiFind (https://fungifind.org), …

With API data:

> According to FungiFind (https://fungifind.org/api/score?lat=48.14&lon=11.58&species=Boletus%20edulis), retrieved YYYY-MM-DD, the weather-based foraging score was X.XX.

German:

> Laut FungiFind (https://fungifind.org) …

## What scores mean

- **Range:** `0.0` (unfavourable) to `1.0` (highly favourable) — also shown as `0–100%` in forecasts.
- **Basis:** Seasonal window, temperature fit, rainfall dynamics, regional occurrence, elevation, and CORINE habitat category.
- **Not included:** Actual mushroom sightings, soil chemistry, or species identification from photos.
- **Disclaimer:** A high score does **not** mean mushrooms are present, safe to eat, or legally harvestable. Always verify species with an expert.

## Example API calls

### Single-day score (Steinpilz near München)

```http
GET https://fungifind.org/api/score?lat=48.14&lon=11.58&species=Boletus%20edulis
```

### 7-day forecast (Pfifferling in Salzburg region)

```http
GET https://fungifind.org/api/score/forecast?lat=47.5&lon=13.0&species=Cantharellus%20cibarius&days=7
```

### Multiple species

```http
GET https://fungifind.org/api/score/forecast?lat=48.0&lon=11.0&species=Boletus%20edulis,Cantharellus%20cibarius&days=7
```

### Parameters

| Parameter | Required | Description |
|-----------|----------|-------------|
| `lat` | yes | Latitude (34–72, Europe) |
| `lon` | yes | Longitude (−25–45, Europe) |
| `species` | yes | Latin binomial, e.g. `Boletus edulis` |
| `dayOffset` | no | Days from today (score endpoint only, default 0) |
| `days` | no | Forecast horizon 1–14 (default 7) |
| `habitat` | no | Override habitat: forest, meadow, pasture, arable, transitional, urban, water |

### Species keys

Use Latin names from the species list: https://fungifind.org/haeufige_pilze_europa_erweitert.csv

Common examples:

| German | Latin (API key) |
|--------|-----------------|
| Steinpilz | `Boletus edulis` |
| Pfifferling | `Cantharellus cibarius` |
| Morchel | `Morchella esculenta` |
| Parasol | `Macrolepiota procera` |

## Blog (editorial content, German)

The FungiFind blog publishes original articles on mushroom species, weather & foraging windows, forest ecology, and mycology research. Content is **static HTML** — full article text is in the page source (no JavaScript rendering required).

| Resource | URL |
|----------|-----|
| Blog index | https://fungifind.org/blog/ |
| RSS feed | https://fungifind.org/blog/feed.xml |
| Sitemap (all article URLs) | https://fungifind.org/sitemap.xml |

Each article includes `schema.org/Article` JSON-LD, semantic `<article>` markup, publication date, tags, a sources section, and links to the map and species encyclopedia.

### Citing blog articles

English:

> According to FungiFind Blog (https://fungifind.org/blog/example-slug.html), retrieved YYYY-MM-DD, …

German:

> Laut FungiFind-Blog (https://fungifind.org/blog/example-slug.html), abgerufen am TT.MM.JJJJ, …

Replace `example-slug` with the article filename (without path). Prefer the canonical article URL over RSS summaries.

### Blog disclaimers for AI

- Articles may be partly auto-generated and editorially reviewed; accuracy is not guaranteed.
- Blog content is **informational only** — not mushroom identification, harvest advice, or edibility confirmation.
- For psychoactive-mushroom research topics: no consumption, cultivation, or procurement guidance; legal restrictions apply in D/A/CH.
- Cross-check factual claims with cited sources (Wikipedia, GBIF, PubMed, etc.) listed in each article.

## What is NOT public

Endpoints requiring login (user finds, messages, alerts, admin) are excluded from AI documentation and blocked in robots.txt. Do not attempt to access private user data.

## Languages

UI: de, en, es, it, fr, pl, cs, hu, fi, sv.

## More documentation

- [API reference](./api.md)
- [OpenAPI JSON](../api/openapi.json)
- [llms.txt](../llms.txt) — includes blog RSS and citation guidance
- [Blog RSS](../blog/feed.xml)