Torob APItorob.com ↗
Access Torob's Iran price comparison data: search products, compare seller prices, retrieve specs, price history, and store details via 11 structured endpoints.
What is the Torob API?
The Torob API exposes 11 endpoints covering Iran's largest price comparison platform, letting you search products by keyword or category, compare live seller prices, and pull full technical specifications. The get_price_history endpoint returns date-labeled chart datasets in Persian calendar format, while search_products returns paginated results with both Persian (name1) and English (name2) product names, making the data usable across multilingual applications.
curl -X GET 'https://api.parse.bot/scraper/89fb9532-9c43-4bfe-8b83-a97933f4849c/search_products?page=0&sort=popularity&query=iPhone&category_id=94' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for products by keyword or category on Torob. Returns paginated results with product summaries, prices, and related categories. Supports pagination and sorting.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number (0-based) |
| sort | string | Sort order for results. |
| query | string | Search keyword (Persian or English) |
| category_id | string | Category ID to filter by (from get_categories results) |
{
"type": "object",
"fields": {
"count": "integer total number of matching products",
"results": "array of product summaries with random_key, name1, name2, price, image_url",
"has_more": "boolean indicating if more pages are available",
"categories": "array of related category objects with title and cat_id"
},
"sample": {
"data": {
"count": 1200,
"results": [
{
"name1": "گوشی آیفون 17 پرو مکس",
"name2": "Apple iPhone 17 Pro Max Not Active 256 GB",
"price": 362840000,
"image_url": "https://image.torob.com/base/images/Dw/ZS/DwZSKQ-pao4RArot.jpg",
"random_key": "18d33323-003c-40be-8405-1805d0b6719d"
}
],
"has_more": true,
"categories": [
{
"id": "94",
"slug": "گوشی-موبایل-mobile",
"title": "گوشی موبایل",
"cat_id": 94
}
]
},
"status": "success"
}
}About the Torob API
Product Search and Discovery
The search_products endpoint accepts a query string in Persian or English, an optional category_id from get_categories, and a sort parameter. Each result includes a random_key (the product UUID used by every other endpoint), dual-language name fields, lowest price in Toman, and an image_url. The response also returns a categories array of related category objects and a has_more boolean for pagination control. get_search_suggestions provides autocomplete results with suggestion_type and suggestion_group fields for building search UIs.
Product Details, Specs, and Pricing
get_product_details returns the full product record for a given UUID: min_price, max_price, variants (with titles and items), breadcrumbs for category path, and key_specs. For deeper spec data, get_product_specs returns a structural_specs object organized into categorized header/value pairs alongside key_specs highlights. get_price_history returns labels as Persian-calendar date strings and chart_data datasets with per-entry val and index fields for rendering price trend charts.
Seller and Store Data
get_product_sellers returns a sellers array with shop_name, shop_id, price, availability, and score_info for each listing. The shop_id from these results feeds directly into get_store_details (which returns city, domain, physical address, date_added, and a 1–5 shop_score) and get_store_products (paginated product listings for that store). For batch workflows, get_product_sellers_bulk accepts a JSON array of up to 10 product UUIDs in a single POST and returns per-UUID seller data or a per-item error object without failing the entire batch.
Similar Products and Category Navigation
get_similar_products returns a results array of related product summaries including shop_text, useful for building recommendation widgets. get_categories returns all top-level Torob categories with cat_id, id, slug, and a global products_count, providing the filter values needed for scoped searches.
The Torob API is a managed, monitored endpoint for torob.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when torob.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 torob.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?+
- Build a Persian-language price alert tool using
get_price_historychart datasets to detect when a product drops below a target price - Aggregate multi-seller pricing data with
get_product_sellersto display the cheapest available option and seller trust scores - Populate a product catalog with dual-language names (
name1/name2), specs, and images fromget_product_detailsandget_product_specs - Monitor competitor store inventories using
get_store_productsfiltered bystore_idand an optional search query - Process bulk price comparisons for up to 10 products simultaneously via
get_product_sellers_bulkto reduce API call overhead - Implement search autocomplete with typed Persian or English input using
get_search_suggestionssuggestion type and group fields - Build a category-scoped product browser using
get_categoriesslugs andcategory_idfiltering insearch_products
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 200 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
| Team | $300/mo | 20,000 | 300 req/min |
| Company | $1,000/mo | 100,000 | 500 req/min |
Each endpoint has a fixed posted price per successful call — most fall between 1 and 10 credits — shown on this API's page before you run it. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Torob have an official public developer API?+
What does get_price_history return, and how are dates formatted?+
labels array of date strings in Persian (Jalali) calendar format and a chart_data array of datasets. Each dataset contains a label, a color, and an entries array of objects with val (price in Toman) and index fields. Typical datasets represent average and minimum price over time.Does the API cover user reviews or ratings for products?+
What happens if one UUID in a get_product_sellers_bulk request is invalid?+
product_uuid, seller_count, and a sellers array; failed items return product_uuid and an error field. The batch accepts a maximum of 10 UUIDs per call.Are subcategories returned by get_categories, or only top-level categories?+
title, cat_id, id, and slug. Subcategory browsing is not currently covered by a dedicated endpoint. You can fork it on Parse and revise to add subcategory traversal if the data is needed.