Bib Number OCR Search

The .fotobots.dev addresses on this page are staging examples. Use the URL and API key for your own environment.

In addition to facial recognition, Fotobots automatically extracts runner bib numbers using optical character recognition (OCR).

---

Search by Bib Number

Query photos by race number via POST /openapi/photos/search/text/list:

curl -X POST https://api.fotobots.dev/openapi/photos/search/text/list \
  -H "Content-Type: application/json" \
  -H "x-api-key: fb_test_YOUR_KEY" \
  -d '{
    "albumId": "d3b07384-d113-4a37-b4d6-f3ec0a4b7f8c",
    "text": "10492"
  }'

Response

{
  "photos": [
    {
      "id": "photo_uuid_502",
      "url": "https://cdn.example.com/preview/photo_uuid_502.jpg",
      "matchedText": "10492",
      "confidence": 0.99
    }
  ],
  "total": 1
}