What is this?

This is the South Park API, it is the first API for south park characters, episodes and locations. It contains information about all of the South Park Universe conveniently in one Application Programming Interface (API).

We've tried to gather every bit of information that is publicly available about the South Park Universe and made it easy for software to gather the data! We can't guarantee the correctness or completeness of the data being provided, we try to be as correct and complete as possible.

Check out the documentation to get started consuming the South Park API.

Statistics

Amount of characters: 212
Amount of episodes: 314
Amount of locations: 661
Amount of families: 49

What can you use this for?

You can use this API to compare data from South Park in any way you like. For example serving data about South Park or creating data-driven applications.

What are the features?

We're using the Laravel framework to serve a RESTish API. All data is formatted in JSON, and schema's can be requested for each endpoint. Currently the South Park API supports querying for Episodes, Characters and Locations. You can also search based on certain fields of resources, which is covered in the documentation

Rate limiting & downtime?

The API currently does not have any rate limiting. If you are making heavy use of the API, please consider caching the results to limit server load.

Downtime or delayed responses may happen once in a while. The server is hosted on DigitalOcean, who usually have update windows between 21:00 UTC until 01:00 UTC. In which the server will either be down, or have delayed response times.

Who are you?

I am Ivo Bot, a PHP programmer from The Netherlands. I made this to practice with serving an API through Laravel, feedback is welcome through Github as I aspire to learn from this project.

Copyright and stuff?

As of now this project is Open Source. You have permission to use this service, copy the code, edit the code and host it yourself. The data is gathered from the South Park Wiki and the South Park Archives.