Google Scholar Case Law API

Our Google Scholar Case Law API allows you to scrape case results from the Google Scholar Case Law pages. The API is accessed through the following endpoint: /search?engine=google_scholar_case_law.

A user may query the following: https://serpapi.com/search?engine=google_scholar_case_law utilizing a GET request. Head to the playground for a live and interactive demo.


The API endpoint is https://serpapi.com/search?engine=google_scholar_case_law

Head to the playground for a live and interactive demo.

API Parameters

Search Query

case_id

Required

Parameter defines the ID of the case you want to scrape.
You can find case law case_id in Google Scholar API results. Please head to the Google Scholar API documentation to learn how to use the as_sdt parameter to get case law results using Google Scholar API.

Serpapi Parameters

engine

Required

Set parameter to google_scholar_case_law to use the Google Scholar Case Law API engine.

no_cache

Optional

Parameter will force SerpApi to fetch the Google Scholar Case Law 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. no_cache and async parameters should not be used together.

async

Optional

Parameter defines the way you want to submit your search to SerpApi. It can be set to false (default) to open an HTTP connection and keep it open until you got your search results, or true to just submit your search to SerpApi and retrieve them later. In this case, you'll need to use our Searches Archive API to retrieve your results. async and no_cache parameters should not be used together. async should not be used on accounts with Ludicrous Speed enabled.

zero_trace

Optional

Enterprise only. Parameter enables ZeroTrace mode. It can be set to false (default) or true. Enable this mode to skip storing search parameters, search files, and search metadata on our servers. This may make debugging more difficult.

api_key

Required

Parameter defines the SerpApi private key to use.

output

Optional

Parameter defines the final output you want. It can be set to json (default) to get a structured JSON of the results, or html to get the raw html retrieved.

API Results

JSON Results

JSON output includes structured data for Google Scholar Case Law results.

A search status is accessible through search_metadata.status. It flows this way: Processing -> Success || Error. If a search has failed, error will contain an error message. search_metadata.id is the search ID inside SerpApi.

HTML Results

HTML output is useful to debug JSON results or support features not supported yet by SerpApi.
HTML output gives you the raw HTML results from Google Scholar Case Law pages.

API Examples

Example with case_id: 14798399380223656729

Example with case_id: 14798399380223656729

JSON Example

{
  ...
  "case_results": {
    "case_id": "14798399380223656729",
    "title": "Reider v. Thompson, 339 US 113 - Supreme Court 1950",
    "name": "REIDER v. THOMPSON, TRUSTEE, MISSOURI PACIFIC RAILROAD CO.",
    "court_name": "Supreme Court of United States.",
    "cert": "CERTIORARI TO THE UNITED STATES COURT OF APPEALS FOR THE FIFTH CIRCUIT.",
    "first_page": 114,
    "last_page": 120,
    "dates": [
      {
        "position": 1,
        "type": "Argued",
        "date": "February 7, 1950"
      },
      {
        "position": 2,
        "type": "Decided",
        "date": "March 13, 1950"
      }
    ],
    "short_citations": [
      {
        "position": 1,
        "name": "339 U.S. 113 (1950)"
      }
    ],
    "case_numbers": [
      {
        "position": 1,
        "id": "15876565480693424878",
        "link": "https://scholar.google.com/scholar?scidkt=15876565480693424878",
        "docket_numbers": [
          {
            "position": 1,
            "docket_number": "403"
          }
        ]
      }
    ],
    "cited_cases": [
      {
        "position": 1,
        "case_id": "13440368754086419354",
        "case_link": "https://scholar.google.com/scholar_case?case=13440368754086419354&hl=en&as_sdt=4000006",
        "serpapi_case_link": "https://serpapi.com/search.json?case_id=13440368754086419354&engine=google_scholar_case_law",
        "citations": [
          {
            "case_name": "Galveston, H. & S. A. R. Co.",
            "variations": [
              {
                "position": 1,
                "defendant": "Wallace",
                "citation": "Galveston, H. & S. A. R. Co. v. Wallace, 223 U. S. 481"
              }
            ]
          }
        ]
      },
      ...
    ]
  }
}

JSON structure overview

{
  ...
  "case_results": {
    "case_id": "String - Google scholar case law ID",
    "title": "String - The full title of the case",
    "name": "String - Case name with names of the parties involved in the case",
    "court_name": "String - The name of the court where the case was heard",
    "cert": "String - Certification details",
    "first_page": "Integer - The starting page number of the case in the official report",
    "last_page": "Integer - The ending page number of the case in the official report",
    "dates": [
      {
        "position": "Integer - Date position",
        "type": "String - The type of the event related to date (e.g., 'Argued', 'Decided')",
        "date": "String - The date corresponding to the event"
      },
      ...
    ],
    "short_citations": [
      {
        "position": "Integer - Position of the short citation entry",
        "name": "String - The abbreviated citation for the case"
      }
    ],
    "case_numbers": [
      {
        "position": "Integer - Position of the case",
        "id": "String - Case number record ID",
        "link": "String - Link to more details about the case number record on Google Scholar",
        "docket_numbers": [
          {
            "position": "Integer - Position of the docket number",
            "docket_number": "String - The official docket number assigned to the case"
          }
        ]
      },
      ...
    ],
    "cited_cases": [
      {
        "position": "Integer - Position of the citation entry",
        "case_id": "String - Cited case ID",
        "case_link": "String - Link to cited case on Google Scholar",
        "serpapi_case_link": "String - SerpApi Link to cited case",
        "citations": [
          {
            "case_name": "String - The name of the cited case as referenced in the citation",
            "variations": [
              {
                "position": "Integer - Position of the variation entry",
                "defendant": "String - The name of the defendant mentioned in this citation variation",
                "citation": "String - The complete citation text in this citation variation"
              }
            ]
          },
          ...
        ]
      },
      ...
    ]
  }
  ...
}