# 10times Events: Industry Discovery, Changes & ICS Calendar (`lifelong_starfruit/10times-event-calendar-sync`) Actor

Discover industry events on 10times and export CSV or an all-day ICS calendar. Compare completed runs using stable edition IDs and preserve known events. Uses a separately billed source collector with a spending cap.

- **URL**: https://apify.com/lifelong\_starfruit/10times-event-calendar-sync.md
- **Developed by:** [Mitchell Graham](https://apify.com/lifelong_starfruit) (community)
- **Categories:** Automation, Integrations, Business
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.00 / 1,000 delivered event editions

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/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## 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.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## 10times Events: Industry Discovery, Changes & ICS Calendar

Discover industry events by country, city, category or keyword, export them to CSV, and maintain an all-day ICS calendar across runs. Stable event-edition IDs let you see new and changed events without treating missing search results as cancellations.

### Ready-to-run examples

- [Discover packaging trade shows and export an ICS calendar](https://apify.com/lifelong_starfruit/10times-event-calendar-sync/examples/packaging-events-to-ics-calendar)
- [Create a baseline for industry event change tracking](https://apify.com/lifelong_starfruit/10times-event-calendar-sync/examples/baseline-industry-event-change-tracking)

These examples create a task in your own account when you choose to try them. Review inputs and your spending limit before starting. Example companies and events are unaffiliated with this tool.

### Quick start

```json
{"country":"US","categoryId":"30","eventType":"tradeshow","maxItems":5,"sourceChargeLimitUsd":0.15}
```

This example collects up to five packaging trade shows. Output includes the dataset, `events.csv`, `calendar.ics`, `SUMMARY` and a checkpoint for repeat runs.

### Track changes without duplicate editions

Pass a prior successful run ID as `previousRunId`, keep the same search filters and set `onlyChanges:true`. Dataset/CSV rows contain only new or updated editions. The calendar retains all known editions from that scoped history, including editions absent from the latest bounded search. Missing results are **not** evidence of cancellation.

Use `excludeEditionIds` to remove unwanted editions from output and retained history. A changed search filter requires a fresh baseline. History is capped at 10,000 editions. Keep prior run storage available; deleted or expired checkpoints cannot be resumed.

### Calendar behavior

Events use source date-only values as all-day entries; no start time or timezone is invented. ICS end dates follow the exclusive-end convention. Explicit source cancellations become CANCELLED, postponed events become tentative. Reimport behavior depends on your calendar application. This Actor generates files; it does not itself subscribe, publish a permanent calendar URL or update your Google/Outlook account.

### Pricing: two separate charges

Our launch service fee is **$1 per 1,000 delivered event rows**, plus the displayed start fee and Apify platform usage. With changes-only output, unchanged events are not billed as output rows.

Collection uses [Zen Studio's 10times collector](https://apify.com/zen-studio/10times-events-scraper), **charged separately to your Apify account** at its current rates, including candidates that are unchanged or locally filtered. Check its Pricing tab. `sourceChargeLimitUsd` limits source event charges, separately from the parent-run charge limit; platform usage can be additional. Start with a small sample.

This adds calendar and checkpoint behavior to the source collector. Results are bounded discovery, not a complete industry calendar. Confirm dates with organizers before travel. Independent tool, unaffiliated with 10times or the example events.

### Tutorial: Refresh a packaging-events calendar and export only changes

The script saves a local baseline run ID only after downloading a healthy result and its calendar. Run it again with the same filters to export only changed rows while retaining known calendar editions. It preserves prior local state if a run or download fails.

Set up a schedule in your own workflow runner to execute the script periodically and retain its state file. Import the resulting ICS file into your calendar application. This is file generation, not an automatic calendar subscription. A schedule reruns the paid source even when nothing changes.

Each run allows $0.15 in source event charges and $0.05 in parent event charges; platform usage can be additional. Keep the previous run's Apify storage available.

#### Complete Node.js example

Requires Node.js 22 or newer and your own Apify account. Save the following as `conferences-sync.mjs`. Set `APIFY_TOKEN` privately in your environment, then run `node conferences-sync.mjs`. No npm packages are needed. Keep credentials out of source control and shared workflows. The script prints a run ID; if your local session stops, set `RESUME_RUN_ID` to that ID to retrieve the same run without starting another.

```javascript
import fs from 'node:fs/promises';

// Node.js 22+. Set APIFY_TOKEN in your environment; never paste it into a URL.
async function request(path, { method = 'GET', body, text = false } = {}) {
  if (!process.env.APIFY_TOKEN) throw new Error('Set APIFY_TOKEN in your environment');
  const response = await fetch(`https://api.apify.com/v2${path}`, {
    method, redirect: 'error', signal: AbortSignal.timeout(30000),
    headers: { Authorization: `Bearer ${process.env.APIFY_TOKEN}`, 'Content-Type': 'application/json' },
    body: body === undefined ? undefined : JSON.stringify(body),
  });
  if (!response.ok) throw new Error(`Apify returned HTTP ${response.status}`);
  if (text) return response.text();
  const data = await response.json();
  return data.data ?? data;
}

async function run(actorName, input, maxCharge, timeoutSecs = 120) {
  // To recover a stopped local script, set RESUME_RUN_ID instead of starting again.
  const resumed = process.env.RESUME_RUN_ID;
  if (resumed && !/^[a-zA-Z0-9]{10,30}$/.test(resumed)) throw new Error('Invalid RESUME_RUN_ID');
  const actor = await request(`/actors/lifelong_starfruit~${actorName}`);
  let current = resumed
    ? await request(`/actor-runs/${resumed}`)
    : await request(`/actors/${actor.id}/runs?timeout=${timeoutSecs}&memory=256&maxTotalChargeUsd=${maxCharge}`, { method: 'POST', body: input });
  if (current.actId !== actor.id) throw new Error('Run belongs to a different Actor');
  console.log(`Run ID: ${current.id}`);
  const deadline = Date.now() + (timeoutSecs + 60) * 1000;
  while (['READY', 'RUNNING', 'ABORTING', 'TIMING-OUT'].includes(current.status)) {
    if (Date.now() > deadline) throw new Error(`Still pending: ${current.id}. Inspect it in Console; resume instead of starting a duplicate.`);
    await new Promise(resolve => setTimeout(resolve, 3000));
    current = await request(`/actor-runs/${current.id}`);
  }
  if (current.status !== 'SUCCEEDED') throw new Error(`Run ${current.id}: ${current.status}. Inspect SUMMARY in Console before retrying.`);
  const summary = await request(`/key-value-stores/${current.defaultKeyValueStoreId}/records/SUMMARY`);
  if (!summary.healthy || !summary.deliveredAll) throw new Error('Incomplete delivery; previous local state preserved');
  const rows = await request(`/datasets/${current.defaultDatasetId}/items?clean=true&limit=5000`);
  if (rows.length !== summary.written) throw new Error('Incomplete download; previous local state preserved');
  return { current, summary, rows };
}

const stateFile = 'industry-calendar-state.json';
let state = {};
try { state = JSON.parse(await fs.readFile(stateFile, 'utf8')); } catch (error) { if (error.code !== 'ENOENT') throw error; }
const input = { country: 'US', categoryId: '30', eventType: 'tradeshow', maxItems: 5, sourceChargeLimitUsd: 0.15, onlyChanges: true, ...(state.previousRunId ? { previousRunId: state.previousRunId } : {}) };
const { current, rows } = await run('10times-event-calendar-sync', input, 0.05, 150);
const calendar = await request(`/key-value-stores/${current.defaultKeyValueStoreId}/records/calendar.ics`, { text: true });
if (!calendar.includes('BEGIN:VCALENDAR')) throw new Error('Calendar download invalid; previous state preserved');
await fs.writeFile(`industry-calendar-${current.id}.ics`, calendar);
await fs.writeFile(`event-changes-${current.id}.json`, JSON.stringify(rows, null, 2));
await fs.writeFile(stateFile + '.tmp', JSON.stringify({ previousRunId: current.id }, null, 2));
await fs.rename(stateFile + '.tmp', stateFile);
console.log(`Saved calendar and ${rows.length} changed event rows.`);

```

### Related tools

- [Greenhouse & Ashby Job Scraper + Change Tracking](https://apify.com/lifelong_starfruit/pilot-employer-job-feed)
- [Eventbrite Scraper: Event URLs to JSON & ICS](https://apify.com/lifelong_starfruit/pilot-event-calendar-feed)
- [Google Maps Leads: Territory Filter & Deduplication](https://apify.com/lifelong_starfruit/pilot-maps-territory-leads)
- [Map Your Show Exhibitor Scraper: Company Matching & CSV](https://apify.com/lifelong_starfruit/map-your-show-company-matching)
- [Thomasnet Supplier Shortlist: Filters, Deduplication & CSV](https://apify.com/lifelong_starfruit/thomasnet-supplier-shortlist)

# Actor input Schema

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

Two letters or WW; ignored with a city ID.

## `cityId` (type: `string`):

Numeric ID, e.g. 70834 New York or 81795 London.

## `categoryId` (type: `string`):

30 Packaging, 34 Industrial Engineering, 156 IT, 27 Medical, 80 Logistics.

## `query` (type: `string`):

Optional search text, up to 150 characters.

## `eventType` (type: `string`):

Filter by source event type.

## `startDate` (type: `string`):

YYYY-MM-DD: events still active on or after this date.

## `endDate` (type: `string`):

YYYY-MM-DD: events starting on or before this date.

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

Bounded candidates before local filters, not an exhaustive calendar.

## `excludeEditionIds` (type: `array`):

IDs as strings, also removed from carried calendar history.

## `previousRunId` (type: `string`):

Prior run of this Actor with identical filters. Unobserved editions are retained, not cancelled.

## `onlyChanges` (type: `boolean`):

Omit unchanged dataset/CSV rows. Calendar retains known editions. Dates are all-day, not inferred times.

## `sourceChargeLimitUsd` (type: `number`):

Required. The upstream Apify collector is charged separately to your account. Rejected and duplicate candidates incur source charges. $0.05–$10 total across this run, in addition to this Actor.

## Actor input object example

```json
{
  "country": "US",
  "eventType": "all",
  "maxItems": 100,
  "onlyChanges": false,
  "sourceChargeLimitUsd": 0.5
}
```

# Actor output Schema

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

Delivered records; check run status and coverage before treating these as complete.

## `summary` (type: `string`):

Source coverage, written record count and completion status.

## `calendar` (type: `string`):

Available after complete delivery. Conference dates are all-day; Eventbrite requires a known source offset.

## `eventsCsv` (type: `string`):

Spreadsheet-safe export available after complete delivery.

# 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 = {
    "sourceChargeLimitUsd": 0.5
};

// Run the Actor and wait for it to finish
const run = await client.actor("lifelong_starfruit/10times-event-calendar-sync").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 = { "sourceChargeLimitUsd": 0.5 }

# Run the Actor and wait for it to finish
run = client.actor("lifelong_starfruit/10times-event-calendar-sync").call(run_input=run_input)

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

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

```

## CLI example

```bash
echo '{
  "sourceChargeLimitUsd": 0.5
}' |
apify call lifelong_starfruit/10times-event-calendar-sync --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,lifelong_starfruit/10times-event-calendar-sync"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/QrcYtwPGJuoQZNKbv/builds/SEv1ZfYkiJNeo3lgg/openapi.json