{"id":15016403,"url":"https://github.com/11ty/api-screenshot","last_synced_at":"2025-10-08T09:31:42.264Z","repository":{"id":37643439,"uuid":"387966444","full_name":"11ty/api-screenshot","owner":"11ty","description":"A service to add web page screenshots to your Eleventy sites.","archived":false,"fork":false,"pushed_at":"2024-08-03T18:01:24.000Z","size":49,"stargazers_count":111,"open_issues_count":12,"forks_count":39,"subscribers_count":7,"default_branch":"v1-vercel","last_synced_at":"2024-10-29T15:44:53.372Z","etag":null,"topics":["eleventy","eleventy-api"],"latest_commit_sha":null,"homepage":"https://v1.screenshot.11ty.dev","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/11ty.png","metadata":{"funding":{"open_collective":"11ty"},"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-07-21T02:13:11.000Z","updated_at":"2024-10-26T16:23:35.000Z","dependencies_parsed_at":"2024-11-06T15:07:31.761Z","dependency_job_id":"93fa0d41-eb60-41b1-a4b5-12bd15cf5a7a","html_url":"https://github.com/11ty/api-screenshot","commit_stats":{"total_commits":103,"total_committers":3,"mean_commits":"34.333333333333336","dds":0.09708737864077666,"last_synced_commit":"954efb69a502a9880095f183f7e1d07a21dc37f5"},"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/11ty%2Fapi-screenshot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/11ty%2Fapi-screenshot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/11ty%2Fapi-screenshot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/11ty%2Fapi-screenshot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/11ty","download_url":"https://codeload.github.com/11ty/api-screenshot/tar.gz/refs/heads/v1-vercel","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":235378181,"owners_count":18980392,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["eleventy","eleventy-api"],"created_at":"2024-09-24T19:48:50.016Z","updated_at":"2025-10-08T09:31:36.988Z","avatar_url":"https://github.com/11ty.png","language":"JavaScript","funding_links":["https://opencollective.com/11ty"],"categories":["JavaScript"],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\u003cimg src=\"https://www.11ty.dev/img/logo-github.svg\" width=\"200\" height=\"200\" alt=\"11ty Logo\"\u003e\u003c/p\u003e\n\n# Screenshot API\n\nA runtime service to use live website screenshots on your site.\n\nRead the [Blog post: Building an Automated Screenshot Service on Netlify in ~140 Lines of Code](https://www.zachleat.com/web/screenshots/).\n\n## Usage\n\nImage URLs have the formats:\n\n```\n/:url/\n/:url/:size/\n/:url/:size/:aspectratio/\n/:url/:size/:aspectratio/:zoom/\n```\n\n* `url` must be URI encoded.\n* Valid `size` values:\n  * `small`: 375×___ (default)\n  * `medium`: 650×___\n  * `large`: 1024×___\n    * `aspectratio` of `9:16` is not supported (throws an error)\n  * `opengraph`: always 1200×630, works with `zoom`\n    * `aspectratio` is ignored (no errors thrown)\n* Valid `aspectratio` values:\n  * `1:1` (default)\n  * `9:16`\n* Valid `zoom` values:\n  * `bigger` (1.4 `devicePixelRatio`)\n  * `smaller` (0.71 `devicePixelRatio`)\n\n### Advanced Options\n\n#### Custom Wait Conditions\n\nYou can customize the conditions with which the headless browser will wait to take the screenshot. At a low level, this controls the [`waitUntil` property in Puppeteer’s `goto` call](https://pptr.dev/#?product=Puppeteer\u0026version=v13.3.1\u0026show=api-pagegotourl-options). The options are:\n\n* DOMContentLoaded `wait:0`\n* Load event `wait:1` (default)\n* Load event and there have been no network connections for 500ms: `wait:2`\n* Load event and there are fewer than two network connections for 500ms: `wait:3`\n\n```\n/:url/_wait:0/\n/:url/_wait:1/\n/:url/_wait:2/\n/:url/_wait:3/\n```\n\n#### Custom Timeout\n\nNumber of seconds to wait before the request times out. We will attempt to simulate the stop button and return the screenshot that exists up to that point. Worst case, a default Eleventy logo is returned.\n\n* Minimum: `3`\n* Maximum: `9`\n\n```\n/:url/_timeout:3/\n/:url/_timeout:9/\n```\n\n#### Combine these options\n\nYou can use any of these advanced options together, like `/:url/_wait:0_timeout:2/`. Order only matters to the uniqueness of the URL caching on the CDN: `/:url/_wait:0/` and `/:url/_wait:0/` will be functionally equivalent but make two different screenshot requests.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F11ty%2Fapi-screenshot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2F11ty%2Fapi-screenshot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F11ty%2Fapi-screenshot/lists"}