Print Publishing

Overview

The Puzzle Section API supports print publishing workflows with:

• ✓High-resolution PDF and SVG export
• ✓Customisable layouts and typography
• ✓Bulk generation for syndication
• ✓Solution pages with date coordination

PDF Export

Generate print-ready PDFs with customisable dimensions and styling:

1curl -X POST "https://api.puzzlesection.app/api/v1/print/puzzles/batch" \
2  -H "X-API-Key: ps_live_xxxxxxxxxxxx" \
3  -H "Content-Type: application/json" \
4  -d '{
5    "puzzleId": "pzl_sudoku_2026-01-09_medium",
6    "format": {
7      "width": 100,
8      "height": 100,
9      "unit": "mm",
10      "margin": 10
11    },
12    "style": {
13      "fontFamily": "Georgia",
14      "gridLineWidth": 0.5,
15      "boldLineWidth": 1.5,
16      "fontSize": 14
17    },
18    "include": {
19      "title": true,
20      "date": true,
21      "difficulty": true,
22      "copyright": "© 2026 Your Publication"
23    }
24  }' \
25  --output puzzle.pdf

Format Options

Bulk Generation

Generate a week or month of puzzles in a single request for syndication:

1curl -X POST "https://api.puzzlesection.app/api/v1/print/puzzles/batch" \
2  -H "X-API-Key: ps_live_xxxxxxxxxxxx" \
3  -H "Content-Type: application/json" \
4  -d '{
5    "type": "sudoku",
6    "difficulty": "medium",
7    "from": "2026-01-06",
8    "to": "2026-01-12",
9    "format": "pdf",
10    "includeSolutions": true,
11    "solutionDelay": 1
12  }' \
13  --output puzzles-week.zip

The response is a ZIP archive containing individual puzzle PDFs and a solutions PDF. The solutionDelay parameter specifies how many days after a puzzle appears that its solution should be dated (typically 1 for daily papers).

SVG Export

For custom layouts or integration with design software, export as SVG:

curl -X GET "https://api.puzzlesection.app/api/v1/print/puzzles/puzzle-uuid" \
  -H "X-API-Key: ps_live_xxxxxxxxxxxx" \
  --output puzzle.svg

SVG exports are vector-based and can be scaled to any size without quality loss. They can be opened directly in Adobe Illustrator, InDesign, or other publishing software.

Structured Data

If you have your own layout system, fetch puzzle data and render it yourself:

1{
2  "type": "sudoku",
3  "difficulty": "medium",
4  "date": "2026-01-09",
5  "grid": [
6    [0, 0, 3, 0, 2, 0, 6, 0, 0],
7    [9, 0, 0, 3, 0, 5, 0, 0, 1],
8    ...
9  ],
10  "solution": [...],
11  "metadata": {
12    "title": "Daily Sudoku #1234",
13    "copyright": "© 2026 The Puzzle Section"
14  }
15}

Use the grid data with your own templates for complete control over the final appearance.

Syndication Workflow

Recommended workflow for newspaper syndication:

1. 1Schedule generation — Set up a weekly cron job to generate next week's puzzles every Friday
2. 2Review puzzles — Quality check the generated puzzles before distribution
3. 3Distribute files — Send PDFs to subscribing publications via FTP, email, or your CMS
4. 4Coordinate solutions — Solutions are dated one day after puzzles for next-day publication