Scholar Search

POST

/api/v1/scholar

The scholar search endpoint indexes academic research papers, scientific journals, preprints (arXiv, PubMed, IEEE), books, and doctoral theses.

It returns author attribution lists, journal publication sources, total citation counts, abstract summaries, and direct paper URLs.

Returned Academic Paper Properties

Each result item in the scholar response array contains scientific reference metadata:

title: Full academic paper or publication title
link: Direct web link to the paper abstract or PDF document
snippet: Research abstract or key findings excerpt
authors: Comma-separated list of author names
publication: Journal, conference, or publisher name (e.g. "Advances in neural information processing systems")
citations: Total number of academic citations received
position: Search rank position (1-based)

{
  "q": "attention is all you need",
  "num": 10
}

Authorizations

X-API-KEYstringheaderrequired

Passed via request headers. Your secret API key for SerperMatrix (e.g. sm_live_...).

Body

application/json

qstringrequired

The scientific search keyword, author, or research paper topic (e.g. "attention is all you need").

glstring

Geographic search constraint.

hlstring

Output language of search indices.

numintegerdefault: 10

Number of scientific paper links to return.

use_cachebooleandefault: true

Use cached results if available.

Request

curl -X POST https://serpermatrix.com/api/v1/scholar \
  -H "X-API-KEY: sm_live_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{"q":"attention is all you need","num":2}'

{
  "searchParameters": {
    "q": "attention is all you need",
    "num": 2,
    "type": "scholar"
  },
  "scholar": [
    {
      "title": "Attention is all you need",
      "link": "https://arxiv.org/abs/1706.03762",
      "snippet": "The dominant sequence transduction models are based on complex recurrent or convolutional neural networks.",
      "position": 1
    }
  ]
}