Introduction

Welcome to the Pricenometry API documentation! We provide real time data to our customers. Through our system, you will be able to receive daily updates on any price changes or product promotions for your product, a competitor’s product or a product you are interested in as a consumer across hundreds of websites. Our entire system is automated so there is no waiting or combing through raw data to find the pricing information you need. We’ve scaled our technology to provide you with up to the minute real time intelligence as well as trends and forecasts that you can use from real daily available data, not guess work. We will change the way you research product pricing.

The API is RESTful and enables gathering pricing data on Pricenometry.com and it’s properties. The API also allows you to check the status of a product and map your pricing data to our database as well as retrieve all your pricing data within our system.

Sample code is currently available as cURL in the menu to the right. Requests and responses are all in JSON.

The API base url is: https://api.pricenometry.com/v1/

The API is versioned, the current version is 1. This is designated in the url path with /v1

If you have any question please visit our support pages.

Authentication

To set authorization, use this code:

# With shell, you can just pass the correct header with each request
curl http://api.pricenometry.com
  -H "Authorization: Token token=YOUR-ACCESS-TOKEN"

Make sure to replace YOUR-ACCESS-TOKEN with your API access key.

We use API keys to allow access to the API. You can get an account by contacting us.

The API expects for the API key to be included in all API requests to the server. The API key can be passed either as a parameter like the following:

access_token=YOUR-ACCESS-TOKEN

Or in a header that looks like the following:

Authorization: Token token=YOUR-ACCESS-TOKEN

Product Data Types

Sample JSON Payload:

{
  "response": {
    "status": 200
  },
  "result": {
    "id": 9071056,
    "container": "bestbuy-offers",
    "name": "Google - Chromecast - Black",
    "social": {
      "facebook_shares": 81,
      "google_shares": 110,
      "twitter_shares": 3,
      "pinterest_shares": 1
    },
    "price": {
      "priceCurrency": "USD",
      "price": 35,
      "original_price": 35,
      "instant_rebate_price": 10.01
    },
    "url": "http://www.bestbuy.com/site/google-chromecast-black/9071056.p?id=1219013308425&skuId=9071056",
    "date": "2016-02-24",
    "open_graph": true,
    "type": "Offer",
    "description": "Google Chromecast: Easily stream your favorite apps and media to your TV via Wi-Fi with Chromecast. Use the included USB cable to plug the Chromecast into your TV, and control streaming content using your compatible smartphone, tablet or computer.",
    "image": "http://pisces.bbystatic.com/image2/BestBuy_US/images/products/9071/9071056_sa.jpg;canvasHeight=210;canvasWidth=210",
    "site_name": "Best buy",
    "schema_org": true,
    "tags": [
      "GOOGLE",
      "Chromecast",
      "H2G2-42",
      "Wireless",
      "Multimedia",
      "Networking"
    ],
    "categories": [
      "TV & Home Theater",
      "TV & Home Theater Accessories",
      "Home Theater Networking"
    ],
    "availability": "InStock",
    "itemCondition": "NewCondition",
    "model": "H2G2-42",
    "sku": 9071056
  }
}

Pricing data is made up of different pieces of data. These are the excepted base record data for a product. These should be sent in the JSON payload. These are all optional except where requests require a particular parameter. You may also add in any data that is not included specifically here, label the data type appropriatly, we will accept any data you would like to send.

Data Types

Data Type	Description
url	Unique URL for product
date	When data was last gathered
id	Unique ID for product
tags	Tags associated with product
name	Unique name of product
description	Given description for product
type	Product Type
image	Unique product image
sku	Unique product sku
mpn	Unique product manufacturer part number
model	Unique product model number
screenshot	Screenshot taken at the time data was collected
price	Price of product at time of sale
original_price	Original retail price of the product
facebook_shares	Number of times product has been shared on Facebook
google_shares	Number of times product has been shared on Google Plus
twitter_shares	Number of times product has been shared on Twitter
reddit_shares	Number of times product has been shared on Reddit
linkedin_shares	Number of times product has been shared on LinkedIn
pinterest_shares	Number of times product has been shared on Pinterest
stumbleupon_shares	Number of times product has been shared on StumbleUpon

