# Goldin Auction Scraper (`parsebird/goldin-auction-scraper`) Actor

Scrape Goldin auction lots: live bids, sold prices, buyer's premium, PSA/BGS/SGC/CGC grades, bid counts, images and lot details. Filter by tier, sport, grader, keyword, price and sold date.

- **URL**: https://apify.com/parsebird/goldin-auction-scraper.md
- **Developed by:** [ParseBird](https://apify.com/parsebird) (community)
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 1 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.89 / 1,000 goldin lots

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?

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

### Goldin Auction Scraper

Goldin Auction Scraper extracts **live bids, sold prices and lot details from [Goldin](https://goldin.co)**, the auction house for trading cards and collectibles, and returns them as clean JSON, CSV or Excel.

<table><tr>
<td style="border-left:4px solid #1C1917;padding:12px 16px;font-weight:600">
Pull every active Goldin lot or years of sold results, filter by Weekly, Elite, Thematic or Buy Now tier, sport, item type, grading company, keyword, price and sold date, and get the grade, bid count, buyer's premium total and images on every row.
</td>
</tr></table>

##### Copy to your AI assistant

Copy this block into ChatGPT, Claude, Cursor, or any LLM to start using this actor.

```
Use the Apify Actor "parsebird/goldin-auction-scraper" (call it via ApifyClient) to scrape Goldin (goldin.co) auction lots. Example (JavaScript): const { ApifyClient } = require('apify-client'); const client = new ApifyClient({ token: '<APIFY_TOKEN>' }); const run = await client.actor('parsebird/goldin-auction-scraper').call({ mode: 'past_auctions', auctionTier: 'Elite', grader: 'PSA', sport: 'Baseball', soldAfter: '2025-01-01', maxItems: 500 }); const { items } = await client.dataset(run.defaultDatasetId).listItems(); Inputs (all optional): mode (string, default "marketplace"; "marketplace" = active auction lots + Buy Now listings, "past_auctions" = sold lots, "lot" = specific lots), lotUrls (array of goldin.co/item/<slug> URLs, slugs or lot IDs; used when mode="lot"), maxItems (integer, default 10, 0 = no cap), auctionTier (string, default "All"; All/Weekly/Elite/Thematic/Fixed_Price), sport (string, Goldin sub-category such as Baseball, Basketball, Pokemon; case-insensitive), itemType (string, e.g. "Single Cards"), grader (string, default "Any"; Any/PSA/Beckett/SGC/CGC/TAG/Ungraded/Other), keyword (string), priceMin and priceMax (integer USD, 0 = no limit), soldAfter and soldBefore (YYYY-MM-DD, past_auctions only), sortBy (string; ending_soonest, most_recent_sold, highest_price, lowest_price, most_bids, least_bids, newest, lot_number), includeLotDetails (boolean, default false). Each output row is one lot: lot_id, lot_url, lot_number, auction_id, auction_name, auction_type, auction_start_date, auction_end_date, title, category, subcategory, item_type, grader, grade, grade_numeric, cert_number, serial_number, listing_status (Live/Preview/Completed_Sold), current_price, final_price, min_bid_price, bid_count, reserve_amount, reserve_met, buyers_premium_pct, final_price_with_premium, allow_offers, currency, sold_at, view_count, description, image_urls (pipe-separated), primary_image_url, video_urls. API docs: https://apify.com/parsebird/goldin-auction-scraper/api. Get a token at https://console.apify.com/settings/integrations.
```

### What is Goldin Auction Scraper?

**Goldin Auction Scraper** is an [Apify Actor](https://apify.com/actors) that collects auction data from [Goldin](https://goldin.co): sports cards, Pokémon and other TCG cards, game-used memorabilia, comics, coins, video games and movie props. You don't need a Goldin account, an API key or a browser. Pick a mode, click **Start**, and download the results.

It works as a **Goldin API alternative** for three jobs:

- **Active lots**: every lot open for bidding in Goldin's Weekly, Elite and Thematic auctions, plus fixed-price Buy Now listings, with the current bid and bid count.
- **Past auctions (sold comps)**: Goldin's sold results with the hammer price, sale time and the price including buyer's premium, filtered by sold date.
- **Lot URLs**: the full record for specific lots, including category, certificate number, description, every image and lot videos.

### What can Goldin Auction Scraper do?

- 🔨 **Live and sold data**: active lots with current bids, or sold lots going back to Goldin's 2012 auctions.
- 🎯 **Goldin's own filters**: auction tier, sport / sub-category, item type, grading company, keyword and price range all run on Goldin's search, so you only pay for lots that match.
- 📅 **Sold-date windows**: get every sold lot between two dates, for example all PSA basketball cards sold in March 2025.
- 🏷️ **Grades parsed from the title**: grader (`PSA`, `Beckett`, `SGC`, `CGC`, `TAG`, `NGC`, `PCGS` and more), grade label (`PSA 10`, `BGS 9.5`, `NGC MS67+`) and a numeric grade for sorting.
- 💵 **Buyer's premium included**: `final_price_with_premium` uses the same rule goldin.co applies on its lot pages, so you can compare what buyers actually paid.
- 🔁 **Complete results**: large result sets are collected in smaller slices so lots are not skipped or duplicated between pages.
- 🔍 **Forgiving keyword search**: if a pasted card title with grading or serial text (`PSA GEM MT 10`, `#/99`) finds nothing, the run retries once without that text.
- ⏱️ **Platform features**: [schedule](https://docs.apify.com/platform/schedules) daily runs, call the Actor through the [Apify API](https://docs.apify.com/api/v2), get [webhooks](https://docs.apify.com/platform/integrations/webhooks) when a run finishes, and connect it to [Make, Zapier, n8n, Google Sheets, Slack and more](https://apify.com/integrations). Export as JSON, CSV, Excel, XML or HTML.

### What data can you extract from Goldin?

| Field | Description |
|-------|-------------|
| `title` | Full lot title as listed on Goldin |
| `lot_url` / `lot_id` / `lot_number` | Lot page on goldin.co, Goldin's lot ID and the lot number in its auction |
| `auction_name` / `auction_type` | Auction title (for example `2026 Fall Vintage Elite Auction`) and tier: `Weekly`, `Elite`, `Thematic` or `Fixed_Price` (Buy Now) |
| `auction_start_date` / `auction_end_date` | Lot start and close time (ISO 8601, UTC) |
| `listing_status` | `Live`, `Preview` (not open for bids yet) or `Completed_Sold` |
| `current_price` | Current bid or Buy Now price, or the hammer price for sold lots (USD) |
| `final_price_with_premium` | Price including Goldin's buyer's premium |
| `buyers_premium_pct` | Buyer's premium percentage Goldin lists for the lot |
| `min_bid_price` / `bid_count` | Opening bid and number of bids |
| `reserve_amount` / `reserve_met` | Reserve price (0 = no reserve) and whether the current price meets it |
| `grader` / `grade` / `grade_numeric` | Grading company, grade label and numeric grade |
| `sold_at` | Sale time for sold lots (ISO 8601, UTC) |
| `image_urls` / `primary_image_url` | Lot photos on Goldin's image CDN (pipe-separated list) |
| `category` / `subcategory` / `item_type` | For example `Sport` / `Basketball` / `Single Cards` (with full lot details) |
| `cert_number` / `serial_number` / `view_count` / `description` / `video_urls` | Grading certificate number, Goldin serial number, page views, lot description and lot videos (with full lot details) |

### How to scrape Goldin auctions

1. Open [Goldin Auction Scraper](https://apify.com/parsebird/goldin-auction-scraper) in Apify Console and go to the **Input** tab.
2. Choose a **Mode**: *Active lots*, *Past auctions* or *Lot URLs*.
3. Add filters if you want: auction tier, sport, item type, grading company, keyword, price range and, for past auctions, the sold-date window.
4. Set **Max lots**. Start small (the default is 10) to check the output.
5. Click **Start**. Most runs take a few seconds to a minute.
6. Download the dataset as JSON, CSV or Excel, or read it with the API.

### Input parameters

| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| `mode` | string | No | `marketplace` | `marketplace` (active lots + Buy Now), `past_auctions` (sold lots) or `lot` (specific lots) |
| `lotUrls` | array | Only for `lot` | — | Goldin lot URLs (`https://goldin.co/item/<slug>`), slugs or lot IDs |
| `maxItems` | integer | No | 10 | Maximum lots to return. 0 = no cap |
| `auctionTier` | string | No | `All` | `All`, `Weekly`, `Elite`, `Thematic` or `Fixed_Price` (Buy Now) |
| `sport` | string | No | — | Goldin sub-category: Baseball, Basketball, Football, Soccer, Hockey, Pokemon, One Piece, Star Wars, Racing and more. Case-insensitive. An unknown value stops the run and lists the available ones |
| `itemType` | string | No | — | Goldin item type such as `Single Cards`, `Cases/Boxes/Packs`, `Jerseys`, `Comics`. Unknown values stop the run with the list |
| `grader` | string | No | `Any` | `PSA`, `Beckett` (includes BGS), `SGC`, `CGC`, `TAG`, `Ungraded` or `Other`, using Goldin's certification filter |
| `keyword` | string | No | — | Player, set, year or card number. Relaxed and retried once if a pasted title with grade/serial text finds nothing |
| `priceMin` / `priceMax` | integer | No | 0 | Price range in USD on the current bid, Buy Now price or sold price. 0 = no limit |
| `soldAfter` / `soldBefore` | string | No | — | Past auctions only. Sold-date window, `YYYY-MM-DD`, inclusive, UTC |
| `sortBy` | string | No | `ending_soonest` / `most_recent_sold` | Active lots: `ending_soonest`, `highest_price`, `lowest_price`, `most_bids`, `least_bids`, `newest`, `lot_number`. Past auctions: `most_recent_sold` or `lot_number` |
| `includeLotDetails` | boolean | No | false | Open every lot to add category, item type, certificate and serial numbers, view count, description, all images and videos. One extra request per lot. Always on in `lot` mode |

**Example: active PSA baseball lots, highest bids first**

```json
{
    "mode": "marketplace",
    "sport": "Baseball",
    "grader": "PSA",
    "sortBy": "highest_price",
    "maxItems": 100
}
```

**Example: Elite PSA results sold since January 2025**

```json
{
    "mode": "past_auctions",
    "auctionTier": "Elite",
    "grader": "PSA",
    "soldAfter": "2025-01-01",
    "maxItems": 500
}
```

**Example: specific lots**

```json
{
    "mode": "lot",
    "lotUrls": ["https://goldin.co/item/2017-nick-markakis-game-used-atlanta-braves-road-independence-day-jersgf6ox"]
}
```

### Output example

```json
[
  {
    "lot_id": "202608-2418-3548-c014da87-77fc-4ab3-b57f-923ec5e18ba1",
    "lot_url": "https://goldin.co/item/1952-bowman-large-18-charlie-justice-psa-nm-7kjltw",
    "lot_number": 365,
    "auction_id": "202609-0215-5618-53c1239f-c383-4c3b-985e-3fb0a70b6610",
    "auction_name": "2026 Fall Vintage Elite Auction",
    "auction_type": "Elite",
    "auction_start_date": "2026-09-16T14:00:00Z",
    "auction_end_date": "2026-10-11T05:43:32Z",
    "title": "1952 Bowman Large #18 Charlie Justice Rookie Card - PSA NM 7",
    "grader": "PSA",
    "grade": "PSA 7",
    "grade_numeric": 7,
    "listing_status": "Completed_Sold",
    "current_price": 1835.0,
    "min_bid_price": 100.0,
    "bid_count": 31,
    "reserve_amount": 0.0,
    "reserve_met": null,
    "buyers_premium_pct": 22.0,
    "final_price_with_premium": 2238.7,
    "currency": "USD",
    "sold_at": "2026-10-11T05:43:32Z",
    "image_urls": "https://d2tt46f3mh26nl.cloudfront.net/public/Lots/202608-2418-3548-c014da87-77fc-4ab3-b57f-923ec5e18ba1/2a0c6b66-c295-41d4-805b-a78598045bce@2x",
    "primary_image_url": "https://d2tt46f3mh26nl.cloudfront.net/public/Lots/202608-2418-3548-c014da87-77fc-4ab3-b57f-923ec5e18ba1/2a0c6b66-c295-41d4-805b-a78598045bce@2x"
  },
  {
    "lot_id": "202609-2518-1629-c05dd78e-413d-49cb-b438-841676ff18be",
    "lot_url": "https://goldin.co/item/2025-topps-chrome-f1-chrome-autographs-superfractor-cac-ant-kimi-antond23hw",
    "lot_number": 2,
    "auction_name": "2026 Monthly Sports Elite #9",
    "auction_type": "Elite",
    "auction_end_date": "2026-10-18T02:00:00Z",
    "title": "2025 Topps Chrome F1 Chrome Autographs SuperFractor #CAC-ANT Kimi Antonelli Signed Rookie Card (#1/1) - PSA GEM MT 10",
    "category": "Sport",
    "subcategory": "Racing",
    "item_type": "Single Cards",
    "grader": "PSA",
    "grade": "PSA 10",
    "grade_numeric": 10,
    "cert_number": "149549417",
    "serial_number": "SF0000378645",
    "listing_status": "Live",
    "current_price": 270000.0,
    "min_bid_price": 50000.0,
    "bid_count": 20,
    "buyers_premium_pct": 22.0,
    "final_price_with_premium": 329400.0,
    "view_count": 18704,
    "video_urls": "https://d2tt46f3mh26nl.cloudfront.net/public/Lots/202609-2518-1629-c05dd78e-413d-49cb-b438-841676ff18be/videos/e815a0c0-6d7f-437f-ba66-56af4f17fda8.m3u8"
  }
]
```

The second record comes from `lot` mode, where the category, certificate number, view count and videos are filled in. Some fields are left out above to keep it short; every record has all fields, empty when Goldin has no value.

### Use Goldin Auction Scraper from Python or JavaScript

Install the [Apify API client](https://docs.apify.com/api/client/python) and use your [API token](https://console.apify.com/settings/integrations).

#### Python

```python
from apify_client import ApifyClient

client = ApifyClient("<APIFY_TOKEN>")

run = client.actor("parsebird/goldin-auction-scraper").call(run_input={
    "mode": "past_auctions",
    "keyword": "1986 Fleer Michael Jordan",
    "grader": "PSA",
    "soldAfter": "2025-01-01",
    "maxItems": 200,
})

for lot in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(lot["sold_at"][:10], lot["grade"], lot["final_price_with_premium"], lot["title"])
```

#### JavaScript

```javascript
import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: '<APIFY_TOKEN>' });

const run = await client.actor('parsebird/goldin-auction-scraper').call({
    mode: 'marketplace',
    sport: 'Pokemon',
    sortBy: 'ending_soonest',
    maxItems: 50,
});

const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((lot) => console.log(lot.auction_end_date, lot.current_price, lot.bid_count, lot.title));
```

### Use cases

- **Sold comps for pricing**: pull every sale of a card at a given grade to price your own copy or a consignment.
- **Collectibles market research**: track how PSA 10 prices move across Weekly and Elite auctions month by month.
- **Bid monitoring**: schedule a run on lots ending soon and get alerts in Slack or email when bids jump.
- **Inventory and deal sourcing**: find Buy Now listings or low-bid lots under a price ceiling in your category.
- **Datasets for analysis**: load sold results into Google Sheets, BigQuery or a BI tool and compare them with eBay or PriceCharting data.

### How it works

1. The Actor sends your filters (tier, sport, item type, grader, keyword, price) to the search that powers goldin.co, so filtering happens on Goldin's side.
2. **Active lots** are collected in price slices of up to 1,000 lots each. Goldin's page order shuffles lots with equal values between pages, so this avoids skipped and repeated lots. Results are then sorted by your `sortBy`.
3. **Past auctions** are collected auction by auction, newest first, using Goldin's list of completed auctions, and Buy Now sales are merged in by sale time. A sold-date window only opens the auctions that ran in that window.
4. Grades are parsed from the lot title, the buyer's premium total is calculated, and image URLs are built for Goldin's image CDN.
5. With **Include full lot details** (or in `lot` mode), each lot's page data is fetched for category, certificate number, description, every image and videos.

### How much does it cost to scrape Goldin?

Goldin Auction Scraper uses pay-per-event pricing. You pay per lot saved to the dataset, and platform usage (compute and data transfer) is included in that price.

| Plan | Price per lot | Price per 1,000 lots |
|------|---------------|----------------------|
| Free | $0.00119 | **$1.19** |
| Bronze | $0.00109 | **$1.09** |
| Silver | $0.00099 | **$0.99** |
| Gold | $0.00089 | **$0.89** |

On October 17, 2026, a full run of every active lot (`maxItems: 0`) saved 5,163 lots (5,010 auction lots and 153 Buy Now listings). That costs about $6.14 on the Free plan and $4.60 on Gold. A run of the 500 most recent Elite PSA sales costs about $0.60 on the Free plan. Turning on full lot details doesn't change the price per lot. To control spend, add filters or set `maxItems`. The run also stops at the maximum cost per run you set in Apify Console.

### Is it legal to scrape Goldin?

This Actor only reads lot information that Goldin shows publicly on goldin.co, without logging in or bidding. Scraping publicly available data is generally legal, but you are responsible for how you use it and for following Goldin's terms of use, especially if you republish lot photos or descriptions. If you aren't sure, consult a lawyer. Read more on the [Apify blog about web scraping legality](https://blog.apify.com/is-web-scraping-legal/).

This Actor is unofficial and isn't affiliated with, endorsed by or sponsored by Goldin.

### Other collectibles scrapers from ParseBird

- [eBay Sold Listings Scraper](https://apify.com/parsebird/ebay-sold-listings-scraper): sold and completed eBay listings with final prices, for comps outside Goldin.
- [PriceCharting Product Scraper](https://apify.com/parsebird/pricecharting-product-scraper): PriceCharting prices for graded and ungraded cards, video games and comics.
- [TCGplayer Scraper](https://apify.com/parsebird/tcgplayer-scraper): TCGplayer card prices and listings for Pokémon, Magic and other TCGs.
- [Mercari US Scraper](https://apify.com/parsebird/mercari-us-scraper): Mercari listings and prices for collectibles and more.

### FAQ

**Does it include unsold lots?**
No. Goldin's public past-auction results only list lots that sold, so `past_auctions` returns `Completed_Sold` lots. Lots that passed without a sale are not available.

**Is `current_price` the hammer price or the total price?**
For sold auction lots, `current_price` is the hammer price before buyer's premium. `final_price_with_premium` adds the premium the way goldin.co calculates it: for lots that closed after June 22, 2024, the listed premium (22% at the time of writing) with a $19 minimum, and for earlier lots the listed premium (20% by default). For Buy Now listings it adds the premium percentage Goldin lists on the listing, which is often 0.

**Which auction tiers are there?**
Goldin's data uses `Weekly`, `Elite`, `Thematic` (themed sales such as movie props, coins or Pokémon events) and `Fixed_Price` for Buy Now. A Thematic auction can contain lots tagged as Weekly or Elite, and the tier filter follows the tag on each lot.

**Why is `grade` empty for some lots?**
Grades are read from the lot title, and memorabilia, sealed products and autograph-only items often have none. When you filter by `grader`, matching lots always get that grader even if the title doesn't name it. With full lot details, Goldin's own grading company field fills `grader` when the title has no grade.

**How far back do past auctions go?**
Goldin lists auctions back to 2012. Older lots often have fewer filled-in fields (for example no sub-category), so sport and item type filters can miss them.

**Why did my run stop with a list of sub-categories?**
The `sport` or `itemType` value didn't match any of Goldin's names for your other filters. Pick one from the list in the log. Matching ignores upper and lower case.

**Can I get the data through an API?**
Yes. Use the [API tab](https://apify.com/parsebird/goldin-auction-scraper/api) or the Python and JavaScript examples above. You can also run it from Make, Zapier or n8n.

**Something is missing or broken?**
Open an issue on the [Issues tab](https://apify.com/parsebird/goldin-auction-scraper/issues).

# Changelog

This Actor's version history is a separate document: https://apify.com/parsebird/goldin-auction-scraper/changelog.md

# Actor input Schema

## `mode` (type: `string`):

Choose what to scrape. <b>Active lots</b> = lots open for bidding plus Buy Now listings. <b>Past auctions</b> = sold lots with their final prices. <b>Lot URLs</b> = the full detail of the lots you paste below.

## `lotUrls` (type: `array`):

Used only when Mode is <b>Lot URLs</b>. Paste Goldin lot links such as https://goldin.co/item/\<lot-slug>. Bare slugs and Goldin lot IDs work too.

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

Stop after this many lots. 0 = no cap. Goldin usually has about 5,000 active lots; past auctions hold hundreds of thousands of sold lots.

## `auctionTier` (type: `string`):

Limit results to one Goldin sale type. <b>Thematic</b> covers Goldin's themed sales (for example movie props, coins or Pokémon events). <b>Buy Now</b> is Goldin's fixed-price marketplace.

## `sport` (type: `string`):

Enter a Goldin sub-category such as Baseball, Basketball, Football, Soccer, Hockey, Pokemon, One Piece, Star Wars or Racing. Matching ignores upper/lower case. If no sub-category matches, the run stops and lists the ones available.

## `itemType` (type: `string`):

Optional. Enter a Goldin item type such as Single Cards, Cases/Boxes/Packs, Jerseys, Memorabilia, Comics or Coins and Currency. An unknown value stops the run and lists the ones available.

## `grader` (type: `string`):

Keep only lots certified by this grading company, using Goldin's own certification filter. Beckett includes BGS.

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

Search Goldin by player, set, year or card number. If a pasted card title with grade or serial text (PSA 10, #/50) finds nothing, the scraper retries once without that text.

## `priceMin` (type: `integer`):

Lowest current bid, Buy Now price or sold price. 0 = no floor.

## `priceMax` (type: `integer`):

Highest current bid, Buy Now price or sold price. 0 = no ceiling.

## `soldAfter` (type: `string`):

Past auctions only. Keep lots that sold on or after this date (UTC).

## `soldBefore` (type: `string`):

Past auctions only. Keep lots that sold on or before this date (UTC).

## `sortBy` (type: `string`):

Order of the results. Active lots support every option (default: Ending soonest). Past auctions support Most recently sold (default) and Lot number.

## `includeLotDetails` (type: `boolean`):

Open every lot to add the category, sub-category, item type, certificate number, serial number, view count, description, auction name and all images and videos. Slower: one extra request per lot. Lot URL mode always includes these fields.

## Actor input object example

```json
{
  "mode": "marketplace",
  "maxItems": 10,
  "auctionTier": "All",
  "grader": "Any",
  "priceMin": 0,
  "priceMax": 0,
  "includeLotDetails": false
}
```

# Actor output Schema

## `dataset` (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 = {
    "mode": "marketplace",
    "maxItems": 10
};

// Run the Actor and wait for it to finish
const run = await client.actor("parsebird/goldin-auction-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 = {
    "mode": "marketplace",
    "maxItems": 10,
}

# Run the Actor and wait for it to finish
run = client.actor("parsebird/goldin-auction-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 '{
  "mode": "marketplace",
  "maxItems": 10
}' |
apify call parsebird/goldin-auction-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,parsebird/goldin-auction-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/b4HgolB5VIRaFwxo9/builds/UmBLVIKWUw0mZFbTO/openapi.json
