# TCGplayer Pokemon Card Scraper (`parseforge/tcgplayer-scraper`) Actor

Scrape TCGplayer Pokemon card listings by search query, set, rarity, or card type. Returns card name, set, rarity, market price, and product URL. No API key required.

- **URL**: https://apify.com/parseforge/tcgplayer-scraper.md
- **Developed by:** [ParseForge](https://apify.com/parseforge) (community)
- **Categories:** E-commerce, Automation, Developer tools
- **Stats:** 36 total users, 3 monthly users, 100.0% runs succeeded, 1 bookmarks
- **User rating**: 3.00 out of 5 stars

## Pricing

from $23.99 / 1,000 result items

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

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

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — 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

[![ParseForge](https://raw.githubusercontent.com/ParseForge/apify-assets/main/banner.jpg)](https://apify.com/parseforge?fpr=vmoqkp)

### TCGplayer Pokemon Card Scraper

**Scrape TCGplayer Pokemon card data by search, set, rarity, or card type, up to a million products per run.** Every card comes with its name, set, rarity, market price, and product URL. No API key or login required. Export to CSV, JSON, Excel, or XML.

TCGplayer's official API requires a merchant account and rate limits you. This Actor reads the public product listings directly, filtered by set, rarity, or card type, and returns each match in one fixed schema. No registration, no tokens, no hassle.

| Who uses it | What they scrape TCGplayer for |
|---|---|
| Pokemon TCG collectors | Track market prices for specific cards across sets and rarities. |
| Investors and flippers | Identify undervalued cards by comparing prices across multiple sets. |
| Deck builders | Find the cheapest listings for competitive staples like Charizard VMAX or Pikachu. |
| Content creators | Build price databases for YouTube or blog price-check videos. |

### What it does

This Actor collects TCGplayer Pokemon card listings by search query, set name, rarity, or card type, and returns each product as a flat row with its name, set, rarity, market price, and direct product URL.

- 🔍 **Search by card name:** Enter any Pokemon card name and get all matching listings.
- 📦 **Filter by set:** Narrow results to a specific TCG set like Celebrations or Scarlet & Violet.
- ⭐ **Filter by rarity:** Choose from common, uncommon, rare, holographic, and more.
- 🃏 **Filter by card type:** Limit to Pokemon, Trainer, Energy, Supporter, Item, Tool, or Stadium cards.

Results export to CSV, JSON, Excel, or XML, or straight from the API.

### What you can do with TCGplayer data

**📈 Track Pokemon card market trends.**

A collector runs weekly searches for Charizard VMAX across all sets to see price movements and decide when to buy.

**💰 Find arbitrage opportunities.**

An investor searches for Pikachu cards filtered by rarity to spot underpriced listings compared to market average.

**🛒 Build a price database for your store.**

A TCG store owner scrapes entire sets like Scarlet & Violet to populate their own pricing tool with current market data.

**📊 Research set completion costs.**

A completionist scrapes all cards from a set like Celebrations to calculate the total cost of finishing their collection.

### Why choose this scraper

|  | What you get |
|---|---|
| **No API key** | Scrape TCGplayer without registering for an API or merchant account. |
| **Real-time market data** | Get current prices directly from TCGplayer's public listings. |
| **Structured output** | Every card is a flat row with name, set, rarity, price, and URL. |
| **Flexible filters** | Narrow by set, rarity, or card type to get exactly the cards you need. |

### How it compares

This Actor is built specifically for Pokemon TCG cards on TCGplayer, while the competitors below cover broader TCGs or use a different data source.

| Feature | ParseForge | TCGplayer Data Scraper | TCGPlayer Pricing Scraper - tcgcsv.com API Wrapper |
|---|---|---|---|
| Pokemon-specific filters (rarity, card type) | Yes | Not listed | Not listed |
| No API key required | Yes | Yes | Not listed |
| Search by card name | Yes | Not listed | Not listed |
| Filter by set name | Yes | Not listed | Not listed |
| Export to CSV, JSON, Excel, XML | Yes | Yes | Not listed |
| Covers non-Pokemon TCGs | Not listed | Not listed | Yes |

### Configure the run

Drive the Actor from a card name, set name, rarity list, or card type, alone or together, and filters run as each product is read so only matches reach your dataset. The Input tab lists every parameter.

A first run with the defaults:

```json
{
  "searchQuery": "Pikachu",
  "maxItems": 10
}
```

A larger pull:

```json
{
  "searchQuery": "Pikachu",
  "maxItems": 200
}
```

### Pricing

Pay-per-result: **$0.03199 per result** collected. You pay only for the results written to your dataset.

| Results collected | Approximate cost |
|---|---|
| 100 results | $3.20 |
| 1,000 results | $31.99 |
| 10,000 results | $319.90 |

New Apify accounts start with $5 in free credit.

### Free users

Free-plan runs return up to 10 results as a preview. [Upgrade your Apify plan](https://console.apify.com/sign-up?fpr=vmoqkp) to collect up to 1,000,000 results per run.

### Run it

1. [Create a free Apify account with $5 in credit](https://console.apify.com/sign-up?fpr=vmoqkp).
2. Open the [TCGplayer Pokemon Card Scraper](https://apify.com/parseforge/tcgplayer-scraper?fpr=vmoqkp).
3. Set your inputs and any filters, then click **Start**.
4. Export the results as CSV, Excel, JSON, or XML from the **Dataset** tab.

Run it programmatically through the [Apify API](https://docs.apify.com/api/v2) (`run-sync-get-dataset-items`) or the [ApifyClient](https://docs.apify.com/api/client/js) for JavaScript and Python.

### Use with AI agents (MCP)

Give an AI agent live access to TCGplayer through the Model Context Protocol. Add the Actor to Claude, Cursor, or any MCP client:

```bash
claude mcp add --transport http apify "https://mcp.apify.com/?tools=parseforge/tcgplayer-scraper"
```

Then prompt it in plain language to run the scraper and read back the results.

### Troubleshooting

**Why am I getting no results?**

Check that your search query is spelled correctly and matches a card name on TCGplayer. Also verify that your set name or rarity filter is valid for that card.

**The Actor returns fewer cards than I expected.**

TCGplayer may not list every variant of a card. Try broadening your search query or removing filters to see more results.

**Can I scrape all cards from a set at once?**

Yes, leave the search query empty and enter only the set name. The Actor will return all cards from that set.

**The price field is empty for some cards.**

Some cards may not have active listings on TCGplayer at the time of scraping. Try running the scrape again later.

**I see duplicate card entries.**

TCGplayer may list the same card from multiple sellers. Each listing is a separate product row. You can deduplicate by card name in your export.

### FAQ

| Question | Answer |
|---|---|
| Do I need a TCGplayer API key? | No. This Actor scrapes public product listings directly from TCGplayer's website. No registration or API key required. |
| Can I scrape cards from a specific set? | Yes. Use the Set Name filter to enter a set like 'Celebrations' or 'Scarlet & Violet' and only cards from that set will be returned. |
| What card types can I filter by? | You can filter by Pokemon, Trainer, Energy, Supporter, Item, Tool, or Stadium cards. |
| How many cards can I scrape per run? | You can set a maximum up to 1,000,000 products per run. The default is 10. |
| What data does each card row include? | Each row includes the card name, set name, rarity, market price, and a direct product URL to TCGplayer. |
| Can I scrape non-Pokemon TCG cards? | This Actor is built for Pokemon TCG cards on TCGplayer. For other TCGs, consider a different scraper. |
| Is the price data real-time? | Prices come from TCGplayer's public listings at the time of scraping. They reflect current market listings, not historical averages. |
| What export formats are supported? | You can export your data as CSV, JSON, Excel, or XML. |
| Can I scrape by rarity only? | Yes. Use the Rarity Filter to select one or more rarities like Rare, Holo, or Reverse Holo. |
| Does this work for Japanese Pokemon cards? | TCGplayer primarily lists English-language cards. Japanese cards may not appear in search results. |

### Related actors

Browse the full [ParseForge collection](https://apify.com/parseforge?fpr=vmoqkp) for more scrapers.

🆘 **Need help?** Email parseforge@protonmail.com with your run ID, your input, and what you expected.

⚠️ **Disclaimer.** This Actor is unofficial and is not affiliated with, endorsed by, or sponsored by TCGplayer, Inc. It collects only publicly available data. You are responsible for using the collected data in compliance with the source's terms of service and applicable data-protection laws, including GDPR, CCPA, and PIPL. Do not use it to collect personal data unlawfully.

# Actor input Schema

## `searchQuery` (type: `string`):

Search for specific Pokemon cards by name (e.g., 'Pikachu', 'Charizard VMAX')

## `maxItems` (type: `integer`):

How many card products to collect per run.

## `setName` (type: `string`):

Filter cards by Pokemon TCG set name (e.g., 'Celebrations', 'Scarlet & Violet')

## `rarityFilter` (type: `array`):

Filter cards by rarity levels

## `cardType` (type: `string`):

Filter by card type

## Actor input object example

```json
{
  "searchQuery": "Pikachu",
  "maxItems": 10
}
```

# Actor output Schema

## `results` (type: `string`):

Dataset with scraped Pokemon card data

# 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 = {
    "searchQuery": "Pikachu",
    "maxItems": 10
};

// Run the Actor and wait for it to finish
const run = await client.actor("parseforge/tcgplayer-scraper").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 = {
    "searchQuery": "Pikachu",
    "maxItems": 10,
}

# Run the Actor and wait for it to finish
run = client.actor("parseforge/tcgplayer-scraper").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 '{
  "searchQuery": "Pikachu",
  "maxItems": 10
}' |
apify call parseforge/tcgplayer-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,parseforge/tcgplayer-scraper"
        }
    }
}

```

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/yv6NR80h0SwLZw1HV/builds/Szv3imqKKZugh4ZA1/openapi.json