Gids
Zo maakt u van elke website een change-API
De meeste pagina's die voor u belangrijk zijn, zullen nooit een API aanbieden. Prijzen van concurrenten, voorwaarden-PDF's van leveranciers, registers van toezichthouders, changelogs van partners: de gegevens staan gewoon in de HTML, maar er is geen endpoint om aan te roepen. U heeft drie realistische opties: bouw zelf een scraper en los constant storingen op; betaal een scraping-API om de hele pagina op verzoek te extraheren; of transformeer de pagina in een change-feed: een monitor die de pagina observeert en alleen JSON pusht wanneer er daadwerkelijk iets relevants is gewijzigd. Dit artikel behandelt die derde weg, van begin tot eind, met Page Deltas.
Gratis abonnement · 10 gemonitorde URL's of sitemaps · onbeperkte controles (best-effort) · AI-filtering en samenvattingen · REST API, MCP en ondertekende webhooks in elk abonnement · geen creditcard vereist
{
"event": "sitemap.new_urls",
"monitor": "https://www.hubspot.com/sitemap.xml",
"detected_at": "2026-06-15T19:30:00Z",
"new_urls": [
"https://www.hubspot.com/case-studies/workleap",
"https://www.hubspot.com/products/artificial-intelligence/use-cases/sales-meeting-prep-and-follow-up",
"https://www.hubspot.com/email-signature-generator/create-rules-gmail"
]
}Zelfbouw-scraper vs scraping-API vs change-feed
Eerlijke vuistregel: heeft u duizenden pagina's nodig als dataset, gebruik dan een scraping-API. Moet u weten wanneer één openbare pagina verandert op een manier die aan een briefing voldoet, dan levert een change-feed minder code en veel minder onderhoud op.
Zelfbouw-scraper
Wat u krijgt: ruwe HTML die u zelf moet parsen. Ideaal voor volledige controle over afwijkende websites. De inspanning is hoog (selectors, proxies, rendering, retries). Zodra de site zijn ontwerp aanpast, breekt uw parser geruisloos. Verversing hangt af van wanneer uw cronjob draait. Typische kosten: infrastructuur plus uw eigen tijd.
Scraping-API
Wat u krijgt: gestructureerde data per request. Ideaal voor bulkextractie van grote aantallen pagina's. De inspanning is laag tot gemiddeld. De leverancier vangt de meeste layoutwijzigingen op. Verversing vindt alleen plaats wanneer u het endpoint aanroept. Typische kosten: credits per verzoek.
Change-feed (deze gids)
Wat u krijgt: een JSON-event wanneer er iets relevants is gewijzigd, inclusief AI-samenvatting. Ideaal voor "meld mijn systeem wanneer deze specifieke pagina verandert". De inspanning is minimaal: één monitor aanmaken, daarna webhook of polling. De content-extractie gecombineerd met de LLM-briefing bepaalt wat belangrijk is. Adaptieve controles en automatische push naar uw endpoint bij een match. Afrekening per gemonitorde URL in uw abonnement (controles worden niet geteld op Page Deltas).
Wat u gaat bouwen
Basis-URL: https://api.pagedeltas.com. Alle endpoints bevinden zich onder /api. Succesvolle responses zijn in JSON-formaat.
Account en API-sleutel
Maak een gratis Page Deltas-organisatie en een API-sleutel aan.
Monitor met een briefing
Maak een monitor aan op een openbare URL met een briefing in natuurlijke taal (het filter).
Polling of webhook
Poll GET /api/monitors/{id}/changes of koppel een generiek webhookkanaal zodat elke match ondertekende JSON via POST naar uw applicatie stuurt.
Optionele MCP
Koppel dezelfde sleutel via MCP aan Claude, Cursor of VS Code.
Configuratie: maak van een pagina een change-feed
Vijf stappen van API-sleutel naar een ondertekende webhook. Geef de voorkeur aan een webhook wanneer u actieve meldingen (push) wilt in plaats van periodieke bevraging (pull).
Account en API-sleutel aanmaken
Registreer u via pagedeltas.com/register. Geen creditcard vereist. Gratis abonnement: 10 gemonitorde URL's of sitemaps, onbeperkte controles (frequentie op best-effort basis), AI-filtering en samenvattingen, onbeperkt aantal teamleden, Slack / Discord / Teams / e-mail / ondertekende webhooks, 14 dagen geschiedenis, REST API en MCP. In de app: Instellingen → API-sleutels (editor of admin). Maak een sleutel aan en kopieer deze direct; deze wordt slechts eenmaal getoond. export PAGEDELTAS_TOKEN="pdt_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx". Sleutels zijn gekoppeld aan de organisatie en functioneren met admin-rechten binnen die organisatie. Ze zijn niet gebonden aan een individueel lid, dus het verwijderen van een teamlid trekt de sleutel niet in. Verwijder de sleutel om de toegang stop te zetten. Behandel deze als een wachtwoord: gebruik omgevingsvariabelen of een secret store, nooit gecommitte bestanden in versiebeheer.
Een monitor aanmaken (cURL)
POST https://api.pagedeltas.com/api/monitors met Authorization: Bearer $PAGEDELTAS_TOKEN en JSON-body: url, nl_description (de briefing), optionele filter_prompt en channel_ids: []. Voorbeeldbriefing: "Prijzenpagina van concurrent. Geef een melding wanneer een abonnementsprijs verandert, een pakket wordt toegevoegd of verwijderd, of quota en limieten wijzigen. Negeer cookiebanners, A/B-testvarianten en wisselende testimonials." Er is geen frequentieveld. De cadans is adaptief (actieve pagina's vaker, rustige minder vaak; betaalde abonnementen krijgen prioriteit). Gebruik POST /api/monitors/{id}/check-now voor een directe controle op verzoek (snelheidslimiet van 1/minuut/monitor). nl_description is de briefing die het LLM gebruikt om te beoordelen of een wijziging relevant is. Vage briefings veranderen uw webhook in een stortvloed aan visuele diffs. Optioneel: filter_prompt, css_selector, xpath_selector, is_pdf en channel_ids (kanaal-overrides per monitor; laat weg om organisatie-standaarden te gebruiken). Alleen voor het openbare web. Pagina's achter een login worden momenteel nog niet ondersteund. Sitemap-monitors zijn een afzonderlijke resource (/api/sitemap-monitors) wanneer de vraag is: "is er een compleet nieuwe pagina verschenen?" in plaats van "is deze pagina herschreven?"
De change-feed pollen
GET https://api.pagedeltas.com/api/monitors/{id}/changes?limit=50 met het Bearer-token. Meest recente wijzigingen eerst (standaard 50, maximaal 100). Er is geen cursor. Houd zelf de meest recente detected_at bij die u al heeft verwerkt. Elke wijziging bevat id, detected_at en summary: een heldere AI-beschrijving van wat voldeed aan de briefing, geen ruwe HTML-diff. Stuur summary door naar Slack, een ticketingsysteem of een andere agent.
Aanmaken en pollen in Python
Gebruik de requests-bibliotheek met Authorization Bearer en Content-Type application/json. POST /api/monitors met url, nl_description en channel_ids: []. Lees monitor["id"] uit het antwoord. Voer vervolgens GET /api/monitors/{monitor_id}/changes uit met limit=50 en print detected_at en summary van elke wijziging. Voer dit uit volgens een planning als u per se wilt pollen. Kies liever voor een webhook wanneer u data direct wilt laten pushen.
Sla polling over, ontvang JSON via push (HMAC-ondertekende webhooks)
In de app: Kanalen → Kanaal toevoegen → Generieke webhook. Plak de HTTPS-ontvanger-URL van uw applicatie. Kopieer het kanaalgeheim zodra dit wordt weergegeven (slechts één keer). Klik op Test verzenden. U kunt het kanaal ook via de API aanmaken (POST /api/alert-channels) en vervolgens koppelen via PUT /api/monitors/{id}/alert-channels, of laat channel_ids leeg zodat de monitor de standaardinstellingen van de organisatie gebruikt. Elke passende wijziging stuurt via POST platte JSON naar uw URL met Content-Type application/json en de header X-Signature: sha256=<hex>. Velden zijn onder andere: event (change.detected), monitor_id, monitor_url, monitor_name, change_id, detected_at, summary, before_screenshot_url, after_screenshot_url en dashboard_url. Verifieer X-Signature als HMAC-SHA256 van de ruwe request-body met uw kanaalgeheim (headerindeling sha256=<hex>). Bereken de hash over de exacte bytes vóórdat u de JSON parset, anders mislukt de verificatie. In de toekomst kunnen nieuwe velden worden toegevoegd: negeer onbekende sleutels. Bezorgingsdetails: momenteel één poging per kanaal per melding (geen automatische nieuwe pogingen); reageer snel en verwerk duplicaten idempotent. Netwerkfouten of niet-2xx statussen markeren de levering als mislukt; de monitor zelf wordt niet gepauzeerd door leveringsfouten. Elke bezorgpoging wordt server-side geregistreerd. Voor mensen in plaats van code gebruikt u Slack-, Discord-, Teams- of e-mailkanalen op dezelfde wijze. De stapsgewijze handleiding voor Slack vindt u in Meldingen van websitewijzigingen ontvangen in Slack.
Optioneel: monitors aansturen via Claude, Cursor of VS Code (MCP)
Dezelfde API-sleutel. Streamable HTTP MCP-endpoint: https://api.pagedeltas.com/mcp. Agents krijgen beschikking over tools zoals create_monitor, list_monitor_changes, create_alert_channel en sitemap-helpers. Cookie-sessies worden niet ondersteund op MCP. Geef de voorkeur aan een webhookkanaal voor event-driven systemen die niet hoeven te pollen.
Cursor mcp.json
Stel in ~/.cursor/mcp.json mcpServers.pagedeltas.url in op https://api.pagedeltas.com/mcp en headers.Authorization op Bearer pdt_xxxxxxxx. Herstart Cursor zodat de tools beschikbaar worden.
Volledige client-voorbeelden
Instructies voor Claude Code, VS Code en Claude Desktop via mcp-remote staan in de MCP-documentatie.
MCP-documentatie →Uw briefing is de query-taal
Bij een REST API filtert u met queryparameters. Bij een change-feed is het filter de briefing in natuurlijke taal op de monitor. Page Deltas leest de pagina uit, vergelijkt deze met de vorige controle en vraagt een LLM of het verschil overeenkomt met uw briefing. Meldingen arriveren met een geschreven samenvatting en screenshots van vóór en na de wijziging. Formuleer de briefing zoals u een collega zou instrueren.
Prijzen
Een pakketprijs wijzigt of er verschijnt een nieuw abonnementsniveau.
Aanbestedingen / RFP's
Er wordt een nieuwe aanbesteding geplaatst binnen ons werkgebied.
API-documentatie
De API-documentatie voegt een endpoint toe, verwijdert er een of verklaart er een verouderd.
Vacatures
Er verschijnt een senior engineering-vacature; negeer niet-technische functies.
Algemene monitor-gids
Dezelfde filosofie als in onze algemene gids over monitoring en de handleiding over filters en beschrijvingen.
Websitewijzigingen monitoren →Filtergids
Voorbeelden van instructies die goed werken en wat u beter kunt vermijden.
Filters en beschrijvingen →Quota die er echt toe doen (en die dat niet doen)
Bij Page Deltas is de enige limiet waarmee u rekening houdt het aantal URL's (of sitemaps) dat u volgt, niet een maandelijks tegoed aan controles. API read/write-endpoints kennen geen harde tariefstructuur buiten redelijk gebruik. De enige uitzondering is check-now: 1 verzoek per minuut per monitor (429 met Retry-After bij overschrijding). Het bereiken van de URL-limiet van uw abonnement resulteert in een 422-fout met uw actuele aantal en het maximum. Traditionele tools dwingen u tot rekenwerk ("elk uur één pagina controleren ≈ 720 controles/maand"). Hier kiest u de pagina's en schrijft u de briefing. De frequentie past zich vanzelf aan.
Free
10 gemonitorde URL's · 14 dagen geschiedenis · onbeperkte controles (best-effort), AI, API, MCP, alle 5 waarschuwingskanalen · $0
Starter
150 gemonitorde URL's · 30 dagen geschiedenis · $29/mnd · controles met prioriteit
Pro
1.000 gemonitorde URL's · 90 dagen geschiedenis · $79/mnd
Business
5.000 gemonitorde URL's · 365 dagen geschiedenis · $199/mnd
Scale
20.000 gemonitorde URL's · 730 dagen geschiedenis · $499/mnd
Enterprise
Aangepast aantal URL's en geschiedenis · SSO / SCIM
Waarin dit verschilt van een Visualping-achtige change-API
Ontwikkelaarsartikelen van Visualping leunen sterk op vaste intervallen, optionele CSS/XPath-selectie, een maandelijks controlequotum en een omvangrijk webhook-payload vol visuele pixel-diffs en belangrijkheidsvlaggen. Dat werkt prima wanneer de vraag is: "ga af wanneer pixels verschoven zijn, en laat mijn eigen code de rest uitzoeken". Page Deltas is gebouwd voor: "wek mijn systeem alleen wanneer de wijziging aan deze briefing voldoet". Dit artikel is de technische handleiding; de volledige vergelijking per abonnement vindt u op Page Deltas vs Visualping.
Briefing in natuurlijke taal staat voorop
Het primaire filter is de briefing. Selectors zijn optioneel, niet verplicht.
Adaptieve controlefrequentie
U hoeft geen intervalstring in te stellen. Actieve pagina's worden vaker gecontroleerd; rustige pagina's minder vaak.
Eenvoudige, platte webhook-payload
Gericht op summary, screenshot-URL's en HMAC X-Signature.
Onbeperkte controles; betaal voor het aantal URL's
Elk abonnement bevat onbeperkte controles. U betaalt uitsluitend voor het aantal URL's dat u monitort.
MCP met dezelfde API-sleutels
MCP gebruikt exact dezelfde API-sleutels als de REST-interface.
Volledige productvergelijking
Vergelijking van Page Deltas en Visualping per abonnement.
Page Deltas vs Visualping →Eerlijke beperkingen
Wees u bewust van wat deze change-feed wel en niet is voordat u productie-applicaties koppelt.
Uitsluitend openbare pagina's
Marketingsites, openbare PDF's, openbare vacaturepagina's, openbare sitemaps. Portalen achter een login staan op de roadmap, maar zijn nu nog niet beschikbaar.
Geen tool voor visuele regressie of defacement
Als het erom gaat of "deze pixel 20px naar rechts is verschoven", is een gespecialiseerde visual-diff tool nog altijd geschikter.
Geen monitoring van LinkedIn- of X-activiteit
Page Deltas observeert het openbare web. Activiteit van personen op LinkedIn of X hoort thuis op MultiFollow. Trefwoordvermeldingen op LinkedIn, X, Reddit en elders horen thuis op KWatch.
Webhook-bezorging kent nu één poging
Bouw idempotente ontvangende endpoints.
Verzin geen eigen veldnamen
Kopieer datastructuren uit de actuele API-referentie en negeer onbekende JSON-sleutels.
API-referentie →Gerelateerde gidsen en documentatie
Inrichting voor teams in Slack, de no-code snelstart en de actuele API-specificaties.
Slack-wijzigingsmeldingen
Koppel dezelfde monitor aan een Slack incoming webhook om meldingen naar collega's in plaats van systemen te sturen.
Meldingen van websitewijzigingen ontvangen in Slack →Snelstartgids
No-code traject: voer een URL in, schrijf de briefing, kies een kanaal en klik op Test verzenden.
Snelstartgids →API-referentie
Actuele structuren van requests en responses. Neem veldnamen hiervandaan over en negeer onbekende JSON-sleutels.
API-referentie →MCP-documentatie
Codevoorbeelden voor Claude Code, Cursor, VS Code en Claude Desktop.
MCP-documentatie →Veelgestelde vragen
- Hoe haal ik data op van een website zonder API?
- U heeft drie opties: zelf een scraper bouwen, een scraping-API inzetten voor bulkextractie, of een change-monitoring API op de pagina richten en de JSON-change-feed consumeren. Voor het scenario "meld mijn systeem wanneer deze pagina wijzigt", vereist de change-feed doorgaans de minste code: maak een monitor aan en gebruik een webhook of polling.
- Kan ik dit instellen zonder code te schrijven?
- Ja. Maak de monitor aan in het dashboard, voeg onder Kanalen een generieke webhook toe (of Slack / Teams / Discord / e-mail), schrijf de briefing en klik op Test verzenden. De snelstartgids toont het no-code traject.
- Wat is het verschil tussen een scraping-API en een change-monitoring API?
- Een scraping-API haalt bij elke aanroep de volledige pagina-inhoud op. Een change-monitoring API volgt de pagina continu en stuurt uitsluitend de wijzigingen door, inclusief een vooraf berekende AI-samenvatting. Data-extractie vraagt om scrapers. De vraag "is er iets veranderd dat voldoet aan mijn briefing?" vraagt om een change-feed.
- Kost toegang tot de API of webhooks extra?
- Nee. De REST API, MCP en ondertekende webhooks zijn inbegrepen in elk abonnement, inclusief het gratis pakket. Het gebruik wordt uitsluitend begrensd door de URL-limiet van uw abonnement, niet door een aparte API-tegoedmeter.
- Kunnen AI-agents monitors voor mij aanmaken?
- Ja. Verbind een MCP-client met https://api.pagedeltas.com/mcp via een Bearer API-sleutel. Raadpleeg de MCP-documentatie.
Auteur
Julien, Product Manager bij Page Deltas. Kies één openbare URL die u nu handmatig ververst. Maak een gratis account aan, genereer een API-sleutel, stel de monitor in met een briefing van één zin, koppel een generieke webhook, verifieer eenmalig de HMAC-handtekening en wacht op de eerste echte melding. Verfijn eventueel de uitsluitingen na de eerste ongewenste melding. Dat is meestal de volledige opzet van een change-API.
Begin met één pagina als change-feed
Gratis abonnement, geen creditcard nodig. Maak een account aan, genereer een API-sleutel, voer de URL in die u nu handmatig in de gaten houdt, voeg een briefing toe uit de filtergids en poll /changes of ontvang ondertekende JSON via POST op uw eigen endpoint.