{ "openapi": "3.0.1", "info": { "title": "Humanitix Scraper", "description": "Scrape Humanitix event listings and details by country - community events, fundraisers, conferences and workshops with dates, venues and tickets.", "version": "1.0", "x-build-id": "pyymaGOblhFrQ1nJy" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/mrdoe~humanitix-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-mrdoe-humanitix-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/mrdoe~humanitix-scraper/runs": { "post": { "operationId": "runs-sync-mrdoe-humanitix-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/mrdoe~humanitix-scraper/run-sync": { "post": { "operationId": "run-sync-mrdoe-humanitix-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", "required": [ "operation", "country" ], "properties": { "operation": { "title": "Operation", "enum": [ "search", "eventDetails" ], "type": "string", "description": "Which Humanitix data to scrape. One operation per run.", "default": "search" }, "country": { "title": "Country", "enum": [ "au", "us", "gb", "nz", "ca" ], "type": "string", "description": "Which Humanitix country storefront to browse. Used by the \"Browse events\" operation.", "default": "au" }, "locationSlug": { "title": "Location (optional)", "type": "string", "description": "A specific Humanitix location to browse, e.g. \"au--nsw--sydney\", \"au--vic--melbourne\", \"us--ny--new-york\", \"gb--england--london\". Find the exact value in a Humanitix location page's URL. Leave blank to browse the whole country selected above." }, "category": { "title": "Category (optional)", "enum": [ "", "charityAndCauses", "businessAndProfessional", "communityAndCulture", "music", "performingAndVisualArts", "filmMediaAndEntertainment", "foodAndDrink", "healthAndWellness", "sportsAndFitness", "familyAndEducation", "schoolActivities", "scienceAndTechnology", "hobbiesAndSpecialInterest", "homeAndLifestyle", "fashionAndBeauty", "religionAndSpirituality", "governmentAndPolitics", "travelAndOutdoor", "seasonalAndHoliday", "autoBoatAndAir" ], "type": "string", "description": "Filter to one event category, e.g. Charity & Causes for nonprofit/fundraiser events. Leave blank for all categories.", "default": "" }, "sortBy": { "title": "Sort by (optional)", "enum": [ "", "recommended", "trending" ], "type": "string", "description": "Bias results toward recommended or currently trending events. Leave blank for the default relevance order.", "default": "" }, "timeFrame": { "title": "Time frame (optional)", "enum": [ "", "today", "thisweekend" ], "type": "string", "description": "Restrict results to a date window. Leave blank for all upcoming dates.", "default": "" }, "maxItems": { "title": "Max items (optional)", "minimum": 1, "type": "integer", "description": "Caps total rows returned for the \"Browse events\" operation (event details always returns one row per event). The first 10 rows of any run are free. Leave blank to use the default of 20.", "default": 20 }, "eventUrl": { "title": "Event URL or slug (optional)", "type": "string", "description": "A Humanitix event page URL (e.g. https://events.humanitix.com/some-event) or its slug. Used by the \"Event details\" operation. Leave blank to fetch a live sample event." }, "eventUrls": { "title": "Event URLs or slugs - batch (optional)", "type": "array", "description": "Many event URLs or slugs in one run. Wins over \"Event URL\" when filled.", "items": { "type": "string" } }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Proxy settings for the run. Humanitix serves both operations over plain HTTP with no bot-verification challenge, so Apify's default proxy works well.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } }