drain.lat API

GET /search

Search Google and retrieve structured web results with metadata.

GET /api/v1/googlesearch/search

string

required

Search query/keywords.

num

number

Number of results to return. Max 10. Default 10.

start

number

Starting index for pagination. Default 1.

safe

string

Safe search level. Options: off, medium, high.

string

Language restrict (e.g. lang_en for English, lang_es for Spanish).

dateRestrict

string

Date restrict filter (e.g. d7 for last 7 days, m1 for last month, y1 for last year).

siteSearch

string

Restrict results to a specific site (e.g. github.com).

fileType

string

File type filter (e.g. pdf, doc, ppt, xls).

curl "https://drain.lat/api/v1/googlesearch/search?q=nodejs&num=5" \
  -H "x-api-key: YOUR_API_KEY"

query

string

The search query used.

totalResults

number

Estimated total results available.

searchTime

number

Search execution time in seconds.

results

array

Show result object

title

string

Page title.

link

string

URL to the page.

snippet

string

Text snippet/description from the page.

displayLink

string

Domain name displayed.

formattedUrl

string

Formatted URL for display.

image

string

Image URL if result has an associated image. null otherwise.

thumbnail

string

Thumbnail URL if available. null otherwise.

Response

{
  "query": "nodejs",
  "totalResults": 1250000000,
  "searchTime": 0.42,
  "results": [
    {
      "title": "Node.js — Run JavaScript Everywhere",
      "link": "https://nodejs.org/",
      "snippet": "Node.js® is a JavaScript runtime built on Chrome's V8 JavaScript engine.",
      "displayLink": "nodejs.org",
      "formattedUrl": "https://nodejs.org/",
      "image": null,
      "thumbnail": null
    },
    {
      "title": "Node.js - Wikipedia",
      "link": "https://en.wikipedia.org/wiki/Node.js",
      "snippet": "Node.js is a cross-platform, open-source JavaScript runtime environment that can run on Windows, Linux, Unix, macOS, and more.",
      "displayLink": "en.wikipedia.org",
      "formattedUrl": "https://en.wikipedia.org/wiki/Node.js",
      "image": "https://upload.wikimedia.org/wikipedia/commons/...",
      "thumbnail": "https://encrypted-tbn0.gstatic.com/images?q=..."
    }
  ],
  "scrapedAt": "2026-06-01T12:00:00.000Z"
}

Pagination

To get the next page of results, increment the start parameter by the number of results per page:

# First page (results 1-10)
GET /api/v1/googlesearch/search?q=nodejs&num=10

# Second page (results 11-20)
GET /api/v1/googlesearch/search?q=nodejs&num=10&start=11

# Third page (results 21-30)
GET /api/v1/googlesearch/search?q=nodejs&num=10&start=21

Filter Examples

# Search within a specific site
GET /api/v1/googlesearch/search?q=react&siteSearch=github.com

# Search for PDFs only
GET /api/v1/googlesearch/search?q=machine+learning&fileType=pdf

# Search in English, last 7 days
GET /api/v1/googlesearch/search?q=news&lr=lang_en&dateRestrict=d7

# Search for recent tutorials
GET /api/v1/googlesearch/search?q=python+tutorial&dateRestrict=m1

# Safe search enabled
GET /api/v1/googlesearch/search?q=education&safe=high

Date Restrict Options

Value	Description
`d[n]`	Last n days (e.g. `d7` = last 7 days)
`w[n]`	Last n weeks (e.g. `w2` = last 2 weeks)
`m[n]`	Last n months (e.g. `m6` = last 6 months)
`y[n]`	Last n years (e.g. `y1` = last year)

Language Codes

Code	Language
`lang_en`	English
`lang_es`	Spanish
`lang_fr`	French
`lang_de`	German
`lang_ja`	Japanese
`lang_zh-CN`	Chinese (Simplified)
`lang_ar`	Arabic
`lang_pt`	Portuguese

Uses Google Custom Search API quota (100 queries per day on free tier). Returns 429 error when quota is exceeded. Results are cached for 10 minutes to reduce quota usage.

Google Search

Google Search

Filter Examples

Date Restrict Options

Language Codes

​Google Search

​Pagination

​Filter Examples

​Date Restrict Options

​Language Codes

Google Search

Pagination

Filter Examples

Date Restrict Options

Language Codes