Bulk Google Search Source

Create Bulk Google Search Source task

post/v1/sources/tasks

Authorizations

Authorizationstringheaderrequired

Use an account access token as Bearer <token>.

Run Google searches and retrieve the results as JSON objects. Send one query per line; Datablist processes them within the same task. You do not need a collection or input rows.

Public ID: bulk-google-source. Get the current definition. You can read it without authentication. Confirm availability in the source catalog.

Settings

Put one query per line in searchQuery, with at most 100 queries per task.

Country and language default to us and en. Set searchPeriod to restrict the time window. searchLimit sets the maximum results per query: 400 by default, up to 1,000. Google may return fewer.

Use resultQuery to identify the query and resultPosition for its search rank. The order of API results is not the search ranking.

searchQuerystringrequired

One Google query per line, such as ceo paris site:linkedin.com/in/.

searchCountrystring

Google country setting. Default to US.

Allowed values:

"ad", "ae", "af", "ag", "ai", "al", "am", "an", "ao", "aq", "ar", "as", "at", "au", "aw", "az", "ba", "bb", "bd", "be", "bf", "bg", "bh", "bi", "bj", "bm", "bn", "bo", "br", "bs", "bt", "bv", "bw", "by", "bz", "ca", "cc", "cd", "cf", "cg", "ch", "ci", "ck", "cl", "cm", "cn", "co", "cr", "cu", "cv", "cx", "cy", "cz", "de", "dj", "dk", "dm", "do", "dz", "ec", "ee", "eg", "eh", "er", "es", "et", "fi", "fj", "fk", "fm", "fo", "fr", "ga", "gb", "gd", "ge", "gf", "gh", "gi", "gl", "gm", "gn", "gp", "gq", "gr", "gs", "gt", "gu", "gw", "gy", "hk", "hm", "hn", "hr", "ht", "hu", "id", "ie", "il", "in", "io", "iq", "ir", "is", "it", "jm", "jo", "jp", "ke", "kg", "kh", "ki", "km", "kn", "kp", "kr", "kw", "ky", "kz", "la", "lb", "lc", "li", "lk", "lr", "ls", "lt", "lu", "lv", "ly", "ma", "mc", "md", "mg", "mh", "mk", "ml", "mm", "mn", "mo", "mp", "mq", "mr", "ms", "mt", "mu", "mv", "mw", "mx", "my", "mz", "na", "nc", "ne", "nf", "ng", "ni", "nl", "no", "np", "nr", "nu", "nz", "om", "pa", "pe", "pf", "pg", "ph", "pk", "pl", "pm", "pn", "pr", "ps", "pt", "pw", "py", "qa", "re", "ro", "rs", "ru", "rw", "sa", "sb", "sc", "sd", "se", "sg", "sh", "si", "sj", "sk", "sl", "sm", "sn", "so", "sr", "st", "sv", "sy", "sz", "tc", "td", "tf", "tg", "th", "tj", "tk", "tl", "tm", "tn", "to", "tr", "tt", "tv", "tw", "tz", "ua", "ug", "uk", "um", "us", "uy", "uz", "va", "vc", "ve", "vg", "vi", "vn", "vu", "wf", "ws", "ye", "yt", "za", "zm", "zw"

searchLanguagestring

Google language setting. Default to English.

Allowed values:

"ach", "af", "ak", "am", "ar", "az", "be", "bem", "bg", "bh", "bn", "br", "bs", "ca", "chr", "ckb", "co", "crs", "cs", "cy", "da", "de", "ee", "el", "en", "eo", "es", "es-419", "et", "eu", "fa", "fi", "fo", "fr", "fy", "ga", "gaa", "gd", "gl", "gn", "gu", "ha", "haw", "hi", "hr", "ht", "hu", "hy", "ia", "id", "ig", "is", "it", "iw", "ja", "jw", "ka", "kg", "kk", "km", "kn", "ko", "kri", "ku", "ky", "la", "lg", "ln", "lo", "loz", "lt", "lua", "lv", "mfe", "mg", "mi", "mk", "ml", "mn", "mo", "mr", "ms", "mt", "ne", "nl", "nn", "no", "nso", "ny", "nyn", "oc", "om", "or", "pa", "pcm", "pl", "ps", "pt", "pt-br", "pt-pt", "qu", "rm", "rn", "ro", "ru", "rw", "sd", "sh", "si", "sk", "sl", "sn", "so", "sq", "sr", "sr-ME", "st", "su", "sv", "sw", "ta", "te", "tg", "th", "ti", "tk", "tl", "tn", "to", "tr", "tt", "tum", "tw", "ug", "uk", "ur", "uz", "vi", "wo", "xh", "xx-bork", "xx-elmer ", "xx-hacker ", "xx-klingon", "xx-pirate", "yi", "yo", "zh-cn", "zh-tw", "zu"

searchPeriodstring

The time period for the results.

Allowed values: "last_hour", "last_day", "last_week", "last_month", "last_year"

searchLimitnumber

Maximum results requested per query. API tasks default to 400 and accept up to 1,000. Google may return fewer results.

Additional properties are supported.

Credits and limits

Cost: 2.5 credits per 10 results.

Each query costs 2.5 credits per group of up to 10 returned results, rounded up independently. For example, 11 results for one query cost 5 credits. Different queries are charged separately; result ordering and API page sizes do not change charging.

Tasks can run for up to 24 hours; completed, failed, or stopped tasks are kept for 90 days. Enrichment and source tasks share your account balance and task limits. Set maxCredits to stop starting new work after a credit threshold; work already underway can still exceed it. See limits and errors.

Accepted task

The API returns 202 Accepted with a task ID. Save it and check links.self every few seconds. Once the task is completed, failed, or stopped, get Bulk Google Search Source task results. The response below is sample data.

Bulk Google Search Source overview · Shared task reference

Request

import requests

url = "https://api.datablist.com/v1/sources/tasks"

headers = {
    "Accept": "application/json",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

payload = {
    "sourceId": "bulk-google-source",
    "uniqueId": "bulk-google-source-example",
    "settings": {
        "searchQuery": "example business software\nexample business services",
        "searchCountry": "us",
        "searchLanguage": "en",
        "searchLimit": 20
    }
}

response = requests.post(url, headers=headers, json=payload)

print(response.text)

Response · illustrative example

{
  "@id": "00000000000040008000000000000001",
  "@type": "SourceTask",
  "kind": "source",
  "sourceId": "bulk-google-source",
  "uniqueId": "bulk-google-source-example",
  "status": "queued",
  "createdAt": "2026-10-09T10:00:00Z",
  "startedAt": null,
  "finishedAt": null,
  "progress": {
    "results": 0
  },
  "credits": {
    "used": "0",
    "max": null
  },
  "error": null,
  "links": {
    "self": "https://api.datablist.com/v1/sources/tasks/00000000000040008000000000000001",
    "results": "https://api.datablist.com/v1/sources/tasks/00000000000040008000000000000001/results"
  }
}

Authorizations

Settings​

Credits and limits​

Accepted task​

Settings

Credits and limits

Accepted task