# Gov Planet Auction Urls Listing (`getdataforme/gov-planet-auction-urls-listing`) Actor

Search GovPlanet auction listings by keyword and extract structured data including item number, title, price, auction date, location, image, and listing URL in clean JSON format.

- **URL**: https://apify.com/getdataforme/gov-planet-auction-urls-listing.md
- **Developed by:** [GetDataForMe](https://apify.com/getdataforme) (community)
- **Categories:** Lead generation, Other, E-commerce
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $9.00 / 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.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#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

## Gov Planet Auction Urls Listing

Extract GovPlanet auction listing URLs and metadata by searching with one or more keywords. This actor searches GovPlanet auction listings and returns structured auction data including title, item number, auction type, location, price, auction date, image, and direct listing URL.

Perfect for market research, inventory monitoring, lead generation, pricing analysis, and auction automation.

***

## Features

- ✅ Search GovPlanet auction listings using one or multiple keywords
- ✅ Returns clean, structured JSON output
- ✅ Includes auction price, auction date, and currency
- ✅ Extracts listing image and direct auction URL
- ✅ Supports Apify Residential Proxy for reliable scraping
- ✅ Configurable item limit
- ✅ Fast and automation-friendly

***

## Input

Example input:

```json
{
  "keywords": [
    "Containers"
  ],
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  },
  "show_browser": false,
  "item_limit": 10
}
```

***

## Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `keywords` | Array | ✅ Yes | One or more search keywords (e.g. Containers, Excavators, Trucks). |
| `proxyConfiguration` | Object | No | Apify proxy configuration. Residential proxy is recommended. |
| `show_browser` | Boolean | No | Displays the browser while running. Default: `false`. |
| `item_limit` | Integer | No | Maximum number of auction listings to return. |

***

## Output

Example output:

```json
[
  {
    "category": "Containers",
    "item_number": "15059032",
    "url": "https://www.govplanet.com/for-sale/Containers-Seabox-S20-155F-Refrigerated-Storage-Container-North-Carolina/15059032?h=5000%2Cc%7C1824%2Cmode%7C2&rr=1&hitprm=&pnLink=yes",
    "title": "Seabox S20-155F Refrigerated Storage Container",
    "location": "North Carolina",
    "away": "8,333 km",
    "auction_type": "Online Auction",
    "price": 500,
    "date": "Aug 26",
    "currency": "USD",
    "title_image": "https://cdn.ironpla.net/i/21759/650/9876c3a6-5b38-4f54-9155-487fdb3f9acc-nowater.jpg",
    "is_verified": true,
    "input_source_key": "start_url:https://www.govplanet.com/jsp/s/search.ips?sm=0",
    "actor_id": null,
    "run_id": null
  }
]
```

***

## Output Fields

| Field | Description |
|-------|-------------|
| `category` | Search category or keyword used. |
| `item_number` | GovPlanet item number. |
| `url` | Direct URL to the auction listing. |
| `title` | Auction listing title. |
| `location` | Item location. |
| `away` | Distance from the selected region (if available). |
| `auction_type` | Type of auction. |
| `price` | Current auction price. |
| `date` | Auction closing date. |
| `currency` | Currency of the listed price. |
| `title_image` | Main listing image. |
| `is_verified` | Indicates whether the listing is verified. |
| `input_source_key` | Internal source reference. |
| `actor_id` | Actor ID (if configured). |
| `run_id` | Run ID (if configured). |

***

## Example Use Cases

- Monitor GovPlanet auctions for specific equipment categories
- Track auction prices over time
- Build auction inventory databases
- Generate sales and procurement leads
- Analyze equipment availability by location
- Feed auction data into BI dashboards
- Automate auction notifications

***

## Why Use This Actor?

Instead of manually browsing GovPlanet listings, this actor automatically searches, extracts, and structures auction data into machine-readable JSON, making it ideal for automation workflows, analytics, and integrations.

***

## Support

Need help, found a bug, or want a custom feature?

**Email:** support@getdataforme.com

**Recommended Email Subject:**

```
Subject: Gov Planet Auction Urls Listing - Support Request
```

For bug reports, feature requests, custom outputs, or enterprise integrations, please include:

- Actor name
- Run ID (if available)
- Input used
- Description of the issue or requested customization

You can also reach us through our contact page:

https://getdataforme.com/contact/

We typically respond as quickly as possible.

Thank you for using **Gov Planet Auction Urls Listing**!

# Actor input Schema

## `keywords` (type: `array`):

The keywords for the spider.

## `proxyConfiguration` (type: `object`):

Specifies proxy servers that will be used by the scraper in order to hide its origin.

## `item_limit` (type: `integer`):

Maximum items to scrape per actor run. Set to 0 for no limit.

## `show_browser` (type: `boolean`):

Open a visible browser window during AWS WAF token refresh. Keep false for server/headless runs.

## Actor input object example

```json
{
  "keywords": [
    "containers"
  ],
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  },
  "item_limit": 10,
  "show_browser": false
}
```

# 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 = {
    "proxyConfiguration": {
        "useApifyProxy": true,
        "apifyProxyGroups": [
            "RESIDENTIAL"
        ]
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("getdataforme/gov-planet-auction-urls-listing").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 = { "proxyConfiguration": {
        "useApifyProxy": True,
        "apifyProxyGroups": ["RESIDENTIAL"],
    } }

# Run the Actor and wait for it to finish
run = client.actor("getdataforme/gov-planet-auction-urls-listing").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 '{
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  }
}' |
apify call getdataforme/gov-planet-auction-urls-listing --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=getdataforme/gov-planet-auction-urls-listing",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/acts/VgX9faBdtRxW7wvLp/builds/rmva2dSH6aP0OJGsg/openapi.json