{
  "openapi": "3.0.1",
  "info": {
    "title": "Awwwards Scraper",
    "description": "[💰 $2.50 / 1K] Extract award-winning websites from Awwwards. Filter by award, category, technology, tag, and country: get site title, live URL, thumbnail, score, tags, tech stack, colors, and agency/designer credits. Clean JSON/CSV/Excel for design research.",
    "version": "1.0",
    "x-build-id": "58zEFiLY9ZNnpgQWw"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/solidcode~awwwards-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-solidcode-awwwards-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/solidcode~awwwards-scraper/runs": {
      "post": {
        "operationId": "runs-sync-solidcode-awwwards-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/solidcode~awwwards-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-solidcode-awwwards-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": {
          "startUrls": {
            "title": "Awwwards URLs",
            "type": "array",
            "description": "Paste one or more Awwwards URLs — gallery/collection pages (e.g. https://www.awwwards.com/websites/animation/) or individual site pages (e.g. https://www.awwwards.com/sites/example). The scraper reads every filter straight from each gallery URL, so the Search Filters below are ignored for these. Use this when you already built a search on the site.",
            "items": {
              "type": "string"
            }
          },
          "award": {
            "title": "Award / Recognition",
            "enum": [
              "all",
              "sotd",
              "sotm",
              "developer",
              "honorable",
              "nominees"
            ],
            "type": "string",
            "description": "Which recognition level to browse: Sites of the Day, Sites of the Month, Developer Award, Honorable Mentions, Nominees, or all sites. Only applies when you build a search below (not when pasting URLs)."
          },
          "categories": {
            "title": "Categories",
            "uniqueItems": true,
            "type": "array",
            "description": "Filter by industry / site category. Leave empty to include all categories. Each category is searched separately.",
            "items": {
              "type": "string",
              "enum": [
                "architecture",
                "art-illustration",
                "business-corporate",
                "culture-education",
                "design-agencies",
                "e-commerce",
                "events",
                "fashion",
                "film-tv",
                "food-drink",
                "games-entertainment",
                "hotel-restaurant",
                "institutions",
                "interaction-design",
                "magazine-newspaper-blog",
                "mobile-apps",
                "music-sound",
                "photo-video",
                "photography",
                "portfolio",
                "promotional",
                "real-estate",
                "social-responsibility",
                "sports",
                "startups",
                "technology",
                "typography",
                "illustration"
              ],
              "enumTitles": [
                "Architecture",
                "Art & Illustration",
                "Business / Corporate",
                "Culture & Education",
                "Design Agencies",
                "E-Commerce",
                "Events",
                "Fashion",
                "Film & TV",
                "Food & Drink",
                "Games & Entertainment",
                "Hotel & Restaurant",
                "Institutions",
                "Interaction Design",
                "Magazine / Newspaper / Blog",
                "Mobile & Apps",
                "Music & Sound",
                "Photo & Video",
                "Photography",
                "Portfolio",
                "Promotional",
                "Real Estate",
                "Social Responsibility",
                "Sports",
                "Startups",
                "Technology",
                "Typography",
                "Illustration"
              ]
            }
          },
          "technologies": {
            "title": "Technologies",
            "uniqueItems": true,
            "type": "array",
            "description": "Filter by the tech stack used to build the site (e.g. React, Next.js, WebGL, Three.js, GSAP, Webflow). Leave empty to include all technologies. Each technology is searched separately.",
            "items": {
              "type": "string",
              "enum": [
                "react",
                "next-js",
                "vue-js",
                "nuxt-js",
                "angularjs",
                "svelte",
                "webgl",
                "three-js",
                "gsap",
                "lottie",
                "framer",
                "webflow",
                "wordpress",
                "shopify",
                "figma",
                "typescript",
                "tailwind",
                "vercel",
                "astro",
                "gatsby"
              ],
              "enumTitles": [
                "React",
                "Next.js",
                "Vue.js",
                "Nuxt",
                "Angular",
                "Svelte",
                "WebGL",
                "Three.js",
                "GSAP",
                "Lottie",
                "Framer",
                "Webflow",
                "WordPress",
                "Shopify",
                "Figma",
                "TypeScript",
                "Tailwind",
                "Vercel",
                "Astro",
                "Gatsby"
              ]
            }
          },
          "tags": {
            "title": "Tags",
            "type": "array",
            "description": "Filter by style/type tags such as 'animation', '3d', 'scrolling', 'typography', 'dark', 'minimal', 'illustration'. Enter tag slugs as they appear on the site. Leave empty to skip tag filtering.",
            "items": {
              "type": "string"
            }
          },
          "country": {
            "title": "Country",
            "type": "string",
            "description": "Filter to sites from a single country of origin, e.g. 'United States', 'France', 'Japan'. Leave empty to include all countries."
          },
          "scrapeDetails": {
            "title": "Scrape Full Details",
            "type": "boolean",
            "description": "Follow each site to its Awwwards page to collect full data: full description, scores, award badges, the complete tag and technology list, colors, and agency/designer credits. Turn off for a faster, lighter run that returns only the summary fields shown in the gallery.",
            "default": true
          },
          "maxResults": {
            "title": "Max Results",
            "minimum": 0,
            "type": "integer",
            "description": "Maximum number of sites to collect across all URLs and searches. Set to 0 for as many as possible (up to a built-in safety cap of 10,000). Tip: start with 10-50 to test, then increase.",
            "default": 100
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}