Developer preview

PicPickerHQ API Documentation

Use the PicPickerHQ API to submit image batches, retrieve scoring results, and organize visual curation workflows.

Authentication

Authenticate API requests with a workspace token. Production API keys can be connected when backend services are enabled.

Image batch submission

Submit a project name, collection label, and image batch metadata so PicPickerHQ can organize analysis results by workflow.

Image scoring response

Responses include practical scoring signals for clarity, lighting, composition, subject focus, and predicted click appeal.

Project status

Track project progress, monthly analysis usage, and completed recommendation summaries for each image batch.

Example response

{
  "project": "Spring Campaign",
  "bestPick": "mountain-landscape.jpg",
  "score": 94,
  "signals": {
    "clarity": "strong",
    "lighting": "balanced",
    "composition": "clean",
    "clickAppeal": "high"
  }
}