API V1

Get Status

Request example

curl "http://api.pricenometry.com/v1"
  -H "Authorization: Token token=YOUR-ACCESS-TOKEN"

The above command returns JSON structured like this:

{
  "response": {
    "status": 200
  },
  "status": {
    "active": true,
    "api_last_used": "2015-03-04",
    "available": {
      "amazon-offers": "15.7M",
      "walmart-offers": "11.2M",
      "bestbuy-offers": "919.4K",
      "target-offers": "581.4K",
      "costco-offers": "10.9K",
      "boxed-offers": "896"
    },
    "indexing": "10K",
    "processing": "11.3M",
    "pending": "1.5B"
  }
}

Check the status of your current api usage as well as available data sources to pull from. Default response is JSON, also available in XML using a *.xml extension.

HTTP Request

GET http://api.pricenometry.com/v1

Query Parameters

Parameter	Required	Description
access_token	true	Access token used to authenticate

Status Types

Status Type	Description
active	Api Key is still active
api_usage_cap	Max number of allowed api calls per day (can be unlimited)
api_last_used	Date of the last call your key made to our api
api_daily_usage	Total number of api calls made on api_last_used date
available	Name and total number of data containers available for you to research
indexing	Collected data being added to search
processing	Data still waiting to be processed
pending	Data still waiting to be added to processing

Search Products

Request example

curl "http://api.pricenometry.com/v1/amazon-offers/search/chromecast"
  -H "Authorization: Token token=YOUR-ACCESS-TOKEN"

The above command returns JSON structured like this:

{
  "response": {
    "status": 200
  },
  "results": [
    {
      "id": "B00DR0PDNE",
      "name": "Google Chromecast HDMI Streaming Media Player",
      "container": "amazon-offers"
    }
  ]
}

Search Products based on a query or key word. Default response is JSON, also available in XML using a *.xml extension.

HTTP Request

GET http://api.pricenometry.com/v1/:CONTAINER/search/:QUERY

Query Parameters

Parameter	Required	Description
access_token	true	Access token used to authenticate
:CONTAINER	true	The available container you are searching in
:QUERY	true	What you are searching for
results	false	Number of Results you want back (default: 10)
fetch	false	Automatically crawl new data (default: true)
social	false	Automatically fetch new social data (default: false)

Match Products

Request example

curl "http://api.pricenometry.com/v1/walmart-offers/match?model=86002596-01"
  -H "Authorization: Token token=YOUR-ACCESS-TOKEN"

The above command returns JSON structured like this:

{
  "response": {
    "status": 200
  },
  "results": [
    {
      "id": "811571013579",
      "container": "walmart-offers",
      "name": "Google Chromecast HDMI Streaming Media Player",
      "social": {
        "facebook_shares": 42,
        "google_shares": 47,
        "twitter_shares": 12,
        "pinterest_shares": 10,
        "stumbleupon_shares": 1
      },
      "price": {
        "priceCurrency": "USD",
        "price": "30.07",
        "original_price": 35
      },
      "url": "http://www.walmart.com/ip/Google-Chromecast-HDMI-Streaming-Media-Player/33142918",
      "date": "2015-02-24",
      "open_graph": true,
      "type": "Offer",
      "image": "http://i5.walmartimages.com/dfw/dce07b8c-cc82/k2-_6f892d53-39df-4687-adae-fd16b2656547.v4.jpg",
      "site_name": "Walmart.com",
      "schema_org": true,
      "tags": [
        "Google",
        "Chromecast",
        "HDMI",
        "Streaming",
        "Media",
        "Player",
        "Wal-mart",
        "Walmart.com"
      ],
      "productID": "811571013579",
      "screenshot": "811571013579/2015-02-23.jpg",
      "availability": "InStock",
      "title": "Media Streaming Players",
      "sku": "811571013579",
      "mpn": "86002596-01",
      "brand": "Google",
      "model": "86002596-01"
    }
  ]
}

