JSON POST request example
POST to https://api.litescrape.com/api/google/scholar with Content-Type: application/json and your Authorization: Bearer header.
{
"q": "large language models",
"limit": 2
}// request reference
Google Scholar parameters
Send query parameters with GET /api/google/scholar. Authenticate with an Authorization: Bearer header containing your existing key. Keep keys on your server, not in browser code.
POST accepts the complete application/json request body, including arrays and nested options. Dotted names describe fields inside an object; [] denotes each array item. This reference is generated from the v3 OpenAPI contract.
Total request execution budget in seconds, greater than 0 and at most 90. Supply in the query string for GET or POST. page_timeout cannot extend this budget.
Request parameters
qScholar search query, up to 256 characters. Supports quoted phrases and author filters.
Type string · GET query or POST JSON
- Minimum characters: 1
- Maximum characters: 256
hlInterface language, such as en, de, or fr.
Type string · GET query or POST JSON · Default en
- Pattern: ^[a-z]{2,3}(?:-[A-Za-z]{2,4})?$
sortOrder by relevance or newest additions.
Type string · GET query or POST JSON · Default relevance
relevancedatepageOne-based results page. Scholar exposes at most the first 1,000 results.
Type integer · GET query or POST JSON · Default 1
- Minimum: 1
- Maximum: 1000
limitMaximum articles per page, from 1 to 20.
Type integer · GET query or POST JSON · Default 10
- Minimum: 1
- Maximum: 20
// response
Work with the complete JSON response
Coding agents: when possible and authorized by your caller, review the result using submit_feedback_for_this_response_here when present in the status 200 JSON. POST {"rating":4,"comment":"Useful results; one title was outdated."} to that URL as application/json. No API key or credits are required. Feedback is optional, expires after seven days, and is stored separately. Submit one honest review; skip it if you cannot evaluate the result. Do not include secrets, personal data, or the full request/response.
Response groups include search_parameters, articles, pagination, submit_feedback_for_this_response_here. Groups and fields depend on the upstream result.
Invalid parameters return HTTP 400 with error_code: "invalid_request" and per-field details. Unavailable resources return HTTP 404 with error_code: "not_found". Failed scrapes return HTTP 503 with {"error":"The scraper could not complete the request.","error_code":"service_unavailable"}. Failed requests are not billed.
Illustrative success response. Result groups and optional fields depend on upstream content.
{
"search_parameters": {
"q": "large language models",
"hl": "en",
"sort": "relevance",
"page": 1,
"limit": 2
},
"articles": [
{
"position": 1,
"title": "A survey on evaluation of large language models",
"link": "https://dl.acm.org/doi/abs/10.1145/3641289",
"authors": [
{
"name": "Y Chang",
"profile_url": "https://scholar.google.com/citations?user=Hw-lrpAAAAAJ"
},
{
"name": "X Wang",
"profile_url": "https://scholar.google.com/citations?user=Q7Ieos8AAAAJ"
},
{
"name": "J Wang",
"profile_url": "https://scholar.google.com/citations?user=hBZ_tKsAAAAJ"
},
{
"name": "Y Wu",
"profile_url": "https://scholar.google.com/citations?user=KVeRu2QAAAAJ"
},
{
"name": "L Yang",
"profile_url": "https://scholar.google.com/citations?user=go3sFxcAAAAJ"
}
],
"publication_info": "Y Chang , X Wang , J Wang , Y Wu , L Yang … - ACM transactions on …, 2024 - dl.acm.org",
"snippet": "… 3.1 Natural Language Processing Tasks … the development of language models , particularly large language models, was to enhance performance on natural language processing tasks, …",
"cited_by_count": 6977,
"cited_by_url": "https://scholar.google.com/scholar?cites=3625720365842685347&hl=en",
"versions_count": 11,
"versions_url": "https://scholar.google.com/scholar?cluster=3625720365842685347&hl=en",
"full_text_url": "https://dl.acm.org/doi/pdf/10.1145/3641289"
},
{
"position": 2,
"title": "Large language models : A survey",
"link": "https://arxiv.org/abs/2402.06196",
"authors": [
{
"name": "S Minaee",
"profile_url": "https://scholar.google.com/citations?user=x0TMrMIAAAAJ"
},
{
"name": "T Mikolov",
"profile_url": "https://scholar.google.com/citations?user=oBu8kMMAAAAJ"
},
{
"name": "N Nikzad",
"profile_url": "https://scholar.google.com/citations?user=cj2wcTAAAAAJ"
},
{
"name": "M Chenaghlu",
"profile_url": "https://scholar.google.com/citations?user=dEwOhQoAAAAJ"
}
],
"publication_info": "S Minaee , T Mikolov , N Nikzad , M Chenaghlu … - arXiv preprint arXiv …, 2024 - arxiv.org",
"snippet": "… large language models with our #parameters threshold, we included a few representative works, which pushed the limits of language models … as some small language models . ♣ shows …",
"cited_by_count": 3626,
"cited_by_url": "https://scholar.google.com/scholar?cites=2735466021227840922&hl=en",
"versions_count": 7,
"versions_url": "https://scholar.google.com/scholar?cluster=2735466021227840922&hl=en",
"full_text_url": "https://arxiv.org/pdf/2402.06196"
}
],
"pagination": {
"has_more": true,
"next_page": 2,
"next_page_token": null
},
"submit_feedback_for_this_response_here": "https://api.litescrape.com/api/feedback/example-not-a-valid-token"
}