{
  "openapi": "3.0.1",
  "info": {
    "title": "10times Events Scraper — Trade Shows, Conferences & Venues",
    "description": "Scrape trade shows, conferences, and exhibitions from 10times.com (200K+ events, 100+ industries). Flat records with ISO dates, venue + GPS, organizer, categories, visitor estimates, and event URL. Three input modes (URLs / search / city). MCP-ready, residential proxy, JSON-LD.",
    "version": "0.1",
    "x-build-id": "aO21fc4510MGb8AzS"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/khadinakbar~10times-events-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-khadinakbar-10times-events-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/khadinakbar~10times-events-scraper/runs": {
      "post": {
        "operationId": "runs-sync-khadinakbar-10times-events-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/khadinakbar~10times-events-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-khadinakbar-10times-events-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": {
          "startUrls": {
            "title": "Start URLs",
            "type": "array",
            "description": "Direct 10times URLs to scrape. Accepts event detail pages (e.g. 'https://10times.com/ces-las-vegas'), city listing pages ('https://10times.com/berlin', 'https://10times.com/new-york-us'), category listings ('https://10times.com/conferences', 'https://10times.com/technology-events'), or search URLs ('https://10times.com/?query=fintech'). Mutually exclusive with searchQuery and city — use this for fully custom filtering 10times exposes in its UI but this Actor's inputs do not surface.",
            "items": {
              "type": "object",
              "required": [
                "url"
              ],
              "properties": {
                "url": {
                  "type": "string",
                  "title": "URL of a web page",
                  "format": "uri"
                }
              }
            }
          },
          "searchQuery": {
            "title": "Search query",
            "type": "string",
            "description": "Free-text keyword to search 10times (e.g. 'fintech', 'medical devices', 'sustainability'). Combined with country and eventType filters when provided. Leave empty when using startUrls or browsing by city alone. NOT an event slug and NOT a full URL — for those use startUrls."
          },
          "city": {
            "title": "City slug",
            "type": "string",
            "description": "10times city slug used in URLs (e.g. 'berlin', 'new-york-us', 'london-uk', 'singapore', 'dubai-ae', 'sao-paulo-br'). Combined with eventType, category, and date filters. Leave empty when using startUrls or searchQuery. NOT a free-text city name — must be the URL slug 10times uses on its city pages."
          },
          "country": {
            "title": "Country",
            "enum": [
              "WW",
              "US",
              "GB",
              "DE",
              "FR",
              "ES",
              "IT",
              "NL",
              "AU",
              "CA",
              "JP",
              "IN",
              "BR",
              "MX",
              "CN",
              "SG",
              "AE",
              "ZA",
              "KR",
              "ID",
              "TH"
            ],
            "type": "string",
            "description": "Two-letter ISO country code to scope a search query to one country (e.g. 'US', 'DE', 'GB', 'IN', 'AE'). Use 'WW' or leave blank for worldwide. Ignored when city is set (city already implies country). NOT a country name — must be the ISO 3166-1 alpha-2 code.",
            "default": "WW"
          },
          "eventType": {
            "title": "Event type",
            "enum": [
              "all",
              "tradeshow",
              "conference",
              "workshop",
              "festival"
            ],
            "type": "string",
            "description": "Filter by event format. 'tradeshow' = exhibitions and trade fairs, 'conference' = paid speaker conferences, 'workshop' = hands-on training, 'festival' = public/cultural events. Applied client-side on discovered events. Defaults to 'all'.",
            "default": "all"
          },
          "category": {
            "title": "Industry category",
            "enum": [
              "all",
              "technology",
              "it",
              "business",
              "medical",
              "health",
              "education",
              "industrial",
              "building",
              "auto",
              "banking",
              "food",
              "entertainment",
              "apparel",
              "science",
              "sports",
              "travel"
            ],
            "type": "string",
            "description": "Industry filter applied to event categories and description tags. Leave 'all' to include every industry. Use this with city/searchQuery to narrow by sector (e.g. 'technology' + 'berlin' = Berlin tech events). NOT a free-text industry name — must be one of the listed slugs.",
            "default": "all"
          },
          "startDate": {
            "title": "Start date (YYYY-MM-DD)",
            "type": "string",
            "description": "Only return events starting on or after this date. Format YYYY-MM-DD (e.g. '2026-06-01'). Leave empty for all upcoming events. NOT a date range — pair with endDate to bound on both sides."
          },
          "endDate": {
            "title": "End date (YYYY-MM-DD)",
            "type": "string",
            "description": "Only return events starting on or before this date. Format YYYY-MM-DD (e.g. '2026-12-31'). Leave empty for no upper bound. Pair with startDate for a bounded date window."
          },
          "onlineOnly": {
            "title": "Online events only",
            "type": "boolean",
            "description": "Restrict results to virtual/online events. Defaults to false (both in-person and online included).",
            "default": false
          },
          "maxItems": {
            "title": "Max events",
            "minimum": 1,
            "maximum": 10000,
            "type": "integer",
            "description": "Maximum number of events to return. 10times listing pages show ~30 events per page; this Actor paginates until maxItems is met or the listing is exhausted. Default 50 keeps run cost low for typical agent calls (~$0.25). Set higher for bulk extraction. Hard ceiling 10000.",
            "default": 50
          },
          "includeDetails": {
            "title": "Include detail-page enrichment",
            "type": "boolean",
            "description": "Fetch each event's detail page to extract full description, organizer details, visitor/exhibitor estimates, and rating. When false, returns only listing-page fields (still includes name, dates, venue, URL). Adds one HTTP request per event but no extra event charge.",
            "default": true
          },
          "proxyConfiguration": {
            "title": "Proxy configuration",
            "type": "object",
            "description": "Apify proxy settings. Defaults to RESIDENTIAL group — 10times sits behind Cloudflare and datacenter IPs are reliably blocked. Override only if you have a tested alternative.",
            "default": {
              "useApifyProxy": true,
              "apifyProxyGroups": [
                "RESIDENTIAL"
              ]
            }
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}