# Astro



Public product data from Astro's quick-commerce catalog — browse a category's shelf with live prices, then read any listing in full: price, availability, gallery, and description.



## Astro Category Listing

One shelf of Astro's quick-commerce catalog — price, discount, original price, photo, and title on every server-rendered card.

- Method: `GET`
- Path: `/v1/marketplace/astro/categories/{category}`

**Parameters**

| Name | Type | | Description |
|---|---|---|---|
| `category` | path segment | required | A category page slug with its numeric id — the `buah-segar-7176` form of any category URL on the board. |
| `max_age` | integer (seconds) | optional | Ask for data no older than this. Clamped to the product's own floor, so it can narrow the window but never force a refresh on every call. |

**Example request**

```bash
curl https://api.diraz.ae/v1/marketplace/astro/categories/%7Bcategory%7D \
  -H "Authorization: Bearer drz_live_…"
```

**Example response**

```json
{
  "data": {
    "category": "buah-segar-7176",
    "items": [
      {
        "product_slug": "pear-xiang-lie-astro-farm-23-pcs-200-250gram-42575",
        "name": "Pear Xiang Lie Astro Farm 2-3 pcs",
        "price": 18500,
        "price_display": "Rp18.500",
        "original_price": null,
        "original_price_display": null,
        "discount_percentage": null,
        "image": "https://image.astronauts.cloud/product-images/2026/7/PearXiangLie1d67a5d_f24ba094-09b7-48c5-b11d-f7d501b9c67a_400x400.jpg",
        "url": "https://www.astronauts.id/p/pear-xiang-lie-astro-farm-23-pcs-200-250gram-42575"
      }
    ]
  },
  "meta": {
    "request_id": "req_7Q2fK4mZ",
    "as_of": "2026-08-20T14:45:00.000Z",
    "age_seconds": 120,
    "next_update_at": "2026-08-20T14:50:00.000Z"
  }
}
```

## Astro Product Detail

One Astro listing in full — price, availability, the whole gallery, and the listing's own description.

- Method: `GET`
- Path: `/v1/marketplace/astro/products/{product}`

**Parameters**

| Name | Type | | Description |
|---|---|---|---|
| `product` | path segment | required | The listing slug from a category card's `url` — the segment after `/p/`. |
| `max_age` | integer (seconds) | optional | Ask for data no older than this. Clamped to the product's own floor, so it can narrow the window but never force a refresh on every call. |

**Example request**

```bash
curl https://api.diraz.ae/v1/marketplace/astro/products/%7Bproduct%7D \
  -H "Authorization: Bearer drz_live_…"
```

**Example response**

```json
{
  "data": {
    "product_id": "42575",
    "slug": "pear-xiang-lie-astro-farm-23-pcs-200-250gram-42575",
    "name": "Pear Xiang Lie Astro Farm 2-3 pcs 200-250gram",
    "description": "Pear Xiang Lie Astro Farm, pear segar dengan kulit hijau kemerahan berbintik halus.",
    "price": 18500,
    "price_display": "Rp18500",
    "in_stock": true,
    "images": [
      "https://image.astronauts.cloud/product-images/2026/7/PearXiangLie1d67a5d_f24ba094-09b7-48c5-b11d-f7d501b9c67a_900x900.jpg"
    ],
    "url": "https://www.astronauts.id/p/pear-xiang-lie-astro-farm-23-pcs-200-250gram-42575"
  },
  "meta": {
    "request_id": "req_7Q2fK4mZ",
    "as_of": "2026-08-20T14:45:00.000Z",
    "age_seconds": 60,
    "next_update_at": "2026-08-20T14:50:00.000Z"
  }
}
```