REST API Reference

API Endpoint:

http://api.precisetarget.com/v1

The PreciseTarget API was designed to surface customized online retail stores and products created by PreciseTarget's deal engine to end users.
The API uses HTTP methods and is organized with a RESTful endpoint structure. Requests are formatted in JSON,
and the API returns JSON-encoded objects for all routes, including errors.

Authentication

To authenticate, pass an api-key header with each request using the -H option:

The PreciseTarget API uses API keys to authenticate all requests. Users can request PreciseTarget API keys by contacting an administrator.

The API expects the API key to be included in all requests to the server, using an api-key header. Any unauthenticated requests will return an HTTP 400 response.

Rate Limiting

Users can make up to 300 requests per minute to each API. Check the HTTP headers of any API request to see your current rate limit status. If you think you will need a higher rate limit, feel free to contact us.

Versioning

All PreciseTarget APIs operate under Version 1.0. Versioning is included in the endpoint path.
Debugging and minor feature improvements to an endpoint may be made without a change to the version number,
and would not be reflected in the endpoint's path.

Error Codes

The PreciseTarget API uses the following error codes:

Error Code

Meaning

400

Bad Request / Invalid API Key

404

Not Found

500

Internal Server Error

Store-Pages API

PreciseTarget offers a variety of cultivated online retail stores, created using different combinations of retailers and brands, called store-pages. Store-pages allow customers to easily find and purchase retail products that are on sale.

The Store-Pages API allows users to access the PreciseTarget store-pages. The Store-Pages API is currently under limited release.

The Store-Pages API Recommendations route allows access to targeted store-page filters and products using PreciseTarget's proprietary recommendation engine. The route returns filters for the selected store-page, along with up to five products from within those recommended filters. Requests must include an MD5-hashed email address, publisher name, and store-page name.

The targeted product and store-page recommendations span a wide variety of retailers, and are generated by processing an incoming hashed email and retailer name through PreciseTarget's proprietary targeting engine.

HTTP Request

GET http://api.precisetarget.com/v1/store-pages/{publisher-name}/{store-name}/recommendations/{email-hash}