# Trade Fairs Calendar — Dates, Venue & Organizer Contacts (`nikse77/trade-fairs-calendar`) Actor

Trade fair calendar for any country: dates, venue and full organizer contact details (address, phone, email, website) for lead generation and event planning. Sourced from eventseye.com's worldwide directory.

- **URL**: https://apify.com/nikse77/trade-fairs-calendar.md
- **Developed by:** [A L](https://apify.com/nikse77) (community)
- **Categories:** Lead generation, Automation, Other
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.00 / 1,000 results

This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):

```bash
npm install apify-client
```

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):

```bash
pip install apify-client
```

In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):

````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash

In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).

If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).


# README

## Trade Fairs Calendar — Dates, Venue & Organizer Contacts

### What does Trade Fairs Calendar do?

This Actor extracts the **calendar of trade fairs and exhibitions for any country** — dates, city, venue and full **organizer contact details** (company name, address, phone, fax, email, website) — sourced from [eventseye.com](https://www.eventseye.com)'s worldwide trade show directory. Get Italy's ~500 fairs, or switch the country to France, Germany, Spain and dozens more.

Running on the Apify platform gives you API access, scheduling, webhooks and integrations (Google Sheets, Make, Zapier, LangChain) on top of a clean, structured dataset instead of manually browsing a directory site.

### Why use Trade Fairs Calendar?

- **Lead generation** — organizer contact details (phone, email) are ready to import into a CRM for exhibition-space sales, sponsorships, or B2B outreach to event organizers.
- **Event planning** — find every fair in your industry (via the `industries` tags) across a whole country to plan which ones to exhibit at or visit.
- **Market research** — track how many fairs run in a sector, how often (`cycle`), and where.
- **AI agents** — feed clean, typed JSON to an LLM agent or dashboard instead of scraping a directory page yourself.

### How to use Trade Fairs Calendar

1. Open the Actor and click **Try for free**.
2. Set **Country** (e.g. `italy`, `france`, `germany` — lowercase, hyphens for multi-word names).
3. Set **Max fairs** and click **Start**.
4. Download the dataset as **JSON, CSV, Excel or HTML**, or read it via API.

### Input

```json
{
    "country": "italy",
    "fetchOrganizerDetails": true,
    "maxItems": 200
}
````

Turn off `fetchOrganizerDetails` for a faster, cheaper run that returns just the calendar (name, dates, city) without visiting each fair's detail page.

### Output

One JSON object per fair. Example:

```json
{
    "slug": "f-samoter-2381-1",
    "name": "SAMOTER",
    "description": "International Earth-Moving and Building Machinery Exhibition...",
    "cycle": "every 3 years",
    "city": "Verona",
    "dateFrom": "05/06/2026",
    "durationDays": 4,
    "url": "https://www.eventseye.com/fairs/f-samoter-2381-1.html",
    "industries": ["Building Machinery", "Building & Construction", "Urban Equipment & Engineering"],
    "audience": "Trade Public",
    "venue": {
        "name": "Verona Exhibition Centre",
        "address": "Viale del Lavoro, 8 37135 Verona",
        "phone": "+39 045 8298111",
        "website": "http://www.veronafiere.it",
        "email": "info@veronafiere.it"
    },
    "organizers": [
        {
            "name": "Veronafiere",
            "address": "Viale del Lavoro 8 37100 Verona Italy",
            "phone": "+39 045 8298111",
            "website": "http://www.veronafiere.it",
            "email": "info@veronafiere.it"
        }
    ]
}
```

#### Main data fields

| Field | Description |
| --- | --- |
| `name`, `description`, `cycle` | Fair name, short description, and how often it recurs |
| `city`, `dateFrom`, `durationDays` | Location and dates |
| `industries`, `audience` | Sector tags and audience type (Trade/Public) |
| `venue` | Exhibition centre: name, address, phone, website, email |
| `organizers` | One or more organizing companies: name, address, phone, website, email |

### How much does it cost to get a trade fair calendar?

Pricing is **pay-per-event**: a small fee per Actor start plus a fee per fair returned. You are only charged for **unique fairs actually saved**. Fetching organizer details adds one request per fair; disable `fetchOrganizerDetails` if you only need the calendar itself.

### Tips

- Leave `country` on `italy` for the default, or try `france`, `germany`, `spain`, `united-kingdom` — most European countries are covered.
- Schedule a **monthly run** to keep a fresh calendar and catch newly announced fairs.
- Combine with a spreadsheet filter on `industries` to build a sector-specific exhibitor-outreach list.

### FAQ & disclaimers

**Is this data official?** It's aggregated by eventseye.com, an independent trade show directory — not the fair organizers themselves. Always confirm dates directly with the organizer before making travel or booth-booking arrangements, as the source itself notes dates are subject to change.

**Is the contact info personal data?** No — `venue` and `organizers` are business contact details for exhibition centres and organizing companies, not private individuals.

**Found a bug or missing field?** Open an issue in the **Issues** tab — feedback is usually addressed within days. Custom solutions available on request.

# Actor input Schema

## `country` (type: `string`):

Country to get the trade fair calendar for, e.g. "italy", "france", "germany", "spain" (lowercase, hyphens for multi-word names, matching eventseye.com's own URLs).

## `fetchOrganizerDetails` (type: `boolean`):

When enabled (default), visits each fair's detail page to add venue and organizer contact info (address, phone, email, website) and industry tags. Disable for a faster, cheaper run with just the calendar (name, dates, city).

## `maxItems` (type: `integer`):

Maximum number of fairs to return. You are only charged for unique fairs actually saved to the dataset.

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

Proxies to use. Apify automatic proxies are recommended.

## Actor input object example

```json
{
  "country": "italy",
  "fetchOrganizerDetails": true,
  "maxItems": 100,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# Actor output Schema

## `results` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "country": "italy",
    "proxyConfiguration": {
        "useApifyProxy": true
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("nikse77/trade-fairs-calendar").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "country": "italy",
    "proxyConfiguration": { "useApifyProxy": True },
}

# Run the Actor and wait for it to finish
run = client.actor("nikse77/trade-fairs-calendar").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "country": "italy",
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}' |
apify call nikse77/trade-fairs-calendar --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=nikse77/trade-fairs-calendar",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Trade Fairs Calendar — Dates, Venue & Organizer Contacts",
        "description": "Trade fair calendar for any country: dates, venue and full organizer contact details (address, phone, email, website) for lead generation and event planning. Sourced from eventseye.com's worldwide directory.",
        "version": "0.1",
        "x-build-id": "3RgauGeOKP5thIjaV"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/nikse77~trade-fairs-calendar/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-nikse77-trade-fairs-calendar",
                "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/nikse77~trade-fairs-calendar/runs": {
            "post": {
                "operationId": "runs-sync-nikse77-trade-fairs-calendar",
                "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/nikse77~trade-fairs-calendar/run-sync": {
            "post": {
                "operationId": "run-sync-nikse77-trade-fairs-calendar",
                "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": {
                    "country": {
                        "title": "Country",
                        "type": "string",
                        "description": "Country to get the trade fair calendar for, e.g. \"italy\", \"france\", \"germany\", \"spain\" (lowercase, hyphens for multi-word names, matching eventseye.com's own URLs).",
                        "default": "italy"
                    },
                    "fetchOrganizerDetails": {
                        "title": "Fetch venue & organizer contact details",
                        "type": "boolean",
                        "description": "When enabled (default), visits each fair's detail page to add venue and organizer contact info (address, phone, email, website) and industry tags. Disable for a faster, cheaper run with just the calendar (name, dates, city).",
                        "default": true
                    },
                    "maxItems": {
                        "title": "Max fairs",
                        "minimum": 1,
                        "type": "integer",
                        "description": "Maximum number of fairs to return. You are only charged for unique fairs actually saved to the dataset.",
                        "default": 100
                    },
                    "proxyConfiguration": {
                        "title": "Proxy configuration",
                        "type": "object",
                        "description": "Proxies to use. Apify automatic proxies are recommended.",
                        "default": {
                            "useApifyProxy": true
                        }
                    }
                }
            },
            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```