4 Comments - Last post 21 minutes ago by Phukndeeveesss
62 Comments - Last post 21 minutes ago by Grilex
597 Comments - Last post 52 minutes ago by MeguminShiro
171 Comments - Last post 52 minutes ago by sensualshakti
15,578 Comments - Last post 1 hour ago by Kenruyoh
2,210 Comments - Last post 2 hours ago by ipax11
8,485 Comments - Last post 3 hours ago by Bum8ara5h
1,188 Comments - Last post 51 seconds ago by icaio
14 Comments - Last post 1 minute ago by PanTsour
170 Comments - Last post 23 minutes ago by FruitCober
10 Comments - Last post 26 minutes ago by adam1224
21 Comments - Last post 38 minutes ago by scorkla
32 Comments - Last post 41 minutes ago by evertonj
7 Comments - Last post 46 minutes ago by NB264
Hi everyone, I setup a few pages on our site to return data in JSON format to help out users developing add-ons and scripts. At the moment these pages are...
Homepage
https://www.steamgifts.com/?format=json
Profiles - Giveaways Created
https://www.steamgifts.com/user/cg?format=json
Profiles - Giveaways Won
https://www.steamgifts.com/user/cg/giveaways/won?format=json
Groups - Giveaways Created
https://www.steamgifts.com/group/SJ7Bu/steamgifts?format=json
Bundle Games
https://www.steamgifts.com/bundle-games?format=json
You can also use existing parameters with these requests. For example, if you wanted to view JSON data for recommended giveaways on our homepage, that have a release date in 2020 or later, you could use...
https://www.steamgifts.com/giveaways/search?format=json&type=recommended&release_date_min=2020-01-01
The previously discussed rate limits also apply to these JSON requests. However, a higher number of results are returned when requesting data in JSON format, so you'll be able to use a fewer number of requests.
All of the responses include page and per_page properties. As expected, these return the current page number and the number of results per page. At the moment 100 results are returned per page, except for the bundle list, which returns 1,000 results per page. These numbers may change in the future, so if you're writing a script don't hardcode the values but instead check if the number of results being returned equals per_page, and if so, request page + 1.
The following information will be returned for giveaways. If the "NULL" column in the below tables is "Yes", that means the property can be null. If the "Always Included" column is "Yes", that means the property will always be returned. For example, name, points, copies, app_id, and package_id will not be returned for open invite only giveaways that you do not have permission to view, and link will never be returned for invite only giveaways you do not have permission to view. The giveaway id is the internal SteamGifts ID for the giveaway. Likewise, the creator or winner id properties correspond to the internal SteamGifts user IDs. These can be useful when dealing with users that change usernames. You'll notice Steam IDs can be null, and that occurs when a user has deleted their account from SteamGifts.
If you're requesting a user's created or won giveaways, the response will include a user object containing properties for the profile. The id is the internal SteamGifts ID for the user.
If you're requesting a group's giveaways, the response will include a group object containing properties for the group. The id is the internal SteamGifts ID for the group and gid is the Steam group ID.
When requesting the JSON data for a user's won giveaways the response will include one additional property for each giveaway called received. This value will be true if the user has marked their gift as received and false when it's marked as not received.
There are a couple of additional parameters that can be assigned to requests. It's recommended you do not apply these parameters unless the information is required, since it requires more database queries and the responses are slightly slower. If you set include_feedback=1 in your requests, the response will include a feedback object containing the total number of winners that have marked each giveaway as received, not received, or awaiting feedback.
https://www.steamgifts.com/user/cg?format=json&include_feedback=1
If you set include_winners=1 in your requests, the response will include a winners array containing up to 50 winners for each giveaway. The received property will be true if the winner has marked their gift as received, false when it's marked as not received, and null when the winner has not provided feedback. The id, steam_id, and username may not be included in the response since winners on the site remain anonymous until feedback is provided.
https://www.steamgifts.com/user/cg?format=json&include_winners=1
Bundle Games
All of the below fields will be included in the results for bundle games, although any of the values can potentially be null when they don't apply to the game.
https://www.steamgifts.com/bundle-games?format=json
Comment has been collapsed.