Salla APISalla.sa ↗
Retrieve newly listed e-commerce stores from Salla's marketplace. Filter by date range, category, and page. Returns store name, price, category, and more.
What is the Salla API?
The Salla.sa API exposes 1 endpoint — list_new_stores — that returns recently added storefronts from the Salla marketplace, each with 9 fields including store name, URL, price, currency, category, company name, sold status, and screenshots. You can query stores listed within any custom date window, filter by category slug, and page through results 12 records at a time.
curl -X GET 'https://api.parse.bot/scraper/cb18131c-f76a-402f-b7b0-134027550690/list_new_stores?page=1&date_to=2026-07-20&category=electronics&language=en&date_from=2026-06-22' \ -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 salla-sa-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.
"""Walkthrough: Salla SDK — browse new marketplace stores, bounded and re-runnable."""
from parse_apis.salla_sa_api import Salla, Language, ParseError
client = Salla()
# List newest stores (last 4 weeks by default), capped at 3 items total.
for store in client.stores.list_new(language=Language.EN, limit=3):
print(store.name, store.price, store.currency, store.is_sold)
# Filter by category and take the first result.
store = client.stores.list_new(category="electronics", language=Language.EN, limit=1).first()
if store:
print(store.name, store.category.slug, store.company.name)
# Custom date window with error handling.
try:
for s in client.stores.list_new(date_from="2025-06-01", date_to="2025-07-01", limit=3):
print(s.id, s.name, s.price)
except ParseError as e:
print("error:", e)
print("exercised: stores.list_new")
Retrieve stores recently added to the Salla marketplace. By default returns stores from the last 4 weeks; override with date_from/date_to for a custom window. Results are paginated (12 per page). Supports category filtering by slug.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for paginated results. |
| date_to | string | End date for the date range filter in ISO format YYYY-MM-DD. Defaults to today. |
| category | string | Category slug to filter stores (e.g. electronics, fashion, jewelry, cosmetics-care, drop-shipping). |
| language | string | Language for localized fields. |
| date_from | string | Start date for the date range filter in ISO format YYYY-MM-DD. Defaults to 4 weeks before today. |
{
"type": "object",
"fields": {
"stores": "array of store objects with id, name, url, price, currency, category, company, is_sold, screenshots",
"date_to": "end of date range used (YYYY-MM-DD)",
"date_from": "start of date range used (YYYY-MM-DD)",
"pagination": "object with current_page, total_pages, total, per_page"
},
"sample": {
"stores": [
{
"id": 703408899,
"url": "https://devstore.salla.design/Orgnza0/",
"name": "Orgnza",
"price": 2200,
"company": {
"id": 941149047,
"name": "Madar Technical Solutions FZC"
},
"is_sold": false,
"category": {
"id": 18,
"slug": "electronics",
"name_ar": "الالكترونيات",
"name_en": "Electronics"
},
"currency": "ر.س",
"screenshots": [
"https://salla-dev-portal.s3.eu-central-1.amazonaws.com/uploads/Ui5qni3kEllayHiqg6ODJrDnbmYmDNe9HPgX9wLW.png"
]
}
],
"date_to": "2025-07-19",
"date_from": "2025-06-19",
"pagination": {
"total": 6,
"per_page": 12,
"total_pages": 1,
"current_page": 1
}
}
}About the Salla API
What the API Returns
The list_new_stores endpoint returns an array of store objects from the Salla marketplace. Each object includes id, name, url, price, currency, category, company, is_sold, and screenshots. The is_sold flag tells you whether a listing has already been purchased. The screenshots field provides visual previews of each storefront. Alongside the store array, the response echoes back date_from and date_to so you always know the exact window your results cover.
Filtering and Pagination
By default, list_new_stores covers the past 4 weeks relative to the current date. Override this with the date_from and date_to parameters, both accepting ISO format (YYYY-MM-DD). Narrow results to a specific vertical using the category parameter — accepted slugs include electronics, fashion, jewelry, cosmetics-care, and drop-shipping. Results are paginated at 12 stores per page; pass the page integer to move through the full result set. The pagination response object returns current_page, total_pages, total, and per_page to help you iterate correctly.
Localization
Pass the language parameter to receive localized field values where supported. This is useful when building dashboards or feeds for non-English audiences in Salla's primary markets.
The Salla API is a managed, monitored endpoint for Salla.sa — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when Salla.sa 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 Salla.sa 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?+
- Monitor newly available stores in a specific Salla category (e.g.
fashionorjewelry) to identify acquisition targets. - Track
is_soldstatus changes over time to analyze how quickly stores sell in different verticals. - Aggregate
priceandcurrencydata across categories to benchmark Salla storefront valuations. - Build a deal-alert tool that notifies users when stores matching a category and price threshold appear.
- Compile a dated catalog of new Salla stores using
date_from/date_tofor competitive market research. - Use
screenshotsto visually audit storefront quality or design trends across categories.
| 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 Salla have an official developer API?+
What does the `list_new_stores` endpoint return for each store?+
id, name, url, price, currency, category, company, is_sold, and screenshots. The pagination object in the response provides current_page, total_pages, total, and per_page so you can iterate through the full result set.Can I retrieve detailed analytics or traffic data for individual stores?+
Is there a limit to how far back I can set `date_from`?+
date_from, but the marketplace itself only surfaces stores that are currently listed or were recently listed. Very old date ranges may return few or no results if those listings are no longer active in the directory. The default window is the past 4 weeks.Are sold-out stores included in the results?+
is_sold boolean field on each store object lets you filter them client-side. The API currently covers stores across all sold states within the requested date range and category. You can fork it on Parse and revise to add server-side filtering by sold status if needed.