# FeetFinder Scraper & Profile Extractor (`dev00/feetfinder-scraper`) Actor Scrape and filter FeetFinder sellers, profiles, store items, and socials with location geocoding and category filters. - **URL**: https://apify.com/dev00/feetfinder-scraper.md - **Developed by:** [dev00](https://apify.com/dev00) (community) - **Categories:** Social media - **Stats:** 1 total users, 1 monthly users, 99.6% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing $6.00 / 1,000 successful requests This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## FeetFinder Scraper & Profile Extractor Search and filter FeetFinder sellers, and extract full profile posts, premium store catalog items, and external social media links. --- ### Features - πŸ” **Search & Filter:** Search sellers by keyword or niche category, age, gender, eye color, BMI, foot size, and willing to meet/show face criteria. - πŸ—ΊοΈ **Geocoding Locations:** Pass simple text queries (e.g. "Boston, MA") to automatically geocode and filter sellers. - πŸ‘₯ **Profile Content Scraper:** Scrape user content logs, photo paths, and pricing info. - πŸ›’ **Store Catalog Scraper:** Retrieve listed paid/free store items for sale by the seller. - πŸ”— **Social Handles Extractor:** Scrape external media handles (Instagram, Twitter/X, etc.). --- ### Input Parameters The actor accepts the following parameters: | Field | Type | Description | |---|---|---| | **action** | `select` | Scraper action (`search`, `profile`, `store`, `socials`). | | **keyword** | `string` | Optional keyword search (overrides other filters). | | **category** | `select` | Select niche category (adorable, amateur, ebony, etc.). | | **gender** | `select` | Filter by gender ID (Female, Male, Transgender, Couple). | | **location** | `string` | Geocoded location filter (e.g. "Boston, MA"). | | **willingToShowFace** | `boolean` | Filter by willing to show face (default: true). | | **willingToMeetPerson** | `boolean` | Filter by willing to meet in person (default: false). | | **sellerId** | `integer` | Target seller ID (required for profile, store, and socials actions). | | **page** | `integer` | Page number for search (page 2 requests limit 200). | --- ### πŸ’° Pricing & Monetization This Actor is published under the **Apify Monetization** program and utilizes the **Pay-Per-Event (PPE)** pricing model. You are charged a single flat rate only for successful extraction actions: | Event Name | Title | Description | Developer Price (per 1,000 runs) | Unit Price (per event) | |---|---|---|---|---| | `request-success` | Successful Request | Charged per successful scraper action (search query, profile details, store items, or socials extraction). | **$2.00** | `$0.002` | # Actor input Schema ## `action` (type: `string`): Select the scraper action to perform. ## `keyword` (type: `string`): Optional search term. Overrides other filters if provided. ## `categories` (type: `array`): Select one or more categories niche to search. ## `genders` (type: `array`): Select one or more genders to search. ## `races` (type: `array`): Select one or more race categories. ## `eyeColor` (type: `array`): Select one or more eye colors. ## `hairColor` (type: `array`): Select one or more hair colors. ## `height` (type: `array`): Select one or more height options. ## `location` (type: `string`): Filter by city/state (e.g. 'Boston, MA' or 'Miami'). ## `willingToShowFace` (type: `string`): Filter by face visibility. ## `willingToMeetPerson` (type: `string`): Filter by meeting in person. ## `minAge` (type: `integer`): Minimum age filter. ## `maxAge` (type: `integer`): Maximum age filter. ## `sellerId` (type: `integer`): Required only for Profile, Store Items, and Socials actions. ## `page` (type: `integer`): Page number for search (e.g., page 2 automatically requests limit 200). ## `isReview` (type: `string`): Filter by review status. ## `isWithBio` (type: `string`): Filter by biography status. ## `minBmi` (type: `integer`): Minimum BMI value. ## `maxBmi` (type: `integer`): Maximum BMI value. ## `minPrice` (type: `integer`): Minimum subscription/content price. ## `maxPrice` (type: `integer`): Maximum subscription/content price. ## `minFootSize` (type: `integer`): Minimum foot size value. ## `maxFootSize` (type: `integer`): Maximum foot size value. ## `footSizeType` (type: `string`): Foot size standard measurement. ## `minWeight` (type: `integer`): Minimum body weight. ## `maxWeight` (type: `integer`): Maximum body weight. ## `experience` (type: `array`): Select one or more seller experience levels. ## `sort` (type: `string`): Sorting criteria for search results. ## `boostStatus` (type: `string`): Filter by boosted status. ## Actor input object example ```json { "action": "search", "categories": [], "genders": [], "races": [], "eyeColor": [], "hairColor": [], "height": [], "willingToShowFace": "any", "willingToMeetPerson": "any", "minAge": 32, "maxAge": 70, "sellerId": 2790476, "page": 1, "isReview": "any", "isWithBio": "any", "minBmi": 11, "maxBmi": 91, "minPrice": 1, "maxPrice": 73, "minFootSize": 2, "maxFootSize": 16, "footSizeType": "US", "minWeight": 95, "maxWeight": 455, "experience": [], "sort": "1", "boostStatus": "any" } ```` # Actor output Schema ## `results` (type: `string`): No description ## `keyValueStoreResult` (type: `string`): No description # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = {}; // Run the Actor and wait for it to finish const run = await client.actor("dev00/feetfinder-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`πŸ’Ύ Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // πŸ“š Want to learn more πŸ“–? Go to β†’ https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = {} # Run the Actor and wait for it to finish run = client.actor("dev00/feetfinder-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("πŸ’Ύ Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # πŸ“š Want to learn more πŸ“–? Go to β†’ https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{}' | apify call dev00/feetfinder-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=dev00/feetfinder-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "FeetFinder Scraper & Profile Extractor", "description": "Scrape and filter FeetFinder sellers, profiles, store items, and socials with location geocoding and category filters.", "version": "1.0", "x-build-id": "eOrYan6LbK3QWHgEz" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/dev00~feetfinder-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-dev00-feetfinder-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/dev00~feetfinder-scraper/runs": { "post": { "operationId": "runs-sync-dev00-feetfinder-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/dev00~feetfinder-scraper/run-sync": { "post": { "operationId": "run-sync-dev00-feetfinder-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": [ "action" ], "properties": { "action": { "title": "Action", "enum": [ "search", "profile", "store", "socials" ], "type": "string", "description": "Select the scraper action to perform.", "default": "search" }, "keyword": { "title": "Keyword Search", "type": "string", "description": "Optional search term. Overrides other filters if provided." }, "categories": { "title": "Categories", "type": "array", "description": "Select one or more categories niche to search.", "items": { "type": "string", "enum": [ "adorable", "african", "amateur", "amputee", "angel", "anime", "arab", "arched", "asian", "ass", "athletic", "automotive", "babe", "bbw", "bdsm", "beautiful", "big-boobs", "big-feet", "bisexual", "blonde", "boobs", "boots", "brazilian", "british", "brunette", "bunion", "bunny", "callus", "chubby-feet", "college", "crocs", "curvy", "dancer", "dildo", "dirty", "disabled", "dominant", "dominatrix", "ebony", "emo", "fantasy", "female", "femdom", "fishnet", "flat-feet", "food", "footjob", "french", "french-tips", "fur", "gay", "german", "giantess", "girl-next-door", "goth", "gym", "hairy", "high-arch", "high-heels", "humiliation", "husband", "indian", "irish", "italian", "japanese", "jewellery", "korean", "licking", "latina", "legs", "lotion", "male", "mature", "medical", "milf", "mirror", "missing-toenail", "mom", "naked", "nail-color-white", "nail-color-black", "nail-color-blue", "nail-polish", "nurse", "nylon", "oiled", "pedicure", "petite", "pink-soles", "platform-heels", "polydactyly", "pov", "pretty", "princess", "redhead", "sandals", "showing-face", "smelly", "smooth-soles", "sneakers", "socks", "soles", "stomping", "strappy-sandals", "stripper", "submissive", "sweaty", "teacher", "thick", "tickle", "toes", "trampling", "trans", "uk", "vehicles", "veins", "waitress", "webbed-feet", "wedge", "white", "wife", "wrinkly-soles" ], "enumTitles": [ "Adorable", "African", "Amateur", "Amputee", "Angel", "Anime", "Arab", "Arched", "Asian", "Ass", "Athletic", "Automotive", "Babe", "BBW", "BDSM", "Beautiful", "Big Boobs", "Big Feet", "Bisexual", "Blonde", "Boobs", "Boots", "Brazilian", "British", "Brunette", "Bunion", "Bunny", "Callus", "Chubby Feet", "College", "Crocs", "Curvy", "Dancer", "Dildo", "Dirty", "Disabled", "Dominant", "Dominatrix", "Ebony", "Emo", "Fantasy", "Female", "Femdom", "Fishnet", "Flat Feet", "Food", "Footjob", "French", "French Tips", "Fur", "Gay", "German", "Giantess", "Girl Next Door", "Goth", "Gym", "Hairy", "High Arch", "High Heels", "Humiliation", "Husband", "Indian", "Irish", "Italian", "Japanese", "Jewellery", "Korean", "Licking", "Latina", "Legs", "Lotion", "Male", "Mature", "Medical", "Milf", "Mirror", "Missing Toenail", "Mom", "Naked", "Nail Color: White", "Nail Color: Black", "Nail Color: Blue", "Nail Polish", "Nurse", "Nylon", "Oiled", "Pedicure", "Petite", "Pink Soles", "Platform Heels", "Polydactyly", "POV", "Pretty", "Princess", "Redhead", "Sandals", "Showing Face", "Smelly", "Smooth Soles", "Sneakers", "Socks", "Soles", "Stomping", "Strappy Sandals", "Stripper", "Submissive", "Sweaty", "Teacher", "Thick", "Tickle", "Toes", "Trampling", "Trans", "UK", "Vehicles", "Veins", "Waitress", "Webbed Feet", "Wedge", "White", "Wife", "Wrinkly Soles" ] }, "default": [] }, "genders": { "title": "Genders Filter", "type": "array", "description": "Select one or more genders to search.", "items": { "type": "string", "enum": [ "0", "1", "2", "6", "7" ], "enumTitles": [ "Female", "Male", "Transgender", "Couple", "Other" ] }, "default": [] }, "races": { "title": "Races Filter", "type": "array", "description": "Select one or more race categories.", "items": { "type": "string", "enum": [ "0", "1", "2", "3", "4", "6", "7", "8" ], "enumTitles": [ "White", "Black/African-American", "Latino/Hispanic", "East Asian", "South Asian", "Middle Eastern", "Native American", "Mixed/Other" ] }, "default": [] }, "eyeColor": { "title": "Eye Colors", "type": "array", "description": "Select one or more eye colors.", "items": { "type": "string", "enum": [ "Amber", "Blue", "Gray", "Green", "Hazel", "Brown" ] }, "default": [] }, "hairColor": { "title": "Hair Colors", "type": "array", "description": "Select one or more hair colors.", "items": { "type": "string", "enum": [ "Blonde", "Brunette", "Redhead", "Black", "Coloured" ] }, "default": [] }, "height": { "title": "Height Ranges", "type": "array", "description": "Select one or more height options.", "items": { "type": "string", "enum": [ "3 ft", "3.1 ft", "3.2 ft", "3.3 ft", "3.4 ft", "3.5 ft", "3.6 ft", "3.7 ft", "3.8 ft", "3.9 ft", "3.10 ft", "3.11 ft", "4.0 ft", "4.1 ft", "4.2 ft", "4.3 ft", "4.4 ft", "4.5 ft", "4.6 ft", "4.7 ft", "4.8 ft", "4.9 ft", "4.10 ft", "4.11 ft", "5.0 ft", "5.1 ft", "5.2 ft", "5.3 ft", "5.4 ft", "5.5 ft", "5.6 ft", "5.7 ft", "5.8 ft", "5.9 ft", "5.10 ft", "5.11 ft", "6.0 ft", "6.1 ft", "6.2 ft", "6.3 ft", "6.4 ft", "6.5 ft", "6.6 ft", "6.7 ft", "6.8 ft", "6.9 ft", "6.10 ft", "6.11 ft", "7.0 ft" ] }, "default": [] }, "location": { "title": "Location Query", "type": "string", "description": "Filter by city/state (e.g. 'Boston, MA' or 'Miami')." }, "willingToShowFace": { "title": "Willing to Show Face", "enum": [ "any", "true", "false" ], "type": "string", "description": "Filter by face visibility.", "default": "any" }, "willingToMeetPerson": { "title": "Willing to Meet in Person", "enum": [ "any", "true", "false" ], "type": "string", "description": "Filter by meeting in person.", "default": "any" }, "minAge": { "title": "Minimum Age", "type": "integer", "description": "Minimum age filter.", "default": 32 }, "maxAge": { "title": "Maximum Age", "type": "integer", "description": "Maximum age filter.", "default": 70 }, "sellerId": { "title": "Seller ID", "type": "integer", "description": "Required only for Profile, Store Items, and Socials actions.", "default": 2790476 }, "page": { "title": "Page / Offset", "type": "integer", "description": "Page number for search (e.g., page 2 automatically requests limit 200).", "default": 1 }, "isReview": { "title": "Has Reviews", "enum": [ "any", "true", "false" ], "type": "string", "description": "Filter by review status.", "default": "any" }, "isWithBio": { "title": "Has Bio", "enum": [ "any", "true", "false" ], "type": "string", "description": "Filter by biography status.", "default": "any" }, "minBmi": { "title": "Min BMI", "type": "integer", "description": "Minimum BMI value.", "default": 11 }, "maxBmi": { "title": "Max BMI", "type": "integer", "description": "Maximum BMI value.", "default": 91 }, "minPrice": { "title": "Min Price ($)", "type": "integer", "description": "Minimum subscription/content price.", "default": 1 }, "maxPrice": { "title": "Max Price ($)", "type": "integer", "description": "Maximum subscription/content price.", "default": 73 }, "minFootSize": { "title": "Min Foot Size", "type": "integer", "description": "Minimum foot size value.", "default": 2 }, "maxFootSize": { "title": "Max Foot Size", "type": "integer", "description": "Maximum foot size value.", "default": 16 }, "footSizeType": { "title": "Foot Size Type", "enum": [ "US", "UK", "EU" ], "type": "string", "description": "Foot size standard measurement.", "default": "US" }, "minWeight": { "title": "Min Weight (lbs)", "type": "integer", "description": "Minimum body weight.", "default": 95 }, "maxWeight": { "title": "Max Weight (lbs)", "type": "integer", "description": "Maximum body weight.", "default": 455 }, "experience": { "title": "Experience Filters", "type": "array", "description": "Select one or more seller experience levels.", "items": { "type": "string", "enum": [ "beginner", "amateur", "professional" ], "enumTitles": [ "Beginner", "Amateur", "Professional" ] }, "default": [] }, "sort": { "title": "Sort Option", "enum": [ "1", "2", "3", "4" ], "type": "string", "description": "Sorting criteria for search results.", "default": "1" }, "boostStatus": { "title": "Include Boosted", "enum": [ "any", "true", "false" ], "type": "string", "description": "Filter by boosted status.", "default": "any" } } }, "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 } } } } } } } } } } ```