# Magic Eden NFT Collection Scraper (`parseforge/magic-eden-nft-scraper`) Actor Scrape Solana NFT collections from Magic Eden public API. Returns collection metadata, social links, floor price, listed count, 24h avg price, total volume, and (optional) per-collection active listings. No API key required. - **URL**: https://apify.com/parseforge/magic-eden-nft-scraper.md - **Developed by:** [ParseForge](https://apify.com/parseforge) (community) - **Categories:** Business, Developer tools, Automation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $23.63 / 1,000 results 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/raw/main/banner.jpg) ## ๐Ÿช Magic Eden NFT Collection Scraper > ๐Ÿš€ **Export every Magic Eden Solana collection in seconds.** Pull collection metadata, social links, **floor price, listed count, 24h average price, all-time volume**, plus (optionally) the first 20 active listings per collection. No API key, no wallet, no manual paging. > ๐Ÿ•’ **Last updated:** 2026-05-13 ยท **๐Ÿ“Š 12 base fields + 4 stats + N listings** per collection ยท **๐Ÿช Solana NFTs** ยท **๐Ÿ›’ Magic Eden marketplace** The **Magic Eden NFT Collection Scraper** queries Magic Eden's public mainnet API (`api-mainnet.magiceden.io/v2`) to return collection-level records for the Solana NFT marketplace. Each record carries the collection symbol, name, image, description, optional Twitter/Discord/website, categories, badge and compressed-NFT flags, and (when enrichment is on) the floor price, listed count, 24h average price, and all-time volume in SOL. A separate toggle pulls the first 20 active listings per collection with tokenMint, seller, price in SOL, optional name, image, and expiry. The Solana side of Magic Eden lists thousands of collections across art, gaming, PFPs, music, and metaverse categories. This Actor paginates the collections feed for you, slices to `maxItems`, and enriches each collection with 10-way concurrent stat lookups so a 100-collection run completes in under a minute. Download CSV, Excel, JSON, or XML. | ๐ŸŽฏ Target Audience | ๐Ÿ’ก Primary Use Cases | |---|---| | NFT analysts, Solana ecosystem researchers, traders, alpha groups, market-data engineers, dapp developers, content creators | Floor-price tracking, listing watchers, collection discovery, marketplace dashboards, alpha alerts, holder/listing snapshots, dApp integrations | --- ### ๐Ÿ“‹ What the Magic Eden NFT Scraper does Three workflows in one run: - ๐Ÿช **Browse the feed.** Page through the global Magic Eden collections feed and slice to `maxItems`. - ๐ŸŽฏ **Lookup by symbol.** Drop in a single Magic Eden symbol (e.g. `degods`, `okay_bears`) for a one-collection scrape. - ๐Ÿ“Š **Stats enrichment.** Optional toggle adds floor price (SOL), listed count, 24h average price (SOL), and all-time volume (SOL). - ๐Ÿ›’ **Listings enrichment.** Optional toggle adds the first 20 active listings per collection with tokenMint, seller, price in SOL, and (when present) name, image, and expiry. Every collection record carries the marketplace URL (`https://magiceden.io/marketplace/{symbol}`), so you can drop straight into the live listing page. > ๐Ÿ’ก **Why it matters:** the NFT market moves on floor prices and listings. Manually polling Magic Eden via the web app is fragile. This Actor returns one clean record per collection with everything an alpha tracker, marketplace dashboard, or dApp integration needs. --- ### ๐ŸŽฌ Full Demo _๐Ÿšง Coming soon: a 3-minute walkthrough showing how to pull the top 100 collections, sort by all-time volume, and drop the data into Sheets._ --- ### โš™๏ธ Input
InputTypeDefaultBehavior
searchSymbolstring""Magic Eden collection symbol (e.g. degods, okay_bears). Leave empty to page the global feed.
maxItemsinteger10Records to return. Free plan caps at 10, paid plan at 1,000,000.
fetchStatsbooleantrueAdds floor price, listed count, 24h avg price, all-time volume (in SOL).
fetchListingsbooleanfalseAdds the first 20 active listings per collection (tokenMint, seller, price SOL, name, image, expiry).
**Example: top 100 collections with stats only.** ```json { "maxItems": 100, "fetchStats": true, "fetchListings": false } ```` **Example: single collection with stats + active listings.** ```json { "searchSymbol": "degods", "maxItems": 1, "fetchStats": true, "fetchListings": true } ``` > โš ๏ธ **Good to Know:** stats and listings come from separate per-collection endpoints. The Actor runs 10 concurrent workers; 100 collections with stats complete in roughly 60 seconds. Lamports are converted to SOL (divided by 1,000,000,000) so every price field is human-readable. *** ### ๐Ÿ“Š Output Each collection record contains up to **12 base fields + 4 stats fields + N listing objects**. Download as CSV, Excel, JSON, or XML. #### ๐Ÿงพ Schema | Field | Type | Example | |---|---|---| | ๐Ÿ–ผ๏ธ `image` | string | null | `"https://www.haxz.xyz/shards/kernel-large.webp"` | | ๐Ÿ†” `symbol` | string | `"haxz_shards"` | | ๐Ÿท๏ธ `name` | string | `"HAXZ Shards"` | | ๐Ÿ”— `url` | string | `"https://magiceden.io/marketplace/haxz_shards"` | | ๐Ÿ“ `description` | string | null | `"HAXZ Shards. 3,333 fragments..."` | | ๐Ÿฆ `twitter` | string (optional) | `"https://www.twitter.com/..."` | | ๐Ÿ’ฌ `discord` | string (optional) | `"https://discord.gg/..."` | | ๐ŸŒ `website` | string (optional) | `"https://example.xyz"` | | ๐Ÿท๏ธ `categories` | string\[] (optional) | `["pfps"]` | | ๐Ÿ… `isBadged` | boolean | null | `false` | | ๐ŸŒฑ `hasCNFTs` | boolean | null | `false` | | ๐Ÿ’Ž `floorPriceSol` | number | null | `0.0988` | | ๐Ÿ›’ `listedCount` | number | null | `11` | | ๐Ÿ“ˆ `avgPrice24hSol` | number | null | `0.065` | | ๐Ÿ“Š `volumeAllSol` | number | null | `0.065` | | ๐Ÿ›’ `listings` | object\[] (optional) | `[{ tokenMint, seller, priceSol, ... }]` | | ๐Ÿ•’ `scrapedAt` | ISO 8601 | `"2026-05-13T22:24:49.269Z"` | #### ๐Ÿ“ฆ Sample records
๐Ÿช PFP collection with full stats: HAXZ Shards ```json { "image": "https://www.haxz.xyz/shards/kernel-large.webp", "symbol": "haxz_shards", "name": "HAXZ Shards", "url": "https://magiceden.io/marketplace/haxz_shards", "description": "HAXZ Shards. 3,333 fragments forged from the deep web - 1,111 rare Kernels and 2,222 Shards. Burn a shard to upgrade your Haxz NFT, release it from staking with no penalty.", "categories": ["pfps"], "isBadged": false, "hasCNFTs": false, "floorPriceSol": null, "listedCount": 0, "avgPrice24hSol": null, "volumeAllSol": null, "scrapedAt": "2026-05-13T22:24:49.268Z" } ```
๐ŸŽจ Art collection with active listings: Art Artifacts ```json { "image": "https://na-assets.pinit.io/.../051cdd6d-846f-447a-8fe9-20f914e6cbb1-99.png", "symbol": "art_artifacts_", "name": "Art Artifacts", "url": "https://magiceden.io/marketplace/art_artifacts_", "description": "Art Artifacts - 1/100 of the complete 'Art'.", "categories": ["pfps"], "isBadged": false, "hasCNFTs": false, "floorPriceSol": 0.0988, "listedCount": 11, "avgPrice24hSol": 0.065, "volumeAllSol": 0.065, "scrapedAt": "2026-05-13T22:24:49.269Z" } ```
๐Ÿง™ Compressed NFT collection: Weezardium ```json { "image": "https://arweave.net/-iV04oJUIoxJa-U34He_f9pH_suO5dCp24ur6NZLkq0?ext=jpg", "symbol": "weezardium", "name": "Weezardium", "url": "https://magiceden.io/marketplace/weezardium", "description": "an abstraction of digital existence", "categories": ["pfps"], "isBadged": false, "hasCNFTs": true, "floorPriceSol": 0.05, "listedCount": 5, "avgPrice24hSol": null, "volumeAllSol": null, "scrapedAt": "2026-05-13T22:24:49.269Z" } ```
*** ### โœจ Why choose this Actor | | Capability | |---|---| | ๐Ÿช | **Solana coverage.** Every Magic Eden Solana collection, paginated for you. | | ๐Ÿ’Ž | **Floor + volume.** Live floor price, listed count, 24h average price, and all-time volume in SOL. | | ๐Ÿ›’ | **Active listings.** Optional per-collection listings with tokenMint, seller, price, and image. | | ๐ŸŒฑ | **cNFT flag.** Each collection tells you whether it uses compressed NFTs. | | โšก | **10-way concurrency.** A 100-collection enrichment in under a minute. | | ๐Ÿšซ | **No API key.** Works against the public Magic Eden mainnet API. | | ๐Ÿ” | **Always fresh.** Every run hits live endpoints. No caching. | > ๐Ÿ“Š In NFT markets, floor price and listing depth are the leading indicators. Clean per-collection records are the foundation of every alpha bot, marketplace dashboard, and Solana dApp integration. *** ### ๐Ÿ“ˆ How it compares to alternatives | Approach | Cost | Coverage | Refresh | Filters | Setup | |---|---|---|---|---|---| | **โญ Magic Eden NFT Scraper** *(this Actor)* | $5 free credit, then pay-per-use | **All Solana collections** | **Live per run** | symbol, stats, listings | โšก 2 min | | Magic Eden web app | Free | Same | Live | Manual click-through | ๐Ÿข Browser only | | Magic Eden API direct | Free + rate limits | Same | Live | None - you write code | ๐Ÿ› ๏ธ Hours | | Aggregator APIs | Free or paid | Cross-marketplace | Often delayed | Varies | โณ Multi-step | Pick this Actor when you want clean, joined collection + stats + listings data in one click. *** ### ๐Ÿš€ 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.** Go to the Magic Eden NFT Collection Scraper on the Apify Store. 3. ๐ŸŽฏ **Set input.** Leave `searchSymbol` empty for the global feed, or drop a symbol for one collection. Toggle `fetchStats` and `fetchListings` as needed. 4. ๐Ÿš€ **Run it.** Click **Start**. 5. ๐Ÿ“ฅ **Download.** Grab CSV, Excel, JSON, or XML from the **Dataset** tab. > โฑ๏ธ Total time from signup to downloaded dataset: **3-5 minutes.** No coding required. *** ### ๐Ÿ’ผ Business use cases
#### ๐Ÿ“Š NFT Trading & Alpha - Floor-price watchers across hundreds of collections - Listed-count signals for liquidity changes - New-collection discovery from the global feed - 24h average price drift for momentum scans #### ๐ŸŽฎ Game Studios & Web3 Apps - Sync collection metadata into your dApp UI - Powering in-game NFT pickers with live images - Auto-update marketplace links on your site - Detect cNFT collections for tooling decisions
#### ๐Ÿ“ˆ Market Data & Aggregators - Snapshot the Solana NFT market each day - Track all-time volume rankings for charts - Power "trending collections" widgets - Build cross-marketplace comparison feeds #### ๐Ÿšจ Alerts & Bots - Telegram/Discord bots on floor moves - Listing-volume spike alerts - New-collection-on-watchlist notifications - Multi-collection portfolio dashboards
*** ### ๐Ÿ”Œ Automating Magic Eden NFT Scraper Control the scraper programmatically for scheduled runs and pipeline integrations: - ๐ŸŸข **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. Minute-by-minute for alpha bots, hourly for analytics, daily for catalog snapshots. *** ### ๐ŸŒŸ Beyond business use cases NFT collection data powers more than alpha groups. The same records support research, education, civic projects, and personal initiatives.
#### ๐ŸŽ“ Research and academia - Quantitative studies of NFT liquidity and floor behavior - Solana ecosystem mapping for academic papers - Reproducible datasets for marketplace research - Coursework on tokenized asset markets #### ๐ŸŽจ Personal and creative - Personal portfolio dashboards for your holdings - Side projects, indie marketplaces, art galleries - Content for NFT creators and YouTubers - Hackathon prototypes with live data
#### ๐Ÿค Community and education - Transparency dashboards for community-run DAOs - Open data on listing distributions - Tutorial materials for Solana developers - Public watchlists for project alumni #### ๐Ÿงช Experimentation - Train ML models on price-floor signals - Prototype agent-based NFT trading - Build personal "favorites" widgets - Test dashboard concepts with live feeds
*** ### ๐Ÿค– Ask an AI assistant about this scraper Open a ready-to-send prompt about this ParseForge actor in the AI of your choice: - ๐Ÿ’ฌ [**ChatGPT**](https://chat.openai.com/?q=How%20do%20I%20use%20the%20Magic%20Eden%20NFT%20Collection%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%20Magic%20Eden%20NFT%20Collection%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%20Magic%20Eden%20NFT%20Collection%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%20Magic%20Eden%20NFT%20Collection%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? The Actor pages the Magic Eden `collections` endpoint (or fetches a single symbol), then enriches each collection with stats and listings calls run with 10 concurrent workers. Each collection gets a single clean record. #### ๐Ÿช Which marketplace and chain are covered? Magic Eden Solana only (the `api-mainnet.magiceden.io/v2` API). Other chains Magic Eden supports are not in scope for this Actor. #### ๐Ÿ’Ž Are prices in SOL or lamports? All price fields (`floorPriceSol`, `avgPrice24hSol`, `volumeAllSol`, listing `priceSol`) are in SOL. The Actor converts the underlying lamports values (1 SOL = 1,000,000,000 lamports). #### ๐Ÿ›’ How many listings does `fetchListings` return? The first 20 active listings per collection from Magic Eden's listings endpoint, with tokenMint, seller, price (SOL), name, image, and expiry where available. #### ๐ŸŒฑ What's `hasCNFTs`? Compressed NFTs (cNFTs) use Solana state compression to reduce mint cost. Magic Eden flags collections that contain cNFTs so tooling can handle them differently. #### ๐Ÿšซ Do I need an API key? No. The Actor uses Magic Eden's public mainnet API. #### โฐ Can I schedule regular runs? Yes. Use Apify Schedules to run the Actor on any cron interval. Hourly for floor-price tracking, daily for snapshots. #### ๐Ÿ” What happens if a collection has no stats? The Actor still emits the base record. Stat fields will be `null` for that collection (Magic Eden returns no values when there are no listings or no trades). #### ๐Ÿ” What happens if a run fails? Apify retries transient errors automatically. If a run still fails, inspect the log, adjust input, and re-run. Partial datasets are preserved. #### ๐Ÿ’ณ Do I need a paid Apify plan? No. Free plan covers testing (10 records per run). Paid plans unlock up to 1,000,000 items and scheduling. #### ๐Ÿ†˜ What if I need help? Our support team is here to help. Contact us through the Apify platform or use the Tally form linked below. *** ### ๐Ÿ”Œ Integrate with any app Magic Eden NFT Scraper 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) - Pipe floor-price alerts into channels - [**Airbyte**](https://docs.apify.com/platform/integrations/airbyte) - Land NFT data in your warehouse - [**GitHub**](https://docs.apify.com/platform/integrations/github) - Trigger runs from commits and releases - [**Google Drive**](https://docs.apify.com/platform/integrations/drive) - Export datasets to Sheets You can also use webhooks to trigger downstream actions when a run finishes. *** ### ๐Ÿ”— Recommended Actors - [**๐ŸฆŽ CoinGecko Cryptocurrency Scraper**](https://apify.com/parseforge/coingecko-scraper) - Coin-level market data across thousands of assets - [**๐Ÿ“ˆ DefiLlama DeFi Protocol Scraper**](https://apify.com/parseforge/defillama-scraper) - TVL and protocol-level DeFi metrics - [**๐Ÿฆ Binance Crypto Prices Scraper**](https://apify.com/parseforge/binance-prices-scraper) - Spot tickers on the largest CEX - [**๐ŸŽจ Artsy Scraper - Artworks, Artists & Shows**](https://apify.com/parseforge/artsy-scraper) - Off-chain art market metadata - [**๐Ÿ’ฑ Yahoo Finance Stock & Crypto Scraper**](https://apify.com/parseforge/yahoo-finance-scraper) - Cross-asset quotes for crypto and equities > ๐Ÿ’ก **Pro Tip:** browse the complete [ParseForge collection](https://apify.com/parseforge) for more NFT and crypto market 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 Magic Eden. All trademarks, collection names, and project names mentioned are the property of their respective owners. Only publicly available collection, stats, and listing data exposed by Magic Eden's public API is collected. This Actor is for informational use only and does not constitute financial advice. # Actor input Schema ## `searchSymbol` (type: `string`): Filter to a single collection by its Magic Eden symbol (e.g. degods, okay\_bears). Leave empty to scan the whole collections feed. ## `maxItems` (type: `integer`): Free users: Limited to 10 items (preview). Paid users: Optional, max 1,000,000 ## `fetchStats` (type: `boolean`): Calls the per-collection stats endpoint to get floor price, listed count, 24h avg price, and total volume. ## `fetchListings` (type: `boolean`): Calls the per-collection listings endpoint for the first 20 active listings. ## Actor input object example ```json { "searchSymbol": "", "maxItems": 10, "fetchStats": true, "fetchListings": false } ``` # Actor output Schema ## `overview` (type: `string`): Overview of scraped data ## `fullData` (type: `string`): Complete dataset # 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 = { "searchSymbol": "", "maxItems": 10, "fetchStats": true, "fetchListings": false }; // Run the Actor and wait for it to finish const run = await client.actor("parseforge/magic-eden-nft-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 = { "searchSymbol": "", "maxItems": 10, "fetchStats": True, "fetchListings": False, } # Run the Actor and wait for it to finish run = client.actor("parseforge/magic-eden-nft-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 '{ "searchSymbol": "", "maxItems": 10, "fetchStats": true, "fetchListings": false }' | apify call parseforge/magic-eden-nft-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=parseforge/magic-eden-nft-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Magic Eden NFT Collection Scraper", "description": "Scrape Solana NFT collections from Magic Eden public API. Returns collection metadata, social links, floor price, listed count, 24h avg price, total volume, and (optional) per-collection active listings. No API key required.", "version": "0.0", "x-build-id": "polhYXLW4P0QTbt4w" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/parseforge~magic-eden-nft-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-parseforge-magic-eden-nft-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~magic-eden-nft-scraper/runs": { "post": { "operationId": "runs-sync-parseforge-magic-eden-nft-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~magic-eden-nft-scraper/run-sync": { "post": { "operationId": "run-sync-parseforge-magic-eden-nft-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": { "searchSymbol": { "title": "Collection Symbol Filter", "type": "string", "description": "Filter to a single collection by its Magic Eden symbol (e.g. degods, okay_bears). Leave empty to scan the whole collections feed.", "default": "" }, "maxItems": { "title": "Max Items", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "Free users: Limited to 10 items (preview). Paid users: Optional, max 1,000,000" }, "fetchStats": { "title": "Fetch Collection Stats", "type": "boolean", "description": "Calls the per-collection stats endpoint to get floor price, listed count, 24h avg price, and total volume.", "default": true }, "fetchListings": { "title": "Fetch Active Listings", "type": "boolean", "description": "Calls the per-collection listings endpoint for the first 20 active listings.", "default": false } } }, "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 } } } } } } } } } } ```