# Fandango API

> Fandango returns movie listings and theater showtimes as a workflow and API.

Fandango’s Get movie showtimes finds nearby U.S. theater showtimes using a movie title and ZIP code or city and state. Get theater showtimes returns a theater’s movies and showtimes using its name and city, state, or ZIP code. List now playing returns movies playing or coming soon in U.S. theaters; choose a list and maximum results.

- Page: https://fous.com/tools/fandango
- Handle: `@fandango`
- Category: [Entertainment](https://fous.com/tools/category/entertainment)
- Source website: https://fandango.com
- Last verified: Sep 29, 2026

## Methods

### Get movie showtimes

Operation `get_movie_showtimes`, version 1. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.

Find a movie’s showtimes at nearby US theaters, with formats, local times and ticket links. Runtime may be unavailable when Fandango does not list it.

**Input**

| Field | Type | Required | Example | Description |
|---|---|---|---|---|
| `date` | string | no | `"2026-09-29"` | Showtime date, such as 2026-09-29. Defaults to today. |
| `movie` | string | yes | `"Resident Evil"` | Movie title, such as Resident Evil. |
| `location` | string | yes | `"Austin, TX"` | US ZIP code or city and state, such as 90210 or Austin, TX. |
| `max_theaters` | integer | no | `3` | Maximum nearby theaters to return, such as 10. Defaults to 10. |

**Input schema**

```json
{
  "type": "object",
  "required": [
    "movie",
    "location"
  ],
  "properties": {
    "date": {
      "type": "string",
      "format": "date",
      "description": "Showtime date, such as 2026-09-29. Defaults to today.",
      "examples": [
        "2026-09-29"
      ]
    },
    "movie": {
      "type": "string",
      "description": "Movie title, such as Resident Evil.",
      "examples": [
        "Resident Evil",
        "Wicked"
      ]
    },
    "location": {
      "type": "string",
      "description": "US ZIP code or city and state, such as 90210 or Austin, TX.",
      "examples": [
        "Austin, TX",
        "90210"
      ]
    },
    "max_theaters": {
      "type": "integer",
      "default": 10,
      "maximum": 30,
      "minimum": 1,
      "description": "Maximum nearby theaters to return, such as 10. Defaults to 10.",
      "x-fous-developer": true,
      "examples": [
        3,
        5
      ]
    }
  },
  "additionalProperties": false,
  "examples": [
    {
      "date": "2026-09-29",
      "movie": "Resident Evil",
      "location": "Austin, TX",
      "max_theaters": 3
    },
    {
      "date": "2026-09-29",
      "movie": "Resident Evil",
      "location": "90210",
      "max_theaters": 5
    },
    {
      "date": "2026-09-29",
      "movie": "Wicked",
      "location": "90210"
    }
  ]
}
```

**Output**

| Field | Type | Example | Description |
|---|---|---|---|
| `runtime` | string or null | `"2 hrs 40 min"` |  |
| `theaters` | array |  |  |
| `theaters[].address` | string | `"434 W. 2nd Street, Austin, TX 78701"` |  |
| `theaters[].theater_link` | string | `"https://www.fandango.com/violet-crown-austin-aawjb/theater-page"` |  |
| `theaters[].theater_name` | string | `"Violet Crown Austin"` |  |
| `theaters[].distance_miles` | number or null | `0.57` |  |
| `theaters[].showtime_groups` | array |  |  |
| `age_rating` | string or null | `"R"` |  |
| `movie_link` | string | `"https://www.fandango.com/resident-evil-2026-245893/movie-overview"` |  |
| `movie_title` | string | `"Resident Evil (2026)"` |  |

**Example input**

```json
{
  "date": "2026-09-29",
  "movie": "Resident Evil",
  "location": "Austin, TX",
  "max_theaters": 3
}
```

**Example output**

```json
{
  "runtime": null,
  "theaters": [
    {
      "address": "434 W. 2nd Street, Austin, TX 78701",
      "theater_link": "https://www.fandango.com/violet-crown-austin-aawjb/theater-page",
      "theater_name": "Violet Crown Austin",
      "distance_miles": 0.57,
      "showtime_groups": [
        {
          "format": "Standard",
          "showtimes": [
            {
              "date_time": "2026-09-29T10:20:00-05:00",
              "local_time": "10:20 AM",
              "ticket_link": "https://tickets.fandango.com/transaction/ticketing/mobile/jump.aspx?sdate=2026-09-29%2B10%3A20&from=mov_det_showtimes&source=desktop&mid=245893&tid=AAWJB&dfam=webbrowser&showtimehashcode=v2-f46601ce6b…"
            }
          ]
        }
      ]
    }
  ],
  "age_rating": "R",
  "movie_link": "https://www.fandango.com/resident-evil-2026-245893/movie-overview",
  "movie_title": "Resident Evil (2026)"
}
```

### Get theater showtimes

Operation `get_theater_showtimes`, version 1. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.

Get a theater’s movies and showtimes for a date from its name and city or ZIP code. Dates without listed showtimes return no movies.

**Input**

| Field | Type | Required | Example | Description |
|---|---|---|---|---|
| `date` | string | no | `"2026-09-29"` | Showtime date in YYYY-MM-DD, such as 2026-09-29. Defaults to today in the theater’s time zone. |
| `theater` | string | yes | `"AMC Metreon 16"` | The theater name, such as AMC Lincoln Square 13. |
| `location` | string | yes | `"San Francisco, CA"` | The city and state or ZIP code, such as New York, NY or 10023. |

**Input schema**

```json
{
  "type": "object",
  "required": [
    "theater",
    "location"
  ],
  "properties": {
    "date": {
      "type": "string",
      "format": "date",
      "description": "Showtime date in YYYY-MM-DD, such as 2026-09-29. Defaults to today in the theater’s time zone.",
      "examples": [
        "2026-09-29",
        "2026-11-11"
      ]
    },
    "theater": {
      "type": "string",
      "description": "The theater name, such as AMC Lincoln Square 13.",
      "examples": [
        "AMC Metreon 16",
        "AMC Lincoln Square 13"
      ]
    },
    "location": {
      "type": "string",
      "description": "The city and state or ZIP code, such as New York, NY or 10023.",
      "examples": [
        "San Francisco, CA",
        "New York, NY",
        "10023"
      ]
    }
  },
  "additionalProperties": false,
  "examples": [
    {
      "date": "2026-09-29",
      "theater": "AMC Metreon 16",
      "location": "San Francisco, CA"
    },
    {
      "date": "2026-09-29",
      "theater": "AMC Lincoln Square 13",
      "location": "New York, NY"
    },
    {
      "date": "2026-11-11",
      "theater": "AMC Lincoln Square 13",
      "location": "10023"
    }
  ]
}
```

**Output**

| Field | Type | Example | Description |
|---|---|---|---|
| `date` | string | `"2026-09-29"` |  |
| `movies` | array |  |  |
| `movies[].title` | string | `"Princess Mononoke - Studio Ghibli Fest 2026"` |  |
| `movies[].runtime` | string or null | `"2 hr 18 min"` | Runtime as hours and minutes. |
| `movies[].age_rating` | string or null | `"PG"` |  |
| `movies[].movie_link` | string or null | `"https://www.fandango.com/princess-mononoke-studio-ghibli-fest-2026-245499/movie-overview"` |  |
| `movies[].showtime_groups` | array |  |  |
| `address` | string | `"135 4th Street Suite #3000, San Francisco, CA 94103"` |  |
| `theater_name` | string | `"AMC Metreon 16"` |  |
| `fandango_link` | string | `"https://www.fandango.com/amc-metreon-16-aanem/theater-page"` |  |

**Example input**

```json
{
  "date": "2026-09-29",
  "theater": "AMC Metreon 16",
  "location": "San Francisco, CA"
}
```

**Example output**

```json
{
  "date": "2026-09-29",
  "movies": [
    {
      "title": "Princess Mononoke - Studio Ghibli Fest 2026",
      "runtime": "2 hr 18 min",
      "age_rating": "PG",
      "movie_link": "https://www.fandango.com/princess-mononoke-studio-ghibli-fest-2026-245499/movie-overview",
      "showtime_groups": [
        {
          "format": "Standard",
          "showtimes": [
            {
              "date_time": "2026-09-29T19:00-07:00",
              "local_time": "7:00 PM",
              "ticket_link": "https://tickets.fandango.com/transaction/ticketing/mobile/jump.aspx?sdate=2026-09-29%2B19%3A00&from=mov_det_showtimes&source=desktop&mid=245499&tid=AANEM&dfam=webbrowser&showtimehashcode=v2-451cfb34b1…"
            }
          ]
        }
      ]
    }
  ],
  "address": "135 4th Street Suite #3000, San Francisco, CA 94103",
  "theater_name": "AMC Metreon 16",
  "fandango_link": "https://www.fandango.com/amc-metreon-16-aanem/theater-page"
}
```

### List now playing

Operation `list_now_playing`, version 1. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.

List Fandango movies now playing or coming soon in U.S. theaters, in their displayed order, with release dates, ratings, runtimes, scores and movie links when available.

**Input**

| Field | Type | Required | Example | Description |
|---|---|---|---|---|
| `list` | string | no | `"coming_soon"` | Which movie list to show, for example now_playing. |
| `max_results` | integer | no | `4` | Maximum movies to return, for example 50. |

**Input schema**

```json
{
  "type": "object",
  "properties": {
    "list": {
      "enum": [
        "now_playing",
        "coming_soon"
      ],
      "type": "string",
      "default": "now_playing",
      "description": "Which movie list to show, for example now_playing.",
      "examples": [
        "coming_soon",
        "now_playing"
      ]
    },
    "max_results": {
      "type": "integer",
      "default": 50,
      "maximum": 100,
      "minimum": 1,
      "description": "Maximum movies to return, for example 50.",
      "x-fous-developer": true,
      "examples": [
        4,
        5,
        50
      ]
    }
  },
  "additionalProperties": false,
  "examples": [
    {
      "list": "coming_soon",
      "max_results": 4
    },
    {
      "list": "now_playing",
      "max_results": 5
    },
    {
      "max_results": 50
    }
  ]
}
```

**Output**

| Field | Type | Example | Description |
|---|---|---|---|
| `movies` | array |  | Movies in Fandango listing order. |
| `movies[].title` | string | `"Avengers: Doomsday (2026)"` | Movie title. |
| `movies[].runtime` | string or null | `"1 hr 54 min"` | Runtime as displayed, such as 2 hr 25 min. |
| `movies[].age_rating` | string or null | `"NR"` | Age rating, such as PG-13. |
| `movies[].poster_link` | string or null | `"https://images.fandango.com/ImageRenderer/300/0/redesign/static/img/default_poster--dark-mode.png/0/images/MasterReposi` | Poster image link. |
| `movies[].tomatometer` | integer or null | `96` | Tomatometer score as a percent, if shown. |
| `movies[].release_date` | string or null | `"2026-12-18"` | U.S. theatrical release date, if shown. |
| `movies[].fandango_link` | string | `"https://www.fandango.com/avengers-doomsday-2026-237176/movie-overview"` | Fandango movie page link. |
| `movies[].audience_score` | integer or null | `91` | Audience score as a percent, if shown. |

**Example input**

```json
{
  "list": "coming_soon",
  "max_results": 4
}
```

**Example output**

```json
{
  "movies": [
    {
      "title": "Avengers: Doomsday (2026)",
      "runtime": null,
      "age_rating": "NR",
      "poster_link": "https://images.fandango.com/ImageRenderer/300/0/redesign/static/img/default_poster--dark-mode.png/0/images/MasterRepository/fandango/237176/avengersdoomsday-posterart-presale.jpg",
      "tomatometer": null,
      "release_date": "2026-12-18",
      "fandango_link": "https://www.fandango.com/avengers-doomsday-2026-237176/movie-overview",
      "audience_score": null
    },
    {
      "title": "Verity (2026)",
      "runtime": "1 hr 54 min",
      "age_rating": "R",
      "poster_link": "https://images.fandango.com/ImageRenderer/300/0/redesign/static/img/default_poster--dark-mode.png/0/images/MasterRepository/fandango/240033/verity_presale.jpg",
      "tomatometer": null,
      "release_date": "2026-10-02",
      "fandango_link": "https://www.fandango.com/verity-2026-240033/movie-overview",
      "audience_score": null
    },
    {
      "title": "Street Fighter (2026)",
      "runtime": "1 hr 59 min",
      "age_rating": "PG-13",
      "poster_link": "https://images.fandango.com/ImageRenderer/300/0/redesign/static/img/default_poster--dark-mode.png/0/images/MasterRepository/fandango/246472/streetfighter_presale.jpg",
      "tomatometer": null,
      "release_date": "2026-10-16",
      "fandango_link": "https://www.fandango.com/street-fighter-2026-246472/movie-overview",
      "audience_score": null
    }
  ]
}
```

## Quick start

Replace `YOUR_API_KEY` with a Fous API key. To create one, open Developers at the bottom of Fous Studio, turn on Developer mode, then go to API keys (https://app.fous.com/keys). Change the values in `input` to run the same tool on new data.

```bash
curl 'https://api.fous.com/v1/query' \
  --fail-with-body --silent --show-error --max-time 180 \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "api": "@fandango",
  "visibility": "public",
  "operation": "get_movie_showtimes",
  "version": 1,
  "input": {
    "date": "2026-09-29",
    "movie": "Resident Evil",
    "location": "Austin, TX",
    "max_theaters": 3
  },
  "response": {
    "format": "json"
  }
}'
```

```python
# Save as fous.py and run with python3 fous.py. No packages needed.
import json
import urllib.error
import urllib.request

api_key = "YOUR_API_KEY"

body = json.loads("{\n  \"api\": \"@fandango\",\n  \"visibility\": \"public\",\n  \"operation\": \"get_movie_showtimes\",\n  \"version\": 1,\n  \"input\": {\n    \"date\": \"2026-09-29\",\n    \"movie\": \"Resident Evil\",\n    \"location\": \"Austin, TX\",\n    \"max_theaters\": 3\n  },\n  \"response\": {\n    \"format\": \"json\"\n  }\n}")
request = urllib.request.Request(
    "https://api.fous.com/v1/query",
    data=json.dumps(body).encode("utf-8"),
    headers={
        "Authorization": f"Bearer {api_key}",
        "Content-Type": "application/json",
    },
    method="POST",
)
try:
    with urllib.request.urlopen(request, timeout=180) as response:
        result = json.load(response)
except urllib.error.HTTPError as error:
    raise RuntimeError(f"HTTP {error.code}: {error.read().decode('utf-8', errors='replace')}") from error
if result.get("success") is False:
    raise RuntimeError(result.get("error", {}).get("message", "Request failed"))
print(json.dumps(result["data"]["output"], indent=2))
```

```typescript
// Save as fous.mts and run with npx tsx fous.mts.
const apiKey = "YOUR_API_KEY";

const response = await fetch("https://api.fous.com/v1/query", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${apiKey}`,
    "Content-Type": "application/json",
  },
  signal: AbortSignal.timeout(180_000),
  body: JSON.stringify({
  "api": "@fandango",
  "visibility": "public",
  "operation": "get_movie_showtimes",
  "version": 1,
  "input": {
    "date": "2026-09-29",
    "movie": "Resident Evil",
    "location": "Austin, TX",
    "max_theaters": 3
  },
  "response": {
    "format": "json"
  }
}),
});
type ApiResult = { success: boolean; data?: { output: unknown }; error?: { message: string } };
const result: ApiResult = await response.json();
if (!response.ok || result.success === false) {
  throw new Error(result.error?.message ?? `HTTP ${response.status}`);
}
if (!result.data) throw new Error("Missing API response data");
console.log(result.data.output);
```

## Use from an AI assistant

Connect this tool to Claude Code, Claude Desktop, Cursor, VS Code, Codex and any MCP client as its own MCP server. Each method is a typed tool whose arguments are the method’s input.

- Server URL: `https://api.fous.com/mcp/tools/fandango`
- Authorization: `Authorization: Bearer <Fous API key>`

