# 10times Trade Show & Conference Finder by City (`nimbryxo-studio/10times-trade-show-and-conference-finder-by-city`) Actor

Find trade shows, conferences, workshops, and festivals listed on 10times.com by city, country, date range, or category, with venue, organizer, and attendance details.

- **URL**: https://apify.com/nimbryxo-studio/10times-trade-show-and-conference-finder-by-city.md
- **Developed by:** [Nimbryxo-studio](https://apify.com/nimbryxo-studio) (community)
- **Categories:** Travel, Lead generation, Other
- **Features:** Limited permissions
- **Stats:** 1 total users, 0 monthly users, 0.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.49 / 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.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

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 Trade Show & Conference Finder by City

10times.com lists trade shows, conferences, workshops, and festivals worldwide, searchable by city, country, category, and date. This actor pulls event listings from 10times given direct event URLs, a city, or a free-text search, and returns one structured record per event.

### What this actor does

- Scrapes individual event pages when given direct 10times event URLs.
- Enumerates events from a city or listing page, or from a free-text search query.
- Filters discovered events by country, event type, category, online-only status, and date range.
- Extracts name, dates, venue/location, organizer, pricing, categories, and attendance signals (followers, rating, estimated visitor/exhibitor counts) from each event page.
- Fields that aren't present on a given event's page are left out of that event's record.

### Output per event

| Field | Description |
|---|---|
| `type` | Always `event_10times`. |
| `url` | Event page URL. |
| `slug` / `id` | 10times URL slug for the event. |
| `name` | Event name. |
| `description` | Event description. |
| `startDate` / `endDate` | Event start and end dates. |
| `eventStatus` | Event status (e.g. scheduled, cancelled, postponed), when published. |
| `eventAttendanceMode` | Attendance mode (e.g. in-person, online, mixed), when published. |
| `image` | Event cover image URL. |
| `tags` | Keyword tags from the event page's metadata. |
| `categories` | Industry/category labels shown on the event page. |
| `edition` | Numbered edition of the event (e.g. `5` for "5th edition"), when stated. |
| `frequency` | Recurrence word parsed from the page (e.g. Annual, Biennial), when stated. |
| `followers` | Follower/interested count shown on the event page. |
| `rating` | Rating out of 5, when the page shows one. |
| `estimatedVisitors` | Estimated visitor/attendee count, when published. |
| `estimatedExhibitors` | Estimated exhibitor count, when published. |
| `ogType` | Open Graph type of the page, when present. |
| `countryCode` | ISO 2-letter country code for the event, derived from the listing page it was discovered through. May be absent for events found in worldwide mode. |
| `location` | Object with `name`, `addressLocality`, `addressRegion`, `addressCountry`, `streetAddress`, `postalCode`, `latitude`, `longitude` — only the keys the event page provides. |
| `organizer` | Object with `name`, `url`, `email`, `telephone` — only the keys the event page provides. |
| `pricing` | Object with `price`, `priceCurrency`, `availability`, `url` — only when the event page publishes ticket pricing. |
| `scrapedAt` | ISO 8601 timestamp of when this actor fetched the record. |

If every URL in a run comes back blocked, the actor writes a single record of `type: "event_10times_blocked"` with the attempted URLs instead of leaving the dataset empty.

### Input

| Field | Type | Default | Description |
|---|---|---|---|
| `startUrls` | Array of strings | – | 10times URLs. Event URLs (`https://10times.com/<event-slug>`) are scraped directly; city/listing URLs (`https://10times.com/<city>-<country>`) are enumerated for events. |
| `query` | String | – | Free-text search term, used to build a 10times search URL. |
| `city` | String | – | City slug (e.g. `berlin`, `new-york`) used to build a 10times city listing URL. |
| `country` | String (select) | `"WW"` | Restrict results to this country. `WW` = worldwide. When set to a specific country, events from other countries are dropped and that country's city listing pages are followed automatically to find more matches. Options: Worldwide, US, UK, Germany, France, Spain, Italy, Netherlands, Australia, Canada, Japan, India, Brazil, Mexico, China, Singapore. |
| `eventType` | String (select) | `"all"` | Keep only events matching this type: `tradeshow`, `conference`, `workshop`, `festival`, or `all`. |
| `onlineOnly` | Boolean | `false` | Keep only online/virtual events. |
| `startDate` | String | – | Keep only events starting on or after this date (`YYYY-MM-DD`). |
| `endDate` | String | – | Keep only events starting on or before this date (`YYYY-MM-DD`). |
| `category` | String (select) | `"all"` | Keep only events matching this industry category (e.g. `technology`, `health`, `building`). |
| `sortBy` | String (select) | `"date"` | Accepted but not currently applied to the output order (see FAQ). |
| `sortType` | String (select) | `"asc"` | Accepted but not currently applied to the output order (see FAQ). |
| `maxItems` | Integer | `20` | Maximum number of events to return. |

#### Example: enumerate a city's events in one country

```json
{
    "city": "berlin",
    "country": "DE",
    "maxItems": 50
}
```

#### Example: free-text search filtered by type and date

```json
{
    "query": "artificial intelligence",
    "eventType": "conference",
    "startDate": "2026-01-01",
    "endDate": "2026-06-30",
    "maxItems": 30
}
```

#### Example: scrape specific event pages directly

```json
{
    "startUrls": [
        "https://10times.com/ces-las-vegas",
        "https://10times.com/mwc-barcelona"
    ]
}
```

### Use cases

- **Event calendar building** — pull upcoming trade shows and conferences for a city, industry, or date window.
- **Exhibitor/sponsor prospecting** — collect organizer contact details and estimated visitor/exhibitor counts to prioritize outreach.
- **Travel and venue planning** — gather venue location, dates, and attendance mode (online/in-person) for events you may attend or sponsor.
- **Competitive and industry tracking** — monitor which conferences recur annually in a category and how their follower counts or ratings change.
- **Market research feeds** — export structured event data into a spreadsheet or BI tool for industry-event landscape reports.

### FAQ

**Can I scrape a specific event page directly?**
Yes — pass its URL in `startUrls`; it's scraped directly without needing a city or search.

**Why do some events lack a `countryCode`?**
10times event pages don't always carry a country signal directly; this actor derives it from the listing page an event was discovered through. Events found via a specific `country` filter always carry that code; events found in worldwide mode sometimes don't.

**What happens if I set `country` to a specific value?**
Only events located in that country are kept, and the actor automatically follows that country's city listing pages to surface more matches beyond whatever a general or worldwide listing returns.

**Why is my filtered result smaller than I expected?**
Narrow combinations of `country`, `eventType`, and `category` can legitimately have few matching events, since these filters compound.

**What does the "blocked" record mean?**
If 10times blocks every URL requested in a run, the dataset gets one record with `type: "event_10times_blocked"` and the list of URLs that failed, instead of coming back empty.

**Does `sortBy`/`sortType` reorder the output?**
Not currently — events are emitted in the order they're discovered/scraped, regardless of `sortBy`/`sortType`. Sort the dataset yourself after export if you need a specific order.

**Is this affiliated with 10times?**
No. This actor reads public 10times.com event pages and is not affiliated with or endorsed by 10times.

# Actor input Schema

## `startUrls` (type: `array`):

10times URLs. Event URLs (https://10times.com/<event-slug>) are scraped directly. City URLs (https://10times.com/<city>-<country>) enumerate events.

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

Free-text event search (builds https://10times.com/?query=<q>).

## `city` (type: `string`):

City slug (e.g. 'berlin', 'new-york'). Creates https://10times.com/<city>.

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

Two-letter country code or 'WW' for worldwide. When set, ONLY events located in that country are returned — events from other countries are filtered out even if they appear on the listing page. City listing pages (e.g. https://10times.com/london-uk) are followed automatically to find events in the requested country.

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

Filter by type (applied client-side on discovered events).

## `onlineOnly` (type: `boolean`):

Return only online / virtual events.

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

Only events starting on or after this date.

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

Only events starting on or before this date.

## `category` (type: `string`):

Industry category filter (keyword match against event tags / description).

## `sortBy` (type: `string`):

Sort events by date, relevance score, name, follower count, or distance.

## `sortType` (type: `string`):

Sort order: ascending or descending.

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

Maximum number of events to return in the dataset.

## Actor input object example

```json
{
  "startUrls": [
    "https://10times.com/ces-las-vegas"
  ],
  "country": "WW",
  "eventType": "all",
  "onlineOnly": false,
  "category": "all",
  "sortBy": "date",
  "sortType": "asc",
  "maxItems": 3
}
```

# Actor output Schema

## `events` (type: `string`):

Dataset containing all scraped events.

# 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 = {
    "startUrls": [
        "https://10times.com/ces-las-vegas"
    ],
    "country": "WW",
    "maxItems": 3
};

// Run the Actor and wait for it to finish
const run = await client.actor("nimbryxo-studio/10times-trade-show-and-conference-finder-by-city").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 = {
    "startUrls": ["https://10times.com/ces-las-vegas"],
    "country": "WW",
    "maxItems": 3,
}

# Run the Actor and wait for it to finish
run = client.actor("nimbryxo-studio/10times-trade-show-and-conference-finder-by-city").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 '{
  "startUrls": [
    "https://10times.com/ces-las-vegas"
  ],
  "country": "WW",
  "maxItems": 3
}' |
apify call nimbryxo-studio/10times-trade-show-and-conference-finder-by-city --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,nimbryxo-studio/10times-trade-show-and-conference-finder-by-city"
        }
    }
}
```

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/vdv14gWsIHotcJPdP/builds/jhBxp6yOrUFvaOnho/openapi.json