# 10times (`runtime/10times`)

Get the events from 10times Top 100 pages categories : Agriculture & Forestry, Animals & Pets, Apparel & Clothing, Arts & Crafts, Auto & Automotive, Baby, Kids & Maternity, Banking & Finance, Building & Construction, Business Services, Education & Training, Electric & Electronics...

- **URL**: https://beta-securitybyobscurity.apify.com/runtime/10times.md
- **Developed by:** [scraping automation](https://beta-securitybyobscurity.apify.com/runtime) (community)
- **Categories:** Lead generation, Jobs, News
- **Stats:** 36 total users, 9 monthly users, 97.8% runs succeeded, 2 bookmarks
- **User rating**: 5.00 out of 5 stars

## Pricing

$19.00 / 1,000 results

This Actor is paid per result. You are not charged for the Apify platform usage, but only a fixed price for dataset items the Actor outputs.

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

# README

## 10times - Top 100 Pages Crawler

### Overview

This crawler extracts event data from 10times Top 100 pages across multiple categories. It provides comprehensive information about events including their rank, name, dates, location, category, and rating.

The crawler supports all major industry categories: Agriculture & Forestry, Animals & Pets, Apparel & Clothing, Arts & Crafts, Auto & Automotive, Baby, Kids & Maternity, Banking & Finance, Building & Construction, Business Services, Education & Training, Electric & Electronics, Entertainment & Media, Environment & Waste, Fashion & Beauty, Food & Beverages, Home & Office, Hospitality, IT & Technology, Industrial Engineering, Logistics & Transportation, Medical & Pharma, Miscellaneous, Packing & Packaging, Power & Energy, Science & Research, Security & Defense, Telecommunication, Travel & Tourism, Wellness, Health & Fitness.

### Features

- **Multi-Category Support**: Extracts data from 30+ industry categories
- **Comprehensive Event Details**: Collects event names, dates, locations, and ratings
- **Structured Output**: Returns data in an organized, easy-to-use JSON format
- **Configurable Input**: Works with any category from the 10times Top 100 pages
- **Advanced Anti-Detection**: Implements sophisticated stealth techniques to avoid blocking
- **Robust Error Handling**: Comprehensive error handling and retry mechanisms
- **Session Management**: Intelligent session rotation and cookie management

### Input Parameters

| Parameter | Type | Description | Default |
|-----------|------|-------------|---------|
| `url` | String | The category URL to scrape | https://10times.com/top100/travel-tourism |
| `proxyConfiguration` | Object | Proxy configuration settings | See below |
| `maxRetries` | Integer | Maximum retry attempts (1-10) | 5 |
| `requestTimeout` | Integer | Request timeout in seconds (30-600) | 300 |

### Example Input

```json
{
  "url": "https://10times.com/top100/travel-tourism",
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": ["RESIDENTIAL"],
    "apifyProxyCountry": ""
  },
  "maxRetries": 5,
  "requestTimeout": 300
}
```

### Proxy Configuration

**IMPORTANT**: Proper proxy configuration is crucial for successful scraping. 10times.com has sophisticated anti-bot measures.

#### Recommended Settings:

```json
{
  "useApifyProxy": true,
  "apifyProxyGroups": ["RESIDENTIAL"],
  "apifyProxyCountry": "IN"
}
```

#### Why These Settings Work Best:

1. **RESIDENTIAL Proxy Group**: Provides real residential IP addresses that are less likely to be blocked
2. **India (IN) Country**: 10times.com has better accessibility from Indian IP addresses
3. **Session Rotation**: The crawler automatically rotates sessions to avoid detection

#### Alternative Proxy Options:

- **DATACENTER**: Faster but more likely to be blocked
- **RESIDENTIAL**: Slower but more reliable (recommended)
- **Other Countries**: Try US, UK, or DE if IN doesn't work

### Output Format

The crawler produces structured JSON data with the following format:

```json
[
    {
        "rank": "1",
        "eventLink": "https://10times.com/magic",
        "eventName": "MAGIC LAS VEGAS",
        "eventDates": "10 - 12 Feb 2025",
        "dateStart": "20250210T000000Z",
        "dateEnd": "20250212T235959Z",
        "location": "Las Vegas",
        "category": "Apparel & Clothing",
        "rating": "4.3",
        "extractedAt": "2025-01-15T10:30:00.000Z",
        "sourceUrl": "https://10times.com/top100/travel-tourism"
    }
]
```

### Available Categories

This crawler supports all categories listed on https://10times.com/top100/, including:

- Agriculture & Forestry
- Animals & Pets
- Apparel & Clothing
- Arts & Crafts
- Auto & Automotive
- Baby, Kids & Maternity
- Banking & Finance
- Building & Construction
- Business Services
- Education & Training
- Electric & Electronics
- Entertainment & Media
- Environment & Waste
- Fashion & Beauty
- Food & Beverages
- Home & Office
- Hospitality
- IT & Technology
- Industrial Engineering
- Logistics & Transportation
- Medical & Pharma
- Miscellaneous
- Packing & Packaging
- Power & Energy
- Science & Research
- Security & Defense
- Telecommunication
- Travel & Tourism
- Wellness, Health & Fitness

### Troubleshooting

#### Common Issues and Solutions

##### 1. 403 Forbidden Errors

**Symptoms**:

- `Request blocked - received 403 status code`
- `Access denied - page blocked`

**Solutions**:

- Use RESIDENTIAL proxy group instead of DATACENTER
- Set proxy country to India (IN)
- Increase delays between requests
- Check if the URL is valid and accessible

##### 2. Execution Context Destroyed

**Symptoms**:

- `page.evaluate: Execution context was destroyed, most likely because of a navigation`

**Solutions**:

- This is usually caused by page redirects or anti-bot measures
- The crawler automatically handles this with retry logic
- Ensure proper proxy configuration

##### 3. Tunnel Connection Failed

**Symptoms**:

- `net::ERR_TUNNEL_CONNECTION_FAILED`

**Solutions**:

- Check proxy configuration
- Try different proxy groups or countries
- Ensure sufficient proxy credits

##### 4. No Data Extracted

**Symptoms**:

- `No valid data extracted`
- `Event list table not found`

**Solutions**:

- Verify the URL is correct and accessible
- Check if the page structure has changed
- Use different proxy settings
- Try a different category URL

##### 5. Session Rotation Issues

**Symptoms**:

- Multiple failed requests with the same session
- Sessions being marked as bad repeatedly

**Solutions**:

- The crawler automatically handles session rotation
- Check proxy configuration
- Ensure sufficient proxy credits

#### Debug Information

The crawler generates debug files when issues occur:

- `debug-{timestamp}.png`: Screenshots when table not found
- `error-{timestamp}.png`: Screenshots when errors occur

These files help identify what the page looks like when issues occur.

#### Performance Optimization

1. **Use RESIDENTIAL Proxies**: More reliable but slower
2. **Limit Concurrency**: Keep at 1 for best results
3. **Proper Delays**: Built-in random delays prevent detection
4. **Session Management**: Automatic session rotation

### Technical Details

#### Anti-Detection Features

- **User Agent Rotation**: Random selection from realistic browser user agents
- **Viewport Randomization**: Different screen sizes for each request
- **Stealth Script Injection**: Masks automation indicators
- **Human-like Behavior**: Random mouse movements and scrolling
- **Cookie Management**: Preserves successful session cookies
- **Header Randomization**: Realistic HTTP headers

#### Error Handling

- **Automatic Retries**: Configurable retry attempts
- **Session Rotation**: Bad sessions are automatically replaced
- **Timeout Management**: Configurable timeouts for different operations
- **Graceful Degradation**: Continues processing even if some requests fail

### Legal Notice

By using this actor, you agree to:

1. **Respect Website Terms**: Comply with the terms of service of 10times.com
2. **Data Ownership**: Acknowledge that the data belongs to respective owners and is subject to copyright laws
3. **Responsible Use**: Use the actor only for lawful purposes without causing harm to the target website
4. **Privacy Compliance**: Handle any collected data in accordance with applicable privacy regulations
5. **Liability**: Accept responsibility for how the data is used and any consequences thereof

### Support

If you encounter persistent issues:

1. Check the troubleshooting section above
2. Verify your proxy configuration
3. Try different category URLs
4. Ensure you have sufficient proxy credits
5. Check the debug screenshots for visual clues

The crawler is designed to be robust and handle most common issues automatically, but proper proxy configuration is essential for success.

# Actor input Schema

## `url` (type: `string`):

The 10times Top 100 category URL to scrape. Available categories include: Agriculture & Forestry, Animals & Pets, Apparel & Clothing, Arts & Crafts, Auto & Automotive, Baby Kids & Maternity, Banking & Finance, Building & Construction, Business Services, Education & Training, Electric & Electronics, Entertainment & Media, Environment & Waste, Fashion & Beauty, Food & Beverages, Home & Office, Hospitality, IT & Technology, Industrial Engineering, Logistics & Transportation, Medical & Pharma, Miscellaneous, Packing & Packaging, Power & Energy, Science & Research, Security & Defense, Telecommunication, Travel & Tourism, Wellness Health & Fitness.

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

Configure proxy settings to avoid blocking. Recommended: Use Apify Proxy with RESIDENTIAL group and India (IN) country for best results.

## `maxRetries` (type: `integer`):

Maximum number of retry attempts for failed requests

## `requestTimeout` (type: `integer`):

Timeout for each request in seconds

## Actor input object example

```json
{
  "url": "https://10times.com/top100/travel-tourism",
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "IN"
  },
  "maxRetries": 5,
  "requestTimeout": 300
}
```

# 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 = {
    "url": "https://10times.com/top100/travel-tourism",
    "proxyConfiguration": {
        "useApifyProxy": true,
        "apifyProxyGroups": [
            "RESIDENTIAL"
        ],
        "apifyProxyCountry": "IN"
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("runtime/10times").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 = {
    "url": "https://10times.com/top100/travel-tourism",
    "proxyConfiguration": {
        "useApifyProxy": True,
        "apifyProxyGroups": ["RESIDENTIAL"],
        "apifyProxyCountry": "IN",
    },
}

# Run the Actor and wait for it to finish
run = client.actor("runtime/10times").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 '{
  "url": "https://10times.com/top100/travel-tourism",
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "IN"
  }
}' |
apify call runtime/10times --silent --output-dataset

