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 1.22+

Install deps

go get -u github.com/geziyor/geziyor

Run the server

go run ./...

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

API

See full endpoint reference in API.md.

Endpoints

• /zonerama
• /zonerama-album

Common query parameters

• 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/.

/zonerama

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 .

/zonerama-album

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

Params:

• link (required): https://eu.zonerama.com/<Account>/Album/<AlbumId>
• photo_limit (int, default: 10): Max photos from the album (0 = no limit)

Example:

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

Notes

• 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.

Disclaimer

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