# Iraq Jobs Foundation Scraper (`scraper_guru/iraq-jobs-foundation-scraper`) Actor

Collect public Iraq job listing metadata from the Iraq Jobs Foundation website, including titles, cities, categories, job types, salaries, and dates.

- **URL**: https://apify.com/scraper_guru/iraq-jobs-foundation-scraper.md
- **Developed by:** [LIAICHI MUSTAPHA](https://apify.com/scraper_guru) (community)
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $5.00 / 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.

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

## Iraq Jobs Foundation Scraper

Collect public job-listing metadata from [Iraq Jobs Foundation](https://www.ijobsiq.com/jobs) using its unauthenticated jobs endpoint.

### Features

- Paginates the public listing endpoint and deduplicates records by source ID.
- Captures titles, employer labels, location, category, job type, salary and source dates/status.
- Uses a single request at a time with a one-second minimum gap.
- Limits collection with `maxItems` and `maxPages`.
- Excludes full descriptions and application methods because those fields may contain personal contact information.
- Saves run counts and source pagination metadata to the `STATS` key-value record.

### Use cases

- Explore the job-posting mix visible on this platform.
- Compare locations, categories, job types, and the presence of salary/deadline data.
- Build a timestamped snapshot for market research.

The dataset represents source listing records, not necessarily individual positions: one post may advertise several roles. It is not a census of Iraq's labor market, and the source's `isActive` flag is not independent verification that a vacancy remains open.

### Input

| Field | Type | Default | Description |
|---|---:|---:|---|
| `maxItems` | integer | `5000` | Maximum unique records to save (1–10,000). |
| `maxPages` | integer | `100` | Maximum listing pages to request (1–100). |

The API currently returns up to 100 records per page. A run with `maxItems: 5000` and `maxPages: 100` collects the full inventory when the source has fewer than 5,000 records.

### Output

Records include `job_id`, `title`, `company`, `location`, `category`, `job_type`, `salary`, `deadline`, `is_active`, `approval_status`, `views`, `created_at`, `updated_at`, source/API URLs, and `scraped_at`.

Example:

```json
{
  "job_id": "2749",
  "title": "Kurdistan Save the Children is looking for qualified candidates to join its teams across Slemani, Darbandikhan, and Kirkuk",
  "company": "Not specified",
  "location": "Sulaymaniyah",
  "category": "Finance",
  "job_type": "full-time",
  "salary": null,
  "deadline": null,
  "is_active": true,
  "approval_status": "approved",
  "views": 13,
  "created_at": "2026-10-09T06:54:16.000Z",
  "updated_at": "2026-10-09T11:45:18.000Z",
  "source": "Iraq Jobs Foundation",
  "country": "Iraq",
  "source_url": "https://www.ijobsiq.com/jobs",
  "source_api_url": "https://www.ijobsiq.com/api/jobs?page=1&limit=100",
  "scraped_at": "2026-10-09T11:50:37.665Z"
}
```

### Notes

- Counts and fields can change between runs. Preserve `scraped_at` when analyzing snapshots.
- The collector uses the publicly accessible listing endpoint and does not fetch full job descriptions, application links, or contact details.
- Before public distribution or commercial use, confirm that collection and downstream use comply with the source's current terms and applicable rules.

### FAQ

**Does a record equal one vacancy?** Not always. A single post may list multiple roles, and duplicate/reposted content may exist under separate IDs.

**Does `is_active: true` prove the job is still open?** No. It reports the source's current flag only; deadlines may be missing or outdated.

**Why are descriptions and application details absent?** They can contain direct contact information. This actor is designed for aggregate analysis, not collecting applicant contact targets.

# Actor input Schema

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

Maximum unique active listing records to collect. This counts website records, not individual positions within multi-role posts.

## `maxPages` (type: `integer`):

Safety cap on listing pages requested.

## Actor input object example

```json
{
  "maxItems": 20,
  "maxPages": 1
}
```

# Actor output Schema

## `jobs` (type: `string`):

No description

## `runStats` (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 = {
    "maxItems": 20,
    "maxPages": 1
};

// Run the Actor and wait for it to finish
const run = await client.actor("scraper_guru/iraq-jobs-foundation-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 = {
    "maxItems": 20,
    "maxPages": 1,
}

# Run the Actor and wait for it to finish
run = client.actor("scraper_guru/iraq-jobs-foundation-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 '{
  "maxItems": 20,
  "maxPages": 1
}' |
apify call scraper_guru/iraq-jobs-foundation-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,scraper_guru/iraq-jobs-foundation-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/0FEybfbcX0aEAQElY/builds/PdRxv5SRZjzpxc4ql/openapi.json