Match Products in a container based on a specific set of known parameters and values. Default response is JSON, also available in XML using a *.xml extension.

HTTP Request

GET http://api.pricenometry.com/v1/:CONTAINER/match

Query Parameters

Parameter	Required	Description
access_token	true	Access token used to authenticate
:CONTAINER	true	The available container you are searching in
:QUERY	true	What you are searching for
results	false	Number of Results you want back (default: 10)
fetch	false	Automatically crawl new data (default: true)
social	false	Automatically fetch new social data (default: false)
url	false	Unique URL for product
date	false	When data was last gathered
id	false	Unique ID for product
tags	false	Tags associated with product
name	false	Unique name of product
description	false	Given description for product
type	false	Product Type
image	false	Unique product image
sku	false	Unique product sku
mpn	false	Unique product manufacturer part number
model	false	Unique product model number
price	false	Price of product at time of sale
original_price	false	Original retail price of the product
facebook_shares	false	Number of times product has been shared on Facebook
google_shares	false	Number of times product has been shared on Google Plus
twitter_shares	false	Number of times product has been shared on Twitter
reddit_shares	false	Number of times product has been shared on Reddit
linkedin_shares	false	Number of times product has been shared on LinkedIn
pinterest_shares	false	Number of times product has been shared on Pinterest
stumbleupon_shares	false	Number of times product has been shared on StumbleUpon
total_shares	false	Number of times product has been shared on Social Media

Request example

curl "http://api.pricenometry.com/v1/amazon-offers/trends/price"
  -H "Authorization: Token token=YOUR-ACCESS-TOKEN"

The above command returns JSON structured like this:

{
  "response": {
    "status": 200
  },
  "results": [
    {
      "id": "B011390PHY",
      "container": "amazon-offers",
      "price": {
        "price": 850000
      },
      "availability": "Only 1 left in stock.",
      "name": "FREAKS 1932 * TOD BROWNING * COMPLETE LOBBY CARD SET * MINT * SUPER RARE!!",
      "url": "http://www.amazon.com/FREAKS-BROWNING-COMPLETE-LOBBY-SUPER/dp/B011390PHY?tag=pricelscom-20"
    },
    {
      "id": "B00EN5R088",
      "container": "amazon-offers",
      "price": {
        "instant_rebate_price": 43838.9,
        "original_price": 219194.48,
        "price": 175355.58
      },
      "name": "1139461 Trimode 9/6/4Monitors Expanded Ea Soma Technology -GEOEC9600",
      "url": "http://www.amazon.com/4Monitors-Expanded-Soma-Technology-GEOEC9600/dp/B00EN5R088?tag=pricelscom-20"
    }
  ]
}

Trending Products in a container based on a specific set of known parameters and values. Default response is JSON, also available in XML using a *.xml extension.

HTTP Request

GET http://api.pricenometry.com/v1/:CONTAINER/trends/:TYPE

Query Parameters

Parameter	Required	Description
access_token	true	Access token used to authenticate
:CONTAINER	true	The available container you are searching in
:TYPE	true	The Trend Type you want to retrieve (example: price, facebook_shares, etc)
results	false	Number of Results you want back (default: 10)
fetch	false	Automatically crawl new data (default: true)
social	false	Automatically fetch new social data (default: false)

Get Product

Request example

curl "http://api.pricenometry.com/v1/bestbuy-offers/9071056"
  -H "Authorization: Token token=YOUR-ACCESS-TOKEN"

The above command returns JSON structured like this:

