{ "openapi": "3.0.1", "info": { "title": "OnlyFans Finder", "description": "Discover OnlyFans creators by keyword, niche, location, or category. Filter by price, likes range, and sort order. Or look up specific usernames directly via the API. Extracts 35+ profile fields including bio, stats, pricing, and social links. No OnlyFans account needed.", "version": "0.0", "x-build-id": "gQesmLRNG6LsMRbA0" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/trev0n~onlyfans-finder/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-trev0n-onlyfans-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/trev0n~onlyfans-finder/runs": { "post": { "operationId": "runs-sync-trev0n-onlyfans-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/trev0n~onlyfans-finder/run-sync": { "post": { "operationId": "run-sync-trev0n-onlyfans-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": { "searchMode": { "title": "Search Mode", "enum": [ "discovery", "direct" ], "type": "string", "description": "How to find creators. 'discovery' searches by keywords, location, and filters. 'direct' looks up specific usernames via OnlyFans API.", "default": "discovery" }, "keywords": { "title": "Search Keywords", "type": "array", "description": "Keywords to search for creators — niche, appearance, interests, style, etc. Examples: 'fitness', 'cosplay', 'latina model', 'redhead'. Used in discovery mode.", "items": { "type": "string" } }, "usernames": { "title": "Usernames", "type": "array", "description": "OnlyFans usernames to look up directly (without @ prefix). Used in direct mode. Examples: 'username1', 'username2'", "items": { "type": "string" } }, "location": { "title": "Location", "type": "string", "description": "Optional geographic filter — city, state, or country. Examples: 'New York', 'California', 'UK'. Used in discovery mode.", "default": "" }, "category": { "title": "Category", "type": "string", "description": "Optional category filter — narrows results to a specific niche. Use the category slug. Examples: 'blonde-onlyfans', 'fitness-gym-girl-onlyfans', 'cosplay-onlyfans', 'latina-onlyfans', 'asian-onlyfans', 'petite-skinny-onlyfans', 'bbw-onlyfans', 'redhead-onlyfans', 'gamer-girl-onlyfans'. Used in discovery mode.", "default": "" }, "priceRange": { "title": "Price Range", "enum": [ "all", "free", "1-10", "10-25", "25+" ], "type": "string", "description": "Filter creators by subscription price range. Used in discovery mode.", "default": "all" }, "sortBy": { "title": "Sort By", "enum": [ "popular", "new", "likes", "price-low", "price-high" ], "type": "string", "description": "How to sort/rank the search results. Used in discovery mode.", "default": "popular" }, "maxResults": { "title": "Max Results", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Maximum number of creator profiles to collect across all keywords. Used in discovery mode.", "default": 100 }, "searchDepth": { "title": "Search Depth", "enum": [ "shallow", "medium", "deep" ], "type": "string", "description": "How thoroughly to search. Controls how many sort/price combinations are queried per keyword. 'shallow' uses your selected sort & price only (~21 results per keyword). 'medium' tries multiple sort orders (~100 per keyword). 'deep' combines all sort orders with all price ranges for maximum coverage (~300+ per keyword). Used in discovery mode.", "default": "medium" }, "minLikes": { "title": "Minimum Likes", "minimum": 0, "type": "integer", "description": "Only include creators with at least this many likes. Set to 0 to disable. Used in discovery mode.", "default": 0 }, "maxLikes": { "title": "Maximum Likes", "minimum": 0, "type": "integer", "description": "Only include creators with at most this many likes. Useful for finding mid-tier or emerging creators. Set to 0 to disable. Used in discovery mode.", "default": 0 }, "requireInstagram": { "title": "Require Instagram", "type": "boolean", "description": "Only include creators who have an Instagram link. Automatically enables 'Enrich with OnlyFans API' since Instagram links are fetched from the API.", "default": false }, "enrichProfile": { "title": "Enrich with OnlyFans API", "type": "boolean", "description": "Fetch additional profile data (verified status, join date, last seen, subscriber count, etc.) directly from OnlyFans API. Slower but provides much more complete data. Used in discovery mode (always enabled in direct mode).", "default": false }, "maxConcurrency": { "title": "Max Concurrency", "minimum": 1, "maximum": 10, "type": "integer", "description": "Maximum number of browser pages running in parallel. Used in discovery mode.", "default": 3 }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Proxy settings for the browser. Residential proxies recommended for best results." } } }, "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 } } } } } } } } } }