▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄

A free & open Star Wars REST API — characters, films, planets, species, starships & vehicles.

[ EXPLORE API ] [ SWAGGER DOCS ]

Data Coverage

🎬
11
FILMS
👤
101
CHARACTERS
🪐
62
PLANETS
🧬
40
SPECIES
🚀
32
STARSHIPS
🚗
30
VEHICLES

Endpoints

Method Endpoint Description
GET/charactersList all characters
GET/characters/:idGet a character by ID
GET/filmsList all films
GET/films/:idGet a film with full cast & relations
GET/planetsList all planets
GET/planets/:idGet a planet by ID
GET/speciesList all species
GET/species/:idGet a species by ID
GET/starshipsList all starships
GET/starships/:idGet a starship by ID
GET/vehiclesList all vehicles
GET/vehicles/:idGet a vehicle by ID
GET/search?q=Search across all resources

Query Parameters

All list endpoints support pagination and filtering:

Param Type Description
pagenumberPage number (default: 1)
limitnumberResults per page (default: 10, max: 100)
namestringFilter by name (case-insensitive)

Examples

# Get all characters — page 2, 20 per page
GET https://star-wars-api-9o3y.onrender.com/characters?page=2&limit=20
# Filter planets by climate
GET https://star-wars-api-9o3y.onrender.com/planets?climate=arid
# Search across all resources
GET https://star-wars-api-9o3y.onrender.com/search?q=Skywalker
# Response format
{
  "data": [ ... ],
  "meta": {
    "total": 101,
    "page": 1,
    "limit": 10,
    "totalPages": 11
  }
}