Get every page URL from a website sitemap, from your AI assistant, no-code workflow or own code.
Pick your tool, copy the line and paste it in. The AI does the setup. You only paste your API key when it asks.
Set up the Datablist Sitemap Scraper API for me.
Here's the documentation: github.com/b1b1h-m1k3r/datablist-api-setup
Set up the Datablist Sitemap Scraper API for me.
Here's the documentation: github.com/b1b1h-m1k3r/datablist-api-setup
Set up the Datablist Sitemap Scraper API for me.
Here's the documentation: github.com/b1b1h-m1k3r/datablist-api-setup
Set up the Datablist Sitemap Scraper API in Make for me.
Here's the documentation: github.com/b1b1h-m1k3r/datablist-api-setup
Set up the Datablist Sitemap Scraper API in n8n for me.
Here's the documentation: github.com/b1b1h-m1k3r/datablist-api-setup
Set up the Datablist Sitemap Scraper API in Zapier for me.
Here's the documentation: github.com/b1b1h-m1k3r/datablist-api-setup
Let an AI assistant or your automation tool do the setup, or call the REST API from your own code.
Copy the prompt for Claude, ChatGPT or Cursor, or for Make, n8n or Zapier, and paste it in. The AI creates a Datablist folder on your computer and sets everything up.
When the AI asks, copy your API key from the Datablist app and paste it into the .env file it opened. Never paste it into the chat.
Send a sitemap URL and get one row back per page: the page URL and when it was last updated, ready for an audit, a scraper or your sheet.
See a sample resultUse the HTTP request module or node your tool offers. You need three steps: start the task, wait, then read the results.
POSThttps://api.datablist.com/v1/sources/tasksX-API-Key = your API keyContent-Type = application/json{
"sourceId": "sitemap-source",
"uniqueId": "sitemap-source-run-1",
"settings": {
"sitemapUrl": "https://northpeak-coffee.de/sitemap.xml",
"filterRegex": "/blog/"
}
}@id from the response. That is your task ID.Add a short wait or delay, then a GET request to https://api.datablist.com/v1/sources/tasks/TASK_ID with the same X-API-Key header. Repeat until status is completed.
GET https://api.datablist.com/v1/sources/tasks/TASK_ID/results?limit=50. Map the fields of each result to your columns. If nextCursor is not empty, call again with &cursor= plus that value.
Create a task with one request. The full script with polling and results is in the developer section.
curl --request POST 'https://api.datablist.com/v1/sources/tasks' \ --header 'X-API-Key: YOUR_PERSONAL_API_KEY' \ --header 'Content-Type: application/json' \ --data '{ "sourceId": "sitemap-source", "uniqueId": "sitemap-source-run-1", "settings": { "sitemapUrl": "https://northpeak-coffee.de/sitemap.xml", "filterRegex": "/blog/" } }'
import requests
response = requests.post(
"https://api.datablist.com/v1/sources/tasks",
headers={"X-API-Key": "YOUR_PERSONAL_API_KEY"},
json={
"sourceId": "sitemap-source",
"uniqueId": "sitemap-source-run-1",
"settings": {
"sitemapUrl": "https://northpeak-coffee.de/sitemap.xml",
"filterRegex": "/blog/"
}
},
)
task = response.json()
print(task["@id"], task["status"])const response = await fetch("https://api.datablist.com/v1/sources/tasks", { method: "POST", headers: { "X-API-Key": "YOUR_PERSONAL_API_KEY", "Content-Type": "application/json", }, body: JSON.stringify({ "sourceId": "sitemap-source", "uniqueId": "sitemap-source-run-1", "settings": { "sitemapUrl": "https://northpeak-coffee.de/sitemap.xml", "filterRegex": "/blog/" } }), }); const task = await response.json(); console.log(task["@id"], task.status);
Read an XML sitemap, follow every sitemap listed in an index, and keep only the pages that match your filter. No Datablist workspace, collection or import needed.
Put Sitemap Scraper wherever your data already flows.
Pay per lookup with credits. API access starts on the Growth plan.
Tell us how many URLs you need and we'll show you the cheapest way to get them.
Everything you need to call the REST API directly: code, responses, endpoints, fields, authentication and limits.
A complete script that creates a task, waits for it and prints every result. Replace YOUR_PERSONAL_API_KEY with your key.
# 1. Create the task (returns 202 Accepted and the task "@id") curl --request POST 'https://api.datablist.com/v1/sources/tasks' \ --header 'X-API-Key: YOUR_PERSONAL_API_KEY' \ --header 'Content-Type: application/json' \ --data '{ "sourceId": "sitemap-source", "uniqueId": "sitemap-source-run-1", "settings": { "sitemapUrl": "https://northpeak-coffee.de/sitemap.xml", "filterRegex": "/blog/" } }' # 2. Poll every few seconds until status is completed, failed or stopped curl 'https://api.datablist.com/v1/sources/tasks/TASK_ID' \ --header 'X-API-Key: YOUR_PERSONAL_API_KEY' # 3. Read the results, then follow nextCursor until it is null curl 'https://api.datablist.com/v1/sources/tasks/TASK_ID/results?limit=50' \ --header 'X-API-Key: YOUR_PERSONAL_API_KEY'
import time import requests BASE = "https://api.datablist.com/v1/sources" HEADERS = {"X-API-Key": "YOUR_PERSONAL_API_KEY"} # 1. Create the task response = requests.post(f"{BASE}/tasks", headers=HEADERS, json={ "sourceId": "sitemap-source", "uniqueId": "sitemap-source-run-1", "settings": { "sitemapUrl": "https://northpeak-coffee.de/sitemap.xml", "filterRegex": "/blog/" } }) response.raise_for_status() task_id = response.json()["@id"] # 2. Poll until the task finishes while True: task = requests.get(f"{BASE}/tasks/{task_id}", headers=HEADERS).json() if task["status"] in ("completed", "failed", "stopped"): break time.sleep(5) # 3. Read every result page params = {"limit": 50} while True: page = requests.get(f"{BASE}/tasks/{task_id}/results", headers=HEADERS, params=params).json() for result in page["results"]: print(result) if not page["nextCursor"]: break params["cursor"] = page["nextCursor"]
// Node.js 18+ or any runtime with fetch. Keep your key on the server. const BASE = "https://api.datablist.com/v1/sources"; const HEADERS = { "X-API-Key": "YOUR_PERSONAL_API_KEY" }; const sleep = (ms) => new Promise((r) => setTimeout(r, ms)); // 1. Create the task const created = await fetch(`${BASE}/tasks`, { method: "POST", headers: { ...HEADERS, "Content-Type": "application/json" }, body: JSON.stringify({ "sourceId": "sitemap-source", "uniqueId": "sitemap-source-run-1", "settings": { "sitemapUrl": "https://northpeak-coffee.de/sitemap.xml", "filterRegex": "/blog/" } }), }); if (!created.ok) throw new Error(`Create failed: ${created.status}`); const taskId = (await created.json())["@id"]; // 2. Poll until the task finishes let task; do { await sleep(5000); task = await (await fetch(`${BASE}/tasks/${taskId}`, { headers: HEADERS })).json(); } while (!["completed", "failed", "stopped"].includes(task.status)); // 3. Read every result page let cursor = null; do { const url = new URL(`${BASE}/tasks/${taskId}/results`); url.searchParams.set("limit", "50"); if (cursor) url.searchParams.set("cursor", cursor); const page = await (await fetch(url, { headers: HEADERS })).json(); for (const result of page.results) { console.log(result); } cursor = page.nextCursor; } while (cursor);
One flat JSON object per generated record, plus a nextCursor for the next page. Sample data.
{
"taskId": "00000000000040008000000000000001",
"results": [
{
"sitemapPageUrl": "https://northpeak-coffee.de/blog/cold-brew",
"sitemapLastUpdated": "2026-10-13T00:00:00+00:00"
}
],
"nextCursor": null
}All paths are relative to https://api.datablist.com. Field definitions come from GET /v1/sources/sitemap-source (docs read Oct 29, 2026).
/v1/sources/sitemap-sourceRead the schema, no key needed/v1/sources/tasksCreate a task/v1/sources/tasks/{taskId}Poll status and progress/v1/sources/tasks/{taskId}/resultsRead results, 1 to 100 per page/v1/sources/tasks/{taskId}/stopCancel a running task/v1/sources/tasksTask history, newest firstsettings once per task. Sources need no input rows. Results can include extra fields as the source evolves, so keep unknown keys when you parse them.sitemapUrlrequiredSitemap URL |
URL | Full sitemap URL, such as https://www.datablist.com/sitemap.xml. Sitemap indexes are followed automatically. |
filterRegexRegex Filter |
Text | Keep only page URLs matching this regular expression. Matching ignores case. |
sitemapSourceLimitLimit |
Number | Maximum page URLs across the task. Defaults to 95,000, which is also the maximum. With several sitemaps processed at once, the count can exceed a smaller limit. |
sitemapPageUrlrequiredPage URL |
URL | Page URL listed in the sitemap. |
sitemapLastUpdatedLast Updated |
DateTime | Last modification date, or null when missing. Dates without a time use midnight UTC. |
Create a Personal API Key in your Datablist account and send it on every authenticated request.
Send your key in the X-API-Key header. Datablist exchanges and renews access tokens for you.
Learn the newest workflows with detailed step-by-step guides.
Everything you or your AI coding agent need to integrate the Sitemap Scraper API: auth, request, polling, results, limits and retries.
Chain Sitemap Scraper with other APIs, in your code, in the Datablist app or for free.