{
  "response": {
    "status": 200
  },
  "result": {
    "id": 9071056,
    "container": "bestbuy-offers",
    "name": "Google - Chromecast - Black",
    "social": {
      "facebook_shares": 81,
      "google_shares": 110,
      "twitter_shares": 3,
      "pinterest_shares": 1
    },
    "price": {
      "priceCurrency": "USD",
      "price": 35,
      "original_price": 35,
      "instant_rebate_price": 10.01
    },
    "url": "http://www.bestbuy.com/site/google-chromecast-black/9071056.p?id=1219013308425&skuId=9071056",
    "date": "2016-02-24",
    "open_graph": true,
    "type": "Offer",
    "description": "Google Chromecast: Easily stream your favorite apps and media to your TV via Wi-Fi with Chromecast. Use the included USB cable to plug the Chromecast into your TV, and control streaming content using your compatible smartphone, tablet or computer.",
    "image": "http://pisces.bbystatic.com/image2/BestBuy_US/images/products/9071/9071056_sa.jpg;canvasHeight=210;canvasWidth=210",
    "site_name": "Best buy",
    "schema_org": true,
    "tags": [
      "GOOGLE",
      "Chromecast",
      "H2G2-42",
      "Wireless",
      "Multimedia",
      "Networking"
    ],
    "categories": [
      "TV & Home Theater",
      "TV & Home Theater Accessories",
      "Home Theater Networking"
    ],
    "availability": "InStock",
    "itemCondition": "NewCondition",
    "model": "H2G2-42",
    "sku": 9071056
  }
}

Get most up to date Product information by Product id. Default response is JSON, also available in XML using a *.xml extension.

HTTP Request

GET http://api.pricenometry.com/v1/:CONTAINER/:ID

Query Parameters

Parameter	Required	Description
access_token	true	Access token used to authenticate
:CONTAINER	true	The available container
:ID	true	Product ID
fetch	false	Automatically crawl new data (default: true)
social	false	Automatically fetch new social data (default: false)

Get Product History

Request example

curl "http://api.pricenometry.com/v1/bestbuy-offers/9071056/history"
  -H "Authorization: Token token=YOUR-ACCESS-TOKEN"

The above command returns JSON structured like this:

{
  "response": {
    "status": 200
  },
  "result": {
    "id": "9071056",
    "container": "bestbuy-offers",
    "name": "Google - Chromecast - Black",
    "history": {
      "price": {
        "2015-07-26": 29.99,
        "2015-08-02": 35.00,
        "2015-08-16": 29.99,
        "2015-09-27": 27.99,
        "2015-11-01": 29.99,
        "2015-11-15": 24.99,
        "2016-02-21": 35.00
      },
      "facebook_shares": {
        "2015-09-13": 39,
        "2015-09-27": 43,
        "2015-10-04": 54,
        "2015-10-11": 64,
        "2015-11-01": 73,
        "2015-11-08": 74,
        "2015-11-22": 79,
        "2016-02-21": 81
      },
      "google_shares": {
        "2015-07-26": 105,
        "2015-08-02": 107,
        "2015-08-09": 106,
        "2015-08-30": 107,
        "2015-11-08": 108,
        "2015-11-15": 105,
        "2016-02-21": 110
      },
      "total_shares": {
        "2015-07-26": 105,
        "2015-08-02": 108,
        "2015-08-09": 107,
        "2015-08-30": 109,
        "2015-09-27": 110,
        "2015-10-04": 111,
        "2015-10-11": 153,
        "2015-11-01": 162,
        "2016-02-14": 164,
        "2016-02-21": 169
      },
      "twitter_shares": {
        "2015-08-02": 1,
        "2015-08-09": 2,
        "2015-09-13": 3
      }
    }
  }
}

Get most up to date Product history by Product id.

HTTP Request

GET http://api.pricenometry.com/v1/:CONTAINER/:ID/history

Query Parameters

Parameter	Required	Description
access_token	true	Access token used to authenticate
:CONTAINER	true	The available container
:ID	true	Product ID
fetch	false	Automatically crawl new data (default: true)
social	false	Automatically fetch new social data (default: false)

Get Product News

Request example

curl "http://api.pricenometry.com/v1/bestbuy-offers/9071056/news"
  -H "Authorization: Token token=YOUR-ACCESS-TOKEN"

The above command returns JSON structured like this:

