tiendamia.com APItiendamia.com ↗
Search products, retrieve best sellers, outlet deals, and weekly promotions from Tiendamia across 5 Latin American countries and multiple vendors.
curl -X GET 'https://api.parse.bot/scraper/2b9395d8-a38c-47d1-afe0-a4270be842fb/search_products?query=laptop&vendor=amz&country=pe' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for products on Tiendamia across Amazon, eBay, or Marketplace vendors. Returns product cards with name, brand, price, discount, and image. Results are paginated and vary by country domain.
| Param | Type | Description |
|---|---|---|
| page | string | Page number for pagination. |
| queryrequired | string | Search keyword (e.g. 'laptop', 'samsung'). |
| vendor | string | Vendor ID: 'amz' for Amazon, 'ebay' for eBay, 'mkt' for Marketplace. |
| country | string | Country code: 'pe' (Peru), 'ar' (Argentina), 'cr' (Costa Rica), 'ec' (Ecuador), 'uy' (Uruguay). |
{
"type": "object",
"fields": {
"page": "page number used",
"query": "search keyword echoed back",
"country": "country code used",
"products": "array of product objects with sku, name, brand, url, image_url, price, original_price, discount_percentage",
"total_results_text": "string with total result count text from the site, or null"
},
"sample": {
"data": {
"page": "1",
"query": "laptop",
"country": "pe",
"products": [
{
"sku": "AMZ-B0947BJ67M",
"url": "https://tiendamia.com.pe/p/amz/b0947bj67m/example-laptop",
"asin": "B0947BJ67M",
"name": "Example Laptop 15.6\"",
"brand": "DELL",
"price": "S/ 2,761.29",
"image_url": "https://m.media-amazon.com/images/I/example.jpg",
"original_price": "S/ 5,384.52",
"discount_percentage": "49"
}
],
"total_results_text": "306 resultados enamazon"
},
"status": "success"
}
}About the tiendamia.com API
The Tiendamia API exposes 6 endpoints covering product search, detailed product data, best sellers, outlet deals, weekly promotions, and supported country listings. The search_products endpoint queries Amazon, eBay, or Marketplace vendors across Peru, Argentina, Costa Rica, Ecuador, and Uruguay, returning per-product fields including SKU, price, original price, discount percentage, brand, and image URL. The get_product_details endpoint adds variant availability, category taxonomy, and local currency codes.
Search and Product Data
The search_products endpoint accepts a required query string plus optional vendor and country filters. The vendor parameter takes amz (Amazon), ebay, or mkt (Marketplace); the country parameter accepts pe, ar, cr, ec, or uy. Results are paginated via a page parameter and return an array of product objects, each carrying sku, name, brand, url, image_url, price, original_price, and discount_percentage. The response also echoes back query, country, and a total_results_text string when the site reports a result count.
Product Details and Variants
get_product_details takes an Amazon ASIN or equivalent SKU and an optional country code. It returns a richer payload: name, brand, image, price, currency (e.g. PEN for Peru), categories as a taxonomy array, and a variants array where each variant object includes sku, label, and an available boolean. This makes it possible to check which specific configurations of a product (color, size, etc.) are currently listed.
Deals and Promotions
Three endpoints cover curated product sets: get_best_sellers, get_outlet_deals, and get_weekly_deals. All three accept the same optional country parameter and return the same product card shape — sku, name, brand, url, image_url, price, original_price, and discount_percentage. None require a search query; they reflect the lists Tiendamia maintains on its best-sellers, outlet, and daily-deals pages respectively.
Country Coverage
get_countries takes no inputs and returns an array of supported country objects, each with code, name, and domain fields. This is useful for dynamically enumerating available markets before constructing requests to the other endpoints rather than hard-coding country codes.
- Track price drops across Peru, Argentina, and Ecuador for a given product ASIN using
get_product_detailswith multiple country codes. - Build a deal-aggregation feed by polling
get_weekly_dealsandget_outlet_dealsdaily and comparingoriginal_pricetoprice. - Monitor Amazon vs. eBay pricing for the same query using the
vendorparameter insearch_products. - Check variant availability (size, color) for a specific product SKU using the
variantsarray fromget_product_details. - Populate a regional best-seller widget by pulling
get_best_sellersfor each supported country code. - Categorize products for a taxonomy-based catalog using the
categoriesfield returned byget_product_details. - Enumerate all supported markets at app startup with
get_countriesto validate user-selected country codes before querying.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Tiendamia have an official developer API?+
What does the `search_products` endpoint return when I don't specify a vendor?+
vendor parameter is omitted, results come from all available vendors. Specifying amz, ebay, or mkt filters results to that vendor only. The response always includes sku, name, brand, price, original_price, discount_percentage, and image_url for each product card, along with total_results_text when available.Does the API cover seller ratings, user reviews, or shipping cost estimates?+
How does pagination work in `search_products`?+
page parameter is an optional string representing the page number. The response echoes back the page value used and includes total_results_text when the source reports a total count — though that field may be null. There is no explicit total_pages field in the response, so you need to parse total_results_text or step through pages until results are empty to determine the full result set size.Is product data from all five countries always available for a given ASIN?+
country code to get_product_details returns data scoped to that market, including the local currency code. If a product is not available in a given market, the response will reflect that. You can fork this API on Parse to add logic that queries multiple countries in sequence and merges results.