{ "openapi": "3.0.1", "info": { "title": "PeoplePerHour Scraper", "description": "[💰 $3.0 / 1K] Extract freelance project and job postings from PeoplePerHour. Search by keyword, browse a category, or paste URLs, then filter by price type, experience level, and remote work. Get titles, budgets, currencies, categories, skills, posting dates, proposal counts, and client details.", "version": "1.0", "x-build-id": "yU8mbcUkUE6ifLo6O" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/solidcode~peopleperhour-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-solidcode-peopleperhour-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/solidcode~peopleperhour-scraper/runs": { "post": { "operationId": "runs-sync-solidcode-peopleperhour-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/solidcode~peopleperhour-scraper/run-sync": { "post": { "operationId": "run-sync-solidcode-peopleperhour-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": { "searchQueries": { "title": "Search Keywords", "maxItems": 50, "type": "array", "description": "Keywords or phrases to search PeoplePerHour for, such as 'wordpress', 'logo design', or 'data entry'. Each keyword runs its own search. Leave empty to use the category below or to collect the broadest project feed. Up to 50 keywords per run.", "items": { "type": "string" } }, "category": { "title": "Category", "enum": [ "", "artificial-intelligence", "technology-programming", "writing-translation", "design", "digital-marketing", "social-media", "marketing-branding-sales", "video-photography", "music-audio", "business" ], "type": "string", "description": "Browse a single PeoplePerHour category instead of, or together with, a keyword. Leave on 'Any category' to search everything." }, "startUrls": { "title": "Direct PeoplePerHour URLs", "maxItems": 50, "type": "array", "description": "Paste full PeoplePerHour freelance-jobs URLs (e.g. https://www.peopleperhour.com/freelance-jobs/technology-programming or a filtered search page) to scrape them exactly as shown on the site. Any filters baked into the URL are respected. Up to 50 URLs per run.", "items": { "type": "string" } }, "priceType": { "title": "Price Type", "enum": [ "", "fixed", "hourly" ], "type": "string", "description": "Limit results to one pricing model. Leave on 'Any' to include both." }, "experienceLevel": { "title": "Experience Level", "enum": [ "", "entry", "intermediate", "expert" ], "type": "string", "description": "Only return projects asking for this experience level. Leave on 'Any' to include all levels." }, "remoteOnly": { "title": "Remote Only", "type": "boolean", "description": "Only return projects that can be done remotely.", "default": false }, "sortBy": { "title": "Sort By", "enum": [ "recent", "relevant" ], "type": "string", "description": "Order results by most recently posted or by best match to your search.", "default": "recent" }, "maxResults": { "title": "Max Results per Search", "minimum": 0, "type": "integer", "description": "Maximum number of projects to collect per keyword, category, or start URL. Set to 0 to collect all available results across pagination. Results are fetched in pages: the actor stops once your cap is reached but always keeps the whole final page, so a small cap can return up to a full page more than you asked for.", "default": 100 }, "onlyUniqueProjects": { "title": "Only Unique Projects", "type": "boolean", "description": "When on, each project is returned once even if it appears across several pages or searches. Deduplicates by the project ID. Turn off to keep every copy.", "default": true }, "includeDescription": { "title": "Fetch Full Project Descriptions", "type": "boolean", "description": "Include the full project description and any extra detail-page fields (skills, client info, expiry) for each project. Leave on for the most complete data. Turn off for lighter, faster records when you only need titles, budgets, categories, posting dates, and project links from the results list.", "default": 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 } } }, "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 } } } } } } } } } }