---
title: محصولات در Stard API
url: https://stard-market.ir/docs/products
markdown: https://stard-market.ir/docs/products.md
language: fa
updated: 2026-11-18
description: همه‌ی محصولات فروشگاه — گیفت، NFT، یوزرنیم، شماره، پریمیوم و استارز — با یک endpoint جستجو و فیلتر می‌شوند.
---

# محصولات در Stard API

> همه‌ی محصولات فروشگاه — گیفت، NFT، یوزرنیم، شماره، پریمیوم و استارز — با یک endpoint جستجو و فیلتر می‌شوند.

## شیء محصول

**product**

```json
{
  "object": "product",
  "id": 4518,
  "tag": "3Q219N",
  "name": "پریمیوم ۳ ماهه",
  "description": "اشتراک تلگرام پریمیوم",
  "category": "premium",
  "pricing_type": "fixed",
  "price": {
    "amount": 3788624,
    "currency": "IRT"
  },
  "starting_price": null,
  "auction_end_at": null,
  "stars_price": null,
  "available": true,
  "purchasable_via_api": true,
  "not_purchasable_reason": null,
  "marketplace": "stard",
  "image_url": "https://stard-market.ir/img/sample.webp",
  "link": "https://fragment.com/premium",
  "badge": null,
  "attributes": null,
  "animation": null,
  "nft": null,
  "community": null,
  "last_checked_at": "2026-10-01T10:13:50Z",
  "created_at": "2026-07-25T21:54:14Z"
}
```

## فیلدهای مهم

- `price.amount`: مبلغی که هنگام خرید کسر می‌شود (تومان).
- `purchasable_via_api`: آیا با `POST /orders` قابل خرید است. آگهی‌های کاربر به کاربر (P2P)، مزایده و توافقی به تایید طرفین در تلگرام نیاز دارند و از API خریده نمی‌شوند.
- `marketplace`: `stard` (فروش مستقیم) یا `p2p`.

## endpointها

- [`GET /products`](https://stard-market.ir/docs/reference/products-list)
- [`GET /products/{category}`](https://stard-market.ir/docs/reference/products-category)
- [`GET /products/{id}`](https://stard-market.ir/docs/reference/product-get)
- [`GET /products/tag/{tag}`](https://stard-market.ir/docs/reference/product-tag)
- [`GET /categories`](https://stard-market.ir/docs/reference/categories)
