{
  "openapi": "3.0.1",
  "info": {
    "title": "IrishJobs.ie [$1.45/1K💰] Ireland Jobs Scraper + Salary",
    "description": "Search IrishJobs.ie by keyword, county & salary — or any URL. Structured salary bands, skills, employer + geo. Only-new-jobs mode for scheduled runs, Telegram/Slack/Discord/WhatsApp alerts, AI-agent compact output, optional contact-email enrichment. JSON/CSV out.",
    "version": "0.1",
    "x-build-id": "0Kd04QBbdDSrPIhcS"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/memo23~irishjobs-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-memo23-irishjobs-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/memo23~irishjobs-scraper/runs": {
      "post": {
        "operationId": "runs-sync-memo23-irishjobs-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/memo23~irishjobs-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-memo23-irishjobs-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": {
          "query": {
            "title": "Job keywords",
            "type": "string",
            "description": "A job title, skill or word, e.g. software engineer, accountant or nurse. Empty: all jobs, narrowed by place if one is set. More searches go in the next field."
          },
          "queries": {
            "title": "More keyword searches (optional)",
            "type": "array",
            "description": "One per line. Each runs as its own search with the same place and filters, into the same dataset. The job limit at the bottom applies to each search.",
            "items": {
              "type": "string"
            }
          },
          "location": {
            "title": "Town or region",
            "type": "string",
            "description": "A place in Ireland, e.g. Dublin, Cork or Portlaoise. Empty: all of Ireland. Not used when a county is picked."
          },
          "county": {
            "title": "Irish county",
            "enum": [
              "carlow",
              "cavan",
              "clare",
              "cork",
              "donegal",
              "dublin",
              "galway",
              "kerry",
              "kildare",
              "kilkenny",
              "laois",
              "leitrim",
              "limerick",
              "longford",
              "louth",
              "mayo",
              "meath",
              "monaghan",
              "offaly",
              "roscommon",
              "sligo",
              "tipperary",
              "waterford",
              "westmeath",
              "wexford",
              "wicklow"
            ],
            "type": "string",
            "description": "Pick a county to search its jobs. Takes the place of the town above."
          },
          "radius": {
            "title": "Distance from the town (km)",
            "minimum": 1,
            "maximum": 200,
            "type": "integer",
            "description": "Optional, needs the town above. IrishJobs accepts 5, 10, 20, 30, 40, 50, 75 or 100."
          },
          "postedWithin": {
            "title": "Posted in the last (days)",
            "minimum": 0,
            "type": "integer",
            "description": "1, 3, 7 or 14. Other numbers round up to the next of these (5 becomes 7), and above 14 the filter is off. For hours or minutes use the age limit under Keep only."
          },
          "minSalary": {
            "title": "Salary at least (EUR a year)",
            "minimum": 0,
            "type": "integer",
            "description": "e.g. 40000. IrishJobs then leaves out jobs that show no salary."
          },
          "companyType": {
            "title": "Posted by",
            "enum": [
              "employer",
              "agency"
            ],
            "type": "string",
            "description": "Direct employers only, or recruitment agencies only. Empty: both."
          },
          "sort": {
            "title": "Result order",
            "enum": [
              "relevance",
              "date",
              "salary_high",
              "salary_low",
              "distance"
            ],
            "type": "string",
            "description": "Relevance by default. Newest first suits scheduled feeds.",
            "default": "relevance"
          },
          "startUrls": {
            "title": "irishjobs.ie pages",
            "type": "array",
            "description": "Listing pages such as https://www.irishjobs.ie/jobs/dublin, /jobs/software-engineer/in-cork or /jobs-at/{company}, and single job pages (/job/{slug}/{company}-job{id}). Any filter the site's own search offers works in the page address. For totaljobs.com use [TotalJobs Scraper](https://apify.com/memo23/totaljobs-scraper), for stepstone.de/at/fr use [StepStone Scraper](https://apify.com/memo23/stepstone-search-cheerio-ppr).",
            "items": {
              "type": "string"
            }
          },
          "remoteOnly": {
            "title": "Fully remote jobs only",
            "type": "boolean",
            "description": "Keeps jobs marked Remote; hybrid roles are left out. IrishJobs has no remote filter of its own, so the run reads up to the job limit and keeps the remote ones.",
            "default": false
          },
          "maxAgeMinutes": {
            "title": "Posted within the last (minutes)",
            "minimum": 0,
            "type": "integer",
            "description": "0 (default): off. With an hourly schedule and newest-first order, 60 gives a live feed.",
            "default": 0
          },
          "fromDate": {
            "title": "Posted on or after",
            "type": "string",
            "description": "A date (YYYY-MM-DD) or a full ISO date and time."
          },
          "toDate": {
            "title": "Posted on or before",
            "type": "string",
            "description": "A date (YYYY-MM-DD, which counts the whole day) or a full ISO date and time."
          },
          "excludeKeywords": {
            "title": "Leave out jobs mentioning",
            "type": "object",
            "description": "Words in the same shape as the next field, e.g. {\"keywords\":[\"PHP\",\"WordPress\"]}."
          },
          "includeKeywords": {
            "title": "Keep jobs mentioning",
            "type": "object",
            "description": "At least one of these words has to be in the title, description or skills, e.g. {\"keywords\":[\"React\",\"Node.js\"],\"matchTitle\":true,\"matchDescription\":true,\"matchSkills\":true}. The three match switches are on unless set to false."
          },
          "customFilters": {
            "title": "Rules on any column (advanced)",
            "type": "array",
            "description": "Each rule names a column (dot paths work), an operator and a value, e.g. {\"field\":\"salary.min\",\"op\":\"gte\",\"value\":50000}. Operators: includes, notIncludes, equals, notEquals, gt, gte, lt, lte. Example list: [{\"field\":\"location.locality\",\"op\":\"includes\",\"value\":\"Dublin\"},{\"field\":\"description\",\"op\":\"notIncludes\",\"value\":\"php\"}]."
          },
          "compact": {
            "title": "Short rows (15 columns)",
            "type": "boolean",
            "description": "Job id, title, company, place, salary band, skills, dates, links and a plain-text description. Email columns stay when the email lookup is on.",
            "default": false
          },
          "outputFields": {
            "title": "Keep only these columns",
            "type": "array",
            "description": "Optional column names, dot paths allowed, e.g. title, salary.min, employer.name or location.locality. Empty: all columns.",
            "items": {
              "type": "string"
            }
          },
          "excludeEmptyFields": {
            "title": "Leave out empty fields",
            "type": "boolean",
            "description": "On: fields with no value (null, empty text or an empty list) are removed from each row.",
            "default": false
          },
          "descriptionFormat": {
            "title": "Description versions",
            "enum": [
              "all",
              "text",
              "html",
              "markdown"
            ],
            "type": "string",
            "description": "Which extra description columns to add: plain text, HTML, Markdown or all three. The original description column is always kept.",
            "default": "all"
          },
          "descriptionMaxLength": {
            "title": "Cut descriptions at",
            "minimum": 0,
            "type": "integer",
            "description": "Longest description kept, in characters, with ... added. 0 (default): no cut. Goes well with short rows when tokens count.",
            "default": 0
          },
          "enrichEmails": {
            "title": "Find employer contact emails (charged per email)",
            "type": "boolean",
            "description": "Looks up each employer's website from its name and reads a contact email from it. Adds contactEmail, contactWebsite and an emailEnrichment object. Charged only when an email is found, never for a miss.",
            "default": false
          },
          "qualifyByPayment": {
            "title": "Flag employers that take payments online",
            "type": "boolean",
            "description": "Needs the email option above. The pages already read for emails are checked for payment and shop platforms (Stripe, Shopify, PayPal, Paddle, Lemon Squeezy, WooCommerce, Square, Chargebee and others). Adds takesPayments, paymentProcessors, stripeLiveKey and paymentConfidence at no extra charge or time.",
            "default": false
          },
          "skipReposts": {
            "title": "Skip jobs already saved",
            "type": "boolean",
            "description": "Remembers every saved job for 90 days and skips it on later runs before its page is opened, so it is never charged and does not count toward the job limit. Scheduled runs keep going until they find new jobs.",
            "default": false
          },
          "dedupStoreName": {
            "title": "Name of the seen-jobs memory",
            "type": "string",
            "description": "Default irishjobs-seen-jobs. Use different names to keep searches apart, or one name to share a memory between tasks."
          },
          "notifyOnlyChanges": {
            "title": "Stay quiet when nothing is new",
            "type": "boolean",
            "description": "On (default): no alert after a run that found nothing new. Off: an alert after every run.",
            "default": true
          },
          "notificationLimit": {
            "title": "Jobs listed per alert",
            "minimum": 1,
            "maximum": 25,
            "type": "integer",
            "description": "Default 10, at most 25.",
            "default": 10
          },
          "webhookUrl": {
            "title": "Webhook address",
            "type": "string",
            "description": "Any HTTPS address. Gets a JSON POST with counts, a dataset link and the newest jobs, for n8n, Make, Zapier or your own backend."
          },
          "webhookHeaders": {
            "title": "Headers for that webhook",
            "type": "object",
            "description": "Optional JSON object of headers sent with the webhook POST, for example an Authorization header with your token."
          },
          "slackWebhookUrl": {
            "title": "Slack incoming webhook",
            "type": "string",
            "description": "Created under api.slack.com/messaging/webhooks."
          },
          "discordWebhookUrl": {
            "title": "Discord channel webhook",
            "type": "string",
            "description": "Created in the channel's integration settings."
          },
          "telegramChatId": {
            "title": "Telegram chat",
            "type": "string",
            "description": "Chat or channel ID your bot posts to, e.g. -1001234567890 (@userinfobot shows yours). Needs the bot token below."
          },
          "telegramToken": {
            "title": "Token of your Telegram bot",
            "type": "string",
            "description": "From @BotFather. Used with the chat above."
          },
          "whatsappTo": {
            "title": "WhatsApp number to message",
            "type": "string",
            "description": "International format, e.g. +353861234567. Meta delivers plain messages only within 24 hours of that person's last message to your business number. Needs the two fields below."
          },
          "whatsappPhoneNumberId": {
            "title": "WhatsApp sender number ID",
            "type": "string",
            "description": "The numeric ID Meta shows next to your business number, not the number itself."
          },
          "whatsappAccessToken": {
            "title": "WhatsApp Cloud API token",
            "type": "string",
            "description": "Needs the whatsapp_business_messaging permission."
          },
          "maxItems": {
            "title": "Jobs per search or listing page",
            "minimum": 1,
            "type": "integer",
            "description": "The most job rows from each search or listing page, default 1000: 2 keywords at 100 give up to 200 rows. A single job page gives 1 row. Each row is a charged item. With Skip jobs already saved on, skipped jobs do not count. On the free Apify plan a run stops at 100 rows.",
            "default": 1000
          },
          "maxConcurrency": {
            "title": "Job pages read at once",
            "minimum": 1,
            "maximum": 10,
            "type": "integer",
            "description": "Default 4, at most 10. Between 3 and 6 works best.",
            "default": 4
          },
          "maxRequestRetries": {
            "title": "Tries per page",
            "minimum": 0,
            "type": "integer",
            "description": "How many times a page that fails is tried again before it is given up, default 6.",
            "default": 6
          },
          "proxy": {
            "title": "Your own proxy (optional)",
            "type": "object",
            "description": "Leave empty: the actor's own connection is included at no extra cost. Set this only to use your own proxies."
          }
        }
      },
      "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
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "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
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}