Skip to main content
Sources

Bulk Google Search Source

post/v1/sources/tasks

Authorizations

Authorizationstringheaderrequired

Use an account access token as Bearer <token>.

Get an access 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.

Outputs​

Each result is a JSON object with the fields below. Sources do not wrap results in inputId, status, or outputs. Fields depend on your settings and the data found; extra fields can appear before the catalog lists them.

resultTitlestringrequired
resultSnippetstring
resultLinkstringrequired
format: "uri"
resultPositionnumberrequired

The result position in Google.

resultQuerystringrequired

Search query used to get this result.

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 and results​

The API returns 202 Accepted with a task ID. Save it, then check links.self every few seconds. Once status is completed, failed, or stopped, read links.results. Failed and stopped tasks can still have useful results. See the task reference.

Example results (sample data and credit amounts):

json
{
  "taskId": "00000000000040008000000000000001",
  "results": [
    {
      "resultTitle": "Example Company",
      "resultSnippet": "An illustrative search result.",
      "resultLink": "https://example.com",
      "resultPosition": 1,
      "resultQuery": "example business software"
    }
  ],
  "nextCursor": null
}

If nextCursor is not null, pass it unchanged in the next request to get more results. Pages default to 50 results; limit accepts 1–100. A page is at most 128 KiB, so it may contain fewer results than requested.