{
  "openapi": "3.0.1",
  "info": {
    "title": "DOTmed Scraper - Medical Equipment Listings, Auctions & Sellers",
    "description": "Scrape DOTmed medical equipment and parts listings, auctions and private sales by keyword, category or URL: price, condition, manufacturer, model, seller company, contact, phone and rating, plus full listing details, auction end times and a new-listing monitor.",
    "version": "0.1",
    "x-build-id": "yaCmcgsaID0Srydb1"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/scrapersdelight~dotmed-listings-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-scrapersdelight-dotmed-listings-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~dotmed-listings-scraper/runs": {
      "post": {
        "operationId": "runs-sync-scrapersdelight-dotmed-listings-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~dotmed-listings-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-scrapersdelight-dotmed-listings-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 keywords",
            "type": "array",
            "description": "Keywords as you would type them in DOTmed's search box: brand, model or equipment type, e.g. \"Voluson E8\", \"CT scanner\", \"GE OEC 9900\". One search per line.",
            "items": {
              "type": "string"
            }
          },
          "searchSection": {
            "title": "Equipment or parts",
            "enum": [
              "equipment",
              "parts"
            ],
            "type": "string",
            "description": "DOTmed keeps equipment and parts apart. Applies to keyword searches and categories.",
            "default": "equipment"
          },
          "categories": {
            "title": "Categories",
            "type": "array",
            "description": "Browse every equipment type page under these DOTmed categories (e.g. Imaging covers CT, MRI, ultrasound, C-arms...). Pair with a result cap; Imaging alone lists 36,000+ items.",
            "items": {
              "type": "string",
              "enum": [
                "imaging",
                "surgical",
                "laboratory",
                "cardiology",
                "radiation-therapy",
                "monitors-icu-ccu",
                "respiratory",
                "endoscopy",
                "dental",
                "ophthalmology",
                "neurology",
                "physical-therapy",
                "homecare-rehab",
                "veterinary",
                "exam-room",
                "beds-stretchers-and-furniture",
                "defibrillator",
                "pumps",
                "sterile-processing",
                "neonatal",
                "cosmetic",
                "ems-rescue",
                "consumables-and-supplies",
                "personal-protective-equipment",
                "all-others"
              ],
              "enumTitles": [
                "Imaging",
                "Surgical",
                "Laboratory",
                "Cardiology",
                "Radiation Therapy",
                "Monitors / ICU / CCU",
                "Respiratory",
                "Endoscopy",
                "Dental",
                "Ophthalmology",
                "Neurology",
                "Physical Therapy",
                "Homecare / Rehab",
                "Veterinary",
                "Exam Room",
                "Beds, Stretchers & Furniture",
                "Defibrillator",
                "Pumps",
                "Sterile Processing",
                "Neonatal",
                "Cosmetic",
                "EMS / Rescue",
                "Consumables & Supplies",
                "Personal Protective Equipment",
                "All Others"
              ]
            }
          },
          "startUrls": {
            "title": "DOTmed URLs",
            "type": "array",
            "description": "Any DOTmed search, newest-listings or category page URL (its filters are kept), or single listing / auction / private-sale URLs, e.g. https://www.dotmed.com/listing/hospital-bed/hill-rom/p3200/5924822.",
            "items": {
              "type": "object",
              "required": [
                "url"
              ],
              "properties": {
                "url": {
                  "type": "string",
                  "title": "URL of a web page",
                  "format": "uri"
                }
              }
            }
          },
          "listingType": {
            "title": "Listing type",
            "enum": [
              "all",
              "listings",
              "auctions",
              "privateSales"
            ],
            "type": "string",
            "description": "Fixed-price listings, auctions, private sales (sold through DOTmed Gold Service Dealers), or all of them.",
            "default": "all"
          },
          "saleMode": {
            "title": "For sale / wanted",
            "enum": [
              "all",
              "sale",
              "wanted",
              "rent",
              "lease"
            ],
            "type": "string",
            "description": "DOTmed's listing mode: equipment for sale, wanted ads (buyers looking for equipment), for rent or for lease.",
            "default": "all"
          },
          "condition": {
            "title": "Condition",
            "enum": [
              "all",
              "used",
              "new",
              "refurbished",
              "oem"
            ],
            "type": "string",
            "description": "Keep only used, new, refurbished or OEM-direct listings.",
            "default": "all"
          },
          "country": {
            "title": "Country",
            "type": "string",
            "description": "Two-letter country code of the seller's listing, e.g. \"US\", \"DE\", \"IN\". Empty = every country.",
            "default": ""
          },
          "region": {
            "title": "Region",
            "enum": [
              "all",
              "north-america",
              "europe",
              "asia",
              "south-america",
              "oceania",
              "africa"
            ],
            "type": "string",
            "description": "World region of the listing.",
            "default": "all"
          },
          "zipCode": {
            "title": "Near ZIP code",
            "type": "string",
            "description": "US ZIP code to search around, e.g. \"10001\". Use with Distance.",
            "default": ""
          },
          "distanceMiles": {
            "title": "Distance (miles)",
            "minimum": 5,
            "maximum": 500,
            "type": "integer",
            "description": "Radius around the ZIP code. DOTmed offers 5, 10, 20, 50, 100, 300 or 500 miles; other values round to the nearest.",
            "default": 100
          },
          "inStockOnly": {
            "title": "In stock only",
            "type": "boolean",
            "description": "Only listings DOTmed marks as in stock.",
            "default": false
          },
          "buyNowOnly": {
            "title": "Buy It Now only",
            "type": "boolean",
            "description": "Only listings with DOTmed's Buy It Now button (card / PayPal checkout).",
            "default": false
          },
          "withPhotosOnly": {
            "title": "With photos only",
            "type": "boolean",
            "description": "Only listings that have photos.",
            "default": false
          },
          "withVideoOnly": {
            "title": "With video only",
            "type": "boolean",
            "description": "Only listings that have a video.",
            "default": false
          },
          "sortBy": {
            "title": "Sort",
            "enum": [
              "relevance",
              "priceLowToHigh",
              "priceHighToLow"
            ],
            "type": "string",
            "description": "Order of keyword-search and category results. The newest-listings feed is always newest first.",
            "default": "relevance"
          },
          "titleOnly": {
            "title": "Match keywords in title only",
            "type": "boolean",
            "description": "Keyword searches match the listing title only, not the description.",
            "default": false
          },
          "matchAllWords": {
            "title": "Match all keywords",
            "type": "boolean",
            "description": "Keyword searches return only listings that contain every word you typed.",
            "default": false
          },
          "manufacturers": {
            "title": "Manufacturers",
            "type": "array",
            "description": "Keep only rows whose manufacturer contains one of these (case-insensitive), e.g. \"Siemens\", \"GE\", \"Philips\".",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "minPrice": {
            "title": "Minimum price",
            "minimum": 0,
            "type": "integer",
            "description": "Lowest asking price (or current bid for auctions), in the listing's currency. Rows without a price are dropped when a price limit is set."
          },
          "maxPrice": {
            "title": "Maximum price",
            "minimum": 0,
            "type": "integer",
            "description": "Highest asking price (or current bid for auctions), in the listing's currency."
          },
          "listedWithinDays": {
            "title": "Listed within (days)",
            "minimum": 0,
            "maximum": 3650,
            "type": "integer",
            "description": "Only listings dated within this many days (DOTmed's listing date). 0 = any date.",
            "default": 0
          },
          "excludeKeywords": {
            "title": "Exclude keywords",
            "type": "array",
            "description": "Drop rows whose title, summary or description contains any of these, e.g. \"for parts\", \"not working\".",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "withPhoneOnly": {
            "title": "Only sellers with a phone",
            "type": "boolean",
            "description": "Keep only rows whose seller shows a phone number on DOTmed.",
            "default": false
          },
          "scrapeDetails": {
            "title": "Scrape full listing details",
            "type": "boolean",
            "description": "Open each listing's page for condition, quantity, in-stock, MPN, specs, full description, all photos, location, WhatsApp, rating and items sold; for auctions the exact end time, lot and buyer's premium. Charged per row as the listing-details event. About 6 s per row.",
            "default": false
          },
          "includeSellerContact": {
            "title": "Include seller contact",
            "type": "boolean",
            "description": "Include the seller's contact person, phone, WhatsApp, Instagram and profile link as DOTmed shows them. Turn off for company-level rows only.",
            "default": true
          },
          "monitorMode": {
            "title": "Only new listings (monitor)",
            "type": "boolean",
            "description": "Remember delivered listings per search/category/feed in a named store and return only new ones on later runs. With full listing details on, a listing delivered earlier without them comes back once with them (changeType DETAILS).",
            "default": false
          },
          "monitorStoreName": {
            "title": "Monitor store name",
            "type": "string",
            "description": "Name of the key-value store that remembers delivered listings. Use a different name per schedule.",
            "default": "dotmed-monitor"
          },
          "maxResults": {
            "title": "Max results",
            "minimum": 0,
            "type": "integer",
            "description": "Most rows to return across all sources. 0 = no cap (a keyword search reaches DOTmed's full result list, e.g. ~18,000 for \"ultrasound\").",
            "default": 100
          },
          "maxResultsPerSource": {
            "title": "Max results per source",
            "minimum": 0,
            "type": "integer",
            "description": "Most rows from each keyword, category or URL. 0 = only the overall cap applies.",
            "default": 0
          },
          "descriptionMaxLength": {
            "title": "Description max length",
            "minimum": 0,
            "type": "integer",
            "description": "Cut descriptions to this many characters. 0 = full text.",
            "default": 0
          },
          "compact": {
            "title": "Compact output",
            "type": "boolean",
            "description": "Core fields only (id, title, maker, model, price, location, seller, phone, description), sized for AI agents and MCP.",
            "default": false
          },
          "proxyConfiguration": {
            "title": "Proxy",
            "type": "object",
            "description": "Optional. The actor connects directly and switches to a proxy only if DOTmed refuses the connection; set your own proxy here to use it as that fallback.",
            "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}