{ "openapi": "3.0.1", "info": { "title": "Numista Coin Catalogue Scraper", "description": "Scrape Numista's coin, banknote, and exonumia catalogue. Search by keyword, or browse by issuer, ruler, material, mint, tag, shape, technique, or script, refined by face value, weight, diameter, or lettering. Get composition, weight, mintage years, catalogue references, and images.", "version": "1.0", "x-build-id": "snfv3gPsFnmuOdXb9" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/crawlerbros~numista-coin-catalogue-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-crawlerbros-numista-coin-catalogue-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/crawlerbros~numista-coin-catalogue-scraper/runs": { "post": { "operationId": "runs-sync-crawlerbros-numista-coin-catalogue-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/crawlerbros~numista-coin-catalogue-scraper/run-sync": { "post": { "operationId": "run-sync-crawlerbros-numista-coin-catalogue-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", "required": [ "mode" ], "properties": { "mode": { "title": "Mode", "enum": [ "search", "byIssuer", "byCoinId", "byRuler", "byMaterial", "byMint", "byTag", "byShape", "byTechnique", "byScript" ], "type": "string", "description": "What to fetch from the Numista catalogue.", "default": "byCoinId" }, "searchQuery": { "title": "Search query (mode=search)", "type": "string", "description": "Free-text query, e.g. `morgan dollar`, `1 franc`, `elizabeth ii crown`. Put quotes around a phrase for an exact match, use `*` as a wildcard, and a leading `-` to exclude a word.", "default": "morgan dollar" }, "issuer": { "title": "Issuing country / entity (mode=search refinement, mode=byIssuer)", "enum": [ "afghanistan_section", "albania_section", "algeria_section", "andorre", "angola", "argentina", "armenie", "australia_section", "austria", "azerbaijan", "bahamas", "bahrein", "bangladesh", "barbade", "bielorussie", "belgium", "belize_section", "benin_section", "bhoutan", "bolivie", "bosnia_herzegovina_section", "botswana", "brazil_section", "brunei", "bulgaria_section", "burkina-faso", "burundi", "cambodia_section", "cameroon_section", "canada_section", "cap-vert", "republique_centrafricaine", "tchad", "chile_section", "china", "colombia_section", "comores", "costa_rica", "croatia", "cuba", "chypre_section", "czech", "drc", "denmark", "djibouti_section", "dominica", "dominican-republic", "equateur", "egypte", "salvador", "guinee_equatoriale", "eritrea_section", "estonia_section", "swaziland", "ethiopia_section", "fidji", "finlande", "france_section", "gabon", "gambie", "georgia_section", "germany", "ghana_section", "greece", "grenada", "guatemala", "guinee", "guyana_section", "haiti_section", "honduras", "hungary", "islande", "india", "indonesia", "iran_section", "iraq", "irlande", "israel_section", "italy", "cote-d-ivoire", "jamaique", "japan_section", "jordanie", "kazakhstan", "kenya_section", "kiribati", "kosovo", "koweit", "kirghizistan", "laos_section", "lettonie_section", "liban", "lesotho", "liberia", "libya_section", "liechtenstein", "lithuania_section", "luxembourg_section", "madagascar", "malawi", "malaysia", "maldives", "mali", "malte", "mauritanie", "maurice", "mexico", "moldavie", "monaco", "mongolie", "montenegro_section", "morocco_section", "mozambique", "myanmar_section", "namibie", "nauru", "nepal_section", "netherlands", "new_zealand_section", "nicaragua_section", "niger", "nigeria_section", "coree_du_nord", "north_macedonia_section", "norway", "oman_section", "pakistan", "palaos", "panama", "papua-new-guinea", "paraguay_section", "perou_section", "philippines_section", "poland_section", "portugal_section", "qatar", "congo-brazzaville", "romania_section", "russia", "rwanda", "samoa", "saint-marin", "saudi-arabia", "senegal_section", "serbia_section", "seychelles", "sierra_leone", "singapour", "slovaquie", "slovenie", "iles_salomon", "somalia", "south-africa", "coree_du_sud", "sud_soudan", "spain", "sri-lanka", "sudan", "suriname", "sweden_section", "switzerland", "syria", "taiwan", "tadjikistan", "tanzania", "thailande", "togo", "tonga", "trinite-et-tobago_section", "tunisie", "turquie", "turkmenistan", "tuvalu", "ouganda", "ukraine_section", "uae", "united-kingdom", "united-states", "uruguay", "ouzbekistan", "vanuatu_section", "papal_states_section", "venezuela_section", "viet-nam", "yemen_section", "zambie", "zimbabwe_section" ], "type": "string", "description": "Restrict results to coins/banknotes issued by this country or historical entity." }, "customIssuerSlug": { "title": "Custom issuer slug (advanced, mode=byIssuer)", "type": "string", "description": "Overrides `issuer` with any Numista issuer slug not in the dropdown (find it in a catalogue.numista.com/catalogue/-1.html URL)." }, "coinIds": { "title": "Catalogue IDs or URLs (mode=byCoinId)", "type": "array", "description": "Numista catalogue numbers (e.g. `1492`) or full URLs (e.g. `https://en.numista.com/1492`).", "default": [ "1492" ], "items": { "type": "string" } }, "ruler": { "title": "Ruler / monarch (mode=byRuler)", "enum": [ "1905", "1492", "6814", "271", "275", "754", "272", "274", "1386", "151", "1166", "1159", "762", "2", "7", "1489", "1566", "5717", "1161", "270", "1162", "1304" ], "type": "string", "description": "A curated list of well-known rulers. Use `customRulerId` for any ruler not listed here." }, "customRulerId": { "title": "Custom ruler ID (advanced, mode=byRuler)", "minimum": 1, "maximum": 999999, "type": "integer", "description": "Overrides `ruler` with any Numista ruler ID not in the dropdown (find it in a ruler.php?id= URL)." }, "material": { "title": "Material / composition (mode=byMaterial)", "enum": [ "38", "45", "50", "10", "30", "54", "34", "7", "4", "5", "37", "24", "63", "41", "39", "3", "2", "36", "17", "60", "48", "64", "6", "74", "13", "21", "75", "62", "56", "28", "8", "16", "65", "12", "53", "55", "49", "18", "52", "44", "25", "14", "22", "26", "33", "70", "71", "1", "15", "9", "40", "19", "58", "57", "61", "35", "23", "47", "20", "27", "11", "42" ], "type": "string", "description": "The metal or material the coin/token is made of.", "default": "2" }, "mint": { "title": "Mint (mode=byMint)", "enum": [ "232", "5", "280", "294", "1319", "41", "14", "1", "21", "26", "19", "20", "23", "17", "16", "288", "10", "11", "12", "13" ], "type": "string", "description": "A curated list of well-known mints. Use `customMintId` for any mint not listed here." }, "customMintId": { "title": "Custom mint ID (advanced, mode=byMint)", "minimum": 1, "maximum": 999999, "type": "integer", "description": "Overrides `mint` with any Numista mint ID not in the dropdown (find it in a mint.php?id= URL)." }, "tags": { "title": "Theme tags (mode=byTag)", "type": "array", "description": "One or more subject tags (e.g. animals, ships, sports). Selecting several narrows results to items matching all of them.", "items": { "type": "string", "enum": [ "34", "43", "209", "133", "137", "12", "151", "172", "185", "24", "97", "51", "30", "54", "177", "107", "52", "115", "68", "170", "13", "80", "20", "196", "129", "90", "48", "100", "82", "21", "154", "50", "16", "197", "31", "156", "114", "4", "6", "176", "202", "39", "144", "102", "78", "84", "79", "101", "138", "152", "108", "199", "27", "81", "146", "75", "17", "171", "64", "121", "216", "67", "77", "95", "1", "175", "118", "91", "65", "117", "160", "179", "122", "14", "5", "99", "11", "226", "219", "131", "37", "164", "173", "153", "132", "188", "225", "59", "104", "150", "184", "41", "119", "200", "106", "53", "205", "15", "161", "128", "35", "66", "73", "71", "206", "111", "26", "7", "89", "69", "47", "127", "109", "18", "187", "207", "180", "36", "92", "141", "105", "201", "72", "123", "25", "42", "29", "214", "166", "163", "223", "218", "134", "157", "147", "148", "182", "28", "110", "87", "120", "96", "208", "103", "126", "85", "22", "9", "93", "40", "124", "145", "136", "220", "165", "116", "49", "143", "183", "210", "88", "167", "140", "135", "56", "139", "222", "46", "94", "62", "74", "212", "83", "70", "55", "162", "3", "159", "23", "2", "149", "181", "178", "38", "189", "158", "61", "98", "60", "174", "57", "113", "213", "76", "86", "155", "33", "19", "112", "10", "142", "186", "169", "168", "63", "198", "194", "44", "204", "58", "193", "8", "221", "224", "217", "215", "203", "32", "45", "130" ], "enumTitles": [ "Agriculture", "Allegory", "Altar", "Amphibian", "Anchor", "Animals", "Arachnid", "Armillary sphere", "Armour", "Art", "Artist", "Asian Games", "Astrology", "Athletics", "Banknote depiction", "Baseball", "Basketball", "Beach", "Bear", "Bike or motorcycle", "Bird", "Birth anniversary", "Boat or watercraft", "Bowling", "Boxing or wrestling", "Bridge", "Buildings", "Caduceus", "Camel or camelid", "Car", "Carnival or festival", "Castle or fortification", "Cat or feline", "Chess", "Chinese calendar", "Christogram", "Cinema", "Coat of Arms", "Coin depiction", "Coins, banknotes, stamps", "Cold weapons", "Commonwealth Games", "Container or tableware", "Cornucopia", "Coronation", "Cow or bovine", "Cricket", "Cross", "Crown", "Crustacean", "Cycling", "Dam", "Dance", "Death anniversary", "Deer or cervid", "Desert", "Dog or canid", "Double-headed eagle", "Eagle", "Education", "Eighty Years' War (1568-1648)", "Elephant", "Events", "Explorer", "FAO", "FIFA World Cup", "Fair or exhibition", "Famous people", "Fantasy animal", "Fasces", "Feminism", "Fictional character", "Firearms", "Fish", "Flag", "Fleur-de-lis", "Flower", "Franco-Dutch War (1672-1678)", "Franco-Spanish War (1635-1659)", "Fruit", "Games and sports events", "Globe", "Globus cruciger", "Goat or caprine", "Golf", "Government building", "Great Northern War (1700-1721)", "Gymnastics", "Hammer and sickle", "Hand", "Handicraft", "Hat", "Health", "Heart", "Hexagram", "Hockey", "Hologram", "Horse or equine", "Human rights", "Independence", "Industry", "Insect", "Lake", "Landscapes", "Latent image", "Lighthouse", "Literature", "Map", "Marine invertebrate", "Marine mammal", "Marriage", "Marsupial", "Martial arts", "Means of transport", "Memorial", "Micro inscriptions", "Military leader", "Millennium", "Monarch", "Monogram", "Moon", "Motorsports", "Mountain", "Museum", "Music", "Mustache / Beard", "Mythology", "Napoleonic Wars (1803-1815)", "National day", "Natural phenomenon", "Nine Years' War (1688-1697)", "Northern Seven Years' War (1563-1570)", "Objects", "Organizations", "Other animal", "Other building", "Other sport", "Painting", "Palace", "Park", "Peace", "Philosopher", "Photoluminescence", "Phrygian cap", "Pig or porcine", "Places", "Plane or aircraft", "Plants", "Politician", "Prehistoric animal", "Primate", "Puzzle coin", "Rabbit", "Reapers' War (1640-1659)", "Red Cross", "Region", "Religious building", "Religious figure", "Religious holiday", "Religious implements", "Reptile", "Revolution or civil war", "River", "Rodent", "Rugby", "Scale", "Schmalkaldic War (1545-1552)", "Science", "Scientist", "Sculpture", "Sea", "Seven Years' War (1756-1763)", "Sheep or ovine", "Shell", "Ski", "Slavery", "Soccer", "Social history", "Space", "Sports", "Sports venue", "Sportsperson", "Stamp depiction", "Summer Olympic Games", "Sun", "Sustainability", "Swimming", "Symbols", "Table tennis", "Technology", "Tennis", "Theatre", "Thirty Years' War (1618-1648)", "Tower", "Town", "Toy or game", "Trade", "Train", "Treaty", "Tree", "Triskelion", "Trophy of arms", "Truck or tractor", "Tunnel", "Turtle or tortoise", "UNESCO", "UNICEF", "United Nations", "Visual effects", "Volleyball", "WWF", "War", "War of the Austrian Succession (1740-1748)", "War of the First Coalition (1792-1797)", "War of the Spanish Succession (1700-1714)", "Wars and conflicts", "Weapons", "Western astrological sign", "Winter Olympic Games", "Wreath" ] }, "default": [] }, "shape": { "title": "Shape (mode=byShape)", "enum": [ "round", "square", "polygonal", "hole", "scalloped", "51", "49", "35", "10", "12", "47", "62", "53", "11", "7", "57", "6", "58", "59", "66", "65", "56", "45", "42", "72", "9", "8", "48", "68", "50", "36", "37", "60", "5", "63", "4", "46", "43", "64", "1", "2", "34", "33", "31", "32", "38", "39", "15", "20", "21", "22", "23", "24", "25", "26", "27", "29", "14", "18", "30", "75", "54", "73", "44", "41", "55", "40", "71", "74", "3", "13", "150", "100", "102", "101", "103", "105", "104", "missing" ], "type": "string", "description": "The physical shape of the coin/token/banknote." }, "mintingTechnique": { "title": "Minting / printing technique (mode=byTechnique)", "enum": [ "hammered", "milled", "1", "36", "5", "6", "7", "4", "2", "24", "20", "25", "23", "21", "22", "11", "41", "38", "12", "3", "39", "10", "34", "29", "30", "32", "37", "42", "33", "35", "31", "missing" ], "type": "string", "description": "How the coin/token was struck (hammered, milled, cast...) or the banknote was printed (offset, lithography...)." }, "script": { "title": "Script (mode=byScript)", "enum": [ "1", "2", "3", "4", "93", "95", "92", "110", "94", "5", "6", "96", "105", "70", "7", "9", "10", "8", "114", "73", "11", "19", "12", "13", "14", "15", "16", "17", "18", "101", "20", "21", "22", "112", "99", "103", "23", "102", "25", "85", "26", "86", "27", "28", "91", "29", "30", "31", "32", "34", "67", "113", "81", "77", "78", "79", "80", "50", "68", "35", "111", "36", "65", "106", "37", "76", "75", "38", "39", "40", "43", "89", "24", "90", "41", "107", "64", "44", "108", "62", "45", "100", "82", "46", "63", "47", "48", "49", "109", "71", "88", "51", "87", "52", "98", "53", "84", "83", "104", "116", "54", "55", "56", "57", "58", "59", "74", "66", "60", "61", "97", "72", "missing" ], "type": "string", "description": "The writing script used in the coin/banknote's lettering (e.g. Latin, Arabic, Chinese, Cyrillic)." }, "faceValue": { "title": "Face value (refinement, all search/browse modes)", "type": "string", "description": "Restrict results to a specific numeric face value (e.g. `5`, `25`, `1.5`), regardless of currency/denomination unit. Combine with any search or browse mode." }, "weight": { "title": "Weight in grams (refinement, all search/browse modes)", "type": "string", "description": "Restrict results to a weight in grams — a single value (e.g. `9.5`, with a built-in ±0.5g tolerance) or a range (e.g. `7.5-10`)." }, "diameter": { "title": "Diameter in mm (refinement, all search/browse modes)", "type": "string", "description": "Restrict results to a diameter/size in millimetres — a single value (e.g. `24`, with a built-in ±0.5mm tolerance) or a range (e.g. `20-25`)." }, "width": { "title": "Width in mm (refinement, all search/browse modes)", "type": "string", "description": "Restrict results to a width in millimetres (for rectangular items such as banknotes) — a single value or a range (e.g. `60-70`)." }, "lettering": { "title": "Lettering / inscription (refinement, all search/browse modes)", "type": "string", "description": "Restrict results to items whose visible obverse/reverse lettering matches this text. Use `*` as a wildcard for any unreadable letters (e.g. `UNITED STA*S`)." }, "engraver": { "title": "Engraver / designer (refinement, all search/browse modes)", "type": "string", "description": "Restrict results to items credited to this engraver or designer." }, "usableInYear": { "title": "Usable in year (refinement, all search/browse modes)", "type": "string", "description": "Restrict results to currency that was in circulation in this year (e.g. `1950`), or `now` for currency still in use today." }, "recordTypeFilter": { "title": "Catalogue type filter", "enum": [ "all", "coin", "banknote", "exonumia" ], "type": "string", "description": "Restrict results to a single catalogue type (search/browse modes only).", "default": "all" }, "yearMin": { "title": "Year (min)", "minimum": -3000, "maximum": 2100, "type": "integer", "description": "Drop items whose (first) year is before this. Only applied when a single year could be parsed." }, "yearMax": { "title": "Year (max)", "minimum": -3000, "maximum": 2100, "type": "integer", "description": "Drop items whose (first) year is after this. Only applied when a single year could be parsed." }, "swapAvailableOnly": { "title": "Available for swap only", "type": "boolean", "description": "Only emit items that at least one Numista member has listed as available for swap.", "default": false }, "maxItems": { "title": "Max items", "minimum": 1, "maximum": 50, "type": "integer", "description": "Hard cap on emitted records. Search/browse modes are limited to a single results page (Numista blocks deeper pagination), so the practical ceiling is 50.", "default": 20 } } }, "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 } } }, "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 } } } } } } } } } }