NAV

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

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.