```

## MCP server setup

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

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "10times",
        "description": "Get the events from 10times Top 100 pages categories : Agriculture & Forestry, Animals & Pets, Apparel & Clothing, Arts & Crafts, Auto & Automotive, Baby, Kids & Maternity, Banking & Finance, Building & Construction, Business Services, Education & Training, Electric & Electronics...",
        "version": "0.9",
        "x-build-id": "DcGEvvj4hwuqtxLS5"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/runtime~10times/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-runtime-10times",
                "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/runtime~10times/runs": {
            "post": {
                "operationId": "runs-sync-runtime-10times",
                "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/runtime~10times/run-sync": {
            "post": {
                "operationId": "run-sync-runtime-10times",
                "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",
                "required": [
                    "url"
                ],
                "properties": {
                    "url": {
                        "title": "Category URL",
                        "pattern": "^https://10times\\.com/top100/[a-z-]+$",
                        "type": "string",
                        "description": "The 10times Top 100 category URL to scrape. Available categories include: Agriculture & Forestry, Animals & Pets, Apparel & Clothing, Arts & Crafts, Auto & Automotive, Baby Kids & Maternity, Banking & Finance, Building & Construction, Business Services, Education & Training, Electric & Electronics, Entertainment & Media, Environment & Waste, Fashion & Beauty, Food & Beverages, Home & Office, Hospitality, IT & Technology, Industrial Engineering, Logistics & Transportation, Medical & Pharma, Miscellaneous, Packing & Packaging, Power & Energy, Science & Research, Security & Defense, Telecommunication, Travel & Tourism, Wellness Health & Fitness."
                    },
                    "proxyConfiguration": {
                        "title": "Proxy Configuration",
                        "type": "object",
                        "description": "Configure proxy settings to avoid blocking. Recommended: Use Apify Proxy with RESIDENTIAL group and India (IN) country for best results.",
                        "default": {
                            "useApifyProxy": true,
                            "apifyProxyGroups": [
                                "RESIDENTIAL"
                            ],
                            "apifyProxyCountry": "IN"
                        }
                    },
                    "maxRetries": {
                        "title": "Maximum Retries",
                        "minimum": 1,
                        "maximum": 10,
                        "type": "integer",
                        "description": "Maximum number of retry attempts for failed requests",
                        "default": 5
                    },
                    "requestTimeout": {
                        "title": "Request Timeout (seconds)",
                        "minimum": 30,
                        "maximum": 600,
                        "type": "integer",
                        "description": "Timeout for each request in seconds",
                        "default": 300
                    }
                }
            },
            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
