# KDP Category Picker: 3 Best Winnable Book Categories (`vncntlabs/kdp-category-finder`) Actor

Pick accurate KDP categories you can win. Finds the Amazon categories similar books use, maps each to its KDP picker path, reads #1 and #10 BSR, and leads with your 3 best. Snapshot plus confirm mode. No AI.

- **URL**: https://apify.com/vncntlabs/kdp-category-finder.md
- **Developed by:** [VNCNT Labs](https://apify.com/vncntlabs) (community)
- **Categories:** E-commerce, SEO tools, MCP servers
- **Features:** Limited permissions
- **Stats:** 1 total users, 0 monthly users, 0.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

$150.00 / 1,000 category reports

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/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## 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.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## KDP Category Picker: your 3 best winnable, relevant book categories

KDP lets you pick **3 categories** for each book, and the orange **Best Seller** badge goes to #1 in a category.
Picking is guesswork: the same Best Sellers Rank (BSR) can make a book #2 in one category and #86 in another. This
Actor answers the question you actually have when KDP's category picker is open:

> **Which 3 categories should I pick, and how many of them can I win?**

Give it a niche keyword (or a few comparable books). It reads the books that already sell in that niche, collects
every category they sit in, maps each one to its **full category path** (the same Amazon tree that KDP's picker shows
for amazon.com), reads each relevant category's Best Sellers chart for the **BSR of its #1 and #10 books**, and
leads with **your 3 best accurate, winnable categories**: path, #1 and #10 BSR, your BSR, a label and a one-line reason.

**Pick accurate categories you can win, never game them.** The tool only recommends categories that at least 2 of the
similar books already use (you can change that number), and it never suggests unrelated categories. KDP removes
misleading categories, and a book in the wrong category doesn't reach its readers even if it ranks.

No AI and no guessing. Every number is a BSR read from Amazon at `readAt`.

### What you get

1. **Top 3 first**: for each pick, the category path to click in KDP, the #1 and #10 BSR, your BSR (or the niche's
   median book), where you'd land ("about #3"), a label and a reason:
   - `badge within reach`: your BSR beats the current #1, so you'd hold the Best Seller badge
   - `top 10 within reach`: you'd be in the top 10
   - `out of reach`: you'd be below #10 today
2. **The full table** after it: every category seen on the similar books, how many of them sit there, each observed
   point ("a book at BSR 62,812 is #2 here"), the path and chart link.
3. **Honest labels for what can't be picked**: a category that doesn't map to the Amazon category tree is labelled
   *observed on Amazon, may not be selectable in KDP* and is never recommended. A parent category is labelled too
   (KDP lists its subcategories).
4. **Snapshot honesty**: category #1s move hour to hour. Every report shows its read time and calls itself a snapshot.
   Use **confirm mode** to see the range over several days.

### Input

| Field | What it does |
| --- | --- |
| `keyword` | Your niche as a reader would search Amazon Books ("gardening journal", "dinosaur picture book") |
| `comparableBooks` | Or up to 5 ASINs / ISBN-10s / links of books like yours (used when `keyword` is empty) |
| `yourBook` | Optional: your ASIN; its current BSR makes the labels personal |
| `yourBsr` | Optional: the BSR you have or expect (e.g. 60000). Without it, labels use the niche's median book |
| `minBooksInCategory` | Relevance gate, default 2: a category is only recommended when this many similar books sit in it |
| `maxBooks` | Similar books to read, default 12 (3-20) |
| `maxCategories` | Relevant categories whose chart is read, default 6 (1-10) |
| `trackName` | Confirm mode: name this report and schedule it daily (see below) |
| `fast` | Priority provider queue, about 2x faster; capped at 12 books and 6 categories |

```json
{ "keyword": "gardening journal", "yourBsr": 60000 }
```

### Output

Real data read on 18 Nov 2026 for `{"keyword": "gardening journal", "yourBsr": 60000}` (shortened; picks in the order this version ranks them):

```json
{
  "type": "summary", "keyword": "gardening journal", "readAt": "2026-11-18T15:31:00Z", "snapshot": true,
  "referenceBsr": 60000, "referenceIs": "your book",
  "top3": [
    { "pick": 1, "path": "Books > Crafts, Hobbies & Home > Gardening & Landscape Design > By Technique > Propagation & Cultivation",
      "bsrFor1": 96, "bsrFor10": 123253, "estimatedRank": 6, "label": "top 10 within reach", "booksInNiche": 2,
      "reason": "2 of the niche's books sit here; #1 is BSR 96; #10 is BSR 123,253; your book (BSR 60,000) would be about #6." },
    { "pick": 2, "path": "Books > Crafts, Hobbies & Home > Gardening & Landscape Design > Vegetables",
      "bsrFor1": 1249, "bsrFor10": 20568, "estimatedRank": 47, "label": "out of reach", "booksInNiche": 3 },
    { "pick": 3, "path": "Books > Crafts, Hobbies & Home > Gardening & Landscape Design > Reference",
      "bsrFor1": 538, "bsrFor10": 10747, "estimatedRank": 58, "label": "out of reach", "booksInNiche": 5 }
  ],
  "booksRead": 12, "categoriesObserved": 19, "categoriesMapped": 19, "categoriesChecked": 6, "charged": true
}
```