{
  "response": {
    "status": 200
  },
  "result": {
    "id": "9071056",
    "container": "bestbuy-offers",
    "name": "Google - Chromecast - Black",
    "news": [
      {
        "title": "Black Friday Streaming Devices: Best Deals for Chromecast, Roku, Apple TV and More",
        "description": "Black Friday is nearly upon us, and this year, consumers around the country are once again looking for devices that help them to stream their favorite shows and movies from services like Netflix, Hulu and HBO Now. Whether it's to take a first step ...",
        "image": "http://t3.gstatic.com/images?q=tbn:ANd9GcQgA_iqMsC1sh9Ty4Tii4Qvt8OIhLLIx9MM1vOFdFzoF-Q9Lb3N2S7N1KI",
        "url": "http://variety.com/2015/digital/news/black-friday-roku-chromecast-appletv-firetv-deals-1201647930/",
        "publisher": "Variety",
        "published": "2015-11-25",
        "language": "en",
        "related": [
          {
            "title": "The Best Black Friday Deals on Streaming Devices",
            "url": "http://www.pcmag.com/article2/0,2817,2495664,00.asp",
            "publisher": "PC Magazine",
            "published": "2015-11-25",
            "language": "en"
          },
          {
            "title": "Black Friday guide to streaming media players: the best deals on Apple TV ...",
            "url": "http://qz.com/559344/black-friday-guide-to-streaming-media-players-the-best-deals-on-apple-tv-chromecast-fire-tv-and-roku/",
            "publisher": "Quartz",
            "published": "2015-11-26",
            "language": "en"
          }
        ]
      },
      {
        "title": "Buy Two Google Chromecast in Best Buy Black Friday Sale for $50",
        "description": "The Best Buy Black Friday 2015 Ad was already packed with deals in the initial release. Today Best Buy packed on another 300 Black Friday deals, almost doubling their Black Friday ad. A deal that jumped out already before the new 300 deals is a deal on ...",
        "image": "http://t2.gstatic.com/images?q=tbn:ANd9GcQ5rrhrzMghDz5Ar2p_uJltsNQxJDg0IASUItlHiQMrv3PnMZra9_Cnslg",
        "url": "http://www.i4u.com/2015/11/97969/buy-two-google-chromecast-best-buy-black-friday-sale-50",
        "publisher": "I4U News",
        "published": "2015-11-16",
        "language": "en",
        "related": []
      }
    ]
  }
}

Get most up to date Product News by Product id.

HTTP Request

GET http://api.pricenometry.com/v1/:CONTAINER/:ID/news

Query Parameters

Parameter	Required	Description
access_token	true	Access token used to authenticate
:CONTAINER	true	The available container
:ID	true	Product ID

Get Product Videos

Request example

curl "http://api.pricenometry.com/v1/bestbuy-offers/9071056/videos"
  -H "Authorization: Token token=YOUR-ACCESS-TOKEN"

The above command returns JSON structured like this:

{
  "response": {
    "status": 200
  },
  "result": {
    "id": "9071056",
    "container": "bestbuy-offers",
    "name": "Google - Chromecast - Black",
    "videos": [
      {
        "title": "Google Chromecast HDMI Streaming Media Player ...",
        "description": "http://www.shorti.me/Black-Friday-Deals ◅ check the best deals Google  Chromecast HDMI ...",
        "image": "https://img.youtube.com/vi/OIVcP780JV4/default.jpg?h=90&w=120&sigh=__bm2WSBbFoR43kQp58pd7Miz3sdU=",
        "url": "https://www.youtube.com/watch?v=OIVcP780JV4",
        "length": "1 minute",
        "published": "2015-04-23"
      }
    ]
  }
}

Get most up to date Product Videos by Product id.

HTTP Request

GET http://api.pricenometry.com/v1/:CONTAINER/:ID/videos

Query Parameters

Parameter	Required	Description
access_token	true	Access token used to authenticate
:CONTAINER	true	The available container
:ID	true	Product ID

Get Product References

Request example

