README.md

discogs-marketplace-js

JavaScript library to pull information from the Discogs marketplace. Returns an object.

Usage

Init

var marketplace = require('discogs-marketplace-js');

Search

var search_parameters = {
	id: "Black Sabbath",
	type: "string",
	pagination : {
		page: 1
	}
}

marketplace.search(search_parameters, function(result){
	if(!(result instanceof Error))
		console.log(result);
});

Filters/Pagination

To specify search filters and pagination options, discogs-marketplace-js will accept an object as an input.

var search_parameters = {
	id: "1067610", //id can also be a string, if used with type 'string'
	type: "release", //one of: 'release', 'master', 'label', 'string'
	filters: {
		genre: "Rock",
		style: null,
		format: "Vinyl",
		country: "US",
		decade: null,
		condition: ["Very Good Plus", "Mint"],
		year: 2015,
		currency: "USD",
	},
	pagination: {
		page: 1,
		per_page: 25,
		sort: "Price Lowest Highest"
	}
};

Result

{
	id: '1067610',
	type: 'master',
	pagination: 
	{ 
		items: 1112, 
		hasNext: true
		totalPages : 0 
	},
  	listing: 
   	[ 
   		{	
   			title: 'Black Sabbath - Black Sabbath (8-Trk, Album)',
       		condition_sleeve: 'Very Good (VG)',
	       	condition_media: 'Very Good (VG)',
	       	seller: 'easeup',
	       	ships_from: 'United States',
	       	price: '$45.00' 
	   },
	   { 
	   		title: 'Black Sabbath - Black Sabbath (2xLP, Album, Dlx, RE, RM, 180)',
		    condition_sleeve: 'Near Mint (NM or M-)',
		    condition_media: 'Near Mint (NM or M-)',
		    seller: 'fishtown19125',
		    ships_from: 'United States',
		    price: '$35.00' 
		}
	]
}

Installation

TODO:

• Add ability to return a promise when no callback is provided
• Add rate-limiting features