# Ihjoz Events Scraper (`aboo.script/ihjoz-scraper`) Actor

⚡ Fast Ihjoz scraper. No login, no API key. Get Lebanon events by browse, organizer or event URL or keyword: dates, sessions, venue, GPS, organizer phone and email, and every ticket category with price and fee. Category and date filters included.

- **URL**: https://apify.com/aboo.script/ihjoz-scraper.md
- **Developed by:** [Aboo Script](https://apify.com/aboo.script) (community)
- **Security:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.80 / 1,000 results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
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

## Ihjoz Events Scraper

![Ihjoz Events Scraper](https://i.ibb.co/FbGfLknG/ihjoz-banner.png)

**Ihjoz Events Scraper** extracts events from [Ihjoz](https://ihjoz.com/), Lebanon's event ticketing platform, into clean, structured data you can download as JSON, CSV, Excel, or HTML. Paste an Ihjoz browse, organizer, or event URL, or type a few keywords, and get dates, sessions, venue, GPS location, organizer contacts, and every ticket category with its price and fee. No account or login required.

### Introduction

[Ihjoz](https://ihjoz.com/) is one of the main ticketing websites in Lebanon, selling tickets for concerts, parties, comedy shows, festivals, workshops, classes, sports, and tours. Organizers publish their events, dates, venues, and ticket prices there, which makes it a good source for tracking the Lebanese events scene.

This actor collects the same public information you see in your browser and turns it into a ready-to-use dataset. You can run it once, schedule it to run daily, or connect it to your own tools.

### What data can you extract from Ihjoz?

- 🏷️ Event title, category, tags, and description
- 📅 Start date, last session date, and every session with its date and time
- 📍 Venue name, area, latitude, and longitude
- 🎟️ Every ticket category per session: name, price, fee, tax note, sold-out status, and minimum and maximum quantity
- 📜 Ticket conditions written by the organizer
- 💲 Currency and lowest and highest ticket price
- 🏢 Organizer name, page URL, logo, description, phone, and email
- 🖼️ Event cover image
- 🔗 Direct URL and ID of each event

### Use Cases

- 📈 **Market research**: follow ticket prices, categories, and event volume across Lebanon.
- 🕵️ **Competitor monitoring**: see which venues and promoters are active and how they price their tickets.
- 🤝 **Lead generation**: build a list of event organizers with their phone numbers and emails.
- 🗂️ **Event listings**: feed an events calendar, newsletter, or city guide with fresh Lebanese events.
- 🤖 **AI and automation**: feed clean, structured data into spreadsheets, dashboards, or AI workflows.

### How to scrape Ihjoz step by step

1. Paste one or more Ihjoz URLs into **Start URLs**, or type keywords into **Search keywords**.
2. Optionally pick a **Category** and a **Date** for your keywords.
3. Set **Maximum number of results** to how many events you want per URL or per keyword.
4. Click **Start** and wait for the run to finish.
5. Download your data in JSON, CSV, Excel, or HTML from the **Output** tab.

### Input

- **Start URLs**: Ihjoz URLs to scrape. Supported pages: the events browse page (with or without filters such as category, country, date, or keyword), organizer pages, and single event pages. Filters you apply on the website are kept in the results.
- **Search keywords**: keywords to search Ihjoz events, one per line. Each keyword is scraped separately.
- **Maximum number of results**: how many events to collect for each start URL or keyword. Use 0 for unlimited.
- **Category**: only return events of one category, such as concert, party, festival, or workshop. Applies to search keywords.
- **Date**: only return events taking place today, tomorrow, this week, this weekend, next week, or this month. Applies to search keywords.

You can use start URLs, search keywords, or both in the same run.

### Input Examples

Scrape the latest events from the Ihjoz browse page:

```json
{
  "startUrls": [{ "url": "https://ihjoz.com/events/browse" }],
  "maxResults": 5
}
```

Search concerts by keyword for this month:

```json
{
  "searchQueries": ["beirut"],
  "category": "concert",
  "dateRange": "this_month",
  "maxResults": 5
}
```

### Output

Each event is saved as one item in the dataset. Here is an example of a single item:

```json
{
  "url": "https://ihjoz.com/events/9271",
  "eventId": 9271,
  "title": "Arnabeat",
  "category": "Concert",
  "tags": [],
  "dateText": "Fri, October 23, 2026 21:00",
  "startDate": "2026-10-23T18:00:00Z",
  "endDate": "2026-10-30T19:00:00Z",
  "sessions": [
    {
      "sessionId": 21663,
      "label": null,
      "startDate": "2026-10-23T18:00:00Z",
      "localDateTime": "2026-10-23T21:00"
    },
    {
      "sessionId": 21664,
      "label": null,
      "startDate": "2026-10-30T19:00:00Z",
      "localDateTime": "2026-10-30T21:00"
    }
  ],
  "venueName": "J/M Diner-Concert",
  "venueArea": "Gemmayze",
  "latitude": 33.896294,
  "longitude": 35.513317,
  "description": "A unique fusion of Oriental and Western classics, brought to life through electrifying remixes, unforgettable medleys, and vibrant rhythms...",
  "imageUrl": "https://images-ihjoz-com.s3.amazonaws.com/events/cover/9271/event_cover_3x_JM_Diner_Ihjoz_Banners-01.jpg",
  "isSeated": false,
  "currency": "USD",
  "priceMin": 25,
  "priceMax": 25,
  "tickets": [
    {
      "sessionId": 21663,
      "sessionLabel": "2026-10-23T21:00",
      "ticketTypeId": 30237,
      "name": "Bar Ticket",
      "price": "$25.00",
      "priceNumeric": 25,
      "fee": null,
      "currency": "USD",
      "priceIncludesTax": true,
      "soldOut": false,
      "minQuantity": 1,
      "maxQuantity": 10,
      "conditions": "Tickets are non-refundable and non-exchangeable.\n\nMinimum age: 21 years..."
    },
    {
      "sessionId": 21663,
      "sessionLabel": "2026-10-23T21:00",
      "ticketTypeId": 30282,
      "name": "Table Ticket",
      "price": "$25.00",
      "priceNumeric": 25,
      "fee": null,
      "currency": "USD",
      "priceIncludesTax": true,
      "soldOut": false,
      "minQuantity": 4,
      "maxQuantity": 10,
      "conditions": "Tickets are non-refundable and non-exchangeable.\n\nMinimum age: 21 years..."
    }
  ],
  "organizerId": 3227,
  "organizerName": "J/M Diner-Concert",
  "organizerUrl": "https://ihjoz.com/companies/3227",
  "organizerLogo": null,
  "organizerDescription": null,
  "organizerPhone": "96181566366",
  "organizerEmail": "info@j-m.live"
}
```

You can download the dataset in JSON, CSV, Excel, XML, or HTML, or access it through the Apify API.

### Notes

- Only Ihjoz browse pages, organizer pages, and event pages are supported; other URLs are skipped.
- Events that have ended are no longer available on Ihjoz and are skipped.
- Dates are converted from Lebanon local time to UTC in `startDate`; `localDateTime` keeps the local time shown on the website.
- Some events use a custom label instead of a date (for example "Register Now" or "Day 1 Pass"). For those sessions the date fields are `null` and the label is kept.
- `endDate` is the start of the last session, because Ihjoz does not show an end time. It is `null` when an event has only one session.
- For events with a seating map, prices are listed per seating category and the sold-out status is not available.
- Venue, organizer logo, and organizer description are not shown for every event, so they can be `null`.

### Why use the Ihjoz Events Scraper?

- ✅ **No login needed**: works with public data only, so there is no account to manage.
- 🎟️ **Every ticket price**: all ticket categories for every session, not only the lowest price.
- 🎯 **Keeps your filters**: paste any browse URL from your browser and get exactly what you see there.
- 🧹 **Clean data**: numbers are real numbers, dates use one standard format, and text is free of HTML.
- 💸 **Pay for what you need**: set a result limit per URL or keyword and keep every run small and cheap.
- 🔄 **Ready for automation**: schedule runs, export to Google Sheets, or connect to Make, Zapier, and n8n.

### FAQ

#### How many results can I scrape?

You can set any number in **Maximum number of results**, or 0 for no limit. The actor keeps going until it reaches your limit or runs out of events.

#### Do I need an Ihjoz account?

No. The actor only collects publicly available data. You do not need to log in or provide any account details.

#### Can I scrape data on a schedule?

Yes. Use Apify Schedules to run the actor every hour, day, or week, and get fresh data automatically.

#### Can I request a new feature or filter?

Yes. Right now the actor supports start URLs, search keywords, category, and date filters. If you need other filters or inputs, get in touch and they can be added.

#### Can I get a custom or private version?

Yes. The actor can be customized for your workflow, delivered as a private version, or a new scraper can be built for a different website. Use the contact details below.

### Need to scrape other event platforms?

- [Webook Scraper - Events & Experiences](https://apify.com/aboo.script/webook-scraper): events and experiences in Saudi Arabia and the Gulf with ticket prices.
- [Virgin Megastore Tickets Scraper](https://apify.com/aboo.script/tickets-virginmegastore-me-scraper): concerts and shows sold by Virgin Megastore Tickets in the Middle East.
- [The Agenda Scraper - Dubai Concerts & Shows](https://apify.com/aboo.script/theagenda-scraper): concerts and shows in Dubai.
- [Get-In Scraper - Events](https://apify.com/aboo.script/get-in-scraper): events and ticket prices from Get-In.
- [Ticketmaster Scraper](https://apify.com/aboo.script/ticketmaster-scraper): events, venues, and ticket prices from Ticketmaster.

***

**Need help or want a custom solution?**

- 📧 Email: aboo.script@gmail.com
- 🧩 More scrapers: [Apify profile](https://apify.com/aboo.script)

### Image Credit

Image credit: [Ihjoz](https://ihjoz.com/)

# Actor input Schema

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

Ihjoz browse pages (with or without filters), organizer pages or event detail URLs, for example https://ihjoz.com/events/browse?browse\[event_type]=concert or https://ihjoz.com/events/9271.

## `searchQueries` (type: `array`):

Keywords to search Ihjoz events, for example jazz, workshop or comedy. Each keyword is scraped separately.

## `maxResults` (type: `integer`):

Maximum number of events to scrape per start URL or search keyword. Use 0 for unlimited.

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

Only return events of this category. Applies to search keywords; start URLs keep their own filters.

## `dateRange` (type: `string`):

Only return events taking place in this period. Applies to search keywords; start URLs keep their own filters.

## Actor input object example

```json
{
  "startUrls": [
    {
      "url": "https://ihjoz.com/events/browse"
    }
  ],
  "maxResults": 5
}
```

# Actor output Schema

## `overview` (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 = {
    "startUrls": [
        {
            "url": "https://ihjoz.com/events/browse"
        }
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("aboo.script/ihjoz-scraper").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": [{ "url": "https://ihjoz.com/events/browse" }] }

# Run the Actor and wait for it to finish
run = client.actor("aboo.script/ihjoz-scraper").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": [
    {
      "url": "https://ihjoz.com/events/browse"
    }
  ]
}' |
apify call aboo.script/ihjoz-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,aboo.script/ihjoz-scraper"
        }
    }
}
```

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/iPI1eGH6AADtlLNkX/builds/tPzAfqOaTb2e7M3sE/openapi.json
