# opensea-scraper-ts > Scraping accurate floor prices from opensea, because the API returns inacurate floor prices. Latest version **5.0.4** (published 2021-12-05) · ISC license · 0 weekly downloads ## Install ```sh npm install opensea-scraper-ts pnpm add opensea-scraper-ts yarn add opensea-scraper-ts bun add opensea-scraper-ts ``` ## Health **Score 25/100 (F)** — status: abandoned. Positive: has types; no vulnerabilities; high quality score. Warnings: low downloads; no esm support. Negative: abandoned; low maintenance score. ## Facts | | | |---|---| | Version | 5.0.4 | | Published | 2021-12-05 | | First published | 2021-10-27 | | Weekly downloads | 0 | | License | ISC | | TypeScript types | bundled | | Module format | CommonJS | | Dependencies | 4 | | Unpacked size | 37.2 KB | | Known vulnerabilities | 0 (+23 in 1 direct dependencies) | | Install scripts | no | | GitHub stars | 0 | | Author | dcts | | Maintainers | robertistok | | Keywords | scraper, opensea, nft, nfts, cryptocurrency, erc-721 | ## Links - npm: https://www.npmjs.com/package/opensea-scraper-ts - Repository: https://github.com/robertistok/opensea-scraper-ts - Homepage: https://github.com/robertistok/opensea-scraper-ts#readme - Issues: https://github.com/robertistok/opensea-scraper-ts/issues - npm.io page: https://npm.io/package/opensea-scraper-ts ## Dependencies (4) - [axios](https://npm.io/package/axios.md) ^0.21.1 - [puppeteer](https://npm.io/package/puppeteer.md) ^10.2.0 - [puppeteer-extra](https://npm.io/package/puppeteer-extra.md) ^3.1.18 - [puppeteer-extra-plugin-stealth](https://npm.io/package/puppeteer-extra-plugin-stealth.md) ^2.7.8 ## Alternatives - [@tsparticles/shape-image](https://npm.io/package/@tsparticles/shape-image.md) — 303.7K weekly downloads - [@tsparticles/shape-line](https://npm.io/package/@tsparticles/shape-line.md) — 233.7K weekly downloads - [stringify-attributes](https://npm.io/package/stringify-attributes.md) — 58.6K weekly downloads - [mobile-drag-drop](https://npm.io/package/mobile-drag-drop.md) — 46.3K weekly downloads - [@comunica/actor-rdf-parse-html](https://npm.io/package/@comunica/actor-rdf-parse-html.md) — 29.2K weekly downloads ## Recent versions - 5.0.4 (latest) — 2021-12-05 - 5.0.31 — 2021-12-05 - 5.0.3 — 2021-12-05 - 0.1.34 — 2021-10-27 - 0.1.33 — 2021-10-27 - 0.1.32 — 2021-10-27 - 0.1.31 — 2021-10-27 - 0.1.3-a — 2021-10-27 - 0.1.3 — 2021-10-27 - 0.1.2 — 2021-10-27 - 0.1.1 — 2021-10-27 - 0.1.0 — 2021-10-27 ## README # Opensea Scraper 🎉 **UPDATE 2021-Nov-3**: Opensea officially [updated their API](https://twitter.com/apiopensea/status/1455918328397144069). You can get accurate realtime floor prices from this endpoint: `https://api.opensea.io/api/v1/collection/{slug}/stats`: ```js const axios = require("axios"); async function getFloorPrice(slug) { try { const url = `https://api.opensea.io/collection/${slug}/stats`; const response = await axios.get(url); return response.data.stats.floor_price; } catch (err) { console.log(err); return undefined; } } await getFloorPrice("lostpoets"); await getFloorPrice("treeverse"); await getFloorPrice("cool-cats-nft"); ``` If you need floor prices, please use the official API (see above 👆👆👆). This scraper still can be used to scrape additional information about offers (tokenId, name, tokenContractAddress and offerUrl) as well as the ranking. ## Install ```bash npm install opensea-scraper ``` ## Usage ℹ **`slug`** is the human readable identifier that opensea uses to identify a collection. It can be extracted from the URL: https://opensea.io/collection/{slug} ![slug](https://user-images.githubusercontent.com/44790691/131232333-b79c50d7-606c-480a-9816-9d750ab798ff.png) ℹ **`options`** is an object with the following keys - **`debug`** [Boolean] launches chromium locally, omits headless mode (default: `false`) - **`logs`** [Boolean]: display logs in the console (default: `false`) - **`sort`** [Boolean]: sorts the offers by lowest to highest (default: `true`) - **`browserInstance`** [PuppeteerBrowser]: bring your own browser instance for more control ```js const OpenseaScraper = require("opensea-scraper"); // which nft project to scrape? const slug = "cool-cats-nft"; // options const options = { debug: false, logs: false, sort: true, browserInstance: undefined, } // get basic info (from the opensea API) const basicInfo = await OpenseaScraper.basicInfo(slug); // get offers from opensea. Each offer includes the floor price, tokenName, // tokenId, tokenContractAddress and offerUrl let result = await OpenseaScraper.offers(slug, options); console.dir(result, {depth: null}); // result object contains keys `stats` and `offers` // get offers from opensea using a custom link // Opensea supports encoding filtering in the URL so this method is helpful for getting // a specific asset (for example floor price for a LAND token from the sandbox collection) let url = "https://opensea.io/collection/sandbox?search[sortAscending]=true&search[sortBy]=PRICE&search[stringTraits][0][name]=Type&search[stringTraits][0][values][0]=Land&search[toggles][0]=BUY_NOW"; result = await OpenseaScraper.offersByUrl(url, options); console.dir(result, {depth: null}); // result object contains keys `stats` and `offers` // get offersByScrolling from opensea. This is an alternative method to get the same // data as in the function `offers`, with the only difference that the data is here // scraped actively by scrolling through the page. This method is not as efficient // as the `offers` method, but it can scrape more than 32 offers. You could even scrape // a whole collection with ~10k spots (this is not recommended though). let resultSize = 40; // if you need less than 32 offers, please use the function `offers()` instead result = await OpenseaScraper.offersByScrolling(slug, resultSize, options); console.dir(result, {depth: null}); // result object contains keys `stats` and `offers` // get offersByScrollingByUrl from opensea using a custom link instead of the slug // the same logic applies as in `offersByScrolling()` // Opensea supports encoding filtering in the URL so this method is helpful for getting // a specific asset (for example floor price for a LAND token from the sandbox collection) url = "https://opensea.io/collection/sandbox?search[sortAscending]=true&search[sortBy]=PRICE&search[stringTraits][0][name]=Type&search[stringTraits][0][values][0]=Land&search[toggles][0]=BUY_NOW"; resultSize = 40; // if you need less than 32 offers, please use the function `offers()` instead result = await OpenseaScraper.offersByScrollingByUrl(url, resultSize, options); console.dir(result, {depth: null}); // result object contains keys `stats` and `offers` // scrape all slugs, names and ranks from the top collections from the rankings page // sorted by all time volume => https://opensea.io/rankings?sortBy=total_volume // `nbrOfPages` specifies how many pages should be scraped (1 page = 100 collections) const nbrOfPages = 2; const ranking = await OpenseaScraper.rankings(nbrOfPages, options); ``` ### Debugging To investigate an issue turn on logs and debug mode (`debug: true` and `logs: true`): ```js const result = await OpenseaScraper.offers("treeverse", { debug: true, logs: true }); ``` ### Bring your own puppeteer if you want to customize the settings for your puppeteer instance you can add your own puppeteer browser instance in the options: ```js const puppeteer = require("puppeteer"); const myPuppeteerInstance = await puppeteer.launch(myCustomSettings); const result = await OpenseaScraper.offer("cool-cats-nft", { browserInstance: myPuppeteerInstance }); ``` ## Demo ```bash npm run demo ``` ## Contribute Open PR or issue if you would like to have more features added. ## Donations 🙏 ``` Thanks for your support! BTC: bc1qq5qn96ahlqjxfxz2n9l20kem8p9nsz5yzz93f7 ETH: 0x3e4503720Fb8f4559Ecf64BE792b3100722dE940 ``` # nftfloorprice.info 🔔 Simple NFT floor price alerts. Easily track all your NFTs and receive realtime email alerts with: https://nftfloorprice.info

--- _Source: https://npm.io/package/opensea-scraper-ts · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._