AkashiDocs
Providers

Serper

Google results as JSON: web (with answer box and knowledge panel), news, Google Scholar, local places and images.

  • Provider id: serper
  • Tools: 5, at $0.005 per call
  • Categories: Web Search, News, Research & Papers, Maps & Places
  • Homepage: serper.dev
  • Provider docs: serper.dev/playground
ToolPriceWhat it does
serper/images$0.005Google Images results: direct image URL, thumbnail, size and the page it appears on.
serper/news$0.005Google News results: headline, publisher, how long ago, snippet and link.
serper/places$0.005Local businesses from Google Maps: name, address, rating, review count, category, phone, website, coordinates.
serper/scholar$0.005Google Scholar results: paper titles, authors and venue, year, citation count and PDF links.
serper/search$0.005Google web results as JSON: titles, links, snippets, plus the answer box and knowledge panel.

Inputs are JSON bodies, and unknown fields are rejected with 422 invalid_input (not charged). POST /v1/inspect with a tool's id returns the same input schema, plus the output schema.

Serper Google Images

serper/images · $0.005 per call (standard) · Web Search

Google Images results: direct image URL, thumbnail, size and the page it appears on.

Image search through Google. Each result has the full-size image_url, a thumbnail_url, the pixel size, the title and url of the page that hosts it, and that site's name. It does not download, describe or check the licence of images: check the hosting page before reusing one.

Related: serper/search.

Input

FieldTypeRequiredDescription
querystringyesWhat to search for; Google operators such as site:, quotes and - work. 1–400 characters.
numintegernoResults to return. From 1 to 10. Default 8.
countrystringnoTwo-letter country to search from, e.g. 'us', 'ng' (Google's gl). Pattern ^[A-Za-z]{2}$.
languagestringnoResult language, e.g. 'en', 'fr', 'pt-br' (Google's hl). Pattern ^[A-Za-z]{2,3}(-[A-Za-z]{2,4})?$.

Example

Input
{
  "query": "golden gate bridge at night",
  "num": 5
}
Run it with the CLI
node akashi.mjs run serper/images --input '{"query":"golden gate bridge at night","num":5}'

Serper Google News

serper/news · $0.005 per call (standard) · News

Google News results: headline, publisher, how long ago, snippet and link.

Searches Google News live. Each article has its headline, link, publisher (source), a relative date such as '3 hours ago' and a snippet. Set time_range to 'day' for breaking stories. It returns headlines, not article bodies: open one with jina/read; for a cited summary of a story use akashi/answer.

Related: jina/read, serper/search, akashi/answer.

Input

FieldTypeRequiredDescription
querystringyesWhat to search for; Google operators such as site:, quotes and - work. 1–400 characters.
numintegernoResults to return. From 1 to 10. Default 8.
countrystringnoTwo-letter country to search from, e.g. 'us', 'ng' (Google's gl). Pattern ^[A-Za-z]{2}$.
languagestringnoResult language, e.g. 'en', 'fr', 'pt-br' (Google's hl). Pattern ^[A-Za-z]{2,3}(-[A-Za-z]{2,4})?$.
time_rangestringnoOnly results from the past day, week, month or year. One of day, week, month, year.
pageintegernoResults page, for more beyond the first. From 1 to 10. Default 1.

Example

Input
{
  "query": "solid-state battery",
  "num": 5,
  "time_range": "week"
}
Run it with the CLI
node akashi.mjs run serper/news --input '{"query":"solid-state battery","num":5,"time_range":"week"}'

Serper Google Places

serper/places · $0.005 per call (standard) · Maps & Places

Local businesses from Google Maps: name, address, rating, review count, category, phone, website, coordinates.

Finds businesses and points of interest the way Google Maps does: give what you want and, ideally, a location in words. Each place has its name, address, category, star rating and number of ratings, price level, phone, website, latitude/longitude and a Google Maps link. It does not return opening hours or reviews. To turn a city name into coordinates use openweather/geocode.

Related: openweather/geocode, serper/search.

Input

FieldTypeRequiredDescription
querystringyesWhat to look for, e.g. 'coffee shops' or 'pharmacy open now'. 1–200 characters.
numintegernoResults to return. From 1 to 10. Default 8.
countrystringnoTwo-letter country to search from, e.g. 'us', 'ng' (Google's gl). Pattern ^[A-Za-z]{2}$.
languagestringnoResult language, e.g. 'en', 'fr', 'pt-br' (Google's hl). Pattern ^[A-Za-z]{2,3}(-[A-Za-z]{2,4})?$.
locationstringnoWhere, in words: 'Lagos, Nigeria', 'Austin, Texas'. Without it, Google guesses from the query and country. 2–100 characters.

Example

Input
{
  "query": "coffee shops",
  "location": "Lagos, Nigeria",
  "num": 5
}
Run it with the CLI
node akashi.mjs run serper/places --input '{"query":"coffee shops","location":"Lagos, Nigeria","num":5}'

Serper Google Scholar

serper/scholar · $0.005 per call (standard) · Research & Papers

Google Scholar results: paper titles, authors and venue, year, citation count and PDF links.

Searches Google Scholar by keyword and returns each paper's title, link, the author/venue line Scholar prints, year, how many times it is cited and a free PDF link when Scholar knows one. Keyword ranking, citation-weighted, no abstracts. For meaning-based search over abstracts use firecrawl/research-papers, then firecrawl/read-paper for the passages inside a paper.

Related: firecrawl/research-papers, firecrawl/read-paper, serper/search.

Input

FieldTypeRequiredDescription
querystringyesWhat to search for; Google operators such as site:, quotes and - work. 1–400 characters.
numintegernoResults to return. From 1 to 10. Default 8.
countrystringnoTwo-letter country to search from, e.g. 'us', 'ng' (Google's gl). Pattern ^[A-Za-z]{2}$.
languagestringnoResult language, e.g. 'en', 'fr', 'pt-br' (Google's hl). Pattern ^[A-Za-z]{2,3}(-[A-Za-z]{2,4})?$.

Example

Input
{
  "query": "retrieval augmented generation",
  "num": 5
}
Run it with the CLI
node akashi.mjs run serper/scholar --input '{"query":"retrieval augmented generation","num":5}'

serper/search · $0.005 per call (standard) · Web Search

Google web results as JSON: titles, links, snippets, plus the answer box and knowledge panel.

Runs a live Google search and returns the organic results (title, url, snippet, date) together with Google's own answer box and knowledge panel when it shows one, 'people also ask' questions and related searches. Snippets only: it does not open the pages. Read a result with jina/read; get every result's page text in one call with jina/search; for a written answer with citations use akashi/answer.

Related: akashi/answer, jina/read, jina/search, serper/news.

Input

FieldTypeRequiredDescription
querystringyesWhat to search for; Google operators such as site:, quotes and - work. 1–400 characters.
numintegernoResults to return. From 1 to 10. Default 8.
countrystringnoTwo-letter country to search from, e.g. 'us', 'ng' (Google's gl). Pattern ^[A-Za-z]{2}$.
languagestringnoResult language, e.g. 'en', 'fr', 'pt-br' (Google's hl). Pattern ^[A-Za-z]{2,3}(-[A-Za-z]{2,4})?$.
time_rangestringnoOnly results from the past day, week, month or year. One of day, week, month, year.
pageintegernoResults page, for more beyond the first. From 1 to 10. Default 1.

Example

Input
{
  "query": "who invented the transistor",
  "num": 5
}
Run it with the CLI
node akashi.mjs run serper/search --input '{"query":"who invented the transistor","num":5}'

On this page