Step-by-step guides, with curl and Python examples ready to copy, for the most common integrations with the Grand Shooting API.
The Grand Shooting cookbooks are published on GitHub: github.com/grandshooting/gs-cookbooks. Each one walks through a complete use case, step by step, with the curl commands and a Python script (requests library) to adapt.
You need an API key (see Getting started with the API) and, depending on the cookbook, the ids of the Production or the account concerned.
| Cookbook | What it shows |
|---|---|
| Create a Production and upload images | Create a Production, find its steps, upload files or have them fetched by URL, link them to References and View codes. |
| Upload images to an existing Production | Find a Production and the target step, organize the files in folders, link a retouched image to the original, handle errors. |
| Reference management | Create and update References, import them in bulk, filter them, link them to a Production or a shotlist. |
| Cookbook | What it shows |
|---|---|
| Retrieve pictures with filters | Filter by date, status or export, paginate beyond 10,000 results, download the files, export the list as CSV. |
| Retrieve the validated pictures of a Connect account | Target a Connect account, tell approved (50) from published (55) media, filter by export, synchronize incrementally. |
To go faster, give your coding agent (Claude Code, Cursor…) the cookbook that matches your need and the API specification (swagger.json): it will adapt the examples to your system.
For continuous synchronization, combine these examples with webhooks: the initial load is done with the cookbook, then the updates arrive by webhook.
