Skip to content
Fotobots Partner Docs

Bib Number OCR Search

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:

Terminal window
curl -X POST https://sandbox-api.fotobots.run/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.fotobots.run/preview/photo_uuid_502.jpg",
      "matchedText": "10492",
      "confidence": 0.99
    }
  ],
  "total": 1
}