# 🔥 Etsy Keyword Research – Demand, Supply & Gaps (`yumitori/etsy-keyword-tool`) Actor

Etsy keyword research: one seed explodes into hundreds of long-tail keywords, each scored on live demand (cart counts), supply (listing count), competition (bestseller/star-seller/promo density) and an opportunity score. Finds the low-supply, high-intent niches.

- **URL**: https://apify.com/yumitori/etsy-keyword-tool.md
- **Developed by:** [Yakugusa Yumitori](https://apify.com/yumitori) (community)
- **Categories:** E-commerce, SEO tools, Lead generation
- **Stats:** 4 total users, 2 monthly users, 80.3% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $9.00 / 1,000 keyword results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):

```bash
npm install apify-client
```

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):

```bash
pip install apify-client
```

In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):

````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash

In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).

If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).


# README

## Etsy Keyword Research Tool

The **Etsy keyword research & SEO tool** that scores keywords on Etsy's *own* live data. Drop in a seed and get back its whole long-tail universe of **tags and niches** — every keyword scored 0–100 on **live demand** (real shopping-cart counts + recent sales), **competition** (how many listings, how entrenched, how breakable), and **margin** (discount pressure), with a letter grade and a plain-English verdict on each.

A data-driven **alternative to eRank, Everbee and Marmalead**: instead of a search-volume guess, this Etsy keyword tool reads Etsy's **own** signals — current carts, sales in the last 90 days, bestseller saturation, whether fresh listings still rank, discount density, and which category a keyword lives in — so you see what's *actually selling and actually winnable*. No login, no proxies, no setup — just add a seed and run.

---

### Quick start

