Skip to content

New Official SDKs for TypeScript, Python and Go

SerpKite
Get API key
Docs menu / Google Scholar

Google Scholar

Papers with authors, publication, year, citation count and PDF links.

POST https://api.serpkite.com/v1/scholar Credits: 1 per page Try in playground
View as Markdown

Google Scholar papers with authors and publication, year, citation count and a direct PDF link when one exists.

Request body

Send a JSON object with Content-Type: application/json. The same parameters also work as a query string on GET /v1/scholar. JSON arrays are rejected: to run many queries at once, use POST /v1/batches at half price. Unknown parameters return 400 invalid_request with a message that names the replacement; see strict validation.

ParameterTypeDefaultDescription
q requiredstringThe search query. Required. Up to 2,048 characters.
languagestringenInterface language, as a language code (en, de, fr, pt-BR…).
numinteger10Results per call. 10 per page; 100 fetches the top 100 as a depth bundle for 7 credits instead of 10. One of: 10, 20, 30, 50, 100.
pageinteger1Results page, 1–10. Each page is billed separately.
formatstringjsonResponse format. markdown is LLM-ready prose; compact is JSON with only the fields agents need. One of: json, compact, markdown.
fieldsstringComma-separated projection, e.g. results.title,results.link,knowledge_graph. Cuts tokens.
max_ageintegerAccept a cached result up to this many seconds old. Cache hits cost 50% of the credits.

Example request

Authenticate with Authorization: Bearer $SERPKITE_API_KEY (GET requests may pass ?api_key= instead). The official SDKs read SERPKITE_API_KEY for you. See Authentication. 

curl https://api.serpkite.com/v1/scholar \
  -H "Authorization: Bearer $SERPKITE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"q":"retrieval augmented generation"}'

Response fields

FieldTypeDescription
requestobjectThe normalised request, with defaults filled in: endpoint, engine, q, country, language, location, num, page, device, autocorrect…
results[]arrayposition, title, link, domain, publication_info, snippet, year, cited_by, pdf_url, id.
metaobjectrequest_id, credits_used, cached, cached_at, engine (the provider that answered), route (provider attempts, see Search providers), latency_ms, parse_quality (ok, partial, empty), resolved_urls.

Every billed response also carries credit and latency headers (X-Credits-Used, X-Credits-Remaining, X-Request-Id…).

Example response

200 OK · illustrative 
{
  "request": {
    "endpoint": "scholar",
    "engine": "google",
    "q": "retrieval augmented generation",
    "language": "en"
  },
  "results": [
    {
      "position": 1,
      "title": "Retrieval-augmented generation for knowledge-intensive NLP tasks",
      "link": "https://papers.example.org/rag",
      "domain": "papers.example.org",
      "publication_info": "P Lewis, E Perez, A Piktus… - Advances in Neural Information Processing Systems, 2020",
      "snippet": "Large pre-trained language models have been shown to store factual knowledge…",
      "year": 2020,
      "cited_by": 9000,
      "pdf_url": "https://papers.example.org/rag.pdf",
      "id": "abcDEF123"
    }
  ],
  "meta": {
    "request_id": "req_01J8ZK4M6Q2V7",
    "credits_used": 1,
    "cached": false,
    "engine": "google",
    "latency_ms": 1034,
    "parse_quality": "ok",
    "resolved_urls": true
  }
}

Errors

Errors use one shape: {"error":{"code","message","request_id"}}. Errors are never billed. Full list in Errors.

StatusCodeMeaning
400invalid_requestA parameter is missing or invalid.
401unauthorizedThe API key is missing, invalid or revoked.
402insufficient_creditsYour balance is too low. Buy a pack or wait for the monthly free grant.
429rate_limitedToo many requests per second for your plan. Retry after the Retry-After header.
503upstream_errorGoogle could not be fetched or parsed. Not billed; retry after Retry-After.