upload

DOCS/zonerama.md

@@ -0,0 +1,44 @@
+ZoneramaScraper API
+This service scrapes album and photo metadata from zonerama.com.
+
+GET /zonerama
+Scrape albums and photos from a Zonerama profile or album URL.
+
+Query parameters
+link (required): A Zonerama URL. Example: https://eu.zonerama.com/<Account>/<TabId> or a profile link.
+album_limit (optional): Integer to limit number of albums processed from a profile. Default: 5. 0 means no limit.
+photo_limit (optional): Integer to limit number of photos scraped per album. Default: 10. 0 means no limit.
+debug (optional): true|false. If true, saves fetched HTML files into debuging/ and serves them at /debuging/.
+Example
+/zonerama?link=https://eu.zonerama.com/SomeAccount/12345&album_limit=5&photo_limit=50
+
+Response
+{
+  "input_link": "...",
+  "albums": [
+    {
+      "id": "...",
+      "title": "...",
+      "url": "...",
+      "date": "...",
+      "photos_count": 42,
+      "photos": [
+        { "id": "...", "page_url": "...", "image_1500": "..." }
+      ]
+    }
+  ]
+}
+GET /zonerama-album
+Scrape a single album by URL (link must contain /Album/).
+
+Query parameters
+link (required): A Zonerama album URL. Example: https://eu.zonerama.com/<Account>/Album/<AlbumId>.
+photo_limit (optional): Integer to limit number of photos scraped from the album. Default: 10. 0 means no limit.
+rendered (optional): true|false. Default: true. Aliases: no-render=true or no_render=true to disable rendering.
+debug (optional): true|false. If true, saves fetched HTML files into debuging/ and serves them at /debuging/.
+Example
+/zonerama-album?link=https://eu.zonerama.com/Fcbizoni/Album/13878599&photo_limit=25
+
+Server listens on :7053. CORS is enabled allowing all origins (Access-Control-Allow-Origin: *).
+
+JS rendering is enabled by default (requires Chrome installed). When debug=true, fetched pages are saved beneath debuging/ and can be viewed at /debuging/.