SmartParsev2.34
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.

5 min readLast updated: 21 May 2026v2.34

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.

terminal
# Install the SDK
npm install @smartparse/sdk
# Or with pnpm
pnpm add @smartparse/sdk

2. Run your first parse

Set SP_KEY in your environment, then run:

quickstart.ts
import { SmartParse } from "@smartparse/sdk";
// Initialize once and reuse across requests.
const sp = new SmartParse({
apiKey: process.env.SP_KEY!, // sk_live_…
timeoutMs: 8000,
retries: 3
});
// Parse a single product
const product = await sp.parse({
marketplace: "wildberries",
url: "https://www.wildberries.ru/catalog/156789201",
include: ["price", "stock", "rating"]
});
// product.price.current → 18990 (RUB, whole units)
// product.stock.total → 1240
// product.rating.value → 4.87

3. What you get back

Every parse returns the same canonical shape. Below is the contract for the product object:

FieldTypeRequiredDescription
titlestringyesCanonical product title, trimmed and de-emojified.
price.currentintegeryesCurrent price in whole RUB (e.g. 18990).
price.originalinteger | nullnoPre-discount price, if a discount is active.
stock.totalintegeryesAggregate stock across all warehouses.
rating.valuefloatnoAverage rating, 0.00–5.00.
images[]string[]yesCDN URLs, deduplicated, ordered by listing position.

4. Next steps

Собрано вISKRA.WORKSКейсХочу такой же →