There are two types of companies: hoarders and givers. RAWG is the largest video game database and game discovery service. And we are gladly sharing our 500,000+ games, search, and machine learning recommendations with the world. Learn what the RAWG games database API can do and build something cool with it!
## Adding the API key to your request
You must include an API key with every request. In the following example, replace YOUR\_API\_KEY with your API key.
`GET https://api.rawg.io/api/platforms?key=YOUR_API_KEY GET https://api.rawg.io/api/games?key=YOUR_API_KEY&dates=2019-09-01,2019-09-30&platforms=18,1,7`
### Why build on RAWG
## 500,000+ games for 50 platforms including mobiles
2,100,000
screenshots
1,100,000
ratings
220,000
developers
58,000
tags
45,000
publishers
24,000
people
Comprehensive video game data: descriptions, genres, release dates, links to stores, ESRB-ratings, average playtime, gameplay videos, Metacritic ratings, official websites, system requirements, linked YouTube and Twitch videos, DLCs and franchises.
Where to buy: links to digital distribution services.
Player activity data: Steam average playtime and RAWG player counts and ratings.
Rapidly growing and getting better by user contribution and our algorithms.
Similar games based on computer vision.
## Ready to start?
### Free
For personal and hobby projects
[Get API Key](https://rawg.io/login/?forward=developer)
- Non-commercial projects only
- 500,000+ video games data
- up to 20,000 requests per month
- Required backlinks to RAWG from pages where the data is used
$149/m.
### Business
For small and mid-size companies
- All in Free Plan
- Commercial use
- Where to buy links
- Similar games
- Gameplay videos, relevant twitch and youtube videos
- up to 50,000 requests per month
- Email support
### Enterprise
For projects with custom needs
[Contact us](https://rawg.io/)
- All in Business Plan
- Downloadable file api
- up to 1,000,000 requests per month
- Custom data requests
- Priority email support
## Some apps using our API
## [Terms of Service](https://rawg.io/tos_api)
Free for personal use as long as you attribute RAWG as the source of the data and/or images and add an active hyperlink from every page where the data of RAWG is used.
Free for commercial use for startups and hobby projects with not more than 100,000 monthly active users or 500,000 page views per month. If your project is larger than that, email us at [
[email protected]](https://rawg.io/) for commercial terms.
No data redistribution. It would not be cool if you used our API to resell our data or make it available for other businesses. In other words, you may use the data with your API access only for your projects.
API Legal Notice: We do not claim ownership of any of the images or data provided by the API. We remove infringing content when properly notified. Any data and/or images one might upload to RAWG is expressly granted a license to use. You are prohibited from using the images and/or data in connection with libelous, defamatory, obscene, pornographic, abusive or otherwise offensive content.
If you have any questions about our API, we'd love to help. Email us at [
[email protected]](https://rawg.io/) or ask the community at our [Discord](https://discord.gg/erNybDp).
## Latest updates
- ESRB-ratings added to list endpoints for easier filtering based on age rating.
- Metacritic can be used as a filtering and sorting option. Filter: [https://api.rawg.io/api/games?metacritic=80,100](https://api.rawg.io/api/games?metacritic=80,100). Sort: [https://api.rawg.io/api/games?ordering=-metacritic](https://api.rawg.io/api/games?ordering=-metacritic).
- Non-fuzzy search option. To turn off fuzziness: [https://api.rawg.io/api/games?search=303%20squadron&search\_precise=true](https://api.rawg.io/api/games?search=303%20squadron&search_precise=true). To search by exact term: [https://api.rawg.io/api/games?search=303%20squadron&search\_exact=true](https://api.rawg.io/api/games?search=303%20squadron&search_exact=true).
- API key-based requests signing. The old method of signing with User Agent string will be slowly deprecated.
- Last update date added to game details endpoint. Useful to know if there is any new info to grab.
- System requirements added to game details endpoint.
- Separate Metacritic ratings for each game platform.
## API wrappers by our community
All of the libraries are contributed by our users. If you find a bug or missing feature, it's best to contact the author. If you want to submit your wrapper, contact us via [
[email protected]](https://rawg.io/)
## Example usecases
RAWG API is a powerful tool for working with video games data. Below are a few examples of what you can do with the API.
What console games were released last month?
`GET https://api.rawg.io/api/platforms # get ids of target platforms GET https://api.rawg.io/api/games?dates=2019-09-01,2019-09-30&platforms=18,1,7 # insert platforms ids`
What are the most anticipated upcoming games?
`GET https://api.rawg.io/api/games?dates=2019-10-10,2020-10-10&ordering=-added`