A category row from the full table, for comparison: *Guided Journals* (Books > Crafts, Hobbies & Home > Crafts &
Hobbies > Guided Journals), #1 at BSR 670, #10 at BSR 2,632: the same BSR 60,000 lands at about #126 there.
Single-book categories such as *Shrub Gardening* (one niche book is #2 there at BSR 62,812) appear in the table but
are not recommended until at least 2 similar books use them.

The dataset leads with one `summary` row, then the `pick` rows (1-3), then every other `category` row. The same
report, with the full table, is saved as `OUTPUT` in the run's key-value store.

### Confirm mode: is that #1 BSR stable? (schedule guide)

One read is a snapshot. To see each category's range before you commit:

1. Run once with your input plus `"trackName": "garden-journal"` (any lowercase name).
2. In Apify Console open **Schedules → Create new**, pick this Actor, paste the same input, and set it to run
   **daily** (for example at 9:00 AM) for **3 to 7 days**. Keep `trackName` the same on every run.
3. Each run adds its read to a named key-value store (`kdp-category-picker-<trackName>`) and every category gets
   `bsrFor1Range` (min, max, reads, days covered). After **3 reads over at least 2 days** a category is `confirmed`
   and its label uses the **strongest #1 seen**, so "badge within reach" means within reach on the hardest day.
4. Delete the schedule when you're done. Each scheduled run is one report.

### Pricing

**$0.15 per report** (pay per event `category-report`), no start fee. You're only charged when at least one
category's bar (#1 BSR) was read. Not charged: no books found, no Best Sellers Rank data, no category could be mapped
and checked, provider errors. The Apify free plan gets up to 12 books and 6 categories per report.

### How it works

- **Similar books**: the top organic Amazon Books results for your keyword (DataForSEO's licensed Amazon API), or your
  comparable books. Each book page gives its BSR and the categories it ranks in.
- **Category path**: each category name is matched to Amazon's public Best Sellers category tree (a bundled index of
  the tree, plus live chart pages for deeper nodes) and verified against that chart's own title. KDP's category picker
  mirrors this tree for amazon.com ("choose categories that match the Amazon Store", KDP, 2023). Some categories
  aren't offered for every format, so confirm in KDP.
- **The bar**: each relevant category's public Best Sellers chart gives its #1 and #10 books; their BSR comes from
  their product pages. Your landing rank is interpolated (log-log) between the points actually seen in that category.
- Runtime: about 3-5 minutes on the standard queue (`fast` is quicker).

### Limits

- amazon.com, print books (Books department). Kindle Store categories show up as not mapped in this version.
- BSR moves hourly; a snapshot is not a forecast. No sales or royalty estimates.
- The tool doesn't place your book anywhere. You choose categories in KDP.

### Related

- [Amazon Book & T-Shirt Niche Analyzer](https://apify.com/vncntlabs/amazon-book-tshirt-niche-analyzer): is the niche
  worth it? Demand, competition, prices, self-published share and a trademark screen. Use it first, then this Actor
  to pick the categories.
- [Amazon Best Sellers Scraper](https://apify.com/vncntlabs/amazon-best-sellers): the raw charts, any category.

Not affiliated with or endorsed by Amazon or Kindle Direct Publishing. Product data via DataForSEO's licensed APIs.

# Actor input Schema

## `keyword` (type: `string`):

What your book is, the way a reader would search for it on Amazon Books (e.g. "gardening journal", "dinosaur picture book", "password log book"). The tool reads the top books for it and uses the categories they already sit in. Leave empty to use Comparable books instead.

## `comparableBooks` (type: `array`):

Up to 5 ASINs, ISBN-10s or Amazon book links of books like yours. Used only when Niche keyword is empty.

## `yourBook` (type: `string`):

Your ASIN, ISBN-10 or Amazon link. Its current Best Sellers Rank makes the labels personal ("at your BSR you'd be about #3 here").

## `yourBsr` (type: `integer`):

Or type the BSR you have or expect (e.g. 60000). Overrides Your book's rank. Without either, labels use the median book in the niche.

## `minBooksInCategory` (type: `integer`):

A category is only recommended when at least this many of the similar books sit in it. Default 2. Unrelated categories are never suggested.

## `maxBooks` (type: `integer`):

Top organic Amazon Books results read for categories. Default 12, max 20.

## `maxCategories` (type: `integer`):

How many relevant categories get their Best Sellers chart read (#1 and #10 BSR). Default 6, max 10.

## `trackName` (type: `string`):

Give this report a name (e.g. "garden-journal") and schedule the same input daily for 3-7 days. Each run adds its read to a named store and the report shows each category's #1 BSR range. After 3 reads over 2+ days the label uses the strongest #1 seen. Each run is one report.

## `fast` (type: `boolean`):

About 2x faster provider queue. Capped at 12 books and 6 categories. Same price.

## Actor input object example

```json
{
  "keyword": "gardening journal",
  "minBooksInCategory": 2,
  "maxBooks": 12,
  "maxCategories": 6,
  "fast": false
}
```

# Actor output Schema

## `report` (type: `string`):

No description

## `summary` (type: `string`):

No description

# 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 = {
    "keyword": "gardening journal"
};

// Run the Actor and wait for it to finish
const run = await client.actor("vncntlabs/kdp-category-finder").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 = { "keyword": "gardening journal" }

# Run the Actor and wait for it to finish
run = client.actor("vncntlabs/kdp-category-finder").call(run_input=run_input)

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

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

```

## CLI example

```bash
echo '{
  "keyword": "gardening journal"
}' |
apify call vncntlabs/kdp-category-finder --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,vncntlabs/kdp-category-finder"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/O4VKTperXpBQfcl3A/builds/u2oeIdsNKsidby3zt/openapi.json
