Steam community search

Steam Market Search is a NodeJS package to search the Steam Community Market. Using this package you will be able to search and retrieve images, prices, descriptions, listing counts and other various information made available by each app.

Install via NPM

npm install steam-market-search

Then you can require the package in your project using TypeScript

or JavaScript

Below is my attempt at documenting how to use this package. If you feel like you can do better please feel free to make a pull request.

search(appid, options);

Searches the marketplace for items.

Basic Search

Search (CSGO) for a gun skin called .

Advanced Search

Search (Armello) for a item using a custom item type

setRequestOptions(RequestOptions)

Allows you to define custom RequestOptions like headers to be passed when making API Calls.

Custom Headers

This is an example that uses setRequestOptions() to change the language of the search results

Now all requests made on will be in German.

As a lot of people use this for apps like CS:GO, TF2 or Dota there are several shortcuts to quickly search that specific app.

Below are some more examples or explanations that may be helpful

Steam Item Types

When using you may want to only fetch certain types of items. Below is a table listing each type and the value required to filter

Multiple Filters

The following example will search for any or that contain the word

Filter by game

If you only want community items from a specific game you can filter them using the option. Like all options ending with square brackets you can pass multiple game appids at once.

Type: SearchOptions

This is the options object you would pass instead of a string when searching

Get Steam Market (API) results in euro

Unfortunately, it isn't possible. The parameter you're referring to, i.e. only allows for specific sub-pages to be called, e.g.:

(looking for the price of the Fracture Case) - returns:

{"success":true,"lowest_price":"0,39€","volume":"84,984","median_price":"0,39€"}

If you change to be equal to (being dollar):

{"success":true,"lowest_price":"$0.49","volume":"84,847","median_price":"$0.48"}

As you can clearly see, works perfectly fine with .

Though as far as I'm aware, doesn't take the parameter as an input, i.e. the currency will ultimately be rendered as dollar (or ).

What you could do is to scrape via and looking up the price via , though this option will yield pretty inaccurate results ( only displays a limited amount of details).

On a slight off-topic note: You can convert the price locally (with other APIs or for static currency pairs with a certain factor). Though as you specifically mentioned that you want to do it via the official price (calculating it "manually" ends up with differences, steam-related) that isn't a valid option.

answered Feb 22 at 14:17

Steam Market Search is a NodeJS package to search the Steam Community Market. Using this package you will be able to search and retrieve images, prices, descriptions, listing counts and other various information made available by each app.

Install via NPM

npm install steam-market-search

Then you can require the package in your project using TypeScript

or JavaScript

Below is my attempt at documenting how to use this package. If you feel like you can do better please feel free to make a pull request.

search(appid, options);

Searches the marketplace for items.

Basic Search

Search (CSGO) for a gun skin called .

Advanced Search

Search (Armello) for a item using a custom item type

setRequestOptions(RequestOptions)

Allows you to define custom RequestOptions like headers to be passed when making API Calls.

Custom Headers

This is an example that uses setRequestOptions() to change the language of the search results

Now all requests made on will be in German.

As a lot of people use this for apps like CS:GO, TF2 or Dota there are several shortcuts to quickly search that specific app.

Below are some more examples or explanations that may be helpful

Steam Item Types

When using you may want to only fetch certain types of items. Below is a table listing each type and the value required to filter

Multiple Filters

The following example will search for any or that contain the word

Filter by game

If you only want community items from a specific game you can filter them using the option. Like all options ending with square brackets you can pass multiple game appids at once.

Type: SearchOptions

This is the options object you would pass instead of a string when searching