Tiendamia APItiendamia.com ↗
Access Tiendamia product listings, pricing, best sellers, outlet deals, and weekly promotions across multiple Latin American countries via 6 endpoints.
What is the Tiendamia API?
The Tiendamia API provides 6 endpoints for querying product listings, pricing, and promotions from Tiendamia's multi-country marketplace. The search_products endpoint runs full-text queries across vendors including Amazon and eBay, returning paginated product cards with name, brand, price, discount, and image. Products carrying an ASIN can be passed directly into get_product_details for full taxonomy, variant, and currency data.
curl -X GET 'https://api.parse.bot/scraper/2b9395d8-a38c-47d1-afe0-a4270be842fb/search_products?page=1&query=laptop&vendor=amz&country=pe' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace tiendamia-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
from parse_apis.tiendamia_api import Tiendamia, Listing, Product, CountryInfo, Vendor, Country
client = Tiendamia()
# List all supported countries
for country_info in client.countryinfos.list():
print(country_info.code, country_info.name, country_info.domain)
# Search for laptop listings on Amazon in Peru
for listing in client.listings.search(query="laptop", vendor=Vendor.AMAZON, country=Country.PERU):
print(listing.name, listing.price, listing.brand)
# Get best sellers in Argentina
for item in client.listings.best_sellers(country=Country.ARGENTINA):
print(item.name, item.price, item.discount_percentage)
# Fetch full product details by ASIN
product = client.products.get(asin="B08D1116YN")
print(product.name, product.brand, product.price, product.description)
Full-text search over Tiendamia product listings for a given vendor and country. Returns paginated product cards with name, brand, pricing, discount, and image. Pagination via integer page counter. Each product includes a SKU and, for Amazon items, an ASIN suitable for get_product_details.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination. |
| queryrequired | string | Search keyword (e.g. 'laptop', 'samsung'). |
| vendor | string | Vendor ID. |
| country | string | Country code. |
{
"type": "object",
"fields": {
"page": "page number used",
"query": "search keyword echoed back",
"country": "country code used",
"products": "array of Listing objects",
"total_results_text": "string with total result count text from the site, or null"
},
"sample": {
"data": {
"page": "1",
"query": "laptop",
"country": "pe",
"products": [
{
"sku": "MKT-2078943_63EDB264",
"url": "https://tiendamia.com.pe/p/mkt/2078943_63edb264/hp-elitebook-845-g8-14-fhd-laptop-amd-ryzen-5",
"name": "HP Elitebook 845 G8 14\" FHD Laptop AMD Ryzen 5 PRO 5650U 16GB 256GB W11P",
"brand": "HP",
"price": "S/ 1,040.95",
"image_url": "https://resized-images.tiendamia.com/130x160/marketplace_manager_service/production/product_63edb264_mirakl_image_1_large.jpg"
}
],
"total_results_text": "306 resultados enamazon"
},
"status": "success"
}
}About the Tiendamia API
Product Search and Detail
search_products accepts a required query string plus optional vendor, country, and page parameters. Each item in the returned products array is a Listing object with name, brand, pricing, discount, image, and SKU. Amazon results also include an asin field, which is the key input for get_product_details. That endpoint returns a richer payload: canonical url, brand, image, price, currency (e.g. PEN), a categories array reflecting the product's taxonomy, and a variants array where each entry carries sku, label, and available status.
Promotions and Curated Lists
Three endpoints cover curated product collections, each scoped by an optional country parameter. get_best_sellers returns top-selling products for the selected market. get_outlet_deals pulls from Tiendamia's Outlet section. get_weekly_deals returns current weekly promotional listings. All three share the same Listing object shape — name, brand, pricing, discount, and image — making it straightforward to display any of these feeds in a consistent format.
Country Coverage
get_countries returns a static array of CountryInfo objects, each with a code, human-readable name, and domain. Use this endpoint to enumerate valid values for the country parameter accepted by the other endpoints. Tiendamia operates across multiple Latin American markets, so country filtering is meaningful for price and availability comparisons.
The Tiendamia API is a managed, monitored endpoint for tiendamia.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when tiendamia.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official tiendamia.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Compare Amazon product prices across different Latin American country markets using
get_product_detailswith varyingcountryvalues. - Build a deal-alert tool that polls
get_weekly_dealsandget_outlet_dealsto surface discounted items by country. - Populate a product catalog with full variant and category data by chaining
search_products(to get ASINs) withget_product_details. - Aggregate best-seller rankings per market by calling
get_best_sellersfor each country code returned byget_countries. - Track discount depth on search results by extracting the discount field from Listing objects returned by
search_products. - Drive a currency-aware price comparison feature using the
currencyandpricefields fromget_product_detailsacross markets.
| 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 | 100 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 `get_product_details` return beyond what `search_products` provides?+
get_product_details adds fields not present in search results: a categories array showing the product's taxonomy path, a variants array (each with sku, label, and available), a currency code, and the canonical url. Search results give pricing and images but do not include variant or category data.Does the API expose product reviews or seller ratings?+
How does pagination work in `search_products`?+
page parameter to step through results. The response echoes back the page used and includes a total_results_text string (or null) reflecting the site's reported result count. There is no cursor-based pagination — incrementing the integer advances to the next page.Can I filter `search_products` results to a specific vendor like eBay or Amazon?+
vendor parameter accepts a vendor ID to narrow results to a specific vendor. Use get_countries to retrieve valid country codes, and combine both parameters to narrow results to a specific vendor and market. The response then contains only Listing objects matching that vendor-country combination.