{ "openapi": "3.0.1", "info": { "title": "AUMA Trade Fairs Scraper - Trade Shows & Organisers", "description": "Scrape 7,000+ current and future trade fairs worldwide from the AUMA database: dates, city, country and category. Add organiser contacts (email, phone, website), audited exhibitor, visitor and space figures, exhibitor countries, visitor profile, sectors and products. 13 filters, only new fairs.", "version": "1.0", "x-build-id": "MgaPdhdltcbxfEc94" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/normdata~auma-trade-fairs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-normdata-auma-trade-fairs-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/normdata~auma-trade-fairs-scraper/runs": { "post": { "operationId": "runs-sync-normdata-auma-trade-fairs-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/normdata~auma-trade-fairs-scraper/run-sync": { "post": { "operationId": "run-sync-normdata-auma-trade-fairs-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": { "maxItems": { "title": "Maximum results", "minimum": 1, "type": "integer", "description": "Stop after this many fairs in total. Leave empty for no limit. The Apify Free plan is always capped at 10." }, "industrySectors": { "title": "Industry sectors", "type": "array", "description": "Empty = every sector. A fair matches when it covers any of them.", "items": { "type": "string", "enum": [ "Advertising, Marketing, Franchising", "Aerospace, Airport Construction", "Agriculture, forestry, fisheries, livestock, veterinary medicine", "Arts, Antiques", "Beauty (Cosmetics, Hairdressing, Bodycare)", "Boats, Boat Accessories", "Books, Prints, Licences, Libraries", "Chemical and Petrochemical Industry", "City Sanitation, Water Technology, Waste Disposal, Public Services", "Clothing, Fashion, Accessories", "Computer-Aided Engineering, Factory Automation, Measuring and Control", "Construction Technology, Materials and Equipment, Interior Fittings", "Consumer Electronics, Multimedia", "Crafting, DIY, Collecting", "Defense Technology", "Dental Medicine, Dental Technology", "Design Services", "Electrical Engineering, Electronics", "Energy (conventional and renewable)", "Environment and Climate Protection", "Facility Management", "Finances, Real Estate, Insurances", "Floorings", "Food Processing and Packaging Machinery", "Food, Beverage and Luxury Foodstuff", "Foundry, Metallurgy (Iron, Non-ferrous Metals)", "Funerals and Religion", "Furniture, Interior Design", "Games, Toys, Computer and Video Games", "Gardening and landscaping (plants, equipment, technology)", "General Service Trade Fairs", "General Trade Fairs for Capital and Consumer Goods", "General Trade Fairs for Consumers", "German Specialized Exhibitions Abroad", "Gifts, Watches & Clocks, Jewelry, Crafts, Special Occasion Party Items", "Hardware, Tools", "Health, Wellness, Leisure activities, Way of Life", "Hotel and Catering, Shop Fittings", "Household Goods and Appliances, Ceramics, Glassware", "Industrial Equipment, Maintenance", "Information and Communication Technology, Software", "Laboratory Technology, Biotechnology", "Leather Processing and Shoe Machinery", "Leather, Leather Goods, Shoes", "Lighting, Lighting Technology", "Logistics, Gears and Drives, Conveyance and Storage Technology", "Market and social research", "Medical Engineering, Pharmaceuticals, Care", "Metalworking, Welding Technology", "Mining, Geodesy, Geoinformation", "Music (Instruments, Licences)", "Nursery Equipment, Children's Clothing", "Office Equipment and Supplies", "Ophthalmic Optics", "Paper and Printing Industry, Media Production", "Pet", "Photography, Film (Technology, Licences), Broadcasting and Television Technology", "Plastic and Rubber Processing", "Plumbing, Heating, Air Conditioning, Refrigeration and Ventilation Technology", "Safety, Disaster Control", "Shipbuilding, Port Machinery, Offshore Engineering", "Sports & Fitness", "Subcontracting", "Surface Treatment Technology", "Teaching and Learning Aids, Further and Continuing Education, Business Start-up, Human Resources Development", "Technical Optics, Laser Technology", "Technologies, Inventions, Innovations", "Textile and Clothing Machinery, Textile Cleaning", "Textiles (Clothing and Home Textiles, Technical Textiles)", "Tourism", "Trade Fairs for Capital Goods", "Trade Fairs for Consumer Goods", "Trade Fairs, Congresses and Events, Event and Stage Technology", "Transport and Traffic", "Vehicles (Cars, Commercial Vehicles, Motorcycles, Caravans, Parts and Accessories)", "Wedding & celebrations", "Woodworking, Furniture Production", "World Expositions" ], "enumTitles": [ "Advertising, Marketing, Franchising", "Aerospace, Airport Construction", "Agriculture, forestry, fisheries, livestock, veterinary medicine", "Arts, Antiques", "Beauty (Cosmetics, Hairdressing, Bodycare)", "Boats, Boat Accessories", "Books, Prints, Licences, Libraries", "Chemical and Petrochemical Industry", "City Sanitation, Water Technology, Waste Disposal, Public Services", "Clothing, Fashion, Accessories", "Computer-Aided Engineering, Factory Automation, Measuring and Control", "Construction Technology, Materials and Equipment, Interior Fittings", "Consumer Electronics, Multimedia", "Crafting, DIY, Collecting", "Defense Technology", "Dental Medicine, Dental Technology", "Design Services", "Electrical Engineering, Electronics", "Energy (conventional and renewable)", "Environment and Climate Protection", "Facility Management", "Finances, Real Estate, Insurances", "Floorings", "Food Processing and Packaging Machinery", "Food, Beverage and Luxury Foodstuff", "Foundry, Metallurgy (Iron, Non-ferrous Metals)", "Funerals and Religion", "Furniture, Interior Design", "Games, Toys, Computer and Video Games", "Gardening and landscaping (plants, equipment, technology)", "General Service Trade Fairs", "General Trade Fairs for Capital and Consumer Goods", "General Trade Fairs for Consumers", "German Specialized Exhibitions Abroad", "Gifts, Watches & Clocks, Jewelry, Crafts, Special Occasion Party Items", "Hardware, Tools", "Health, Wellness, Leisure activities, Way of Life", "Hotel and Catering, Shop Fittings", "Household Goods and Appliances, Ceramics, Glassware", "Industrial Equipment, Maintenance", "Information and Communication Technology, Software", "Laboratory Technology, Biotechnology", "Leather Processing and Shoe Machinery", "Leather, Leather Goods, Shoes", "Lighting, Lighting Technology", "Logistics, Gears and Drives, Conveyance and Storage Technology", "Market and social research", "Medical Engineering, Pharmaceuticals, Care", "Metalworking, Welding Technology", "Mining, Geodesy, Geoinformation", "Music (Instruments, Licences)", "Nursery Equipment, Children's Clothing", "Office Equipment and Supplies", "Ophthalmic Optics", "Paper and Printing Industry, Media Production", "Pet", "Photography, Film (Technology, Licences), Broadcasting and Television Technology", "Plastic and Rubber Processing", "Plumbing, Heating, Air Conditioning, Refrigeration and Ventilation Technology", "Safety, Disaster Control", "Shipbuilding, Port Machinery, Offshore Engineering", "Sports & Fitness", "Subcontracting", "Surface Treatment Technology", "Teaching and Learning Aids, Further and Continuing Education, Business Start-up, Human Resources Development", "Technical Optics, Laser Technology", "Technologies, Inventions, Innovations", "Textile and Clothing Machinery, Textile Cleaning", "Textiles (Clothing and Home Textiles, Technical Textiles)", "Tourism", "Trade Fairs for Capital Goods", "Trade Fairs for Consumer Goods", "Trade Fairs, Congresses and Events, Event and Stage Technology", "Transport and Traffic", "Vehicles (Cars, Commercial Vehicles, Motorcycles, Caravans, Parts and Accessories)", "Wedding & celebrations", "Woodworking, Furniture Production", "World Expositions" ] } }, "searchTerms": { "title": "Search words", "type": "array", "description": "Words in the fair title, like \"food\" or \"Medica\". A fair matches when it has every word of any one line.", "items": { "type": "string" } }, "dateFrom": { "title": "Start date from", "type": "string", "description": "Keep fairs starting on or after this date, like 2027-01-01 or \"3 months\" from today. AUMA lists fairs from January of this year on." }, "dateTo": { "title": "Start date to", "type": "string", "description": "Keep fairs starting on or before this date." }, "sortBy": { "title": "Sort by", "enum": [ "date", "dateDesc", "title", "country", "city" ], "type": "string", "description": "Empty = start date, soonest first. Fairs known only by month come after the dated ones of that month." }, "includeDetails": { "title": "Fair details (organiser contacts, exhibitor and visitor figures, profile)", "type": "boolean", "description": "Also read each fair for its organiser (address, phone, email, website), the fair website, email and social links, venue, cycle, year founded, audience, description, sectors, products, exhibitor and visitor numbers (domestic and abroad), space, journalists, exhibitor countries, visitor countries and profile, past editions, German pavilions with prices and deadlines, sponsors, co-located fairs and next editions. AUMA allows about one fair every 3 seconds, so 100 fairs take about 5 minutes. Charged per fair as an add-on." }, "continents": { "title": "Continents", "type": "array", "description": "Empty = worldwide.", "items": { "type": "string", "enum": [ "Africa", "Asia", "Australia/Oceania", "Europe", "North America", "Latin America" ], "enumTitles": [ "Africa", "Asia", "Australia/Oceania", "Europe", "North America", "Latin America" ] } }, "countries": { "title": "Countries", "type": "array", "description": "Empty = every country.", "items": { "type": "string", "enum": [ "Albania", "Algeria", "Angola", "Argentina", "Armenia", "Australia", "Austria", "Azerbaijan", "Bahrain", "Bangladesh", "Belarus", "Belgium", "Bolivia", "Bosnia and Herzegovina", "Brazil", "Bulgaria", "Burkina Faso", "Cambodia", "Cameroon", "Canada", "Chile", "China, People's Republic", "Colombia", "Congo, Democratic Republic", "Costa Rica", "Côte d'Ivoire", "Croatia", "Cuba", "Cyprus", "Czechia", "Denmark", "Dominican Republic", "Ecuador", "Egypt", "El Salvador", "Estonia", "Ethiopia", "Finland", "France", "Georgia", "Germany", "Ghana", "Greece", "Guatemala", "Hong Kong, China SAR", "Hungary", "Iceland", "India", "Indonesia", "Iran, Islamic Republic", "Iraq", "Ireland", "Israel", "Italy", "Jamaica", "Japan", "Jordan", "Kazakhstan", "Kenya", "Korea, Democratic People's Republic", "Korea, Republic", "Kosovo", "Kuwait", "Kyrgyzstan", "Lao People's Democratic Republic", "Latvia", "Lebanon", "Libya", "Lithuania", "Luxembourg", "Macao, China SAR", "Madagascar", "Malaysia", "Mexico", "Moldova, Republic", "Monaco", "Mongolia", "Montenegro", "Morocco", "Mozambique", "Myanmar", "Namibia", "Nepal", "Netherlands", "New Zealand", "Nigeria", "North Macedonia", "Norway", "not yet determined", "Oman", "Pakistan", "Panama", "Peru", "Philippines", "Poland", "Portugal", "Qatar", "Romania", "Russia", "Rwanda", "Saudi Arabia", "Senegal", "Serbia", "Singapore", "Slovakia", "Slovenia", "South Africa", "Spain", "Sudan", "Sweden", "Switzerland", "Syrian Arab Republic", "Taiwan", "Tanzania, United Republic", "Thailand", "Trinidad and Tobago", "Tunisia", "Türkiye", "Turkmenistan", "Uganda", "Ukraine", "United Arab Emirates", "United Kingdom of Great Britain and Northern Ireland", "United States of America", "Uruguay", "Uzbekistan", "Vietnam", "Zambia", "Zimbabwe" ], "enumTitles": [ "Albania", "Algeria", "Angola", "Argentina", "Armenia", "Australia", "Austria", "Azerbaijan", "Bahrain", "Bangladesh", "Belarus", "Belgium", "Bolivia", "Bosnia and Herzegovina", "Brazil", "Bulgaria", "Burkina Faso", "Cambodia", "Cameroon", "Canada", "Chile", "China, People's Republic", "Colombia", "Congo, Democratic Republic", "Costa Rica", "Côte d'Ivoire", "Croatia", "Cuba", "Cyprus", "Czechia", "Denmark", "Dominican Republic", "Ecuador", "Egypt", "El Salvador", "Estonia", "Ethiopia", "Finland", "France", "Georgia", "Germany", "Ghana", "Greece", "Guatemala", "Hong Kong, China SAR", "Hungary", "Iceland", "India", "Indonesia", "Iran, Islamic Republic", "Iraq", "Ireland", "Israel", "Italy", "Jamaica", "Japan", "Jordan", "Kazakhstan", "Kenya", "Korea, Democratic People's Republic", "Korea, Republic", "Kosovo", "Kuwait", "Kyrgyzstan", "Lao People's Democratic Republic", "Latvia", "Lebanon", "Libya", "Lithuania", "Luxembourg", "Macao, China SAR", "Madagascar", "Malaysia", "Mexico", "Moldova, Republic", "Monaco", "Mongolia", "Montenegro", "Morocco", "Mozambique", "Myanmar", "Namibia", "Nepal", "Netherlands", "New Zealand", "Nigeria", "North Macedonia", "Norway", "not yet determined", "Oman", "Pakistan", "Panama", "Peru", "Philippines", "Poland", "Portugal", "Qatar", "Romania", "Russia", "Rwanda", "Saudi Arabia", "Senegal", "Serbia", "Singapore", "Slovakia", "Slovenia", "South Africa", "Spain", "Sudan", "Sweden", "Switzerland", "Syrian Arab Republic", "Taiwan", "Tanzania, United Republic", "Thailand", "Trinidad and Tobago", "Tunisia", "Türkiye", "Turkmenistan", "Uganda", "Ukraine", "United Arab Emirates", "United Kingdom of Great Britain and Northern Ireland", "United States of America", "Uruguay", "Uzbekistan", "Vietnam", "Zambia", "Zimbabwe" ] } }, "cities": { "title": "Cities", "type": "array", "description": "City names as AUMA writes them in English, like Munich, Cologne, Dubai or Las Vegas.", "items": { "type": "string" } }, "germanStates": { "title": "German states", "type": "array", "description": "Fairs in Germany held in these states.", "items": { "type": "string", "enum": [ "Baden-Württemberg", "Bavaria", "Berlin", "Brandenburg", "Bremen", "Hamburg", "Hesse", "Lower Saxony", "Mecklenburg-West-Pommerania", "North Rhine-Westphalia", "Rhineland-Palatinate", "Saarland", "Saxony", "Saxony-Anhalt", "Schleswig-Holstein", "Thuringia" ], "enumTitles": [ "Baden-Württemberg", "Bavaria", "Berlin", "Brandenburg", "Bremen", "Hamburg", "Hesse", "Lower Saxony", "Mecklenburg-West-Pommerania", "North Rhine-Westphalia", "Rhineland-Palatinate", "Saarland", "Saxony", "Saxony-Anhalt", "Schleswig-Holstein", "Thuringia" ] } }, "organisers": { "title": "Organisers", "type": "array", "description": "Organiser names or part of them, like \"Messe Frankfurt\" or \"RX Global\". Each matching AUMA organiser is one more search.", "items": { "type": "string" } }, "categories": { "title": "Category (fairs in Germany)", "type": "array", "description": "AUMA category of fairs held in Germany. Fairs abroad have none, so picking one keeps only German fairs.", "items": { "type": "string", "enum": [ "international", "national", "regional", "new" ], "enumTitles": [ "International (Germany)", "National (Germany)", "Regional (Germany)", "New (Germany)" ] } }, "germanSupport": { "title": "German exhibitor support", "type": "array", "description": "Keep fairs with a German federal or state pavilion, or a Young Innovators stand.", "items": { "type": "string", "enum": [ "federal", "state", "youngInnovators" ], "enumTitles": [ "German federal pavilion (AMP)", "German state pavilion (LPA)", "Young Innovators stand" ] } }, "fkmCertifiedOnly": { "title": "Only FKM certified figures", "type": "boolean", "description": "Keep fairs whose exhibitor, visitor and space figures are audited by FKM." }, "germanOrganisersAbroadOnly": { "title": "Only German organisers abroad", "type": "boolean", "description": "Keep fairs abroad run by German organisers (AUMA GTQ label)." }, "onlyNew": { "title": "Only new fairs", "type": "boolean", "description": "Skip fairs saved by earlier runs with the same monitor name." }, "monitorName": { "title": "Monitor name", "type": "string", "description": "Runs with the same name share their history. Use a different name for each schedule." }, "startUrls": { "title": "Links", "type": "array", "description": "Trade fair pages (https://www.auma.de/en/find-your-fair/details/?tfd=hanover_euroblech_227825) or \"Find your fair\" searches with their filters (https://www.auma.de/en/find-your-fair/?strFilterCountry=Germany).", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } } } }, "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 } } } } } } } } } }