Bowmark AIdocs

Serper

Google's own search results as JSON through Serper's API — honours site:, quoted phrases and every other Google operator, in about a second.

Google's own search results as JSON through Serper's API — honours site:, quoted phrases and every other Google operator, in about a second. Uses Bowmark's Serper key and charges each search to your account, or your own key sent as the x-bowmark-vendor-key-serper header.

Domain: serper.dev

Also known as: Serper, serper.dev, Serper API

Prefer the capability

bowmark.booking_links covers this provider and routes around it when it is having a bad day. Reach for this page when you need serper.dev specifically.

Call it directly

bowmark.providers.serper.searchGoogle(query: string, opts?: SerperSearchOptions): Promise<SerperSearchResult>

Functions

FunctionWhat it does
searchGoogleRuns a Google search and returns Google's organic results — position, title, destination url, snippet — with every Google operator honoured.

Types

interface SerperOrganicResult {
  position: number;
  title: string;
  link: string;              // the destination url
  snippet: string | null;
  date: string | null;
}

interface SerperSearchOptions {
  num?: number;              // 1-100, default 10
  gl?: string;               // country, e.g. "us"
  hl?: string;               // language, e.g. "en"
}

interface SerperSearchResult {
  query: string;
  results: SerperOrganicResult[];   // empty only when Google matched nothing
  credits: number | null;           // Serper credits this search spent
  warnings: string[];
}
booking_linksBooking links — find a person's Calendly or Cal.com link and read its form — the capability this provider backs.
archive_orgAlso backs the same capability.
cal_comAlso backs the same capability.
calendlyAlso backs the same capability.
githubAlso backs the same capability.