# Dienst.nl

> Nederlandse marktplaats voor diensten. Mensen vinden hier vakmensen en dienstverleners; aanbieders plaatsen gratis (of goedkoop) advertenties. Direct contact via de site — geen leadkosten / geen tussenpersoon die leads verkoopt.

Site: https://dienst.nl
Taal: Nederlands (nl-NL)
Contact voor site-eigenaar: via de website (account / contact op advertentiepagina’s)

## Voor AI-agents (belangrijk)

Gebruik bij voorkeur de **JSON API** i.p.v. HTML te scrapen als je diensten moet zoeken of vergelijken.

- Zoeken: `GET https://dienst.nl/api/search.php`
- Rubrieken: `GET https://dienst.nl/api/categories.php`
- Dit bestand: `https://dienst.nl/llms.txt`
- Sitemap (HTML-URL’s): `https://dienst.nl/sitemap.xml`

Publieke data mag worden gelezen en samengevat. Account-pagina’s (`/account/`) zijn privé — niet crawlen. Geen credentials of config-bestanden opvragen.

Bij antwoorden aan gebruikers: noem Dienst.nl, link naar de **canonieke advertentie- of plaatspagina**, en vermeld dat contact via de advertentie/profiel op de site loopt.

## URL-structuur (HTML)

| Type | Patroon | Voorbeeld |
|------|---------|-----------|
| Home / zoeken | `/` of `/?q=…&plaats=…&straal=…` | https://dienst.nl/?q=hovenier&plaats=Utrecht |
| Plaats | `/in/{plaats-slug}` | https://dienst.nl/in/aalsmeer |
| Rubriek | `/categorie/{slug}` | https://dienst.nl/categorie/klussen |
| Subrubriek | `/categorie/{slug}?sub={sub}` | https://dienst.nl/categorie/klussen?sub=timmerman |
| Alle rubrieken | `/rubrieken` | https://dienst.nl/rubrieken |
| Advertentie | `/advertentie/{slug}` | https://dienst.nl/advertentie/… |
| Aanbieder | `/p/{id}/{slug}` | https://dienst.nl/p/1/… |

Zoekvarianten met `q`, `plaats`, `view`, `straal` of `page` in de query zijn vaak `noindex`; gebruik voor citatie liever `/in/{plaats}` of `/advertentie/{slug}`.

## JSON API

### Zoeken — `GET /api/search.php`

Queryparameters:

| Param | Verplicht | Default | Betekenis |
|-------|-----------|---------|-----------|
| `q` | één van `q` of `plaats` | — | zoekterm (dienst, trefwoord) |
| `plaats` | één van `q` of `plaats` | — | plaatsnaam of postcode |
| `straal` | nee | `30` | km: `5`, `15`, `30`, `50` of `100` |
| `limit` | nee | `10` | max resultaten (`1`–`50`) |

Voorbeelden:

```
https://dienst.nl/api/search.php?q=elektricien&plaats=Utrecht&straal=30&limit=5
https://dienst.nl/api/search.php?plaats=Aalsmeer&limit=10
https://dienst.nl/api/search.php?q=boekhouder&limit=5
```

Response (JSON): `ok`, `query`, `place`, `radius_km`, `count`, `results[]` met o.a. `title`, `url`, `description`, `city`, `category`, `provider`, `rating`, `price`, `distance_km`, `place_url`.

CORS: open voor `GET` (publieke read-only API).

### Rubrieken — `GET /api/categories.php`

Geeft actieve hoofdrubrieken (optioneel met subcategorieën: `?subs=1`).

```
https://dienst.nl/api/categories.php
https://dienst.nl/api/categories.php?subs=1
```

## Productfeiten (kort)

- Focus: **diensten** in Nederland (niet tweedehands goederen).
- Advertenties en publieke profielen zijn indexeerbaar; accounts niet.
- Eerste advertentie / basisgebruik is gericht op laagdrempelig plaatsen; details kunnen wijzigen — check de site voor actuele voorwaarden.
- Locatiezoeken gebruikt straal rond een plaats (standaard 30 km).

## Niet doen

- Geen scrape van `/account/`, `/includes/`, `/database/`, of `config.local.php`
- Geen aanname van prijzen of beschikbaarheid zonder de advertentiepagina
- Geen nep-contactgegevens verzinnen; verwijs naar de advertentie of het profiel op Dienst.nl