**Tools**

- `get_movie_showtimes`: Get movie showtimes. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.
- `get_theater_showtimes`: Get theater showtimes. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.
- `list_now_playing`: List now playing. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.
- `fous_get_run`: the result of a run that was still going, by its `request_id`. Free.

Claude Code:

```bash
claude mcp add --scope user --transport http fous-fandango https://api.fous.com/mcp/tools/fandango --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"
```

To give the assistant every tool, connect `https://api.fous.com/mcp`: it finds one with `fous_search_tools` and runs it with `fous_run_tool`. Setup for other clients: https://fous.com/llms-full.txt.

## Use cases

- Compare nearby showtimes for a movie.
- Find showtimes at a specific theater.
- Plan movie outings by date and location.
- Review movies now playing or coming soon.
- Track release dates, ratings, runtimes, and scores.

## FAQ

### Can I run it with my own inputs?

Yes. Change the inputs in Studio and press Run, or send new inputs from your code, or ask a connected AI assistant.

### Can I call this Fandango tool as an API?

Yes. Send a POST request to /v1/query with your Fous API key and the inputs, and get JSON back.

### How much does it cost?

Each completed run costs 1 credit. Failed runs without a completed receipt are free; completed work can remain charged if delivery is interrupted. With pay as you go, a credit costs 1¢. Monthly plans cost less per credit.

### Do I need a Fandango account?

No. You only need a Fous account.

### How current is the data?

Fous gets the data from fandango.com when you run it. Some results are reused for up to 24 hours, and results that use your account or key are never reused. It was last verified on Sep 29, 2026.

### What showtimes are available near me for a movie?

Get movie showtimes returns nearby theaters, local showtimes, formats, and ticket links when you provide a movie title and location.

### What movies are showing at a specific theater?

Get theater showtimes returns a theater’s movies and showtimes for a date when you provide its name and location.

### Which movies are now playing or coming soon?

List now playing returns Fandango’s displayed movie list, with release dates, ratings, runtimes, scores, and movie links when available.

## Related

- [All Entertainment tools](https://fous.com/tools/category/entertainment)