Zonerama Scraper (Go + Geziyor)

Blazing-fast JSON API to scrape Zonerama albums and photos using geziyor/geziyor.

Input: Zonerama profile/link page, e.g. https://eu.zonerama.com/Fcbizoni/1419417
Output: JSON listing albums and photos.
Photo links are normalized to https://eu.zonerama.com/photos/{photoID}_1500x1000.jpg.

Requirements

go get -u github.com/geziyor/geziyor

go run ./...

The server listens on http://localhost:8080.

See full endpoint reference in API.md.

rendered (bool, default: true) — Enable/disable JS rendering. Aliases: no-render=true or no_render=true to disable.
debug (bool, default: false) — If true, saves fetched HTML into debuging/ and serves at /debuging/.

Scrape albums and their photos starting from a Zonerama profile (account) or page URL.

Params:

link (required): A Zonerama URL (profile or album link)
album_limit (int, default: 5): Max albums to process from a profile (0 = no limit)
photo_limit (int, default: 10): Max photos per album (0 = no limit)
concurrency (int, default: 8): Max concurrent album fetches when rendering (capped by album_limit)

Example:

curl "http://localhost:8080/zonerama?link=https://eu.zonerama.com/Fcbizoni/1419417&album_limit=3&photo_limit=25" | jq .

Scrape a single album by URL (link must contain /Album/).

Params:

Example:

curl "http://localhost:8080/zonerama-album?link=https://eu.zonerama.com/SomeAccount/Album/13903610&photo_limit=25" | jq .

This scraper parses:
- Albums from the main/profile page by selecting li.list-alb and reading data-url or the nested anchor href.
- Photos from each album page via div.gallery-inner[data-type='photo'] and its data-id (photo ID).
For each photo ID, it builds https://{host}/photos/{id}_1500x1000.jpg.
If Zonerama changes their HTML structure, selectors may need to be updated.

Server starts at :8080. CORS is enabled.

For full details and response schemas, see API.md.

Be respectful of Zonerama's terms of service and rate limits. This project is for educational purposes.