{ "openapi": "3.0.1", "info": { "title": "Journalist Request Finder: HARO Alternative for Digital PR", "description": "Find live journalist source requests in one feed, pulled from SourceBottle call-outs and #journorequest posts on Bluesky and Mastodon. Filter by your topics, sort by deadline, and schedule daily runs that return only new requests. No HARO account, no Qwoted login, no API keys.", "version": "0.1", "x-build-id": "TtzNqTJActfmCPOvu" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/fayoussef~journalist-request-finder/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-fayoussef-journalist-request-finder", "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/fayoussef~journalist-request-finder/runs": { "post": { "operationId": "runs-sync-fayoussef-journalist-request-finder", "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/fayoussef~journalist-request-finder/run-sync": { "post": { "operationId": "run-sync-fayoussef-journalist-request-finder", "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": { "keywords": { "title": "Your topics / expertise", "type": "array", "description": "The topics you can speak on, in plain words - e.g. `cybersecurity`, `personal finance`, `interior design`. Requests mentioning any of them are matched, tagged and ranked to the top. Leave empty to get every open request.\n\n⚡ Unlock full pages and higher limits by subscribing to an [Apify plan](https://apify.com/pricing?fpr=youssef).\n💼 Need a custom solution? Reach out at youssefarhan24@gmail.com\n🌐 Got a site in mind? [Suggest it here](https://automationbyexperts.com/apify)", "items": { "type": "string" } }, "keywordsOnly": { "title": "Only requests matching my topics", "type": "boolean", "description": "Drop every request that does not mention one of your keywords. Turn on once your keyword list is dialled in; leave off to also browse everything else that is open.", "default": false }, "onlyOpenDeadlines": { "title": "Hide expired requests", "type": "boolean", "description": "Keep only requests whose deadline has not passed. Social posts count as open for 30 days after they were posted, since journalists rarely state a deadline there.", "default": true }, "maxRequests": { "title": "Max requests to return", "minimum": 1, "maximum": 2000, "type": "integer", "description": "Stop after this many requests, most pitchable first. Free plan is capped at 25.", "default": 200 }, "sources": { "title": "Where to look", "type": "array", "description": "Which public sources to pull from. All three are free and need no account. SourceBottle carries the structured call-outs with real deadlines and is where the volume is; Bluesky carries live #journorequest posts. Mastodon is off by default because the hashtag is only lightly used there.", "items": { "type": "string", "enum": [ "sourcebottle", "bluesky", "mastodon" ], "enumTitles": [ "SourceBottle (journalist call-outs)", "Bluesky (#journorequest)", "Mastodon (#journorequest, sparse)" ] }, "default": [ "sourcebottle", "bluesky" ] }, "industries": { "title": "SourceBottle sections", "type": "array", "description": "Narrow SourceBottle to specific sections. Leave empty to scan all twelve, which is usually what you want since journalists file requests under the section that fits their outlet, not your niche.", "items": { "type": "string", "enum": [ "63", "61", "64", "65", "66", "67", "69", "70", "71", "68", "62", "54" ], "enumTitles": [ "General", "Business & Finance", "Health & Wellbeing", "Lifestyle, Food & Fashion", "Parenting & Education", "Professional Services", "PR, Media & Marketing", "Technology", "Travel & Leisure", "Property", "Environment", "Samples, Prizes & Sponsorship" ] }, "default": [] }, "onlyNewRequests": { "title": "Only new requests (for scheduled runs)", "type": "boolean", "description": "The Actor remembers every request it has ever returned to you. Turn this on in a daily schedule to get only requests you have not seen before, so each run is a clean alert instead of the whole board.", "default": false }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Optional. Every source is public, so a proxy is not required. Leave it on if you run frequently or from a blocked region.", "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 } } }, "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 } } } } } } } } } }