Getting started / Quickstart
Edit on GitHub →Welcome to SmartParse.
SmartParse is a single API for reading data from marketplaces. You send URLs, we return strict, typed JSON. This quickstart will take you from zero to a successful parse in under five minutes.
1. Install the SDK
We ship official SDKs for TypeScript, Python and Go. You can also call the API directly via HTTPS — see the cURL guide.
2. Run your first parse
Set SP_KEY in your environment, then run:
3. What you get back
Every parse returns the same canonical shape. Below is the contract for the product object:
| Field | Type | Required | Description |
|---|---|---|---|
| title | string | yes | Canonical product title, trimmed and de-emojified. |
| price.current | integer | yes | Current price in whole RUB (e.g. 18990). |
| price.original | integer | null | no | Pre-discount price, if a discount is active. |
| stock.total | integer | yes | Aggregate stock across all warehouses. |
| rating.value | float | no | Average rating, 0.00–5.00. |
| images[] | string[] | yes | CDN URLs, deduplicated, ordered by listing position. |