# Simplyscripts — 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 browse thousands of movie, TV, radio, and unproduced scripts from SimplyScripts.com, including Oscar-winning screenplays and the latest additions. Filter by genre, alphabetically, or by script type to find exactly what you're looking for.

**Category:** Entertainment | **Website:** [simplyscripts.com/](https://simplyscripts.com/) | **Docs:** [parse.bot/marketplace/fcfeb1d5-dd5f-4d43-9016-87cba15a6d8d/simplyscripts-com-api](https://parse.bot/marketplace/fcfeb1d5-dd5f-4d43-9016-87cba15a6d8d/simplyscripts-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-simplyscripts-com-api-fcfeb1d5/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_homepage_updates

Get recent site updates and newly added scripts from the homepage blog feed. Each update includes a title, summary text, and any script links mentioned. Updates are ordered newest-first.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-simplyscripts-com-api-fcfeb1d5/get_homepage_updates \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_movie_scripts_by_genre

List movie scripts filtered by genre. Uses the site's genre-specific listing pages. Each entry includes the script title, download URL, and optional writer and host site information.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `genre` | string | No | Genre slug for the listing page. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-simplyscripts-com-api-fcfeb1d5/get_movie_scripts_by_genre \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"genre":"<string>"}'
```

### get_movie_scripts_by_letter

List movie scripts alphabetically by first letter. Each letter page contains scripts starting with that letter, with links to the script files and optional writer/host information. Not all letters have a corresponding page on the site; unavailable letters return an upstream error.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `letter` | string | No | Single lowercase letter (a-z) or numeric prefix (0). Not all letters have pages on the site. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-simplyscripts-com-api-fcfeb1d5/get_movie_scripts_by_letter \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"letter":"<string>"}'
```

### get_oscar_scripts

List Academy Award-winning and nominated screenplays organized by year with links to script files. Covers Best Original Screenplay and Best Adapted Screenplay categories from early Oscars through the present.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-simplyscripts-com-api-fcfeb1d5/get_oscar_scripts \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_plays

List stage play scripts available on the site. Returns play titles with download URLs and optional writer attribution.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-simplyscripts-com-api-fcfeb1d5/get_plays \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_radio_scripts

List radio play scripts from the Golden Age of Radio and other sources. Aggregates scripts from both A-F and G-Z sub-pages into a single combined listing.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-simplyscripts-com-api-fcfeb1d5/get_radio_scripts \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_script_detail

Retrieve metadata about a script URL. For PDFs, returns type 'pdf' without fetching the file. For HTML pages on simplyscripts.com, returns the page text content. For external HTML pages, returns type 'external' with a content indicator. The url parameter should be a script_url obtained from other listing or search endpoints.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `url` | string | Yes | The full URL of the script file or page, as obtained from other endpoint results (e.g. script_url from search_scripts). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-simplyscripts-com-api-fcfeb1d5/get_script_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"<string>"}'
```

### get_tv_scripts

List TV scripts and teleplays. The site splits TV scripts across multiple sub-pages organized alphabetically. Each page contains script entries with title, download URL, writer, and host site information.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | string | No | TV listing page filename. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-simplyscripts-com-api-fcfeb1d5/get_tv_scripts \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<string>"}'
```

### get_unproduced_scripts

List unproduced original screenplays submitted by writers. Optionally filter by genre slug. When no genre is specified, returns the main unproduced scripts listing page.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `genre` | string | No | Genre slug filter for unproduced scripts. Omitting returns the main unproduced scripts listing. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-simplyscripts-com-api-fcfeb1d5/get_unproduced_scripts \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"genre":"<string>"}'
```

### search_scripts

Full-text search over the SimplyScripts database by title, writer, or keyword. Returns matching script listings with titles, URLs, and metadata. The search method controls how multi-word queries are matched: exact matches the phrase, or matches any word, and requires all words.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `method` | string | No | Search method controlling multi-word query matching. |
| `query` | string | Yes | Search keyword or phrase. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-simplyscripts-com-api-fcfeb1d5/search_scripts \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"method":"<string>","query":"<string>"}'
```