{
  "openapi": "3.0.1",
  "info": {
    "title": "Codeable Scraper",
    "description": "Scrape Codeable's curated WordPress developer marketplace - browse the developer directory by specialty or country, or fetch full profile detail (rating, completed projects, skills, reviews) for specific developers.",
    "version": "1.0",
    "x-build-id": "oQNFeYjconuqgatxy"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/crawlerbros~codeable-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-crawlerbros-codeable-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/crawlerbros~codeable-scraper/runs": {
      "post": {
        "operationId": "runs-sync-crawlerbros-codeable-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/crawlerbros~codeable-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-crawlerbros-codeable-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": [
          "mode"
        ],
        "properties": {
          "mode": {
            "title": "Mode",
            "enum": [
              "browseDevelopers",
              "developerProfile"
            ],
            "type": "string",
            "description": "What to fetch.",
            "default": "browseDevelopers"
          },
          "searchQuery": {
            "title": "Search query (mode=browseDevelopers)",
            "type": "string",
            "description": "Free-text keyword search against Codeable's own developer-directory search box (e.g. a name, agency, or skill keyword). Combines with `specialty` and/or `country`.",
            "default": ""
          },
          "specialty": {
            "title": "Specialty (mode=browseDevelopers)",
            "enum": [
              "",
              "accelerated-mobile-pages-amp",
              "accessibility",
              "acf",
              "ada-compliance",
              "advanced-ads",
              "advanced-coupons",
              "advanced-form-building",
              "affiliatewp",
              "ai-integration",
              "amelia",
              "android",
              "angularjs",
              "animations",
              "anything-backend",
              "anything-frontend",
              "app-themes",
              "autoptimize",
              "avada",
              "awp-classifieds",
              "aws",
              "bbpress",
              "beaver-builder-plugin",
              "bedrock",
              "bigcommerce",
              "blockchain",
              "booked-appointment",
              "bookly",
              "bootstrap",
              "bricks-page-builder",
              "buddyboss",
              "buddypress",
              "bullhorn",
              "business-development",
              "business-directory-plugin",
              "caldera-forms",
              "cloudways",
              "contact-form-7",
              "conversion-rate-optimization-cro",
              "core-contributor",
              "cpanel",
              "css",
              "currency-switchers",
              "custom-api-integration",
              "custom-block-development",
              "custom-post-type",
              "custom-themes",
              "data-visualisation",
              "database-development",
              "design",
              "digitalocean",
              "directory-themes",
              "divi",
              "dokan",
              "doubleclick-for-publisher",
              "drupal",
              "easy-digital-downloads",
              "elasticpress",
              "elasticsearch",
              "elegant-themes",
              "elementor",
              "enfold",
              "essential-grid",
              "event-calendar",
              "event-espresso",
              "ewww-image-optimizer",
              "export-import",
              "facetwp",
              "flutter",
              "flywheel",
              "fooevents",
              "formidable-forms",
              "foundation-framework",
              "freemius",
              "french",
              "fse",
              "full-site-builds",
              "full-site-editing",
              "full-stack",
              "gamipress",
              "gatsbyjs",
              "gdpr",
              "generatepress",
              "genesis",
              "givewp",
              "google-ad-manager",
              "google-analytics",
              "google-cloud-platform",
              "google-maps-api",
              "gravity-forms",
              "gravityflow",
              "gravityview",
              "gutenberg",
              "hacking-cleanup",
              "headless-wordpress",
              "hosting-transfer",
              "html",
              "hubspot",
              "ionic",
              "ios",
              "jamstack",
              "javascript",
              "javascript-debugging",
              "jetpack",
              "jetpack-scan",
              "job-themes",
              "joomla",
              "jquery",
              "json-api",
              "jupiter",
              "kinsta",
              "laravel",
              "learndash",
              "learnpress",
              "lifterlms",
              "listable-theme",
              "listify",
              "magento",
              "mailchimp",
              "mailpoet",
              "maintenance",
              "meks-themes",
              "memberful",
              "memberium",
              "memberpress",
              "membership-websites",
              "microsoft-azure",
              "mobile-app-development",
              "mobile-responsiveness",
              "multilingualpress",
              "multisite",
              "mysql",
              "new-relic",
              "nextjs",
              "ninja-forms",
              "nodejs",
              "nuxtjs",
              "openai",
              "oxygen-builder",
              "paid-memberships-pro",
              "pantheon",
              "payment-gateways",
              "performance",
              "php",
              "php-7-x-x",
              "plesk",
              "plugin-customization",
              "plugin-development",
              "plugin-republic",
              "pods",
              "polylang",
              "pressable",
              "project-huddle",
              "react-js",
              "react-native",
              "recaptcha",
              "regex",
              "responsive-design",
              "restrict-content-pro",
              "rss",
              "runcloud",
              "salesforce",
              "salient",
              "search-wp",
              "searchwp",
              "security",
              "sensei",
              "seo",
              "seopress",
              "server-tuning",
              "shipstation",
              "shopify",
              "simple-page-tester",
              "simply-schedule-appointments",
              "site-hardening",
              "site-migration",
              "siteground",
              "skyverge",
              "slider-revolution",
              "speed-optimization",
              "sportspress",
              "squarespace",
              "stripe",
              "studio-press",
              "subversion",
              "sugar-calendar",
              "svg",
              "tailwind-css",
              "the-events-calendar",
              "the-seo-framework",
              "theme-customization",
              "theme-development",
              "tickera",
              "timber",
              "toolset",
              "troubleshooting",
              "twig",
              "ui-ux",
              "uncode-theme",
              "underscores",
              "understrap",
              "visual-composer",
              "vue-js",
              "w3-total-cache",
              "wc-pre-order",
              "wc-vendor-pro",
              "weglot",
              "woocommerce",
              "woocommerce-bookings",
              "woocommerce-composite-products",
              "woocommerce-currency-converter",
              "woocommerce-deposits",
              "woocommerce-events",
              "woocommerce-product-bundles",
              "woocommerce-shipping",
              "woocommerce-smart-coupons",
              "woocommerce-subscription",
              "woocommerce-vendors",
              "wordpress-vip",
              "wordpress-com",
              "wp-all-import",
              "wp-cli",
              "wp-job-manager",
              "wp-rest-api",
              "wp-rocket",
              "wp-rss-aggregator",
              "wp-simple-pay",
              "wpbakery-page-builder",
              "wpengine",
              "wpforms",
              "wpml",
              "xero-api",
              "yith",
              "yoast",
              "zapier"
            ],
            "type": "string",
            "description": "Filter the directory to developers listing this specialty/skill. Leave blank to browse all developers. If `country` is also set, the browse listing is fetched by country (Codeable can't combine both in one URL) and `specialty` is then applied as an additional client-side filter against each developer's listed specialties.",
            "default": ""
          },
          "country": {
            "title": "Country (mode=browseDevelopers)",
            "enum": [
              "",
              "albania",
              "argentina",
              "armenia",
              "australia",
              "austria",
              "bangladesh",
              "belgium",
              "bosnia-and-herzegovina",
              "brazil",
              "bulgaria",
              "canada",
              "china",
              "colombia",
              "croatia",
              "czechia",
              "denmark",
              "dominican-republic",
              "ecuador",
              "egypt",
              "france",
              "georgia",
              "germany",
              "greece",
              "hungary",
              "india",
              "indonesia",
              "ireland",
              "israel",
              "italy",
              "japan",
              "kenya",
              "lithuania",
              "malaysia",
              "malta",
              "morocco",
              "namibia",
              "nepal",
              "netherlands",
              "nigeria",
              "north-macedonia",
              "norway",
              "pakistan",
              "paraguay",
              "peru",
              "poland",
              "portugal",
              "romania",
              "russia",
              "saudi-arabia",
              "serbia",
              "slovenia",
              "south-africa",
              "spain",
              "switzerland",
              "taiwan",
              "thailand",
              "turkey",
              "uganda",
              "ukraine",
              "united-arab-emirates",
              "united-kingdom",
              "united-states",
              "uruguay",
              "vietnam"
            ],
            "type": "string",
            "description": "Filter the directory to developers based in this country. Leave blank to ignore. When both `country` and `specialty` are set, the browse listing is fetched by country and `specialty` is applied on top as a client-side filter.",
            "default": ""
          },
          "developerIdentifiers": {
            "title": "Developer slugs or URLs (mode=developerProfile)",
            "type": "array",
            "description": "Codeable developer slugs (e.g. `nishit-kumar`) or full profile URLs.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "minRating": {
            "title": "Min overall rating",
            "minimum": 1,
            "maximum": 5,
            "type": "number",
            "description": "Drop developers with an overall rating below this (1-5)."
          },
          "minCompletedProjects": {
            "title": "Min completed projects",
            "minimum": 0,
            "maximum": 100000,
            "type": "integer",
            "description": "Drop developers with fewer completed projects than this."
          },
          "language": {
            "title": "Spoken language",
            "enum": [
              "",
              "English",
              "Spanish",
              "French",
              "German",
              "Portuguese",
              "Italian",
              "Dutch",
              "Russian",
              "Ukrainian",
              "Polish",
              "Romanian",
              "Bulgarian",
              "Serbian",
              "Croatian",
              "Greek",
              "Turkish",
              "Arabic",
              "Hebrew",
              "Hindi",
              "Bengali",
              "Urdu",
              "Punjabi",
              "Gujarati",
              "Tamil",
              "Telugu",
              "Kannada",
              "Marathi",
              "Nepali",
              "Sinhala",
              "Indonesian",
              "Malay",
              "Vietnamese",
              "Thai",
              "Filipino",
              "Tagalog",
              "Chinese",
              "Mandarin",
              "Cantonese",
              "Japanese",
              "Korean",
              "Swahili",
              "Amharic",
              "Hausa",
              "Yoruba",
              "Zulu",
              "Afrikaans",
              "Czech",
              "Slovak",
              "Hungarian",
              "Finnish",
              "Swedish",
              "Norwegian",
              "Danish",
              "Macedonian",
              "Albanian",
              "Georgian",
              "Armenian",
              "Azerbaijani",
              "Persian"
            ],
            "type": "string",
            "description": "Only keep developers who list this language among the languages they speak.",
            "default": ""
          },
          "maxItems": {
            "title": "Max items",
            "minimum": 1,
            "maximum": 500,
            "type": "integer",
            "description": "Hard cap on emitted records.",
            "default": 20
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}