{
  "openapi": "3.0.1",
  "info": {
    "title": "GunBroker Scraper - Listings, Bids, Prices, Specs & Sellers",
    "description": "Scrape GunBroker.com listings: guns, ammo, parts and gear. Current bid, buy-now, fixed price, bids, reserve, end time, category, condition, make, model, caliber, UPC, shipping and payment methods, seller rating and state, photos. Search, category and item URLs. Monitor new listings and price moves.",
    "version": "0.1",
    "x-build-id": "v5AbkWtUWMiS6bris"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/scrapersdelight~gunbroker-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-scrapersdelight-gunbroker-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/scrapersdelight~gunbroker-scraper/runs": {
      "post": {
        "operationId": "runs-sync-scrapersdelight-gunbroker-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/scrapersdelight~gunbroker-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-scrapersdelight-gunbroker-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": {
          "searchTerms": {
            "title": "🔍 Search terms",
            "type": "array",
            "description": "Keywords to search GunBroker for, one search each, e.g. \"glock 19\", \"ruger 10/22\", \"9mm ammo\". Leave empty when you paste URLs or pick a category.",
            "items": {
              "type": "string"
            }
          },
          "startUrls": {
            "title": "🔗 GunBroker URLs or item ids",
            "type": "array",
            "description": "GunBroker search or category URLs (filters in the URL are kept, e.g. https://www.gunbroker.com/semi-auto-pistols/search?keywords=sig) and item URLs or bare item ids (https://www.gunbroker.com/item/1204792646 or 1204792646).",
            "items": {
              "type": "string"
            }
          },
          "categories": {
            "title": "📂 Categories",
            "type": "array",
            "description": "Limit the searches to these GunBroker categories. A category alone, without search terms, searches the whole category.",
            "items": {
              "type": "string",
              "enum": [
                "851",
                "978",
                "3026",
                "2325",
                "979",
                "3024",
                "3022",
                "3023",
                "980",
                "2338",
                "1014",
                "3094",
                "1012",
                "3018",
                "3017",
                "3019",
                "982",
                "3038",
                "3039",
                "10050",
                "10060",
                "1017",
                "3013",
                "5200",
                "2328",
                "1013",
                "3120",
                "3130",
                "3300",
                "3002",
                "4038",
                "3001",
                "9000"
              ],
              "enumTitles": [
                "Guns & Firearms (all)",
                "Handguns",
                "Semi Auto Pistols",
                "Revolvers",
                "Rifles",
                "Semi Auto Rifles",
                "Bolt Action Rifles",
                "Lever Action Rifles",
                "Shotguns",
                "NFA Guns & Silencers",
                "Collectible Guns",
                "Black Powder & Muzzleloaders",
                "Ammo (all)",
                "Handgun Ammo",
                "Rifle Ammo",
                "Shotgun Shells",
                "Gun Parts (all)",
                "Pistol Parts",
                "Rifle Parts",
                "AR Parts",
                "Glock Parts",
                "Scopes & Optics",
                "Holsters",
                "Concealed Carry",
                "Knives & Swords",
                "Air Guns",
                "Reloading Equipment",
                "Reloading Supplies",
                "Storage: Cases, Safes, Cabinets",
                "Hunting Supplies & Gear",
                "Tactical Gear",
                "Collectibles & Militaria",
                "Miscellaneous"
              ]
            }
          },
          "categoryIds": {
            "title": "Other category ids",
            "type": "array",
            "description": "Any other GunBroker category id (the number GunBroker uses for a category, e.g. 3311 for Pistol Frames). Combined with Categories.",
            "items": {
              "type": "string"
            }
          },
          "listingType": {
            "title": "🏷️ Listing type",
            "enum": [
              "all",
              "auctions",
              "buy-now"
            ],
            "type": "string",
            "description": "Auctions only, Buy Now & fixed-price only, or both.",
            "default": "all"
          },
          "condition": {
            "title": "Condition",
            "enum": [
              "any",
              "new",
              "new-or-nos",
              "used-or-nos",
              "used",
              "nos",
              "new-or-used"
            ],
            "type": "string",
            "description": "Item condition as GunBroker files it.",
            "default": "any"
          },
          "minPrice": {
            "title": "Min price ($)",
            "minimum": 0,
            "type": "integer",
            "description": "Lowest current price, in US dollars. 0 = no minimum."
          },
          "maxPrice": {
            "title": "Max price ($)",
            "minimum": 0,
            "type": "integer",
            "description": "Highest current price, in US dollars. 0 = no maximum."
          },
          "manufacturer": {
            "title": "Manufacturer",
            "type": "string",
            "description": "GunBroker's manufacturer filter, written as the site lists it, e.g. \"GLOCK\", \"SIG SAUER\", \"SMITH & WESSON\"."
          },
          "caliber": {
            "title": "Caliber",
            "type": "string",
            "description": "GunBroker's caliber filter, written as the site lists it, e.g. \"9MM LUGER\", \".45 ACP\", \".223 REMINGTON\"."
          },
          "state": {
            "title": "Item location (state)",
            "enum": [
              "",
              "AL",
              "AK",
              "AZ",
              "AR",
              "CA",
              "CO",
              "CT",
              "DE",
              "DC",
              "FL",
              "GA",
              "HI",
              "ID",
              "IL",
              "IN",
              "IA",
              "KS",
              "KY",
              "LA",
              "ME",
              "MD",
              "MA",
              "MI",
              "MN",
              "MS",
              "MO",
              "MT",
              "NE",
              "NV",
              "NH",
              "NJ",
              "NM",
              "NY",
              "NC",
              "ND",
              "OH",
              "OK",
              "OR",
              "PA",
              "RI",
              "SC",
              "SD",
              "TN",
              "TX",
              "UT",
              "VT",
              "VA",
              "WA",
              "WV",
              "WI",
              "WY"
            ],
            "type": "string",
            "description": "Only listings located in this US state.",
            "default": ""
          },
          "shipsToState": {
            "title": "Can be sold to (state)",
            "enum": [
              "",
              "AL",
              "AK",
              "AZ",
              "AR",
              "CA",
              "CO",
              "CT",
              "DE",
              "DC",
              "FL",
              "GA",
              "HI",
              "ID",
              "IL",
              "IN",
              "IA",
              "KS",
              "KY",
              "LA",
              "ME",
              "MD",
              "MA",
              "MI",
              "MN",
              "MS",
              "MO",
              "MT",
              "NE",
              "NV",
              "NH",
              "NJ",
              "NM",
              "NY",
              "NC",
              "ND",
              "OH",
              "OK",
              "OR",
              "PA",
              "RI",
              "SC",
              "SD",
              "TN",
              "TX",
              "UT",
              "VT",
              "VA",
              "WA",
              "WV",
              "WI",
              "WY"
            ],
            "type": "string",
            "description": "Hide listings whose seller excludes this state (GunBroker's own filter), e.g. CA to see only items that can go to California.",
            "default": ""
          },
          "minBids": {
            "title": "Min bids",
            "minimum": 0,
            "type": "integer",
            "description": "Only listings with at least this many bids. 0 = no minimum."
          },
          "maxBids": {
            "title": "Max bids",
            "minimum": 0,
            "type": "integer",
            "description": "Only listings with at most this many bids (0 = no bids yet). Leave empty for no maximum."
          },
          "minStartingBid": {
            "title": "Min starting bid ($)",
            "minimum": 0,
            "type": "integer",
            "description": "Auctions whose starting bid is at least this. 0 = no minimum."
          },
          "maxStartingBid": {
            "title": "Max starting bid ($)",
            "minimum": 0,
            "type": "integer",
            "description": "Auctions whose starting bid is at most this, e.g. 1 for penny auctions. 0 = no maximum."
          },
          "sellerName": {
            "title": "Seller username",
            "type": "string",
            "description": "Only listings from this GunBroker seller, e.g. \"Arms.Club\"."
          },
          "sellerIds": {
            "title": "Seller ids",
            "type": "array",
            "description": "Only listings from these GunBroker seller ids (the number in a seller's feedback URL), e.g. 7775447.",
            "items": {
              "type": "string"
            }
          },
          "upc": {
            "title": "UPC",
            "type": "string",
            "description": "Listings with this UPC, e.g. 764503068256 (Glock 19)."
          },
          "sku": {
            "title": "Seller SKU",
            "type": "string",
            "description": "Listings with this seller SKU."
          },
          "keywordMatch": {
            "title": "Keyword match",
            "enum": [
              "all",
              "any",
              "exact"
            ],
            "type": "string",
            "description": "How search terms match listing titles.",
            "default": "all"
          },
          "excludeWords": {
            "title": "Exclude words",
            "type": "string",
            "description": "Words to leave out of the results, e.g. \"gen5 holster\"."
          },
          "listingFlags": {
            "title": "Only listings that…",
            "type": "array",
            "description": "Any combination of GunBroker's listing filters.",
            "items": {
              "type": "string",
              "enum": [
                "free-shipping",
                "no-reserve",
                "with-pictures",
                "immediate-checkout",
                "accepts-offers",
                "layaway",
                "financing",
                "no-card-fees",
                "ships-international",
                "collectors-elite"
              ],
              "enumTitles": [
                "Offer free shipping",
                "Have no reserve",
                "Have pictures",
                "Can be paid by card immediately",
                "Accept offers",
                "Offer layaway",
                "Offer financing",
                "Charge no credit-card fee",
                "Ship internationally",
                "Are Collector's Elite auctions"
              ]
            }
          },
          "sortBy": {
            "title": "Sort by",
            "enum": [
              "featured",
              "relevance",
              "ending-soonest",
              "ending-latest",
              "newly-listed",
              "oldest-listed",
              "price-low",
              "price-high",
              "most-bids",
              "fewest-bids",
              "item-number-high",
              "item-number-low",
              "quantity-high",
              "quantity-low"
            ],
            "type": "string",
            "description": "Order of the results (GunBroker's own sort).",
            "default": "featured"
          },
          "endingWithinHours": {
            "title": "⏱️ Ending within (hours)",
            "minimum": 0,
            "maximum": 2160,
            "type": "integer",
            "description": "Only listings that end within this many hours, e.g. 24. Uses the ending-soonest order and stops at the first listing past the window. 0 = off."
          },
          "fflSellersOnly": {
            "title": "FFL dealers only",
            "type": "boolean",
            "description": "Only listings from sellers GunBroker marks as FFL holders.",
            "default": false
          },
          "minSellerFeedbackCount": {
            "title": "Min seller feedback",
            "minimum": 0,
            "type": "integer",
            "description": "Only sellers with at least this many feedback ratings, e.g. 100. 0 = off."
          },
          "includeDetails": {
            "title": "➕ Full item record",
            "type": "boolean",
            "description": "Add category path, condition, manufacturer / model / caliber and every spec, location state, shipping and payment methods, return policy, FFL-required flag, start date, starting bid and all photos. Adds about a minute per 100 listings.",
            "default": true
          },
          "includeDescription": {
            "title": "Description & seller terms",
            "type": "boolean",
            "description": "Add the listing description and the seller's terms as plain text (needs the full item record). Long text; off by default.",
            "default": false
          },
          "monitorMode": {
            "title": "🔁 Monitor mode",
            "type": "boolean",
            "description": "Deliver only listings that are new since earlier runs, or whose price or bid count changed (with changeType, previousPrice, previousBids). Unchanged listings are skipped.",
            "default": false
          },
          "monitorStoreName": {
            "title": "Monitor store name",
            "type": "string",
            "description": "Named key-value store that remembers delivered listings between runs. One name per watch list, e.g. \"glock-19-watch\". Default: gunbroker-monitor."
          },
          "maxResults": {
            "title": "📦 Max results",
            "minimum": 0,
            "type": "integer",
            "description": "Most listings to deliver in this run, across all searches. GunBroker serves up to 10,000 listings per search (bigger searches are split by price). 0 = no limit.",
            "default": 100
          },
          "maxResultsPerSearch": {
            "title": "Max results per search",
            "minimum": 0,
            "type": "integer",
            "description": "Cap for each search term or URL. 0 = no per-search cap."
          },
          "splitLargeSearches": {
            "title": "Go past 10,000 per search",
            "type": "boolean",
            "description": "When a search matches 10,000+ listings and you want more, split it into price bands (each band costs one more request).",
            "default": true
          },
          "compact": {
            "title": "Compact output",
            "type": "boolean",
            "description": "Core fields only (id, URL, title, prices, bids, end time, category, condition, make/model/caliber, seller, state, thumbnail) - for AI / MCP pipelines.",
            "default": false
          },
          "maxConcurrency": {
            "title": "Parallel requests",
            "minimum": 1,
            "maximum": 10,
            "type": "integer",
            "description": "Requests in flight at once. Each GunBroker answer takes 20-90 seconds.",
            "default": 5
          },
          "proxyConfiguration": {
            "title": "Proxy",
            "type": "object",
            "description": "Optional: your own proxy URLs are tried first. No setting is needed - the actor picks its own route.",
            "default": {
              "useApifyProxy": 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
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "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
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}