curl "http://api.pricenometry.com/v1/bestbuy-offers/9071056/references"
  -H "Authorization: Token token=YOUR-ACCESS-TOKEN"

The above command returns JSON structured like this:

{
  "response": {
    "status": 200
  },
  "result": {
    "id": "9071056",
    "container": "bestbuy-offers",
    "name": "Google - Chromecast - Black",
    "references": [
      {
        "title": "Unlock the Power of Your Chromecast",
        "description": "by Aaron Halbert ISBN: ISBN1494976765",
        "image": null,
        "url": "http://books.google.com/books?id=NyQ_ngEACAAJ&dq=Google+-+Chromecast+-+Black&client=internal-uds&num=8&cd=1&source=uds",
        "length": "44 pages",
        "published": "2013"
      }
    ]
  }
}

Get most up to date Product Books or other Reference manuals by Product id.

HTTP Request

GET http://api.pricenometry.com/v1/:CONTAINER/:ID/references

Query Parameters

Parameter	Required	Description
access_token	true	Access token used to authenticate
:CONTAINER	true	The available container
:ID	true	Product ID

Get Product Links

Request example

curl "http://api.pricenometry.com/v1/bestbuy-offers/9071056/links"
  -H "Authorization: Token token=YOUR-ACCESS-TOKEN"

The above command returns JSON structured like this:

{
  "response": {
    "status": 200
  },
  "result": {
    "id": "9071056",
    "container": "bestbuy-offers",
    "name": "Google - Chromecast - Black",
    "links": [
      {
        "title": "Google Chromecast (2015) review - CNET",
        "description": "Oct 3, 2015 ... The innovative Chromecast might be the ultimate living-room accessory for your \nphone or tablet, but more ... Google Chromecast 2015 (Black).",
        "url": "http://www.cnet.com/products/google-chromecast-2015/"
      }
    ]
  }
}

Get most up to date Product Links by Product id.

HTTP Request

GET http://api.pricenometry.com/v1/:CONTAINER/:ID/links

Query Parameters

Parameter	Required	Description
access_token	true	Access token used to authenticate
:CONTAINER	true	The available container
:ID	true	Product ID

Get Product Screenshot Image

Request example

curl "http://api.pricenometry.com/v1/amazon-offers/B00DR0PDNE/2015-02-24.jpg"
  -H "Authorization: Token token=YOUR-ACCESS-TOKEN"

The above command redirects to a URL like the one below:

  <html>
    <body>
    You are being
    <a href="https://amazon-screenshots.pricenometry.com/B00DR0PDNE/2015-02-24.jpg?AWSAccessKeyId=AUTO-GENERATED&Signature=AUTO-GENERATED&Expires=24-HOURS">redirected</a>.
    </body>
  </html>

Get Product redirect to screenshot image.

HTTP Request

GET http://api.pricenometry.com/v1/:CONTAINER/:ID/:SCREENSHOT_DATE.jpg

Query Parameters

Parameter	Required	Description
access_token	true	Access token used to authenticate
:CONTAINER	true	The available container
:ID	true	Product ID
:SCREENSHOT_DATE	true	Date screenshot was captured

Get Product Screenshot

Request example

curl "http://api.pricenometry.com/v1/amazon-offers/B00DR0PDNE/2015-02-24"
  -H "Authorization: Token token=YOUR-ACCESS-TOKEN"

The above command returns JSON structured like this:

{
  "response": {
    "status": 200
  },
  "id": "B00DR0PDNE",
  "redirect_url": "https://amazon-screenshots.pricenometry.com/B00DR0PDNE/2015-02-24.jpg?AWSAccessKeyId=AUTO-GENERATED&Signature=AUTO-GENERATED&Expires=24-HOURS"
}

Get Product screenshot data. Default response is JSON, also available in XML using a *.xml extension.

HTTP Request

GET http://api.pricenometry.com/v1/:CONTAINER/:ID/:SCREENSHOT_DATE

Query Parameters

Parameter	Required	Description
access_token	true	Access token used to authenticate
:CONTAINER	true	The available container
:ID	true	Product ID
:SCREENSHOT_DATE	true	Date screenshot was captured

