# Scholar Google — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Search and retrieve case law from Google Scholar by keyword, with optional filtering by date range and court type. Fetch full case details including citations, court, and opinion text for any case returned by search.

**Category:** Government & Public Data | **Website:** [scholar.google.com/](https://scholar.google.com/) | **Docs:** [parse.bot/marketplace/7c497c6e-8f4f-4d0e-a4cf-ec0138121fd1/scholar-google-com-api](https://parse.bot/marketplace/7c497c6e-8f4f-4d0e-a4cf-ec0138121fd1/scholar-google-com-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-scholar-google-com-api-7c497c6e/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_case_details

Get full details of a specific case by its Google Scholar case ID. Returns the case title, citation, court, dates, and full opinion text (truncated to first 10000 characters). The case_id is a numeric string obtained from search_cases results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `case_id` | string | Yes | Google Scholar case ID (numeric string from search_cases results[*].case_id) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-scholar-google-com-api-7c497c6e/get_case_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"case_id":"<string>"}'
```

### search_cases

Search Google Scholar case law by subject matter keywords. Returns case listings with title, citation, court, year, snippet, and cited-by count. Results are paginated with 10 cases per page. The court filter restricts to federal courts or all courts. Year filters narrow results to a specific date range.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `court` | string | No | Court filter: 'all' for all courts, 'federal' for federal courts only |
| `page` | integer | No | Page number (1-based) |
| `query` | string | Yes | Search query for case law (e.g., 'fourth amendment search and seizure', 'patent infringement') |
| `year_from` | string | No | Filter cases from this year onward (e.g., '2020'). Omitting returns cases from all years. |
| `year_to` | string | No | Filter cases up to this year (e.g., '2024'). Omitting returns cases up to present. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-scholar-google-com-api-7c497c6e/search_cases \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"court":"<string>","page":"<integer>","query":"<string>","year_from":"<string>","year_to":"<string>"}'
```