{
  "openapi": "3.0.1",
  "info": {
    "title": "Behance Scraper - Projects, Creators & Designer Leads",
    "description": "Scrape Behance projects, creators and creative jobs: portfolios, views/appreciations, tools, tags, plus designer leads with availability-for-hire, budget, social links, location and contact enrichment. Keyless, no browser, with a new-content monitor.",
    "version": "0.1",
    "x-build-id": "l7GwYeswW7CqH9X0r"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/scrapesage~behance-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-scrapesage-behance-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/scrapesage~behance-scraper/runs": {
      "post": {
        "operationId": "runs-sync-scrapesage-behance-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/scrapesage~behance-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-scrapesage-behance-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",
        "properties": {
          "searchQueries": {
            "title": "Search queries",
            "type": "array",
            "description": "Free-text searches run against Behance for each selected content type (e.g. \"logo\", \"mobile app\", \"3d character\"). Each query returns the first server-rendered page (up to 24 results). Combine with creative fields, sort and location for breadth.",
            "items": {
              "type": "string"
            }
          },
          "contentTypes": {
            "title": "Content types",
            "type": "array",
            "description": "What to scrape: design Projects, Creators (designer profiles = leads), and/or creative Jobs. Searches, fields and filters apply to each selected type.",
            "items": {
              "type": "string",
              "enum": [
                "projects",
                "creators",
                "jobs"
              ],
              "enumTitles": [
                "Projects",
                "Creators (leads)",
                "Jobs"
              ]
            },
            "default": [
              "projects"
            ]
          },
          "creativeFields": {
            "title": "Creative fields",
            "type": "array",
            "description": "Limit results to one or more Behance creative fields (e.g. UI/UX, Branding, Illustration, Motion Graphics, Web Design, Photography). Each field is combined with each search query.",
            "items": {
              "type": "string"
            }
          },
          "tools": {
            "title": "Tools (projects)",
            "type": "array",
            "description": "Filter projects by the software/tool used, e.g. Figma, Photoshop, Illustrator, Blender, After Effects.",
            "items": {
              "type": "string"
            }
          },
          "sort": {
            "title": "Sort order",
            "enum": [
              "recommended",
              "most_appreciated",
              "most_viewed",
              "most_recent",
              "most_commented"
            ],
            "type": "string",
            "description": "Sort order for searches. Different sorts surface different results, widening coverage.",
            "default": "recommended"
          },
          "timeframe": {
            "title": "Timeframe (projects)",
            "enum": [
              "all",
              "today",
              "week",
              "month"
            ],
            "type": "string",
            "description": "Restrict projects to a recency window.",
            "default": "all"
          },
          "country": {
            "title": "Country (creators & jobs)",
            "type": "string",
            "description": "Two-letter ISO country code to target creators/jobs by location, e.g. US, GB, DE, FR, IN, BR."
          },
          "state": {
            "title": "State / region (creators)",
            "type": "string",
            "description": "State or region to target creators by location (used with country)."
          },
          "city": {
            "title": "City (creators & jobs)",
            "type": "string",
            "description": "City to target creators/jobs by location, e.g. Berlin, London, New York."
          },
          "availableForFreelance": {
            "title": "Available for freelance (creators)",
            "type": "boolean",
            "description": "Only return creators who flag themselves as available for freelance work.",
            "default": false
          },
          "availableForFullTime": {
            "title": "Available for full-time (creators)",
            "type": "boolean",
            "description": "Only return creators who flag themselves as available for full-time work.",
            "default": false
          },
          "jobTypes": {
            "title": "Job types (jobs)",
            "type": "array",
            "description": "Filter jobs by type. Behance uses Freelance, Full-time and Contract.",
            "items": {
              "type": "string",
              "enum": [
                "FREELANCE",
                "FULLTIME",
                "CONTRACT"
              ],
              "enumTitles": [
                "Freelance",
                "Full-time",
                "Contract"
              ]
            }
          },
          "remoteOnly": {
            "title": "Remote jobs only",
            "type": "boolean",
            "description": "Only return jobs flagged as remote.",
            "default": false
          },
          "minFollowers": {
            "title": "Minimum followers (creators)",
            "minimum": 0,
            "type": "integer",
            "description": "Only keep creators with at least this many followers. 0 = no filter.",
            "default": 0
          },
          "minAppreciations": {
            "title": "Minimum appreciations",
            "minimum": 0,
            "type": "integer",
            "description": "Only keep creators/projects with at least this many appreciations (likes). 0 = no filter.",
            "default": 0
          },
          "minViews": {
            "title": "Minimum views",
            "minimum": 0,
            "type": "integer",
            "description": "Only keep creators/projects with at least this many views. 0 = no filter.",
            "default": 0
          },
          "availableForHireOnly": {
            "title": "Available-for-hire creators only",
            "type": "boolean",
            "description": "Drop creators who are not open to freelance or full-time work — keep only contactable, in-market leads.",
            "default": false
          },
          "withContactOnly": {
            "title": "Creators with contact only",
            "type": "boolean",
            "description": "Only keep creator leads that have at least one of: website, social link, or enriched email.",
            "default": false
          },
          "profileUrls": {
            "title": "Profile URLs / usernames",
            "type": "array",
            "description": "Direct Behance profiles to pull as full creator leads, e.g. https://www.behance.net/uxpolly or just \"uxpolly\".",
            "items": {
              "type": "string"
            }
          },
          "projectUrls": {
            "title": "Project URLs / ids",
            "type": "array",
            "description": "Direct Behance project (gallery) pages or numeric ids, e.g. https://www.behance.net/gallery/243538069/My-Project or 243538069.",
            "items": {
              "type": "string"
            }
          },
          "startUrls": {
            "title": "Start URLs (mixed)",
            "type": "array",
            "description": "Optional mixed list of behance.net URLs — profiles, gallery projects, or /search and /joblist result pages. Each is auto-classified.",
            "items": {
              "type": "string"
            }
          },
          "includeProjectDetails": {
            "title": "Include project details",
            "type": "boolean",
            "description": "Open each project's gallery page for the rich record — description, tags, tools used, creative fields, module/image counts and full owner list. Turn OFF for a fast, cheap listing-only crawl.",
            "default": true
          },
          "includeCreatorProfiles": {
            "title": "Include full creator profiles",
            "type": "boolean",
            "description": "Open each creator's profile for the full lead — occupation, company, website, web links, work history and complete availability/budget. For projects, resolves the primary owner into a creator lead attached to the project. Turn OFF for speed.",
            "default": true
          },
          "enrichContactEmails": {
            "title": "Enrich contact emails (lead wedge)",
            "type": "boolean",
            "description": "Crawl each creator's own website (home + /contact + /about) for a contact email and extra socials. Behance rarely exposes emails directly, so this is the way to get them.",
            "default": false
          },
          "emitProjectOwners": {
            "title": "Also emit project owners as creator leads",
            "type": "boolean",
            "description": "When scraping projects, also output a separate creator-lead record for each project's owner (deduplicated), not just the summary attached to the project.",
            "default": false
          },
          "maxItems": {
            "title": "Max items",
            "minimum": 1,
            "type": "integer",
            "description": "Global cap on the total number of records (projects + creators + jobs) scraped across all searches and inputs.",
            "default": 200
          },
          "maxItemsPerQuery": {
            "title": "Max items per search",
            "minimum": 1,
            "maximum": 24,
            "type": "integer",
            "description": "Cap on records pulled from each individual search (Behance serves up to 24 per page).",
            "default": 24
          },
          "deduplicateCreators": {
            "title": "Deduplicate creators",
            "type": "boolean",
            "description": "Emit each creator only once per run even if they appear across multiple searches or projects.",
            "default": true
          },
          "monitorMode": {
            "title": "Monitor mode (only new content)",
            "type": "boolean",
            "description": "Remember project/creator/job ids returned in previous runs (in a named key-value store) and emit only NEW ones next time. Pair with an Apify Schedule to watch a field, a search, or a location for fresh portfolios, creators or jobs. The schedule decides WHEN to run; monitor mode decides WHAT is new.",
            "default": false
          },
          "monitorStoreName": {
            "title": "Monitor store name",
            "type": "string",
            "description": "Name of the key-value store that holds the monitor's memory. Use different names to track different watches independently. Lowercase letters, digits and hyphens only.",
            "default": "behance-monitor"
          },
          "maxConcurrency": {
            "title": "Max concurrency",
            "minimum": 1,
            "maximum": 20,
            "type": "integer",
            "description": "How many requests to run in parallel.",
            "default": 6
          },
          "proxyConfiguration": {
            "title": "Proxy configuration",
            "type": "object",
            "description": "Proxy settings. Apify Proxy (default datacenter) is recommended and works well — a fresh session is rotated per attempt to shrug off the occasional 403. Switch to residential if you see persistent blocks.",
            "default": {
              "useApifyProxy": true,
              "apifyProxyGroups": [
                "RESIDENTIAL"
              ],
              "apifyProxyCountry": "US"
            }
          },
          "urlsFromFile": {
            "title": "Import URLs from a file",
            "type": "string",
            "description": "Paste a list of URLs (one per line), OR one link to a .txt/.csv file, Google Sheet or Google Drive file containing them. Lets you import many Start URLs at once instead of typing each. Google Sheet/Drive share links are handled automatically."
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}