## 🛒 Instacart API — Get Goods

**Endpoint:** `GET /getGoods`
**Description:**
Fetches available goods from a specified store and ZIP code. Supports filtering by one or more **product categories** and **subcategories** (e.g., “Paper Goods → Tissues”).

**Site:** [instacart.com](https://www.instacart.com)
**Budget:** `$100`

---

### ⚙️ Method

`GET`

---

### 🔹 Request Parameters

| Parameter    | Type                | Required | Description                                                                       |
| ------------ | ------------------- | -------- | --------------------------------------------------------------------------------- |
| `zipcode`    | `string`            | ✅        | ZIP code for the delivery or store location                                       |
| `store`      | `string`            | ✅        | Store name (e.g., `"Costco"`)                                                     |
| `categories` | `string` or `array` | ✅        | One or more product categories to search (e.g., `"paper goods, dairy & produce"`) |

---

### 🧱 Example Request

```json
{
  "zipcode": "90001",
  "store": "Costco",
  "categories": ["paper goods"]
}
```

---

### ✅ Example Response

```json
{
  "paper goods": {
    "subcategories": {
      "tissues": [
        {
          "name": "Kleenex Ultra Soft Tissues, 3-Ply (8 Boxes)",
          "price": "$16.49",
          "size": "8 boxes, 120 tissues each",
          "image": "https://www.instacart.com/image-server/140x140/filters:fill(FFFFFF)",
          "category": "Paper Goods",
          "subcategory": "Tissues",
          "store": "Costco",
          "zipcode": "90001",
          "url": "https://www.instacart.com/products/12345678-kleenex-ultra-soft"
        },
        {
          "name": "Kirkland Signature Facial Tissues, 2-Ply (12 Boxes)",
          "price": "$14.79",
          "size": "12 boxes, 160 tissues each",
          "image": "https://www.instacart.com/image-server/140x140/filters:fill(FFFFFF)",
          "category": "Paper Goods",
          "subcategory": "Tissues",
          "store": "Costco",
          "zipcode": "90001",
          "url": "https://www.instacart.com/products/22345678-kirkland-facial-tissues"
        },
        {
          "name": "Puffs Plus Lotion Tissues (4 Boxes)",
          "price": "$7.99",
          "size": "4 boxes, 124 tissues each",
          "image": "https://www.instacart.com/image-server/140x140/filters:fill(FFFFFF)",
          "category": "Paper Goods",
          "subcategory": "Tissues",
          "store": "Costco",
          "zipcode": "90001",
          "url": "https://www.instacart.com/products/32345678-puffs-plus-lotion"
        }
      ],
      "paper towels": [
        {
          "name": "Bounty Select-A-Size Paper Towels, 12 Rolls",
          "price": "$29.99",
          "size": "12 rolls, 2-ply",
          "image": "https://www.instacart.com/image-server/140x140/filters:fill(FFFFFF)",
          "category": "Paper Goods",
          "subcategory": "Paper Towels",
          "store": "Costco",
          "zipcode": "90001",
          "url": "https://www.instacart.com/products/87654321-bounty-select-a-size"
        },
        {
          "name": "Kirkland Premium Paper Towels, 12 Mega Rolls",
          "price": "$24.49",
          "size": "12 mega rolls, 160 sheets each",
          "image": "https://www.instacart.com/image-server/140x140/filters:fill(FFFFFF)",
          "category": "Paper Goods",
          "subcategory": "Paper Towels",
          "store": "Costco",
          "zipcode": "90001",
          "url": "https://www.instacart.com/products/87659999-kirkland-premium-towels"
        }
      ],
      "toilet paper": [
        {
          "name": "Charmin Ultra Soft Toilet Paper, 30 Rolls",
          "price": "$32.89",
          "size": "30 rolls, 2-ply",
          "image": "https://www.instacart.com/image-server/140x140/filters:fill(FFFFFF)",
          "category": "Paper Goods",
          "subcategory": "Toilet Paper",
          "store": "Costco",
          "zipcode": "90001",
          "url": "https://www.instacart.com/products/56789012-charmin-ultra-soft"
        },
        {
          "name": "Kirkland Bath Tissue, 30 Rolls",
          "price": "$25.99",
          "size": "30 rolls, 425 sheets per roll",
          "image": "https://www.instacart.com/image-server/140x140/filters:fill(FFFFFF)",
          "category": "Paper Goods",
          "subcategory": "Toilet Paper",
          "store": "Costco",
          "zipcode": "90001",
          "url": "https://www.instacart.com/products/56789999-kirkland-bath-tissue"
        }
      ],
      "napkins": [
        {
          "name": "Vanity Fair Everyday Napkins, 600 ct",
          "price": "$9.99",
          "size": "600 napkins, 2-ply",
          "image": "https://www.instacart.com/image-server/140x140/filters:fill(FFFFFF)",
          "category": "Paper Goods",
          "subcategory": "Napkins",
          "store": "Costco",
          "zipcode": "90001",
          "url": "https://www.instacart.com/products/34567890-vanity-fair-everyday-napkins"
        },
        {
          "name": "Kirkland Premium Dinner Napkins, 320 ct",
          "price": "$7.99",
          "size": "320 napkins, folded",
          "image": "https://www.instacart.com/image-server/140x140/filters:fill(FFFFFF)",
          "category": "Paper Goods",
          "subcategory": "Napkins",
          "store": "Costco",
          "zipcode": "90001",
          "url": "https://www.instacart.com/products/34567899-kirkland-premium-napkins"
        }
      ]
    }
  }
}
```

---

### 📦 Response Format

Each **category** contains:

* A `subcategories` object.
* Each **subcategory** is an array of products with details:

  * `name`
  * `price`
  * `size`
  * `image`
  * `category` / `subcategory`
  * `store`
  * `zipcode`
  * `url`

---

### 🐧 Linux VPS & Python Compatibility

* Fully operational on **Linux VPS** (e.g., Ubuntu 22.04, Debian 12).
* Compatible with **Python 3.10+** using standard libraries (`requests`, `json`).
* Optimized for small, $5 VPS instances — low memory, no external dependencies required.

**Python Example:**

```python
import requests, json

url = "https://api.instacart.com/getGoods"
params = {
    "zipcode": "90001",
    "store": "Costco",
    "categories": ["paper goods"]
}

response = requests.get(url, params=params)
data = response.json()
print(json.dumps(data, indent=2))
```