README updates

Author: chriskh

labs/README.md

@@ -25,10 +25,25 @@ This directory contains hands-on resources to help you learn and master the **Se
 
 ---
 
+## Quick Start Command
+
+Open Terminal run the following:
+```bash
+  cd selling-partner-api-samples/labs/server
+  sh setup.sh
+```
+
+Open a new terminal and run:
+```bash
+   cd selling-partner-api-samples/labs
+   jupyter lab .
+```
 ## 📚 Quick Access Table
 
 | Category     | Folder                                                                                      | Description                                                                 | Example                                                |
 |--------------|---------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------|--------------------------------------------------------|
 | 📖 Tutorials | [`tutorials/`](https://github.com/amzn/selling-partner-api-samples/tree/hands-on-labs/labs/tutorials) | Guided Jupyter notebooks focused on a single API workflow                   | Querying SKU economics with Data Kiosk                 |
 | 🏋️ Workshops | [`workshops/`](https://github.com/amzn/selling-partner-api-samples/tree/hands-on-labs/labs/workshops) | Multi-step challenges combining multiple APIs to solve real-world problems   | Listing error diagnosis, Fulfillment workflows with MLI |
 | 🖥 Server    | [`server/`](https://github.com/amzn/selling-partner-api-samples/tree/hands-on-labs/labs/server)       | Mock server to run tutorials and workshops locally, and understand API flows | Listings Wizard, Data Kiosk, Shipping Guru             |
+
+

labs/server/requirements.txt

@@ -5,12 +5,6 @@ ipykernel
 # SP-API SDK
 amzn-sp-api
 
-# Data analysis & visualization
-pandas
-numpy
-matplotlib
-seaborn
-
 # Utils
 requests
 python-dotenv

labs/tutorials/data-kiosk/README.md

@@ -0,0 +1,83 @@
+# 📊 Data Kiosk Flow Tutorial
+
+---
+
+Welcome to the **Data Kiosk Flow Tutorial**!  
+In this hands-on tutorial, you’ll learn how to work with the **Amazon Data Kiosk API** and understand the **end-to-end flow of querying, retrieving, and analyzing seller economics data**.  
+
+Unlike workshops, which are challenge-based, this tutorial is designed to **teach you the request/response flow** of the Data Kiosk API step by step.
+
+---
+
+#### ⚠️ Check the [🚀 How to Access](#-how-to-access) to learn more about deployment.
+
+---
+
+## 🧩 The Tutorial
+
+This tutorial is organized into a single notebook:
+
+#### data-kiosk-flow.ipynb
+
+- **Goal**: Learn the flow of the Data Kiosk API from query creation to document retrieval.
+- **Steps you’ll cover**:
+  1. Create a Data Kiosk query with `POST /dataKiosk/2023-11-15/queries`
+  2. Check query status with `GET /dataKiosk/2023-11-15/queries/{queryId}`
+  3. Retrieve all queries with `GET /dataKiosk/2023-11-15/queries`
+  4. Fetch the final dataset with `GET /dataKiosk/2023-11-15/documents/{documentId}`
+- **Deliverable**: Understand how Data Kiosk integrates into SP-API flows and be able to extend queries for your own use cases.
+
+---
+
+## 🛠️ Tools You’ll Use
+
+- SP-API SDK → pre-installed in the environment (Python).
+- Sample Payloads → included in the notebook.
+- Mock Endpoints → provided for safe experimentation (no live API calls required).
+- Step-by-Step Guidance → built directly into the notebook to help you follow the flow.
+
+---
+
+## 🎯 What You’ll Learn
+
+By completing this tutorial, you’ll:
+- Understand the **full lifecycle** of a Data Kiosk query.
+- Learn how to **test queries locally** with the mock server.
+- Gain the foundation to integrate Data Kiosk into **custom seller analytics solutions**.
+
+---
+
+## 🚀 How to Access
+
+### Quick Start - Amazon SP-API Mock Server
+
+The fastest way to get started is using our automated setup scripts:
+
+**macOS/Linux:**
+```bash
+cd selling-partner-api-samples/labs/server
+sh setup.sh
+```
+
+**Windows:**
+
+```bash
+setup.bat
+```
+
+**The script will automatically:**
+
+- Set up a virtual environment 
+- Install all dependencies 
+- Start the server at http://localhost:8000
+
+You can run these notebooks on Amazon SageMaker → Notebook Instances
+**OR** run them locally in any Jupyter environment:
+
+```bash
+cd labs/tutorials/data-kiosk
+python3 -m venv venv
+source venv/bin/activate
+pip install -r requirements.txt
+jupyter lab
+```

labs/tutorials/data-kiosk/data-kiosk-flow.ipynb

@@ -28,18 +28,13 @@
   },
   {
    "cell_type": "code",
-   "execution_count": null,
    "id": "ef145f6d-ce8c-4c21-804e-254ca8190350",
-   "metadata": {
-    "ExecuteTime": {
-     "end_time": "2025-09-05T08:45:48.456073Z",
-     "start_time": "2025-09-05T08:45:40.864569Z"
-    }
-   },
-   "outputs": [],
+   "metadata": {},
    "source": [
     "pip install amzn-sp-api==1.2.0"
-   ]
+   ],
+   "outputs": [],
+   "execution_count": null
   },
   {
    "cell_type": "markdown",
@@ -88,15 +83,8 @@
   },
   {
    "cell_type": "code",
-   "execution_count": null,
    "id": "4b7d9770-ccdc-4edd-a910-242916c578f7",
-   "metadata": {
-    "ExecuteTime": {
-     "end_time": "2025-09-05T08:46:03.140419Z",
-     "start_time": "2025-09-05T08:45:48.635393Z"
-    }
-   },
-   "outputs": [],
+   "metadata": {},
    "source": [
     "from spapi.models.datakiosk_v2023_11_15 import GetDocumentResponse, CreateQueryResponse, GetQueriesResponse, Query\n",
     "from spapi import SPAPIConfig, SPAPIClient, ApiException, QueriesApi, ProductPricingV2022Api, ListingsApi\n",
@@ -125,7 +113,9 @@
     "data_kiosk_api = QueriesApi(client.api_client)\n",
     "\n",
     "print(\"Connected to SP-API\")\n"
-   ]
+   ],
+   "outputs": [],
+   "execution_count": null
   },
   {
    "cell_type": "markdown",
@@ -149,10 +139,8 @@
   },
   {
    "cell_type": "code",
-   "execution_count": null,
    "id": "c8d26053-3778-45bb-a3b1-3491e81526e1",
    "metadata": {},
-   "outputs": [],
    "source": [
     "# This is a sample query - please update with your own query\n",
     "# Make sure to use backspaces with the quotation marks\n",
@@ -168,7 +156,9 @@
     "# Tell Amazon to start processing your query\n",
     "create_query_response = data_kiosk_api.create_query(body=graphql_query)\n",
     "print(\"✅ Query submitted! Response:\", create_query_response)"
-   ]
+   ],
+   "outputs": [],
+   "execution_count": null
   },
   {
    "cell_type": "markdown",
@@ -189,15 +179,15 @@
   },
   {
    "cell_type": "code",
-   "execution_count": null,
    "id": "22d659b2-f89a-4c7e-bd5b-adf13ba85ccf",
    "metadata": {},
-   "outputs": [],
    "source": [
     "# Tell Amazon to start processing your query\n",
     "create_query_response = data_kiosk_api.create_query(body=graphql_query)\n",
     "print(\"✅ Query submitted! Response:\", create_query_response)"
-   ]
+   ],
+   "outputs": [],
+   "execution_count": null
   },
   {
    "cell_type": "markdown",
@@ -224,15 +214,15 @@
   },
   {
    "cell_type": "code",
-   "execution_count": null,
    "id": "0857ee42-ce36-4252-8a11-2ca395f1b1de",
    "metadata": {},
-   "outputs": [],
    "source": [
     "# Check the status of your query\n",
     "get_query_response = data_kiosk_api.get_query(query_id=create_query_response.query_id)\n",
     "print(\"⏱️ Query status:\", get_query_response)"
-   ]
+   ],
+   "outputs": [],
+   "execution_count": null
   },
   {
    "cell_type": "markdown",
@@ -254,15 +244,15 @@
   },
   {
    "cell_type": "code",
-   "execution_count": null,
    "id": "02bceeee-e931-4ccc-b01f-d3368fe6d335",
    "metadata": {},
-   "outputs": [],
    "source": [
     "# Now let's get the actual data!\n",
     "get_document = data_kiosk_api.get_document(document_id=get_query_response.data_document_id)\n",
     "print(\"📊 Here's your data:\", get_document)"
-   ]
+   ],
+   "outputs": [],
+   "execution_count": null
   },
   {
    "cell_type": "markdown",
@@ -293,19 +283,9 @@
    ]
   },
   {
-   "metadata": {},
    "cell_type": "code",
-   "outputs": [],
-   "execution_count": null,
-   "source": "pip install pandas",
-   "id": "6eb9f3ee0e837b80"
-  },
-  {
-   "cell_type": "code",
-   "execution_count": null,
    "id": "dc0721a2-e9ab-403f-b87b-4ef0883e35a9",
    "metadata": {},
-   "outputs": [],
    "source": [
     "import ast\n",
     "import pandas as pd\n",
@@ -351,7 +331,9 @@
     "\n",
     "plt.tight_layout()\n",
     "plt.show()\n"
-   ]
+   ],
+   "outputs": [],
+   "execution_count": null
   },
   {
    "cell_type": "markdown",

labs/workshops/README.md

@@ -23,13 +23,6 @@ cd selling-partner-api-samples/labs/server
 sh setup.sh
 ```
 
-Or download and run:
-```bash
-curl -O https://raw.githubusercontent.com/amzn/sp-api-sample-solutions/main/labs/server/setup.sh
-chmod +x setup.sh
-./setup.sh
-```
-
 **Windows:**
 ```cmd
 setup.bat