Skip to main content

​
Overview

The Memories endpoints cover everything you need to render a participant’s gallery of photos and videos, run searches, generate personalised video clips, and produce presigned download links. All endpoints are event-scoped and require an X-API-Key header — see Conventions for the shared response envelope and identifier rules. The endpoints surface four 9Pic AI products through the API:
ProductWhat it doesEndpoint
9Pic BibTrackMarathon BIB number recognition.BIB Search
9Pic FaceFindAI face recognition photo search.Face Search
9Pic MotionSelfie + BIB-driven video clipping.Video Clipping Search
9Pic StampWatermarked previews; originals are unwatermarked on download.All Photos, Download Originals

​
Endpoints

All Photos

GET /event/{event_id}/images — full paginated photo gallery for an event, ordered by capture timestamp.

BIB Search

GET /event/{event_id}/bibs/{bib} — photos tagged with a participant’s BIB number, powered by 9Pic BibTrack.

Face Search

POST /event/{event_id}/faces — upload a selfie and get matching photos via 9Pic FaceFind. Reuse the returned request_id for cached pagination and downloads.

Photo Timeline

GET /event/{event_id}/timeline/days and GET /event/{event_id}/timeline/images — browse photos by capture time with day/hour buckets and windowed pagination.

Video Clipping Search

POST /event/{event_id}/video-clipping/search-by-selfie — async 9Pic Motion pipeline that returns short MP4 clips of moments where the participant appears.

Download Originals

POST /event/{event_id}/original-photos — presigned URLs for unwatermarked originals, keyed by BIB or selfie request_id.
  1. Confirm the event has the right discovery features enabled with Event Details.
  2. Render the gallery with All Photos.
  3. Offer BIB Search (9Pic BibTrack) for runners who know their bib, and Face Search (9Pic FaceFind) for selfie-based discovery.
  4. Optionally start Video Clipping Search (9Pic Motion) using the same request_id returned by Face Search to power photo and video discovery from a single selfie upload.
  5. When the participant is ready to download, hand the request_id (with method: "selfie") or BIB number (with method: "bib") to Download Originals.