Font recognition

Font recognition analyzes a public image URL, detects the largest readable word, and returns ranked open-source font matches. Use font recognition when you want to identify type from screenshots, logos, posters, packaging, and other flattened design references.

Request

Send a public http:// or https:// image URL to the font recognition endpoint. The image response must be an image file and no larger than 10 MB.

curl https://api.mixfont.com/v1/api/lens \
  -H "Content-Type: application/json" \
  -H "x-api-key: $MIXFONT_API_KEY" \
  -d '{
    "image_url": "https://images.example.com/wordmark.png",
    "top_k": 3
  }'

top_k is optional. It defaults to 3 and must be an integer from 1 to 10.

Response

The response includes the detected word, its bounding box, the analyzed image dimensions, ranked font matches, and a request id when available.

{
  "word": "Mixfont",
  "word_box": {
    "left": 140,
    "top": 96,
    "width": 412,
    "height": 104
  },
  "input_image": {
    "width": 1600,
    "height": 900,
    "image_url": "https://images.example.com/wordmark.png"
  },
  "font_matches": [
    {
      "name": "Inter",
      "score": 0.83,
      "fonts": [
        {
          "full_name": "Inter Regular",
          "style": "normal",
          "weight": 400,
          "url": "https://static.mixfont.com/fonts/inter/Inter-Regular.ttf"
        }
      ]
    }
  ],
  "requestId": "7d58a66d-f129-4f9a-bf9a-4f2c6d0c3e4d"
}