Run many Google searches at once and get every result, 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 Bulk Google Search API for me.
Here's the documentation: github.com/b1b1h-m1k3r/datablist-api-setup
Set up the Datablist Bulk Google Search API for me.
Here's the documentation: github.com/b1b1h-m1k3r/datablist-api-setup
Set up the Datablist Bulk Google Search API for me.
Here's the documentation: github.com/b1b1h-m1k3r/datablist-api-setup
Set up the Datablist Bulk Google Search API in Make for me.
Here's the documentation: github.com/b1b1h-m1k3r/datablist-api-setup
Set up the Datablist Bulk Google Search API in n8n for me.
Here's the documentation: github.com/b1b1h-m1k3r/datablist-api-setup
Set up the Datablist Bulk Google Search 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 your list of searches and get one row back per Google result: title, link, snippet, position and the search that found it.
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": "bulk-google-source",
"uniqueId": "bulk-google-source-run-1",
"settings": {
"searchQuery": [
"coffee roaster hamburg",
"coffee roaster berlin",
"coffee roaster munich"
],
"searchCountry": "de",
"searchLanguage": "de",
"searchLimit": 100
}
}@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": "bulk-google-source", "uniqueId": "bulk-google-source-run-1", "settings": { "searchQuery": [ "coffee roaster hamburg", "coffee roaster berlin", "coffee roaster munich" ], "searchCountry": "de", "searchLanguage": "de", "searchLimit": 100 } }'
import requests
response = requests.post(
"https://api.datablist.com/v1/sources/tasks",
headers={"X-API-Key": "YOUR_PERSONAL_API_KEY"},
json={
"sourceId": "bulk-google-source",
"uniqueId": "bulk-google-source-run-1",
"settings": {
"searchQuery": [
"coffee roaster hamburg",
"coffee roaster berlin",
"coffee roaster munich"
],
"searchCountry": "de",
"searchLanguage": "de",
"searchLimit": 100
}
},
)
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": "bulk-google-source", "uniqueId": "bulk-google-source-run-1", "settings": { "searchQuery": [ "coffee roaster hamburg", "coffee roaster berlin", "coffee roaster munich" ], "searchCountry": "de", "searchLanguage": "de", "searchLimit": 100 } }), }); const task = await response.json(); console.log(task["@id"], task.status);
Search wide instead of deep: run up to 100 Google queries in one task, in the country and language you need, and keep the query behind every result. No Datablist workspace, collection or import needed.
Put Bulk Google Search wherever your data already flows.
Pay per lookup with credits. API access starts on the Growth plan.
Tell us how many Google results 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": "bulk-google-source", "uniqueId": "bulk-google-source-run-1", "settings": { "searchQuery": [ "coffee roaster hamburg", "coffee roaster berlin", "coffee roaster munich" ], "searchCountry": "de", "searchLanguage": "de", "searchLimit": 100 } }' # 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": "bulk-google-source", "uniqueId": "bulk-google-source-run-1", "settings": { "searchQuery": [ "coffee roaster hamburg", "coffee roaster berlin", "coffee roaster munich" ], "searchCountry": "de", "searchLanguage": "de", "searchLimit": 100 } }) 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": "bulk-google-source", "uniqueId": "bulk-google-source-run-1", "settings": { "searchQuery": [ "coffee roaster hamburg", "coffee roaster berlin", "coffee roaster munich" ], "searchCountry": "de", "searchLanguage": "de", "searchLimit": 100 } }), }); 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": [
{
"resultTitle": "Northpeak Coffee Roasters | Specialty coffee from Hamburg",
"resultSnippet": "Small batch roastery in Hamburg. Order beans online or visit our cafe.",
"resultLink": "https://northpeak-coffee.de",
"resultPosition": 1,
"resultQuery": "coffee roaster hamburg"
}
],
"nextCursor": null
}All paths are relative to https://api.datablist.com. Field definitions come from GET /v1/sources/bulk-google-source (docs updated Oct 19, 2026).
/v1/sources/bulk-google-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.searchQueryrequiredGoogle Search Queries |
List | Google searches, one complete query per array element, commas included. At most 100 per task. |
searchCountrySearch Country |
Text | Google country as a lowercase code, such as "de" or "fr". Defaults to "us". |
searchLanguageSearch Language |
Text | Google language code, such as "de" or "pt-br". Defaults to "en". |
searchPeriodTime Period |
Text | Only results from a recent period. One of: "last_hour", "last_day", "last_week", "last_month", "last_year". |
searchLimitLimit per query |
Number | Maximum results per query. Defaults to 400, up to 1,000. Google may return fewer. |
resultTitlerequiredResult Title |
Text | Page title as shown by Google. |
resultSnippetResult Snippet |
Text | Short description shown under the title. |
resultLinkrequiredResult Link |
URL | Link of the result. |
resultPositionrequiredPosition |
Number | Position of the result in Google for its query. |
resultQueryrequiredSearch Query |
Text | The query that returned this result. |
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 Bulk Google Search API: auth, request, polling, results, limits and retries.
Chain Bulk Google Search with other APIs, in your code, in the Datablist app or for free.