Barter.vg
App · Gaming · 10 actions
Read Barter.vg, where Steam game traders list what they have to trade and what they want. Look up a game's prices, reviews, bundle and giveaway history and the traders who have or want it; a trader's profile and their tradables, wishlist, library and blacklist; the games two traders could swap; a trader's offers and what is in each; and the giveaways and bundles Barter.vg tracks. No account or API key is needed. Barter.vg's terms allow its data for personal, non-commercial use, at up to 240 requests an hour shared by everyone on Lodol.
Actions
| Action | What it does |
|---|---|
| Find trade matches | Find what two Barter.vg traders could swap: the games the first has to trade that the second has on their wishlist, and the games the second has to trade that the first wants. |
| Get a bundle | Get one bundle Barter.vg has recorded, old or new, by its ID or a link to it: its store, link, start and end, and its games and packages with their Steam IDs, tiers and the games each package holds. |
| Get a game | Look up a game, DLC or package on Barter.vg by its Steam app ID, Steam package ID or Barter.vg item ID, or a link to its page: its platform, release date, Steam price and lowest price, reviews, achievements and trading cards, how often it has been bundled and given away, and how many traders have it to trade, want it or own it. |
| Get a user | Get a Barter.vg trader's profile by their Barter.vg user ID, SteamID64 or profile link: their Steam name and avatar, how many trades they have completed and with how many traders, any disputes, whether they are taking offers, and the trade preferences they set. |
| Get an offer | Get one Barter.vg trade offer with what is in it: the games each side gives and how many, who sent it to whom with their SteamIDs, each side's status and reason, whose move it is, and when it was sent, changed and expires. |
| List a game's traders | List the Barter.vg traders who have a game to trade, who have it on their wishlist, and who do not own it and take any game they do not own, each with their Steam name, SteamID and the trade preferences they set. |
| List a user's games | List the games in a Barter.vg trader's tradables, wishlist, library or blacklist, newest first or by title, optionally only those whose title has some words, a page at a time. |
| List a user's offers | List the trade offers a Barter.vg trader has sent and received, most recently changed first, with the other trader, each side's status and whose move it is. |
| List bundles | List the game bundles Barter.vg lists from stores such as Humble Bundle, Fanatical, Indiegala and DailyIndieGame, newest first, with each bundle's store, link, start and end, and its games with their Steam IDs and tiers. |
| List giveaways | List the game giveaways Barter.vg has recorded, newest first: free keys, games to add to an account for free, limited and expiring keys and more, on Steam, Epic, GOG, itch.io and other platforms. |
Find trade matches
Find what two Barter.vg traders could swap: the games the first has to trade that the second has on their wishlist, and the games the second has to trade that the first wants. Compares their lists as they are now, reading four lists, sorted by title.
Inputs
- User
usertextRequired - The first trader, usually you: their Barter.vg user ID, such as a0, their SteamID64, or a link to their profile.
- Other user
other_usertextRequired - The trader to compare with, given the same ways.
- Limit
limitnumber - The most games to return each way, from 1 to 500. Defaults to 100; each count is the full number.From 1 to 500. Default:
100.
Outputs
is_two_waytrue/false- Whether each trader has something the other wants.
other_userobject- The trader.
userobject- The trader.
user_can_getlist- Games the other trader has to trade that the first wants, from the other trader's list.
user_can_get_countnumber- How many games the first trader could get.
user_can_givelist- Games the first trader has to trade that the other wants, from the first trader's list.
user_can_give_countnumber- How many games the first trader could give.
Example output
{
"is_two_way": true,
"other_user": {
"id": "427",
"name": "luckz",
"url": "https://barter.vg/u/427/"
},
"user": {
"id": "a0",
"name": "ellipsism",
"url": "https://barter.vg/u/a0/"
},
"user_can_get": [
{
"achievements": 26,
"blacklist_count": 19,
"entry_tags": [],
"included_games": [],
"item_id": 642,
"library_count": 165,
"line_id": 93696174,
"linux": true,
"mac": true,
"platform": "Steam",
"platform_id": 1,
"price_usd": 0.99,
"release_year": 2014,
"reviews_positive_percent": 67,
"reviews_total": 2892,
"steam_app_id": 225600,
"steam_limited": false,
"steam_package_id": null,
"steamgifts_cv_percent": 15,
"store_url": "https://store.steampowered.com/app/225600/",
"times_bundled": 3,
"times_given_away": 0,
"title": "Blade Symphony",
"title_extra": null,
"tradable_count": 16,
"trading_cards": 9,
"type": "Game",
"url": "https://barter.vg/i/642/",
"wishlist_count": 2
}
],
"user_can_get_count": 4,
"user_can_give": [
{
"achievements": null,
"blacklist_count": 2,
"entry_tags": [],
"included_games": [],
"item_id": 144500,
"library_count": 1,
"line_id": 126526259,
"linux": false,
"mac": false,
"platform": "Epic Games Store",
"platform_id": 66,
"price_usd": null,
"release_year": null,
"reviews_positive_percent": null,
"reviews_total": null,
"steam_app_id": null,
"steam_limited": false,
"steam_package_id": null,
"steamgifts_cv_percent": 100,
"store_url": null,
"times_bundled": 0,
"times_given_away": 0,
"title": "Control Ultimate Edition",
"title_extra": null,
"tradable_count": 0,
"trading_cards": null,
"type": "Game",
"url": "https://barter.vg/i/144500/",
"wishlist_count": 1
}
],
"user_can_give_count": 8
}Get a bundle
Get one bundle Barter.vg has recorded, old or new, by its ID or a link to it: its store, link, start and end, and its games and packages with their Steam IDs, tiers and the games each package holds.
Inputs
- Bundle
bundletextRequired - The bundle's Barter.vg ID, as List bundles and Get a game give it, or a link to its page on Barter.vg.
Outputs
bundleobject- One bundle, with its games.
Example output
{
"bundle": {
"barter_url": "https://barter.vg/bundle/1/",
"ends_at": "2010-05-15T07:00:00Z",
"game_count": 2,
"games": [
{
"included_app_ids": [
22000,
24420,
9500,
22180,
25010,
40720
],
"item_id": 35899,
"steam_app_id": null,
"steam_package_id": 4991,
"store_url": "https://store.steampowered.com/sub/4991/",
"tier": 1,
"url": "https://barter.vg/i/35899/"
},
{
"included_app_ids": [
40720,
420690
],
"item_id": 130743,
"steam_app_id": null,
"steam_package_id": 85841,
"store_url": "https://store.steampowered.com/sub/85841/",
"tier": 1,
"url": "https://barter.vg/i/130743/"
}
],
"id": 1,
"is_running": false,
"starts_at": "2010-05-04T17:00:00Z",
"store": "Humble Bundle",
"store_id": 3,
"title": "The Humble Indie Bundle",
"url": "http://web.archive.org/web/20100517091615/http://www.wolfire.com/humble"
}
}Get a game
Look up a game, DLC or package on Barter.vg by its Steam app ID, Steam package ID or Barter.vg item ID, or a link to its page: its platform, release date, Steam price and lowest price, reviews, achievements and trading cards, how often it has been bundled and given away, and how many traders have it to trade, want it or own it.
Inputs
- Game
gametextRequired - The game: its ID, or a link to its page on Barter.vg, the Steam store or SteamDB, such as 212680 or https://store.steampowered.com/app/212680/. A link says what kind of ID it holds, as does a game an earlier step returned (by its Barter.vg item ID); a number is read as ID type says.
- ID type
id_typetext - What kind of ID Game is: a Steam app ID (the number in a Steam store link), a Steam package ID, or Barter.vg's own item ID. Steam app ID by default. Ignored when Game is a link or a game an earlier step returned.One of:
steam_app(Steam app ID),steam_package(Steam package ID),barter_item(Barter.vg item ID). Default:steam_app.
Outputs
gameobject- One game, and everything Barter.vg records about it.
Example output
{
"game": {
"achievements": 51,
"adult_only": false,
"base_game_id": null,
"blacklist_count": 18,
"bundle_ids": [
21,
1787,
4706,
4939
],
"bundles_available": 0,
"id": 1,
"is_free": false,
"isthereanydeal_url": "https://isthereanydeal.com/game/ftl-faster-than-light/info/",
"library_count": 298,
"linux": true,
"lowest_price_eur": 1.99,
"lowest_price_usd": 1.99,
"mac": true,
"platform": "Steam",
"platform_id": 1,
"price_eur": 9.99,
"price_usd": 9.99,
"prices_updated_at": "2026-10-01T05:34:01Z",
"release_date": "2012-09-14",
"release_year": 2012,
"reviews_positive_percent": 95,
"reviews_total": 46900,
"steam_app_id": 212680,
"steam_package_id": null,
"steam_tags": [
"Roguelike",
"macOS",
"Steam plus one",
"Linux",
"Real-Time with Pause",
"Procedural Generation",
"Tactical",
"Top-Down",
"Roguelite",
"Space Sim",
"Choose Your Own Adventure",
"Addictive",
"Steam Deck Playable",
"RPG",
"Replay Value",
"Pixel Graphics",
"Casual",
"Perma Death",
"Atmospheric",
"Sci-fi",
"Survival",
"Simulation",
"Great Soundtrack",
"Indie",
"Space",
"Adventure",
"2D",
"Singleplayer",
"Difficult",
"Strategy",
"achievements"
],
"steamgifts_cv_percent": 15,
"store_url": "https://store.steampowered.com/app/212680/",
"times_bundled": 3,
"times_given_away": 0,
"title": "FTL: Faster Than Light",
"title_extra": null,
"tradable_count": 11,
"trading_cards": 8,
"trading_cards_marketable": true,
"type": "Game",
"updated_at": "2026-09-15T21:15:01Z",
"url": "https://barter.vg/i/1/",
"windows": true,
"wishlist_count": 13
}
}Get a user
Get a Barter.vg trader's profile by their Barter.vg user ID, SteamID64 or profile link: their Steam name and avatar, how many trades they have completed and with how many traders, any disputes, whether they are taking offers, and the trade preferences they set.
Inputs
- User
usertextRequired - The trader: their Barter.vg user ID (the part of their profile link after /u/, such as a0), their SteamID64, or a link to their Barter.vg or Steam profile.
Outputs
userobject- One trader's Barter.vg profile.
Example output
{
"user": {
"accepts_unowned": true,
"available": false,
"avatar_url": "https://avatars.steamstatic.com/41d0a0ca20c6b460c10e03c6ff8ef23bc6bb7f9d_full.jpg",
"avoids_bundled": false,
"avoids_given_away": false,
"disputed": 0,
"id": "a0",
"name": "ellipsism",
"steam_id": "76561198164997231",
"steam_profile_url": "https://steamcommunity.com/profiles/76561198164997231",
"trade_partners": 588,
"trades": 1309,
"url": "https://barter.vg/u/a0/",
"wants_cards": false
}
}Get an offer
Get one Barter.vg trade offer with what is in it: the games each side gives and how many, who sent it to whom with their SteamIDs, each side's status and reason, whose move it is, and when it was sent, changed and expires.
Inputs
- User
usertextRequired - A trader in the offer, who sent it or received it: their Barter.vg user ID, such as a0, their SteamID64, or a link to their profile.
- Offer
offertextRequired - The offer's number, as List a user's offers gives it, or a link to it on Barter.vg.
Outputs
offerobject- One offer, with the games each side gives.
Example output
{
"offer": {
"counter_offer_id": null,
"created_at": "2024-10-08T17:39:04Z",
"from_expires_at": "2024-10-23T17:42:38Z",
"from_items": [
{
"achievements": null,
"included": true,
"item_id": 8251,
"library_count": 0,
"platform": "Steam Item",
"platform_id": 19,
"price_usd": null,
"quantity": 2,
"reviews_positive_percent": 0,
"reviews_total": 0,
"steam_app_id": null,
"steam_package_id": null,
"store_url": null,
"times_bundled": 0,
"title": "Mann Co. Supply Crate Key",
"title_extra": null,
"tradable_count": 99,
"trading_cards": 0,
"type": "other",
"url": "https://barter.vg/i/8251/",
"wishlist_count": 121
},
{
"achievements": null,
"included": false,
"item_id": 8261,
"library_count": 0,
"platform": "Steam Item",
"platform_id": 19,
"price_usd": null,
"quantity": 0,
"reviews_positive_percent": 0,
"reviews_total": 0,
"steam_app_id": null,
"steam_package_id": null,
"store_url": null,
"times_bundled": 0,
"title": "Gems",
"title_extra": null,
"tradable_count": 72,
"trading_cards": 0,
"type": "other",
"url": "https://barter.vg/i/8261/",
"wishlist_count": 58
},
{
"achievements": null,
"included": false,
"item_id": 8262,
"library_count": 0,
"platform": "Steam Item",
"platform_id": 19,
"price_usd": null,
"quantity": 15,
"reviews_positive_percent": 0,
"reviews_total": 0,
"steam_app_id": null,
"steam_package_id": null,
"store_url": null,
"times_bundled": 0,
"title": "Sack of Gems",
"title_extra": null,
"tradable_count": 82,
"trading_cards": 0,
"type": "other",
"url": "https://barter.vg/i/8262/",
"wishlist_count": 74
}
],
"from_reason": null,
"from_status": "completed",
"from_steam_id": "76561198164997231",
"from_user_id": "a0",
"from_user_name": "ellipsism",
"id": 6246635,
"is_open": false,
"original_offer_id": null,
"side_to_act": "none",
"to_expires_at": "2024-10-30T20:49:28Z",
"to_items": [
{
"achievements": 47,
"included": true,
"item_id": 136760,
"library_count": 258,
"platform": "Steam",
"platform_id": 1,
"price_usd": 17.99,
"quantity": 1,
"reviews_positive_percent": 90,
"reviews_total": 7069,
"steam_app_id": 1382330,
"steam_package_id": null,
"store_url": "https://store.steampowered.com/app/1382330/",
"times_bundled": 1,
"title": "Persona 5 Strikers",
"title_extra": null,
"tradable_count": 38,
"trading_cards": 9,
"type": "Game",
"url": "https://barter.vg/i/136760/",
"wishlist_count": 25
}
],
"to_reason": null,
"to_status": "completed",
"to_steam_id": "76561198105279930",
"to_user_id": "926",
"to_user_name": "Osztihun",
"updated_at": "2024-10-16T17:29:49Z",
"url": "https://barter.vg/u/a0/o/6246635/",
"waiting_on_user_id": null
}
}List a game's traders
List the Barter.vg traders who have a game to trade, who have it on their wishlist, and who do not own it and take any game they do not own, each with their Steam name, SteamID and the trade preferences they set. Finds the game the same ways as Get a game.
Inputs
- Game
gametextRequired - The game: its ID, or a link to its page on Barter.vg, the Steam store or SteamDB, such as 212680 or https://store.steampowered.com/app/212680/. A link says what kind of ID it holds, as does a game an earlier step returned (by its Barter.vg item ID); a number is read as ID type says.
- ID type
id_typetext - What kind of ID Game is: a Steam app ID (the number in a Steam store link), a Steam package ID, or Barter.vg's own item ID. Steam app ID by default. Ignored when Game is a link or a game an earlier step returned.One of:
steam_app(Steam app ID),steam_package(Steam package ID),barter_item(Barter.vg item ID). Default:steam_app. - Limit
limitnumber - The most traders to return in each group, from 1 to 500. Defaults to 50; each group's count is the full number.From 1 to 500. Default:
50.
Outputs
gameobject- The game, as Get a game names it.
offeringlist- Traders who have it to trade.
offering_countnumber- How many traders have it to trade.
wantinglist- Traders who have it on their wishlist.
wanting_countnumber- How many traders have it on their wishlist.
would_acceptlist- Traders who do not own it and take any game they do not own, so they may take it in a trade.
would_accept_countnumber- How many traders would take it that way.
Example output
{
"game": {
"id": 1,
"platform": "Steam",
"steam_app_id": 212680,
"steam_package_id": null,
"title": "FTL: Faster Than Light",
"url": "https://barter.vg/i/1/"
},
"offering": [
{
"accepts_unowned": true,
"avoids_bundled": false,
"avoids_dlc": true,
"avoids_given_away": false,
"id": "145",
"max_items_per_offer": 10,
"name": "theemu",
"steam_id": "76561197972529138",
"steam_only": false,
"url": "https://barter.vg/u/145/",
"wants_cards": false
},
{
"accepts_unowned": true,
"avoids_bundled": false,
"avoids_dlc": false,
"avoids_given_away": false,
"id": "427",
"max_items_per_offer": null,
"name": "luckz",
"steam_id": "76561197963550511",
"steam_only": false,
"url": "https://barter.vg/u/427/",
"wants_cards": false
}
],
"offering_count": 3,
"wanting": [
{
"accepts_unowned": true,
"avoids_bundled": false,
"avoids_dlc": false,
"avoids_given_away": false,
"id": "1b04",
"max_items_per_offer": 100,
"name": "jojoPL1987",
"steam_id": "76561198064549565",
"steam_only": false,
"url": "https://barter.vg/u/1b04/",
"wants_cards": false
},
{
"accepts_unowned": false,
"avoids_bundled": true,
"avoids_dlc": false,
"avoids_given_away": false,
"id": "1be5",
"max_items_per_offer": 100,
"name": "rafa.vb",
"steam_id": "76561198262464555",
"steam_only": false,
"url": "https://barter.vg/u/1be5/",
"wants_cards": true
}
],
"wanting_count": 3,
"would_accept": [
{
"accepts_unowned": true,
"avoids_bundled": false,
"avoids_dlc": false,
"avoids_given_away": false,
"id": "6923",
"max_items_per_offer": 6,
"name": "Eddie the Head",
"steam_id": "76561198271914559",
"steam_only": false,
"url": "https://barter.vg/u/6923/",
"wants_cards": false
},
{
"accepts_unowned": true,
"avoids_bundled": false,
"avoids_dlc": true,
"avoids_given_away": false,
"id": "6d5f",
"max_items_per_offer": 10,
"name": "Capit\u00e3o Claw",
"steam_id": "76561198013317302",
"steam_only": true,
"url": "https://barter.vg/u/6d5f/",
"wants_cards": false
}
],
"would_accept_count": 3
}List a user's games
List the games in a Barter.vg trader's tradables, wishlist, library or blacklist, newest first or by title, optionally only those whose title has some words, a page at a time. Each comes with its platform, Steam IDs, price, reviews, bundle and giveaway counts, how many traders want it, and the tags the trader added; a package comes with the games it holds.
Inputs
- User
usertextRequired - The trader: their Barter.vg user ID (the part of their profile link after /u/, such as a0), their SteamID64, or a link to their Barter.vg or Steam profile.
- Collection
collectiontext - Which of the trader's lists: what they have to trade, what they want, what they own, or what they do not want offered. Tradables by default.One of:
tradable(Tradables),wishlist,library,blacklist. Default:tradable. - Title contains
title_containstext - Optional. Only games whose title has all of these words, ignoring case and accents, such as half life.
- Sort
sorttext - Newest first, the games the trader added last at the top, or by title. Newest first by default.One of:
newest(Newest first),title(Title, A to Z). Default:newest. - Limit
limitnumber - The most games to return, from 1 to 1000. Defaults to 100.From 1 to 1000. Default:
100. - Offset
offsetnumber - How many games to skip first, for the next page: 100 for the second page of 100. Defaults to 0.At least 0.
Outputs
collectiontext- The list: 'tradable', 'wishlist', 'library' or 'blacklist'.
countnumber- How many games this page has.
gameslist- This page of the games that match, in the order asked for.
has_moretrue/false- Whether more games match after this page.
offsetnumber- How many games were skipped before this page.
totalnumber- How many games match, across every page.
userobject- The trader.
Example output
{
"collection": "wishlist",
"count": 2,
"games": [
{
"achievements": null,
"blacklist_count": 6,
"entry_tags": [],
"included_games": [],
"item_id": 68538,
"library_count": 5,
"line_id": 163368413,
"linux": false,
"mac": false,
"platform": "Steam",
"platform_id": 1,
"price_usd": 59.99,
"release_year": 2018,
"reviews_positive_percent": 73,
"reviews_total": 15,
"steam_app_id": 821800,
"steam_limited": false,
"steam_package_id": null,
"steamgifts_cv_percent": 100,
"store_url": "https://store.steampowered.com/app/821800/",
"times_bundled": 0,
"times_given_away": 0,
"title": "ADR-Labelling Game",
"title_extra": null,
"tradable_count": 0,
"trading_cards": null,
"type": "Game",
"url": "https://barter.vg/i/68538/",
"wishlist_count": 16
},
{
"achievements": null,
"blacklist_count": 17,
"entry_tags": [],
"included_games": [],
"item_id": 153212,
"library_count": 108,
"line_id": 173361365,
"linux": false,
"mac": false,
"platform": "Steam",
"platform_id": 1,
"price_usd": 8.99,
"release_year": 2024,
"reviews_positive_percent": 82,
"reviews_total": 112,
"steam_app_id": 1435970,
"steam_limited": true,
"steam_package_id": null,
"steamgifts_cv_percent": 15,
"store_url": "https://store.steampowered.com/app/1435970/",
"times_bundled": 4,
"times_given_away": 0,
"title": "Anomalous",
"title_extra": null,
"tradable_count": 6,
"trading_cards": null,
"type": "Game",
"url": "https://barter.vg/i/153212/",
"wishlist_count": 19
}
],
"has_more": true,
"offset": 0,
"total": 21,
"user": {
"id": "a0",
"name": "ellipsism",
"url": "https://barter.vg/u/a0/"
}
}List a user's offers
List the trade offers a Barter.vg trader has sent and received, most recently changed first, with the other trader, each side's status and whose move it is. Narrow to sent or received offers, to those waiting on the trader or on the other side, or to those changed since a time, for a workflow that reacts to new offers.
Inputs
- User
usertextRequired - The trader: their Barter.vg user ID (the part of their profile link after /u/, such as a0), their SteamID64, or a link to their Barter.vg or Steam profile.
- Direction
directiontext - Sent and received offers, or only one of them. Both by default.One of:
all(Sent and received),sent(Sent by this trader),received(Received by this trader). Default:all. - State
statetext - Any offer, only open ones, only those waiting on this trader's move or on the other trader's, or only closed ones. Any by default.One of:
all(Any state),open(Open, waiting on either trader),waiting_on_user(Waiting on this trader),waiting_on_other(Waiting on the other trader),closed. Default:all. - Updated after
updated_afterdate and time - Optional. Only offers that changed after this time, such as the last time the workflow ran.
- Limit
limitnumber - The most offers to return, from 1 to 500. Defaults to 50.From 1 to 500. Default:
50.
Outputs
countnumber- How many offers this answer has.
matchednumber- How many offers match, before the limit.
offerslist- The offers that match, most recently changed first.
totalnumber- How many offers the trader has in all.
userobject- The trader.
Example output
{
"count": 2,
"matched": 18,
"offers": [
{
"counter_offer_id": null,
"created_at": "2024-12-26T12:18:37Z",
"direction": "sent",
"from_expires_at": "2024-12-30T12:29:13Z",
"from_reason": null,
"from_status": "expired",
"from_user_id": "a0",
"from_user_name": "ellipsism",
"id": 6352848,
"is_open": false,
"other_user_id": "427",
"other_user_name": "luckz",
"side_to_act": "none",
"to_expires_at": "2025-01-02T04:05:13Z",
"to_reason": null,
"to_status": "accepted",
"to_user_id": "427",
"to_user_name": "luckz",
"updated_at": "2025-01-02T04:10:01Z",
"url": "https://barter.vg/u/a0/o/6352848/",
"waiting_on_user_id": null
},
{
"counter_offer_id": null,
"created_at": "2018-04-25T06:13:04Z",
"direction": "sent",
"from_expires_at": "2018-05-02T06:14:14Z",
"from_reason": null,
"from_status": "proposed",
"from_user_id": "a0",
"from_user_name": "ellipsism",
"id": 2086714,
"is_open": false,
"other_user_id": "12d4",
"other_user_name": "Seemannsd\u00e4mlack",
"side_to_act": "none",
"to_expires_at": "2025-01-01T19:23:07Z",
"to_reason": null,
"to_status": "expired",
"to_user_id": "12d4",
"to_user_name": "Seemannsd\u00e4mlack",
"updated_at": "2025-01-01T19:30:02Z",
"url": "https://barter.vg/u/a0/o/2086714/",
"waiting_on_user_id": null
}
],
"total": 1600,
"user": {
"id": "a0",
"name": "ellipsism",
"url": "https://barter.vg/u/a0/"
}
}List bundles
List the game bundles Barter.vg lists from stores such as Humble Bundle, Fanatical, Indiegala and DailyIndieGame, newest first, with each bundle's store, link, start and end, and its games with their Steam IDs and tiers. Narrow to bundles on sale now, to one store, or to those newer than the last one seen.
Inputs
- Store
storetext - Optional. Only bundles from this store, by its name or part of it, such as Humble or Fanatical.
- Running only
running_onlytrue/false - Only bundles on sale now. On by default; turn it off to include the older ones Barter.vg still lists.Default:
true. - Newer than ID
newer_than_idnumber - Optional. Only those with a higher ID than this one, newer than the newest a workflow has already seen. Each answer gives newest_id to keep for the next run.At least 0.
- Limit
limitnumber - The most bundles to return, from 1 to 100. Defaults to 25.From 1 to 100. Default:
25.
Outputs
bundleslist- The bundles that match, newest first.
countnumber- How many bundles this answer has.
matchednumber- How many bundles match, before the limit.
newest_idnumber- The highest ID Barter.vg lists, whatever the filters, or null when it lists none. Keep it for Newer than ID on the next run.
Example output
{
"bundles": [
{
"barter_url": "https://barter.vg/bundle/9227/",
"ends_at": "2026-10-31T04:00:00Z",
"game_count": 4,
"games": [
{
"included_app_ids": [],
"item_id": 353492,
"steam_app_id": 4249140,
"steam_package_id": null,
"store_url": "https://store.steampowered.com/app/4249140/",
"tier": 2,
"url": "https://barter.vg/i/353492/"
},
{
"included_app_ids": [],
"item_id": 359913,
"steam_app_id": 4249120,
"steam_package_id": null,
"store_url": "https://store.steampowered.com/app/4249120/",
"tier": 1,
"url": "https://barter.vg/i/359913/"
},
{
"included_app_ids": [],
"item_id": 359914,
"steam_app_id": 4249150,
"steam_package_id": null,
"store_url": "https://store.steampowered.com/app/4249150/",
"tier": 2,
"url": "https://barter.vg/i/359914/"
},
{
"included_app_ids": [],
"item_id": 359911,
"steam_app_id": 4249100,
"steam_package_id": null,
"store_url": "https://store.steampowered.com/app/4249100/",
"tier": 1,
"url": "https://barter.vg/i/359911/"
}
],
"id": 9227,
"is_running": true,
"starts_at": "2026-10-02T18:00:00Z",
"store": "Humble Bundle",
"store_id": 3,
"title": "Capcom Classics Bundle",
"url": "https://www.humblebundle.com/games/capcom-classics-bundle"
}
],
"count": 1,
"matched": 61,
"newest_id": 9227
}List giveaways
List the game giveaways Barter.vg has recorded, newest first: free keys, games to add to an account for free, limited and expiring keys and more, on Steam, Epic, GOG, itch.io and other platforms. Narrow by kind and platform, or to those newer than the last one seen, for a workflow that announces new ones.
Inputs
- Giveaway types
giveaway_typestext - Only giveaways of these kinds. Leave empty for every kind.One or more of:
free_key(Free key),expiring_key(Free key that expires),add_to_account(Add to account for free),limited(Limited, 1000 or fewer keys),random_key(Random free key),free_to_play(Free to play),beta(Free beta that may deactivate),demo(Demo key),free_with_purchase(Free with purchase),lottery(Lottery or chance),revoked. - Platforms
platformstext - Only giveaways redeemed on these platforms. Steam covers apps and packages. Leave empty for every platform.One or more of:
steam,epic(Epic Games Store),gog,itch(itch.io),ubisoft(Ubisoft Connect),ea,playstation,xbox,nintendo. - Newer than ID
newer_than_idnumber - Optional. Only those with a higher ID than this one, newer than the newest a workflow has already seen. Each answer gives newest_id to keep for the next run.At least 0.
- Limit
limitnumber - The most giveaways to return, from 1 to 200. Defaults to 25.From 1 to 200. Default:
25.
Outputs
countnumber- How many giveaways this answer has.
giveawayslist- The giveaways that match, newest first.
matchednumber- How many giveaways match, before the limit.
newest_idnumber- The highest ID Barter.vg lists, whatever the filters, or null when it lists none. Keep it for Newer than ID on the next run.
Example output
{
"count": 2,
"giveaways": [
{
"game_url": "https://barter.vg/i/387178/",
"id": 12179,
"item_id": 387178,
"platform": "Steam",
"platform_id": 1,
"posted_at": "2026-09-30T21:00:12Z",
"steam_app_id": 5242170,
"steam_package_id": null,
"store_url": "https://store.steampowered.com/app/5242170/",
"title": "Horror Golf",
"type": "Lottery / Chance",
"type_id": 15,
"url": "https://barter.vg/giveaway/12179/"
},
{
"game_url": "https://barter.vg/i/381499/",
"id": 12178,
"item_id": 381499,
"platform": "Steam",
"platform_id": 1,
"posted_at": "2026-09-30T20:59:41Z",
"steam_app_id": 5113190,
"steam_package_id": null,
"store_url": "https://store.steampowered.com/app/5113190/",
"title": "BAFF E",
"type": "Free Key",
"type_id": 1,
"url": "https://barter.vg/giveaway/12178/"
}
],
"matched": 105,
"newest_id": 12179
}