Bulk import

Two ways to cover many pages at once: import a CSV of URLs as monitors, or add a sitemap and let Page Deltas watch it for newly published URLs.

CSV import (in the app)

From the dashboard, click Import CSV, choose your file, and Import monitors. Every row is validated; the valid set is created together, and any skipped rows are listed back with the reason so you can fix and re-upload just those. You need editor or admin access.

CSV import (via API)

The same flow is available programmatically. POST a multipart form with a single file field containing your CSV to /api/monitors/import, authenticated with a Bearer token.

curl -X POST https://api.pagedeltas.com/api/monitors/import \
  -H "Authorization: Bearer $PAGEDELTAS_TOKEN" \
  -F "[email protected]"

The JSON response reports what happened:

{
  "created": 2,
  "skipped": 1,
  "errors": [
    { "row": 4, "url": "notaurl", "reason": "invalid URL" }
  ]
}

CSV format

A header row is required (column names are case-insensitive; a UTF-8 BOM is tolerated). Recognised columns:

Column	Required	Notes
`url`	yes	Full URL including scheme. Duplicate URLs are flagged.
`description`	no	Natural-language note describing the page and what you care about.
`filter_prompt`	no	Optional explicit instruction for the LLM filter. See Filters.

There is no frequency column — checks are scheduled adaptively (see How monitoring works). Any unrecognised columns are ignored.

Example:

url,description,filter_prompt
https://competitor.com/pricing,"Competitor pricing page","Alert on plan or price changes; ignore copy tweaks"
https://competitor.com/changelog,"Product changelog","Alert on new release entries only"
https://example.com/careers,"Engineering careers page","Alert on new senior+ roles"

Sitemap monitoring

Many sites publish a sitemap.xml listing their public URLs. Add one from the Sitemap Monitoring section (or POST /api/sitemap-monitors) and Page Deltas tracks the set of URLs it contains. When the sitemap gains new URLs, you get an alert listing them — so you learn about freshly published pages without watching the site by hand.

To add several sitemaps at once, use Import CSV on the Sitemap Monitoring page (or POST /api/sitemap-monitors/import with a multipart file field). The CSV needs a single sitemap_url column (a plain url column is also accepted); each row is validated and you get the same per-row result as the monitor importer above.