The Unoffical Backpack.tf API Wrapper in Python 3.
Project description
BackpackTF-API
This is an unoffical api wrapper for the Backpack.tf API in python. You can do a lot with this API keep reading for more information
Important Information
- If this API stops working for any reason open an issue.
- Feel free to mention @davidteather in an issue you open, because I might not see it otherwise.
Getting Started
To get started using this api follow the instructions below.
You need to register for an API key and create an app to use all the fucntions of this api at BackpackTF
Installing
If you need help installing or run into some error, please open an issue. I will try to help out as much as I can.
Tested with python 3.7.3
pip install BackpackTF
Quick Start Guide
Here's a quick bit of code to get an item's price
from BackpackTF import Currency
api = Currency(apikey="xxxxxxxxxxxxxxxxx")
price = api.itemPrice(name="Tour of Duty Ticket", quality="Unique", craftable=1, tradable=1)
print(price)
Detailed Documentation
The Account Class
init
Attributes | Description |
---|---|
client_id | from your backpack.tf app here |
client_secret | from your backpack.tf app here |
api_key | your api key from here |
create_listing - creates a listing / classified on backpack.tf
Attributes | Description |
---|---|
intent | 0 (Buy) or 1 (Sell) |
id | if intent is 1, the current id of the id you want to list |
item_name | if intent is 0, the item's name you want to buy |
quality | if intent is 0, either the number or the text |
craftable | if intent is 0, 0 or 1 |
offers | set to 0 for only accepting friend requests |
buyout | set to 0 to allow negotiation |
promoted | set to 1 to promote it, must be premium |
details | the listing comment, max 200 characters |
priceindex | complicated, most of the time is 0. More info |
returns 0 or 1 for success or failure.
search_classifieds - searches for classifieds
Attributes | Description |
---|---|
intent | either sell, buy, or both |
page_size | the results / page 0 < page_size <= 30 |
page | the page number you want to view |
fold | if set 0 disables listing folding |
item_name | the name of the item you want to search for |
steamid | the steam id of the user who you want to check their listings |
tradable | 0/1 |
craftable | 0/1 |
australium | 0/1 |
wear_tier | 1-5 for tier of skin wear, use MiscUtils().wear_Tier_String_To_Int() |
texture_name | required to search by wear_tier, the name of the skin / texture to search by |
quality | the integer of the quality to search by use MiscUtils().qualityStringToInt() to get it |
paint | the paint's ID to search by |
particle | particle ID effect |
killstreak_tier | 1-3, use MiscUtils().killstreaker_Tier_String_To_Int() |
sheen | 0-7, use MiscUtils().sheen_String_To_Int() |
killstreaker | the id of the killstreaker |
returns a dictionary. Here's an example json
extract_trade_url - extracts the trade url with token from a listing
Attributes | Description |
---|---|
listingJSON | This is the json object of a classified listing on backpack.tf. You can get this using the method above. |
proxy | This is an optional field, provide a dictionary that fits the python requests module requirements. See here |
returns the trade url as a string.
The Currency Class
init
Attributes | Description |
---|---|
apikey | your api key from here |
get_currencies - gets currency values
Attributes | Description |
---|---|
None | None |
returns a dictonary. Here's an example json.
price_history - gets the price history for a given item
Attributes | Description |
---|---|
name | the name of the item you want to search for |
quality | the integer of the quality to search by use MiscUtils().qualityStringToInt("Unique") to get it |
craftable | 0/1 |
tradable | 0/1 |
priceindex | complicated, most of the time is 0. More info |
returns an array of dictionaries. Here's an example.
item_price - gets the current price for a given item
Attributes | Description |
---|---|
name | the name of the item you want to search for |
quality | the integer of the quality to search by use MiscUtils().qualityStringToInt("Unique") to get it |
craftable | 0/1 |
tradable | 0/1 |
priceindex | complicated, most of the time is 0. More info |
returns a single dictionary of current value. Here's an example.
get_all_prices - gets all prices
Attributes | Description |
---|---|
raw | shows a value_low field |
since | will only show items that has had price changes since the unix epoch. |
returns a kind of weird json file. Here's an example, and here's the structure.
The MiscUtils Class
init
Attributes | Description |
---|---|
None | None |
quality_string_to_int
Attributes | Description |
---|---|
string | The string of the quality. Ex: "Unique" |
particle_string_to_int
Attributes | Description |
---|---|
string | The string of the particle effect. |
rarity_string_to_int
Attributes | Description |
---|---|
string | The string of the rarity. |
origin_string_to_int
Attributes | Description |
---|---|
string | The string of the origin. |
wear_tier_string_to_int
Attributes | Description |
---|---|
string | The string of the wear_tier. |
killstreaker_string_to_int
Attributes | Description |
---|---|
string | The string of the killstreaker. |
strange_parts_string_to_int
Attributes | Description |
---|---|
string | The string of the strange part. |
steam_id_to_account_id
Attributes | Description |
---|---|
string | The string of the steam_id. |
returns an int of the account id.
Built With
- Python 3.7 - The web framework used
Authors
- David Teather - Initial work - davidteather
See also the list of contributors who participated in this project.
License
This project is licensed under the MIT License - see the LICENSE.md file for details
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.