General

Authentication

Each api call is required to provide a authentication key.
Access to our api is free for Dutch webshops who push their prices to us.
Others need an Cardsearch Advanced account.

Output format

Each api call can provide an additional parameter "format" with values "json","xml", "csv" or "table".
Json is the default format.
GET http://api.cardsearch.nl/v1/sets?key=demo&format=xml

GET - retrieve information

Cards Get card information

(max 1000 requests per day)
Get information of a single card:
GET http://api.cardsearch.nl/v1/cards?key=demo&names[]=Terror

Get information of a single card of a specific set:
GET http://api.cardsearch.nl/v1/cards?key=demo&names[]=Terror@6ED

Get information of multiple cards:
GET http://api.cardsearch.nl/v1/cards?key=demo&names[]=Terror&names[]=Disintegrate@5ED

Get information of a single card or multiple cards by id:
GET http://api.cardsearch.nl/v1/cards?key=demo&ids[]=1758

Get information of a single card or multiple cards by multiverseid:
GET http://api.cardsearch.nl/v1/cards?key=demo&mids[]=1758

Get information of a single card or multiple cards by modified date:
GET http://api.cardsearch.nl/v1/cards?key=demo&since=yesterday

Sets Get all sets on cardsearch

(max 500 requests per day)
Get all sets:
- SID is the internal set-id.
- Both code and alt_code will always work.

GET http://api.cardsearch.nl/v1/sets?key=demo

Prices General price information per card

(max 100 requests per day)
Get general price of a single card:
GET http://api.cardsearch.nl/v1/prices?key=demo&names[]=Terror

Get general price of a single card of a specific set:
GET http://api.cardsearch.nl/v1/prices?key=demo&names[]=Terror@6ED

Get general price of multiple cards:
GET http://api.cardsearch.nl/v1/prices?key=demo&names[]=Terror&names[]=Disintegrate@5ED

Get general price of a single card or multiple cards by id:
GET http://api.cardsearch.nl/v1/prices?key=demo&ids[]=1758

Get general price of a single card or multiple cards by multiverseid:
GET http://api.cardsearch.nl/v1/prices?key=demo&mids[]=1758

Rarities Get rarities used on cardsearch

(max 1000 requests per day)
Get rarities used on cardsearch:
GET http://api.cardsearch.nl/v1/rarities?key=demo

Colors Get colors used on cardsearch

(max 1000 requests per day)
Get colors used on cardsearch:
GET http://api.cardsearch.nl/v1/colors?key=demo

POST - update information

Prices Post price information to cardsearch

(max 200 requests per day)
Post new price & quantity of cards.
- Prices need to be with dots, not comma's.
- Foilprice, foilquantity, link, condition and language are optional.
- You can only post cards in CSV or XML format for now.
- For the correct use of setcodes, please use the api for sets.

CSV
POST http://api.cardsearch.nl/v1/prices
VAR key=demo
VAR format=csv
VAR data="Terror";"10E";"0.25";"15";"2.00";"1";
"Disintegrate";"5ED";"0.20";"11";"NM";"EN"
csv format: "Name";"Set";"Price";"Quantity";"Foilprice";"Foilquantity","Link","Condition","Language"

XML
POST http://api.cardsearch.nl/v1/prices
VAR key=demo
VAR format=xml
VAR data=<?xml version="1.0"?> <xml><card><name>Terror</name><set>10E</set><price>0.25</price><quantity>15</quantity><foilprice>2.00</foilprice><foilquantity>1</foilquantity></card><card><name>Disintegrate</name><set>5ED</set><price>0.20</price><quantity>11</quantity><condition>NM</condition><language>EN</language></card></xml>

Questions?

Need to know more? Contact me by clicking here.