# 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/workflows/fandango
- Handle: `@fandango`
- Category: [Entertainment](https://fous.com/workflows/category/entertainment)
- Source website: https://fandango.com
- Last verified: Sep 29, 2026
- Fous is not affiliated with Fandango.

## Methods

### Get movie showtimes

Operation `get_movie_showtimes`, version 1. 1 credit per call.

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 call.

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-11-11"` |  |
| `movies` | array |  |  |
| `movies[].title` | string |  |  |
| `movies[].runtime` | string or null |  | Runtime as hours and minutes. |
| `movies[].age_rating` | string or null |  |  |
| `movies[].movie_link` | string or null |  |  |
| `movies[].showtime_groups` | array |  |  |
| `address` | string | `"1998 Broadway, New York, NY 10023"` |  |
| `theater_name` | string | `"AMC Lincoln Square 13"` |  |
| `fandango_link` | string | `"https://www.fandango.com/amc-lincoln-square-13-aabqi/theater-page"` |  |

**Example input**

```json
{
  "date": "2026-11-11",
  "theater": "AMC Lincoln Square 13",
  "location": "10023"
}
```

**Example output**

```json
{
  "date": "2026-11-11",
  "movies": [],
  "address": "1998 Broadway, New York, NY 10023",
  "theater_name": "AMC Lincoln Square 13",
  "fandango_link": "https://www.fandango.com/amc-lincoln-square-13-aabqi/theater-page"
}
```

### List now playing

Operation `list_now_playing`, version 1. 1 credit per call.

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

Call the API with a Fous API key (`FOUS_API_KEY`). To create one, turn on Developer mode in Fous Studio, then open Keys & connections → API keys (https://app.fous.com/keys).

```bash
# First set your key: export FOUS_API_KEY='YOUR_FOUS_API_KEY'
: "${FOUS_API_KEY:?Set FOUS_API_KEY before running this example}"

curl 'https://api.fous.com/v1/query' \
  --fail-with-body --silent --show-error --max-time 120 \
  -H "Authorization: Bearer $FOUS_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.
# First set your key: export FOUS_API_KEY='YOUR_FOUS_API_KEY'
import json
import os
import urllib.error
import urllib.request

api_key = os.environ.get("FOUS_API_KEY")
if not api_key:
    raise RuntimeError("Set FOUS_API_KEY before running this example")

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=120) 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.
// First set your key: export FOUS_API_KEY='YOUR_FOUS_API_KEY'
const apiKey = process.env.FOUS_API_KEY;
if (!apiKey) throw new Error("Set FOUS_API_KEY before running this example");

const response = await fetch("https://api.fous.com/v1/query", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${apiKey}`,
    "Content-Type": "application/json",
  },
  signal: AbortSignal.timeout(120_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);
```

Or describe the data in plain language: send `{"api":"@fandango","prompt":"Describe the data you need, with every detail"}` to the same URL. Fous fills in the input, runs the method that fits and returns only the fields you asked for; `data.route.calls[].request` is the exact call it made. Routing is free; the run costs the same.

## 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

### Is Fous affiliated with Fandango?

No. Fous is not affiliated with Fandango. This workflow reads the public fandango.com website and returns its data.

### How much does it cost?

Each run costs 1 credit. 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; repeating the same request within a day may return the saved result. Fous checks this workflow automatically; it last passed a check 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

- [Rotten Tomatoes API](https://fous.com/workflows/rotten-tomatoes.md): Rotten Tomatoes returns movie and TV details, scores, newest reviews, and listings for theaters, coming soon, or at home; series rating counts may be unavailable.
- [TMDB API](https://fous.com/workflows/tmdb.md): TMDB returns movie and TV details, cast, trailers, releases, viewing services, scheduled upcoming movies, and up to 20 homepage trending titles; future episode details depend on published schedules.
- [JustWatch API](https://fous.com/workflows/justwatch.md): JustWatch shows where movies and shows are available, including streaming, purchase, and cinema options, plus recent streaming arrivals and daily streaming charts based on its listings.
- [Ticketmaster API](https://fous.com/workflows/ticketmaster.md): Ticketmaster finds upcoming live events and shows available ticket options with prices, excluding partner-only listings and offers requiring a code or sign-in.
- [Box Office Mojo API](https://fous.com/workflows/box-office-mojo.md): Box Office Mojo reports weekend rankings, movie details, daily grosses, and annual leaders; weekend and daily results default to the latest reported period, with some international figures unavailable.
- [Letterboxd API](https://fous.com/workflows/letterboxd.md): Letterboxd provides films with ratings, cast, location-dependent watch services and popular reviews, plus popularity-ranked lists by time period, genre and decade; some details may be unavailable.
- [IMDb API](https://fous.com/workflows/imdb.md): IMDb returns movie, TV, person, episode, chart and Parents Guide details, including available weekly rank changes; missing details are null, and unaired or unrated episodes lack ratings.
- [TVmaze API](https://fous.com/workflows/tvmaze.md): TVmaze provides TV schedules, broadcast and streaming releases, and show status, ratings, and episode details; streaming times may be unavailable or shown in UTC.
- [All Entertainment workflows](https://fous.com/workflows/category/entertainment)