Search All Products

Request example

curl "http://api.pricenometry.com/v1/search/chromecast"
  -H "Authorization: Token token=YOUR-ACCESS-TOKEN"

The above command returns JSON structured like this:

{
  "response": {
    "status": 200
  },
  "results": [
    {
      "id": "B00DR0PDNE",
      "name": "Google Chromecast HDMI Streaming Media Player",
      "container": "amazon-offers"
    },
    {
      "id": "811571013579",
      "name": "Google Chromecast HDMI Streaming Media Player",
      "container": "walmart-offers"
    },
    {
      "name": "Google Chromecast HDMI Streaming Media Player",
      "id": "15460778",
      "container": "target-offers"
    },
    {
      "id": "945132",
      "name": "Google Chromecast HDMI Streaming Media Player with $10 Google Play Credit",
      "container": "costco-offers"
    }
  ]
}

Search all availble Products based on a query or key word. Default response is JSON, also available in XML using a *.xml extension.

HTTP Request

GET http://api.pricenometry.com/v1/search/:QUERY

Query Parameters

Parameter	Required	Description
access_token	true	Access token used to authenticate
:QUERY	true	What you are searching for

Match All Products

Request example

curl "http://api.pricenometry.com/v1/match?name=chromecast"
  -H "Authorization: Token token=YOUR-ACCESS-TOKEN"

The above command returns JSON structured like this:

{
  "response": {
    "status": 200
  },
  "results": [
    {
      "id": "B00DR0PDNE",
      "name": "Google Chromecast HDMI Streaming Media Player",
      "container": "amazon-offers"
    },
    {
      "id": "811571013579",
      "name": "Google Chromecast HDMI Streaming Media Player",
      "container": "walmart-offers"
    },
    {
      "name": "Google Chromecast HDMI Streaming Media Player",
      "id": "15460778",
      "container": "target-offers"
    },
    {
      "id": "945132",
      "name": "Google Chromecast HDMI Streaming Media Player with $10 Google Play Credit",
      "container": "costco-offers"
    }
  ]
}

Match all Products based on a specific set of known parameters and values. Default response is JSON, also available in XML using a *.xml extension.

HTTP Request

GET http://api.pricenometry.com/v1/match

Query Parameters

Parameter	Required	Description
access_token	true	Access token used to authenticate
results	false	Number of Results you want back (default: 10)
fetch	false	Automatically crawl new data (default: true)
social	false	Automatically fetch new social data (default: false)
url	false	Unique URL for product
date	false	When data was last gathered
id	false	Unique ID for product
tags	false	Tags associated with product
name	false	Unique name of product
description	false	Given description for product
type	false	Product Type
image	false	Unique product image
sku	false	Unique product sku
mpn	false	Unique product manufacturer part number
model	false	Unique product model number
price	false	Price of product at time of sale
original_price	false	Original retail price of the product
facebook_shares	false	Number of times product has been shared on Facebook
google_shares	false	Number of times product has been shared on Google Plus
twitter_shares	false	Number of times product has been shared on Twitter
reddit_shares	false	Number of times product has been shared on Reddit
linkedin_shares	false	Number of times product has been shared on LinkedIn
pinterest_shares	false	Number of times product has been shared on Pinterest
stumbleupon_shares	false	Number of times product has been shared on StumbleUpon
total_shares	false	Number of times product has been shared on Social Media

Request example

curl "http://api.pricenometry.com/v1/trends/price"
  -H "Authorization: Token token=YOUR-ACCESS-TOKEN"

The above command returns JSON structured like this:

