# Scholar Google — Wrapped API

> **You are on:** `https://api.beta.paywithlocus.com/api` | [llms.txt](https://beta.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 for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/credits/scholar-google/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## 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.beta.paywithlocus.com/api/wrapped/credits/scholar-google/get-case-details \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/scholar-google/search-cases \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"court":"<string>","page":"<integer>","query":"<string>","year_from":"<string>","year_to":"<string>"}'
```

## Next steps

- [All wrapped API providers](https://beta.paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://beta.paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://beta.paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://beta.paywithlocus.com/agent/index.md): every Locus agent page.