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