{
  "response": {
    "status": 200
  },
  "results": [
    {
      "id": "B011390PHY",
      "container": "amazon-offers",
      "price": {
        "price": 850000
      },
      "availability": "Only 1 left in stock.",
      "name": "FREAKS 1932 * TOD BROWNING * COMPLETE LOBBY CARD SET * MINT * SUPER RARE!!",
      "url": "http://www.amazon.com/FREAKS-BROWNING-COMPLETE-LOBBY-SUPER/dp/B011390PHY?tag=pricelscom-20"
    },
    {
      "id": "36144922",
      "container": "walmart-offers",
      "price": {
        "maximum_price": 418348.46,
        "minimum_price": 19.99,
        "price": 202462.33,
        "priceCurrency": "USD"
      },
      "availability": "Out of stock",
      "name": "Surya Intersecting Lines Polyester Throw Pillow",
      "url": "http://www.walmart.com/ip/Surya-Intersecting-Lines-Pillow/36144922"
    }
  ]
}

Trending Products in a container based on a specific set of known parameters and values. Default response is JSON, also available in XML using a *.xml extension.

HTTP Request

GET http://api.pricenometry.com/v1/trends/:TYPE

Query Parameters

Parameter	Required	Description
access_token	true	Access token used to authenticate
:TYPE	true	The Trend Type you want to retrieve (example: price, facebook_shares, etc)
results	false	Number of Results you want back (default: 10)
fetch	false	Automatically crawl new data (default: true)
social	false	Automatically fetch new social data (default: false)

Batch Products

Request example

curl "https://api.pricenometry.com/v1/batch"
  -H "Authorization: Token token=YOUR-ACCESS-TOKEN"
  -H "Content-Type: application/json"
  -X POST -d '{"amazon-offers": ["B00DR0PDNE"], "walmart-offers": ["811571013579"]}'

The above command returns JSON structured like this:

{
  "response": {
    "status": 200
  },
  "results": [
    {
      "id": "B00DR0PDNE",
      "name": "Google Chromecast HDMI Streaming Media Player",
      "container": "amazon-offers"
    },
    {
      "id": "811571013579",
      "name": "Google Chromecast HDMI Streaming Media Player",
      "container": "walmart-offers"
    }
  ]
}

Batch Products from any container based on a specific set of known ID’s from each seperate container, maximum of 50 ID’s total per request. Default response is JSON.

HTTP Request

POST https://api.pricenometry.com/v1/batch

Query Parameters

Parameter	Required	Description
access_token	true	Access token used to authenticate.

Changelog

Changes to the API and documentation are below.

Date	Changes
2/28/2016	Added additional end points
2/17/2015	Initial docs + code samples written

Errors

This API uses the following error codes:

Error Code	Meaning
401	Unauthorized – Your API key is wrong or not provided
403	Forbidden – The API key does not have access to the requested action or your subscription has elapsed.
404	Not Found –- The requested action does not exist.
408	Request Timeout –- The request took too long to complete on our side. Please reduce the amount of information you are requesting, or try again later.
429	Too Many Requests – You have exceeded your provisioned rate limit. If this becomes a regular occurrence, please contact us to have your rate limit increased.
500	Internal Server Error – We had a problem with our server. Try again later.
503	Service Unavailable – We’re temporarially offline for maintanance. Please try again later.

Terms and Conditions

By using this API, you agree to the terms and conditions set forth at pricenometry.com.

Introduction

Authentication

Product Data Types

Data Types

API V1

Get Status

HTTP Request

Query Parameters

Status Types

Search Products

HTTP Request

Query Parameters

Match Products

HTTP Request

Query Parameters

Trending Products

HTTP Request

Query Parameters

Get Product

HTTP Request

Query Parameters

Get Product History

HTTP Request

Query Parameters

Get Product News

HTTP Request

Query Parameters

Get Product Videos

HTTP Request

Query Parameters

Get Product References

HTTP Request

Query Parameters

Get Product Links

HTTP Request

Query Parameters

Get Product Screenshot Image

HTTP Request

Query Parameters

Get Product Screenshot

HTTP Request

Query Parameters

Search All Products

HTTP Request

Query Parameters

Match All Products

HTTP Request

Query Parameters

All Trending Products

HTTP Request

Query Parameters

Batch Products

HTTP Request

Query Parameters

Changelog

Errors

Terms and Conditions