Defaults: gl=US, hl=en. For best accuracy, keep the query language consistent with gl/hl — e.g. a Chinese query with gl=CN&hl=zh-CN. A locale that conflicts with the query language tends to lower the success rate and reduce result relevance.
Reverse image search via Google Lens. Provide an image url or upload the image file. Auth via Authorization: Bearer YOUR_API_KEY. Credits are consumed only for successful searches.
Request — provide either url (JSON body) or image (multipart/form-data):
ParamDefaultDescription
url—Public image URL. One of url / image required.
image—Image file (binary) via multipart/form-data. One of url / image required.
hlenResult language / localization (e.g. en, zh-CN).
Two input modes (pick one): url — send JSON {"url":"…","hl":"…"}. image — send multipart/form-data with an image file field. hl defaults to en.
Google Images search (udm=2) — returns image results as structured JSON. Same query params as Google Search Advanced. Auth via Authorization: Bearer YOUR_API_KEY. Credits are consumed only for successful searches.
page1Result page number (max 5). Each page returns ~50 images.
Same locale rules as Google Search: defaults gl=US, hl=en; keep the query language consistent with gl/hl. page max is 5; each page returns roughly 50 images.
Bing web search — returns structured JSON. Defaults to Chinese results / China region. Auth via Authorization: Bearer YOUR_API_KEY. Credits are consumed only for successful searches.
Request parameters (JSON body):
ParamDefaultDescription
q—Search query. Required.
langzh-CNLanguage / region code, e.g. zh-CN, en-US, ja-JP, zh-TW. Full list below.
Defaults to lang=zh-CN (Chinese / China). Returns the first page only.
When each module appears (Bing decides per query — a module is omitted when Bing doesn't render it):
· answer_box — factual / "how much / how tall" queries with a concrete answer (cost, height, date…).
· ai_overview — complex or event queries; shown inconsistently by Bing.
· knowledge_graph — entity queries (people / brands / companies) that Bing has an encyclopedia or official-site card for; many queries have none.
· top_stories — trending people / events that currently have news.
· people_also_ask — person / topic queries. Questions only — Bing loads the answers asynchronously.
· people_also_search_for — almost always present.
· you_might_like — how-to / guide queries; shown inconsistently by Bing.
· organic — always present.
POST /serp/google/scholar/advanced
Google Scholar academic search — returns structured JSON. Every left-hand filter is a request param. Auth via Authorization: Bearer YOUR_API_KEY. Credits are consumed only for successful searches.
Request parameters (JSON body):
ParamDefaultDescription
q—Search query. Required.
hlenInterface language (e.g. en, zh-CN).
sortrelevancedate = sort by date (recent articles); default sorts by relevance.
since_year—Only results from this year onward (e.g. 2022).
until_year—Only results up to this year (with since_year = custom range).
review_articlesfalseOnly review articles.
include_patentsfalseInclude patents in results.
include_citationstrueInclude [CITATION] entries; set false to exclude.
lr—Limit result languages, e.g. lang_en or lang_zh-CN|lang_en.
page1Result page number (max 100). 10 results per page.
These map 1:1 to Google Scholar's left-hand sidebar (Sort by date, Since year / custom range, Review articles, include patents / citations). Only q is required; hl defaults to en.
Google Scholar Case law (US court opinions) search — returns structured JSON. Every left-hand filter is a request param. Auth via Authorization: Bearer YOUR_API_KEY. Credits are consumed only for successful searches.
Request parameters (JSON body):
ParamDefaultDescription
q—Search query. Required.
hlenInterface language (e.g. en, zh-CN).
courtallCourt scope preset: all (all case law), federal (US federal courts), california. Ignored when courts is given.
courts—Select specific courts — array or comma list of court IDs, e.g. [60,131] or "215,216". Overrides court. See court ID reference below.
sortrelevancedate = sort by date; default sorts by relevance.
since_year—Only opinions from this year onward (e.g. 2015).
until_year—Only opinions up to this year (with since_year = custom range).
include_citationstrueInclude citation-only entries; set false to exclude.
page1Result page number (max 100). 10 results per page.
These map 1:1 to Google Scholar's Case law sidebar (Case law / Federal courts / California courts / Select courts…, Any time / Since year / custom range, Sort by relevance / date, include citations). Only q is required.
Court ID reference (for courts — Select courts)
Presets (via court): all = all case law · federal = all US federal courts · california = all California courts.
Federal: US Supreme Court 60 · Courts of Appeals 1st–11th 119,122,123,124,125,126,127,128,129,120,121 · D.C. Cir. 130 · Federal Circuit 131 · US Tax Court 192.
State group IDs (each selects all courts in that state): Alabama 1, Alaska 2, Arizona 3, Arkansas 4, California 5, Colorado 6, Connecticut 7, Delaware 8, DC 9, Florida 10, Georgia 11, … New York 33, … Texas 44, … Wyoming 51. Pass one or more after the preset, e.g. "courts":[33,192] → New York + US Tax Court.