```json
{
  "seeds": ["ceramic mug"],
  "depth": 2,
  "maxKeywords": 40
}
````

One seed → up to 40 scored keywords, ranked by opportunity, in a couple of minutes. **Every run pulls fresh, live data** — nothing is cached between runs.

***

### What you get per keyword

**Demand** — `avg_carts` (mean live shopping-cart count across the top listings), `with_carts_pct`, **`recent_sales_pct`** (share of top listings that sold in the last 90 days — proof the niche converts *now*), and a `trending` flag when the term is on Etsy's live trending feed.

**Competition** — `listings` (exact number competing), `bestseller_pct` + `starseller_pct` (how entrenched the top is), and **`recent_listings_pct`** (share of top listings under a year old — if fresh listings rank, a new seller can still break in even when `listings` is high).

**Margin** — `on_sale_pct` (how many top listings are running a discount — high = a price war eating everyone's margin).

**Niche & price** — `category` (which Etsy category the keyword actually lives in → where to list), `category_focus_pct` (how concentrated), `digital_pct` (digital / print-on-demand niches), `avg_price`, and `price_tiers` (the niche's common price breakpoints). *All pulled free from the same call — no extra cost.*

**Who you're up against (niche profile)** — `ad_density_pct` (how pay-to-play the niche is — what share of the top is paid ads), `personalize_pct` (do buyers expect customization?), `handmade_pct` / `vintage_pct` (handmade vs. reseller/vintage-dominated), and the **trust wall** you'd have to clear: `avg_shop_rating`, `median_shop_reviews` (how much social proof each competitor carries), and `avg_seller_sales` (how established they are). *Aggregated across the top listings — free, same call, niche-level only (no per-listing rows).*

**Scores** — a **0–100 Opportunity** score with an **A–F grade**, the three sub-scores it's built from (**Demand**, **Competition**, **Margin**), and a plain-English **`verdict`** like *"⚠️ Proven but hard: strong demand, saturated — fresh listings rank (breakable), actively selling."*

***

### How the score works (nothing hidden)

Every score is computed from the raw Etsy numbers on the same row, so you can always check the math:

- **Demand /100** = live carts (`avg_carts`) + buy-intent (`with_carts_pct`) + recent sales (`recent_sales_pct`) + how high Etsy ranks the search (`autosuggest_rank`) + a trending bump.
- **Competition /100** = how big the niche is (`listings`, log-scaled) + how entrenched the top is (`bestseller_pct` + `starseller_pct`), **eased when fresh listings still rank** (`recent_listings_pct`). Higher = harder.
- **Margin /100** = `100 − on_sale_pct` — the share of top listings *not* in a discount war.
- **Opportunity /100** = `0.45 × Demand + 0.35 × (100 − Competition) + 0.20 × Margin`.

The raw fields (`listings`, `avg_carts`, `recent_sales_pct`, `on_sale_pct`, `bestseller_pct`, …) stay on every row — the scores just summarise them. If a number looks off, the evidence is right there next to it.

**Grades:** A (80+) · B (65–79) · C (50–64) · D (35–49) · F (<35).

**Verdicts** are kept *consistent* with the scores — a verdict never contradicts the numbers:

- **✅ Strong opening** — strong demand **and** low competition, and not a price war. The genuine gaps (rare on purpose — you'll see one only when it's real).
- **⚠️ Proven but hard** — real demand, but the niche is saturated or in a discount war. Winnable only with a clear edge.
- **◽ Mixed** — strong on one axis, ordinary on another; judge case-by-case.
- **🚫 Skip** — thin demand.

Tags add nuance: *actively selling* (sold <90d), *fresh listings rank (breakable)*, *heavy discounting (price war)*, *digital/POD niche*, *trending now*.

#### How accurate is it?

- **The raw data is Etsy's own numbers** — listing count, live carts, recent sales, badges, price — pulled straight from Etsy. As accurate as it gets.
- **The scores are a transparent heuristic** over that data (formula above) — consistent and explainable, never a black box.

***

### What you control

| Knob | Default | What it does |
|---|---|---|
| `seeds` | — | 1–50 seed keywords; each is expanded into its long-tail universe |
| `depth` | `2` | hops of expansion — `1` = direct suggestions, `2` = suggestions-of-suggestions (much wider), `3` explodes |
| `maxKeywords` | `40` | **upper limit** of keywords per seed (a cap, not a guarantee — see note below); a run is also capped at **200 total**, split evenly across seeds so cost stays predictable |
| `trendingOnly` | `false` | skip keyword research entirely and just return Etsy's live **popular/trending feed** — one row per term. For tracking what's hot. Seeds are ignored when on. |

> **Why a run can return fewer than `maxKeywords`.** The number is an upper bound, not a quota. A seed only expands into as many real keywords as **Etsy's autosuggest actually has** for it (narrow or unusual seeds have a shallow long-tail), and any keyword whose search returns **no live listings is dropped** rather than padded with an empty row. So a broad seed like "ceramic mug" fills the cap easily, while a thin one may come back with far fewer — that's expected, and it means every row you get is a real keyword with real data. **Want more from a thin seed?** Bump `depth` to `3` to widen the expansion, or feed a couple of related seeds in one run.

***

### Use it for

**Find the gap.** Sort by opportunity — low listings + real carts + low bestseller density = an underserved niche you can actually rank in.

```json
{ "seeds": ["dog bandana"], "depth": 2, "maxKeywords": 40 }
```

**Break into a "saturated" niche.** A high-`listings` keyword where `recent_listings_pct` is high means new listings *still rank* — the verdict flags it "breakable."

**Spot digital plays.** `digital_pct: 100` keywords are print-on-demand / download niches — low fulfilment, high margin.

**Avoid the price wars.** `on_sale_pct: 90` means everyone's discounting — thin margins ahead.

**Pick the right category & price.** `category` tells you where to list; `price_tiers` + `avg_price` tell you where the niche prices.

**Plan your Etsy Ads.** Etsy now lets you set an ad strategy *per listing* (Greater visibility / Lower click cost / Efficient spending). Use `ad_density_pct` (how pay-to-play the niche already is) alongside demand and competition to pick which listings are worth pushing for "Greater visibility" and which to keep on a tighter, lower-click-cost budget.

**Compare seeds.** Feed several seeds at once and sort all their keywords together to see which theme is the richest.

***

### Output

The **dataset** holds one clean row per scored keyword (export as JSON, CSV, Excel, JSONL) — four pre-built views:

- **Opportunities** — keyword, category, grade, the 0–100 scores, listings, carts, price, verdict (sorted by opportunity)
- **Demand evidence** — carts, % with carts, sold-<90d %, suggest rank, trending
- **Competition evidence** — listings, fresh-<1yr %, bestseller / star-seller / on-sale density, category focus, price
- **Niche profile** — who you'd be up against: ad density, personalization, handmade/vintage mix, and the seller "trust wall" (avg rating, median reviews, avg sales)
- **All columns (ordered)** — every column in a readable order, keyword first (use this one when exporting to CSV/Excel)

Every keyword is one clean row — no array columns, no half-empty cells.

**Exporting to a spreadsheet (keyword-first):** Apify's raw **"All fields"** CSV export lists columns *alphabetically* (so it opens with `ad_density_pct`, not `keyword`) — that's a platform default, not something the actor sets. For a keyword-first sheet, do either: **(a)** pick the **"All columns (ordered)"** (or **Opportunities**) view in the export dialog — the view defines the column order; or **(b)** grab **`OUTPUT.csv`** from the key-value store, which is pre-built keyword-first (verdict last) and already sorted best-opportunity first.

**🔥 Trending on Etsy now** → `TRENDING_AND_POPULAR`. Etsy's current **popular searches, trending terms, trending products, and gift-guide themes** — spot fresh niches to research next:

```json
{
  "popular_searches": ["gardening supplies", "modern clock", "custom quilt from baby clothes"],
  "trending_terms": ["bun feet", "garden marker", "succulent ring dish", "red silk top"],
  "trending_products": ["Ocean Resin Art", "Summer Picnic Basket", "Carved Wooden Spoon"],
  "gift_guides": ["Personalized Gifts", "Gifts for Her", "Gifts Under $30", "Gifts for Pets"]
}
```

**Where to find it:** after a run, open the run → **Storage → Key-value store → `TRENDING_AND_POPULAR`** — it sits right next to `OUTPUT.csv`. It's also printed to the run **log** every time ("🔥 Trending on Etsy now…"), so you see it without digging. It's kept out of the keyword dataset on purpose, so your results table and CSV stay clean.

**Just want the trending feed?** Turn on **`trendingOnly`** and the run skips keyword research entirely — the dataset comes back as one clean row per term (`kind`, `rank`, `term`) under the **Trending feed** view, exportable to CSV/JSON.

> 💡 **Track what's hot — set it on a schedule.** A trending-only run is tiny and cheap (one start + ~40 small rows, finishes in seconds), so it's ideal to **schedule daily**. In Apify: open the Actor → **Schedules → Create**, set the input to `{ "trendingOnly": true }` and a daily cron — every morning you'll have a fresh snapshot of Etsy's popular searches, trending terms/products and gift-guide themes, and the dataset history lets you watch terms rise and fall over time.

Sample row:

```json
{
  "keyword": "ceramic mug no handle",
  "category": "Home & Living",
  "grade": "C",
  "opportunity": 62,
  "demand_score": 75,
  "competition_score": 58,
  "margin_score": 69,
  "verdict": "◽ Mixed: strong demand, competitive — fresh listings rank (breakable), actively selling",
  "listings": 93116,
  "avg_carts": 20.5,
  "with_carts_pct": 94,
  "recent_sales_pct": 94,
  "recent_listings_pct": 56,
  "bestseller_pct": 17,
  "starseller_pct": 58,
  "on_sale_pct": 31,
  "digital_pct": 0,
  "avg_price": 35.18,
  "category_focus_pct": 94,
  "price_tiers": [25, 50, 75],
  "autosuggest_rank": 5,
  "trending": false,
  "ad_density_pct": 19,
  "personalize_pct": 44,
  "handmade_pct": 86,
  "vintage_pct": 0,
  "avg_shop_rating": 4.91,
  "median_shop_reviews": 1485,
  "avg_seller_sales": 11564,
  "seed": "ceramic mug"
}
```

***

### Speed & limits

| Run shape | Time |
|---|---|
| 1 seed, depth 1 (~17 keywords) | ~30–60s |
| 1 seed, depth 2 (~40 keywords) | ~2–3 min |

Demand numbers are live and shift as carts and sales change, so re-run periodically to track a niche over time.

***

Built and maintained by \[Yakugusa Yumitori]. Custom data work and "can you scrape X?" challenges → <logic.deploy@pm.me>.

> ⚠️ **Unofficial.** Not affiliated with, endorsed by, or sponsored by Etsy, Inc. "Etsy" is a trademark of Etsy, Inc., used here for descriptive purposes only.

# Actor input Schema

## `seeds` (type: `array`):

One or more seed keywords to research (e.g. "ceramic mug", "dog bandana"). Each seed is expanded into its long-tail keyword universe.

## `trendingOnly` (type: `boolean`):

Skip keyword expansion and just return Etsy's current popular searches, trending terms, trending products, and gift-guide themes — one row per term. For tracking what's hot. When on, the seeds above are ignored.

## `depth` (type: `integer`):

How many hops of autosuggest expansion. 1 = direct suggestions only; 2 = suggestions-of-suggestions (much wider). 3 explodes fast.

## `maxKeywords` (type: `integer`):

Upper limit on keywords per seed (each is one scored row). It's a cap, not a guarantee — a seed only returns as many keywords as Etsy actually has autosuggest data for, and any keyword with no live listings is dropped, so a thin/niche seed can return fewer. A run is also hard-capped at 200 keywords total, split evenly across seeds.

## Actor input object example

```json
{
  "seeds": [
    "ceramic mug"
  ],
  "trendingOnly": false,
  "depth": 2,
  "maxKeywords": 40
}
```

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "seeds": [
        "ceramic mug"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("yumitori/etsy-keyword-tool").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = { "seeds": ["ceramic mug"] }

# Run the Actor and wait for it to finish
run = client.actor("yumitori/etsy-keyword-tool").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "seeds": [
    "ceramic mug"
  ]
}' |
apify call yumitori/etsy-keyword-tool --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=yumitori/etsy-keyword-tool",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "🔥 Etsy Keyword Research – Demand, Supply & Gaps",
        "description": "Etsy keyword research: one seed explodes into hundreds of long-tail keywords, each scored on live demand (cart counts), supply (listing count), competition (bestseller/star-seller/promo density) and an opportunity score. Finds the low-supply, high-intent niches.",
        "version": "0.1",
        "x-build-id": "1IJFLYC48y2wWD9xZ"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/yumitori~etsy-keyword-tool/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-yumitori-etsy-keyword-tool",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        },
        "/acts/yumitori~etsy-keyword-tool/runs": {
            "post": {
                "operationId": "runs-sync-yumitori-etsy-keyword-tool",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor and returns information about the initiated run in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/runsResponseSchema"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/acts/yumitori~etsy-keyword-tool/run-sync": {
            "post": {
                "operationId": "run-sync-yumitori-etsy-keyword-tool",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        }
    },
    "components": {
        "schemas": {
            "inputSchema": {
                "type": "object",
                "properties": {
                    "seeds": {
                        "title": "Seed keywords",
                        "maxItems": 50,
                        "uniqueItems": true,
                        "type": "array",
                        "description": "One or more seed keywords to research (e.g. \"ceramic mug\", \"dog bandana\"). Each seed is expanded into its long-tail keyword universe.",
                        "items": {
                            "type": "string"
                        }
                    },
                    "trendingOnly": {
                        "title": "🔥 Trending feed only (no keyword research)",
                        "type": "boolean",
                        "description": "Skip keyword expansion and just return Etsy's current popular searches, trending terms, trending products, and gift-guide themes — one row per term. For tracking what's hot. When on, the seeds above are ignored.",
                        "default": false
                    },
                    "depth": {
                        "title": "Expansion depth",
                        "minimum": 1,
                        "maximum": 3,
                        "type": "integer",
                        "description": "How many hops of autosuggest expansion. 1 = direct suggestions only; 2 = suggestions-of-suggestions (much wider). 3 explodes fast.",
                        "default": 2
                    },
                    "maxKeywords": {
                        "title": "Max keywords per seed",
                        "minimum": 5,
                        "maximum": 100,
                        "type": "integer",
                        "description": "Upper limit on keywords per seed (each is one scored row). It's a cap, not a guarantee — a seed only returns as many keywords as Etsy actually has autosuggest data for, and any keyword with no live listings is dropped, so a thin/niche seed can return fewer. A run is also hard-capped at 200 keywords total, split evenly across seeds.",
                        "default": 40
                    }
                }
            },
            "runsResponseSchema": {
                "type": "object",
                "properties": {
                    "data": {
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "string"
                            },
                            "actId": {
                                "type": "string"
                            },
                            "userId": {
                                "type": "string"
                            },
                            "startedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "finishedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "status": {
                                "type": "string",
                                "example": "READY"
                            },
                            "meta": {
                                "type": "object",
                                "properties": {
                                    "origin": {
                                        "type": "string",
                                        "example": "API"
                                    },
                                    "userAgent": {
                                        "type": "string"
                                    }
                                }
                            },
                            "stats": {
                                "type": "object",
                                "properties": {
                                    "inputBodyLen": {
                                        "type": "integer",
                                        "example": 2000
                                    },
                                    "rebootCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "restartCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "resurrectCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "computeUnits": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "options": {
                                "type": "object",
                                "properties": {
                                    "build": {
                                        "type": "string",
                                        "example": "latest"
                                    },
                                    "timeoutSecs": {
                                        "type": "integer",
                                        "example": 300
                                    },
                                    "memoryMbytes": {
                                        "type": "integer",
                                        "example": 1024
                                    },
                                    "diskMbytes": {
                                        "type": "integer",
                                        "example": 2048
                                    }
                                }
                            },
                            "buildId": {
                                "type": "string"
                            },
                            "defaultKeyValueStoreId": {
                                "type": "string"
                            },
                            "defaultDatasetId": {
                                "type": "string"
                            },
                            "defaultRequestQueueId": {
                                "type": "string"
                            },
                            "buildNumber": {
                                "type": "string",
                                "example": "1.0.0"
                            },
                            "containerUrl": {
                                "type": "string"
                            },
                            "usage": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "integer",
                                        "example": 1
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "usageTotalUsd": {
                                "type": "number",
                                "example": 0.00005
                            },
                            "usageUsd": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "number",
                                        "example": 0.00005
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```