Find merchants

Back to top

1. Merchant API

You can use this to find a list of available merchants.

Request URL

http://api.popshops.com/v2/brgymtenmw5ea9unauesmh9nz/merchants.xml

Sample requests

Find all merchants available:
http://api.popshops.com/v2/brgymtenmw5ea9unauesmh9nz/merchants.xml

Find merchants in current catalog:
http://api.popshops.com/v2/brgymtenmw5ea9unauesmh9nz/merchants.xml?catalog_key=48qsligejm5qng6cv5waprcoq48qsligejm5qng6cv5waprcoq

Find merchants belonging to "Appliances" merchant type:
http://api.popshops.com/v2/brgymtenmw5ea9unauesmh9nz/merchants.xml?merchant_type_id=12

Optional request parameters

Field	Value	Description
catalog_key	string	You can limit the list of merchants to your active catalog by passing in its catalog_key
merchant_type_id	integer	You can limit the list of merchants to a specific merchant_type by passing in a valid merchant_type_id
merchant_id	integer	You can limit the list of merchants to a specific merchant by passing in a valid merchant_id

Response fields

Field	Description
merchants	Contains all of the query responses. Attributes: total_count: the total count of merchants available merchant_type_id: any merchant_type_id parameter that was passed in catalog_key: any catalog_key parameter that was passed in
merchant	Contains individual merchants. Attributes: id: Unique id for the merchant that can be used as a parameter value in product queries. name: The name of the merchant network_id: Unique id of the affiliate network the merchant is with. logo_url: URL for a merchant logo url: Landing page redirect url

Back to top

2. Merchant Types

You can use this to find a list of all available merchant types. A merchant type is used to categorize a merchant. You can use a merchant_type id to further filter product/deal queries.

Request URL

http://api.popshops.com/v2/brgymtenmw5ea9unauesmh9nz/merchant_types.xml

Request parameters

None

Response fields

Field	Description
merchant_types	Contains all of the query responses. Attributes: total_count: the total count of merchant types available
merchant_type	Contains individual merchant types. Attributes: id: Unique id for the merchant type that can be used as a parameter value in queries. name: The name of the deal type merchant_count: The total count of merchants available for this specific merchant type