{
  "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}