Google Scholar API
Last updated
Last updated
EndpointGET https://serpapi.abcproxy.com/search
Description
Our Google Scholar API allows you to scrape SERP results from a Google Scholar search query. The API is accessed through the following endpoint:
/search?engine=google_scholar
.A user may query the following:
https://serpapi.abcproxy.com/search
utilizing aGET
request. Head to the for a live and interactive demo.
Search Query
q
String
Yes
Parameter defines the query you want to search. You can also use helpers in your query such as: author:
, or source:
.
Usage of cites
parameter makes q
optional. Usage of cites
together with q
triggers search within citing articles.
Usage of cluster
together with q
and cites
parameters is prohibited. Use cluster
parameter only.
Coffee
Advanced Google Scholar Parameters
cites
String
No
Parameter defines unique ID for an article to trigger Cited By searches. Usage of cites
will bring up a list of citing documents in Google Scholar. Example value: cites=1275980731835430123
. Usage of cites
and q
parameters triggers search within citing articles.
cites=1275980731835430123
as_ylo
String
No
Parameter defines the year from which you want the results to be included. (e.g. if you set as_ylo parameter to the year 2018
, the results before that year will be omitted.). This parameter can be combined with the as_yhi parameter.
2018
as_yhi
String
No
Parameter defines the year until which you want the results to be included. (e.g. if you set as_yhi parameter to the year 2018
, the results after that year will be omitted.). This parameter can be combined with the as_ylo parameter.
2018
scisbd
String
No
Parameter defines articles added in the last year, sorted by date. It can be set to 1
to include only abstracts, or 2
to include everything. The default value is 0
which means that the articles are sorted by relevance
1
cluster
String
No
Parameter defines unique ID for an article to trigger All Versions searches. Example value: cluster=1275980731835430123
. Usage of cluster
together with q
and cites
parameters is prohibited. Use cluster
parameter only.
cluster=1275980731835430123
Localization
lr
String
No
Parameter defines one or multiple languages to limit the search to. It uses lang_{two-letter language code}
to specify languages and `
as a delimiter. (e.g.,
lang_fr
hl
String
No
en
Pagination
start
Int
No
Parameter defines the result offset. It skips the given number of results. It's used for pagination. (e.g., 0
(default) is the first page of results, 10
is the 2nd page of results, 20
is the 3rd page of results, etc.).
10
num
Int
No
Parameter defines the maximum number of results to return, ranging from 1 to 20, with a default of 10.
10
Search Type
as_sdt
String
No
-
Advanced Filters
safe
String
No
Parameter defines the level of filtering for adult content. It can be set to active
or off
, by default Google will blur explicit content.
off
filter
String
No
Parameter defines if the filters for 'Similar Results' and 'Omitted Results' are on or off. It can be set to 1
(default) to enable these filters, or 0
to disable these filters.
1
as_vis
String
No
Parameter defines whether you would like to include citations or not. It can be set to 1
to exclude these results, or 0
(default) to include them.
1
as_rr
String
No
Parameter defines whether you would like to show only review articles or not (these articles consist of topic reviews, or discuss the works or authors you have searched for). It can be set to 1
to enable this filter, or 0
(default) to show all results.
1
Serpapi Parameters
engine
String
Yes
Set parameter to google_scholar
to use the Google Finance API engine.
google_scholar
no_cache
boolean
No
Parameter will force SerpApi to fetch the results even if a cached version is already present. A cache is served only if the query and all parameters are exactly the same. Cache expires after 1h. Cached searches are free, and are not counted towards your searches per month. It can be set to false
(default) to allow results from the cache, or true
to disallow results from the cache.
true
orfalse
api_key
string
Yes
Parameter defines the SerpApi private key to use.
123
Response Body
Response Fields
search_parameters
Object
Contains query parameters and search context
search_metadata
Object
Contains timing and status information
search_information
Object
Search_information information parameter
query_displayed
string
query_displayed information parameter
profiles[]
Object[]
profiles information parameter
organic_results[]
Object[]
organic_results information parameter
related_searches[]
Object[]
related_searches information parameter
pagination
Object
pagination information parameter
Common Errors
200
400
API Key can not be empty
200
401
Param error
200
402
API Key error
200
403
Insufficient Balance
200
404
Deduction failed
200
405
Failed to record usage count
200
406
Unsupported engine
200
407
Network error
200
408
File not found
200
409
Limit param error
200
410
Build url error
200
411
Failed to QueryRecentRecord
200
412
Failed to find json
200
413
Get html error
200
414
HTML is empty
200
429
Too many request
Error Example
Parameter defines the language to use for the Google Scholar search. It's a two-letter language code. (e.g., en
for English, es
for Spanish, or fr
for French). Head to the for a full list of supported Google languages.
Parameter can be used either as a search type or a filter.
As a Filter (only works when searching articles):
0
- exclude patents (default).
7
- include patents.
As a Search Type:
4
- Select case law (US courts only). This will select all the State and Federal courts.
e.g. as_sdt=4
- Selects case law (all courts)
To select specific courts, see the full list of supported .
e.g. as_sdt=4,33,192
- 4
is the required value and should always be in the first position, 33
selects all New York courts and 192
selects Tax Court.
Values have to be separated by comma (,
)
as_sdt=4,33,192