Skip to main content
POST
/
v1
/
api
/
lens
Lens
curl --request POST \
  --url https://api.mixfont.com/v1/api/lens \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "image_url": "https://images.example.com/wordmark.png"
}
'
{
  "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"
        },
        {
          "full_name": "Inter Italic",
          "style": "italic",
          "weight": 400,
          "url": "https://static.mixfont.com/fonts/inter/Inter-Italic.ttf"
        }
      ]
    },
    {
      "name": "Public Sans",
      "score": 0.11,
      "fonts": [
        {
          "full_name": "Public Sans Regular",
          "style": "normal",
          "weight": 400,
          "url": "https://static.mixfont.com/fonts/public-sans/PublicSans-Regular.ttf"
        }
      ]
    }
  ],
  "creditsRemaining": 124,
  "requestId": "7d58a66d-f129-4f9a-bf9a-4f2c6d0c3e4d"
}
Lens example image

Authorizations

x-api-key
string
header
required

Body

application/json
image_url
string<uri>
required

Public http:// or https:// image URL to analyze.

Response

Successful response

word
string | null

Largest detected word in the image. This can be null if no confident word is found.

word_box
object

Location of the detected word in the original image. This can be null if detection falls back to the full image.

input_image
object
font_matches
object[]

Ranked font matches, sorted best first.

creditsRemaining
integer

How many API credits remain after the request.

requestId
string

Request identifier to share with support.