# Pokémon Catalog Scraper (`parseforge/pokemon-catalog-scraper`) Actor Pull Pokémon catalog records: stats (HP, Attack, Defense), types, abilities, height, weight, base experience, sprites (front/back/shiny), generation, and more. Browse the full Pokédex of 1,300+ Pokémon or look up specific ones by name or number. Useful for fan apps, games. - **URL**: https://apify.com/parseforge/pokemon-catalog-scraper.md - **Developed by:** [ParseForge](https://apify.com/parseforge) (community) - **Categories:** Games, Automation, Other - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $13.00 / 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/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 ![ParseForge Banner](https://github.com/ParseForge/apify-assets/blob/ad35ccc13ddd068b9d6cba33f323962e39aed5b2/banner.jpg?raw=true) ## 🐉 Pokémon Catalog Scraper (1,300+ Pokédex) > 🚀 **Pull Pokémon stats, types, abilities, sprites, generation. Browse the full Pokédex of 1,300+ Pokémon or look up by name/ID.** > 🕒 **Last updated:** 2026-05-07 · **📊 20 fields** per record · **1,300+ Pokémon** · stats, types, abilities, sprites (front/back/shiny), generation, region · full PokéAPI catalog The **Pokémon Catalog Scraper** pulls catalog records from PokeAPI, the most comprehensive open Pokémon dataset. Output includes Pokédex number, name, types, abilities, base stats (HP, Attack, Defense, Sp.Atk, Sp.Def, Speed), height, weight, base experience, sprites (front/back/shiny/home), and the moveset. The catalog covers all **1,300+ Pokémon across 9 generations** with associated forms, regional variants, and Mega/Giga/Z evolutions. Two modes: paginate the full Pokédex, or look up specific Pokémon by name or number. Optional filter by primary type (Fire, Water, Grass, etc.). | 🎯 Target Audience | 💡 Primary Use Cases | |---|---| | Pokémon fan apps, game developers, content creators, ML training pipelines, niche-content researchers | Building Pokédex apps, fan-blog content, recommendation engines, training niche ML models, museum exhibits | --- ### 📋 What the Pokémon Catalog Scraper (1,300+ Pokédex) does Five filtering workflows in a single run: - 📖 **Full Pokédex.** All 1,300+ Pokémon across 9 generations. - 🔍 **Direct lookup.** Pass names or Pokédex numbers. - 🏷️ **Type filter.** Fire, Water, Grass, Electric, etc. - 📊 **Full stats.** HP, Attack, Defense, Sp.Atk, Sp.Def, Speed, base experience. - 🖼️ **Multi-sprite.** Front, back, shiny, home, and official artwork. > 💡 **Why it matters:** clean, server-side filtering and fresh data on every run. --- ### 🎬 Full Demo _🚧 Coming soon: a 3-minute walkthrough showing how to go from sign-up to a downloaded dataset._ --- ### ⚙️ Input
InputTypeDefaultBehavior
maxItemsinteger10Records to return. Free plan caps at 10, paid plan up to 1,000,000.
modestring"browse"browse (paginate Pokédex) or lookup (specific names/IDs).
namesstringnewline listNames or numeric IDs (lookup mode).
typestring""Type filter (Fire, Water, Grass...).
**Example: top 20 most-popular Pokémon.** ```json { "maxItems": 20, "mode": "browse" } ```` **Example: lookup specific Pokémon.** ```json { "maxItems": 5, "mode": "lookup", "names": "pikachu\ncharizard\nmewtwo" } ``` *** ### 📊 Output Each record contains **20 fields**. Download as CSV, Excel, JSON, or XML. #### 🧾 Schema | Field | Type | Example | |---|---|---| | 🖼️ `spriteFront` | string | `"https://raw.githubusercontent.com/.../pikachu.png"` | | 🆔 `id` | number | `25` | | 📛 `name` | string | `"pikachu"` | | 🏷️ `typesText` | string | `"electric"` | | 🏷️ `types` | array | `["electric"]` | | ⚡ `hp` | number | `35` | | ⚔️ `attack` | number | `55` | | 🛡️ `defense` | number | `40` | | 💥 `specialAttack` | number | `50` | | 🛡️ `specialDefense` | number | `50` | | 💨 `speed` | number | `90` | | 📐 `heightDecimeters` | number | `4` | | ⚖️ `weightHectograms` | number | `60` | | ✨ `abilitiesText` | string | `"static, lightning-rod"` | #### 📦 Sample records
⚡ Pikachu ```json {"id":25,"name":"pikachu","types":["electric"],"hp":35,"attack":55,"defense":40,"specialAttack":50,"specialDefense":50,"speed":90,"abilitiesText":"static, lightning-rod"} ```
🔥 Charizard ```json {"id":6,"name":"charizard","types":["fire","flying"],"hp":78,"attack":84,"defense":78,"specialAttack":109,"specialDefense":85,"speed":100} ```
*** ### ✨ Why choose this Actor | | Capability | |---|---| | 📚 | **All 1,300+ Pokémon.** Across 9 generations including Paldea Pokémon. | | 🏷️ | **Type filter.** Fire, Water, Grass, Electric — every primary type. | | 📊 | **Full stat block.** HP, Attack, Defense, Sp.Atk, Sp.Def, Speed. | | 🖼️ | **Multi-sprite.** Front, back, shiny, home, official artwork. | | ⚡ | **Fast.** 100 Pokémon in under 30 seconds. | *** ### 📈 How it compares to alternatives | Approach | Cost | Coverage | Refresh | Filters | Setup | |---|---|---|---|---|---| | **⭐ This Actor** | $5 free credit | **1,300+** Pokémon | Live per run | mode, names, type | ⚡ 2 min | | Manual Pokémon DB scraping | Free | All | Live | DIY | 🐢 Days | | Bulbapedia / Serebii | Free | Curated | Variable | Manual | 🕒 Manual | | Pokemon Showdown JSON | Free | Battle-data | Live | Limited | 🐢 Custom | *** ### 🚀 How to use 1. 📝 **Sign up.** [Create a free account with $5 credit](https://console.apify.com/sign-up?fpr=vmoqkp) (takes 2 minutes). 2. 🌐 **Open the Actor.** Find the Pokémon Catalog Scraper (1,300+ Pokédex) on the Apify Store. 3. 🎯 **Set input.** Pick filters and `maxItems`. 4. 🚀 **Run it.** Click **Start**. 5. 📥 **Download.** Grab results in the **Dataset** tab as CSV, Excel, JSON, or XML. > ⏱️ Total time from signup to dataset: **3-5 minutes.** No coding required. *** ### 💼 Business use cases
#### 🎮 Game Apps - Pokédex apps - Battle simulators - Team-builder tools - Fan-game datasets #### 📰 Content + Fan Sites - Pokémon-of-the-day content - Stat-comparison articles - Ranked best-of lists - Community newsletters
#### 🤖 ML + Research - Train Pokémon classifiers - Build battle-prediction features - Pokémon-style image generation - Cross-game data analysis #### 🎓 Education + Niche - Trivia games - Stat-charting apps - Hobbyist data exploration - Educational gamification
*** ### 🔌 Automating Pokémon Catalog Scraper (1,300+ Pokédex) Control the scraper programmatically: - 🟢 **Node.js.** Install the `apify-client` NPM package. - 🐍 **Python.** Use the `apify-client` PyPI package. - 📚 See the [Apify API documentation](https://docs.apify.com/api/v2) for full details. The [Apify Schedules feature](https://docs.apify.com/platform/schedules) lets you trigger this Actor on any cron interval. *** ### 🌟 Beyond business use cases Data like this powers more than commercial workflows.
#### 🎓 Research and academia - Game-design research - Reproducible Pokédex snapshots - Course materials - Niche-fandom analysis #### 🎨 Personal and creative - Personal Pokémon dashboards - Fan apps - Pokémon-themed newsletters - Hobbyist databases
#### 🤝 Non-profit and civic - Educational gamification - Community outreach - Open metadata contributions - Niche-language preservation #### 🧪 Experimentation - Train classifiers on metadata - Prototype Pokémon-aware agents - Build battle simulators - Test game ML libraries
*** ### 🤖 Ask an AI assistant about this scraper Open a ready-to-send prompt in the AI of your choice: - 💬 [**ChatGPT**](https://chat.openai.com/?q=How%20do%20I%20use%20the%20Pok%C3%A9mon%20Catalog%20Scraper%20by%20ParseForge%20on%20Apify%3F%20Show%20me%20input%20examples%2C%20output%20fields%2C%20common%20use%20cases%2C%20and%20how%20to%20integrate%20it%20into%20a%20workflow.) - 🧠 [**Claude**](https://claude.ai/new?q=How%20do%20I%20use%20the%20Pok%C3%A9mon%20Catalog%20Scraper%20by%20ParseForge%20on%20Apify%3F%20Show%20me%20input%20examples%2C%20output%20fields%2C%20common%20use%20cases%2C%20and%20how%20to%20integrate%20it%20into%20a%20workflow.) - 🔍 [**Perplexity**](https://perplexity.ai/search?q=How%20do%20I%20use%20the%20Pok%C3%A9mon%20Catalog%20Scraper%20by%20ParseForge%20on%20Apify%3F%20Show%20me%20input%20examples%2C%20output%20fields%2C%20common%20use%20cases%2C%20and%20how%20to%20integrate%20it%20into%20a%20workflow.) - 🅒 [**Copilot**](https://copilot.microsoft.com/?q=How%20do%20I%20use%20the%20Pok%C3%A9mon%20Catalog%20Scraper%20by%20ParseForge%20on%20Apify%3F%20Show%20me%20input%20examples%2C%20output%20fields%2C%20common%20use%20cases%2C%20and%20how%20to%20integrate%20it%20into%20a%20workflow.) *** ### ❓ Frequently Asked Questions #### 🧩 How does it work? Pick browse mode (paginate the Pokédex) or lookup mode (provide names/IDs). The Actor calls PokéAPI and emits one record per Pokémon. #### 📊 How many fields per record? 20, including Pokédex number, name, types, abilities, six base stats, height, weight, base experience, and four sprite URLs. #### 🏷️ How does the type filter work? In browse mode, the type filter switches the source endpoint to PokéAPI's per-type list. In lookup mode, it filters results client-side. #### 🖼️ What sprites are returned? Default front/back, shiny variants, home (3D), and official artwork (high-res). #### 📅 Are regional/Mega/Giga forms included? Yes. PokéAPI assigns separate IDs to forms (e.g. Mega Charizard X has its own record). #### 🔁 Can I schedule runs? Yes. PokéAPI is updated as new Pokémon are released. #### ⚖️ Is this data free? Yes. PokéAPI is open source under BSD. Pokémon, names, and sprites are trademarks of The Pokémon Company; only public-API metadata is collected. #### 💳 Do I need a paid Apify plan? No. The free plan covers preview runs. #### 🆘 What if a run fails? Apify retries transient errors. #### ⚔️ Are moves included? First 30 move names per Pokémon (truncated for size). Full move data available via lookup of moves endpoint (not exposed in this Actor). *** ### 🔌 Integrate with any app Pokémon Catalog Scraper (1,300+ Pokédex) connects to any cloud service via [Apify integrations](https://apify.com/integrations): - [**Make**](https://docs.apify.com/platform/integrations/make) - Automate multi-step workflows - [**Zapier**](https://docs.apify.com/platform/integrations/zapier) - Connect with 5,000+ apps - [**Slack**](https://docs.apify.com/platform/integrations/slack) - Get run notifications - [**Airbyte**](https://docs.apify.com/platform/integrations/airbyte) - Pipe data into your warehouse - [**GitHub**](https://docs.apify.com/platform/integrations/github) - Trigger runs from commits - [**Google Drive**](https://docs.apify.com/platform/integrations/drive) - Export datasets to Sheets *** ### 🔗 Recommended Actors - [**🎌 AniList Anime/Manga**](https://apify.com/parseforge/anilist-anime-manga-scraper) - Search anime, manga, light novels - [**🎬 TVMaze TV Shows**](https://apify.com/parseforge/tvmaze-shows-scraper) - TV show metadata and episodes - [**🎙️ iTunes Podcast Search**](https://apify.com/parseforge/itunes-podcast-search-scraper) - Apple Podcasts catalog - [**💻 VS Code Marketplace**](https://apify.com/parseforge/vs-code-marketplace-scraper) - VS Code extensions catalog - [**📰 Hacker News Search**](https://apify.com/parseforge/hackernews-algolia-scraper) - Every HN story since 2007 > 💡 **Pro Tip:** browse the complete [ParseForge collection](https://apify.com/parseforge) for more reference-data scrapers. *** **🆘 Need Help?** [**Open our contact form**](https://tally.so/r/BzdKgA) to request a new scraper, propose a custom data project, or report an issue. *** > **⚠️ Disclaimer:** this Actor is an independent tool and is not affiliated with, endorsed by, or sponsored by The Pokémon Company, Nintendo, Game Freak, Creatures Inc., or PokéAPI. All trademarks mentioned are the property of their respective owners. Only publicly available open data is collected. # Actor input Schema ## `maxItems` (type: `integer`): Free users: Limited to 10 items (preview). Paid users: Optional, max 1,300 ## `mode` (type: `string`): browse = paginate the Pokédex, lookup = pull specific Pokémon by name/id. ## `names` (type: `string`): Names or numeric IDs, one per line or semicolon-separated. ## `type` (type: `string`): Filter by primary or secondary type. ## Actor input object example ```json { "maxItems": 10, "mode": "browse", "names": "pikachu\ncharizard\nmewtwo\neevee\nbulbasaur", "type": "" } ``` # Actor output Schema ## `overview` (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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "maxItems": 10, "mode": "browse", "names": `pikachu charizard mewtwo eevee bulbasaur`, "type": "" }; // Run the Actor and wait for it to finish const run = await client.actor("parseforge/pokemon-catalog-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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "maxItems": 10, "mode": "browse", "names": """pikachu charizard mewtwo eevee bulbasaur""", "type": "", } # Run the Actor and wait for it to finish run = client.actor("parseforge/pokemon-catalog-scraper").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 '{ "maxItems": 10, "mode": "browse", "names": "pikachu\\ncharizard\\nmewtwo\\neevee\\nbulbasaur", "type": "" }' | apify call parseforge/pokemon-catalog-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=parseforge/pokemon-catalog-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Pokémon Catalog Scraper", "description": "Pull Pokémon catalog records: stats (HP, Attack, Defense), types, abilities, height, weight, base experience, sprites (front/back/shiny), generation, and more. Browse the full Pokédex of 1,300+ Pokémon or look up specific ones by name or number. Useful for fan apps, games.", "version": "1.0", "x-build-id": "Qsr3UlR14gYFBkLcP" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/parseforge~pokemon-catalog-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-parseforge-pokemon-catalog-scraper", "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/parseforge~pokemon-catalog-scraper/runs": { "post": { "operationId": "runs-sync-parseforge-pokemon-catalog-scraper", "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/parseforge~pokemon-catalog-scraper/run-sync": { "post": { "operationId": "run-sync-parseforge-pokemon-catalog-scraper", "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": { "maxItems": { "title": "Max Items", "minimum": 1, "maximum": 1300, "type": "integer", "description": "Free users: Limited to 10 items (preview). Paid users: Optional, max 1,300" }, "mode": { "title": "Mode", "enum": [ "browse", "lookup" ], "type": "string", "description": "browse = paginate the Pokédex, lookup = pull specific Pokémon by name/id.", "default": "browse" }, "names": { "title": "Pokémon names or IDs (lookup mode)", "type": "string", "description": "Names or numeric IDs, one per line or semicolon-separated." }, "type": { "title": "Type filter", "enum": [ "", "normal", "fire", "water", "grass", "electric", "ice", "fighting", "poison", "ground", "flying", "psychic", "bug", "rock", "ghost", "dragon", "dark", "steel", "fairy" ], "type": "string", "description": "Filter by primary or secondary type.", "default": "" } } }, "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 } } } } } } } } } } ```