LogoGrab API

How to integrate the highest quality and most scalable logo detection technology.

Brand Detection API

  • Detect logos in images and videos.
  • Bring your own data. Analyse any image or video.
  • Scale rapidly across any volume of images, videos and brands.
  • Fast integration. Start detecting brands quickly, and activate new logos in minutes.
  • LogoGrab API Brand Insights Illustration

    POSTRequest

    An example of using the LogoGrab API with a POST request is shown below.

    Result: JSON Object

    The logo detection response (below) consists of a JSON Array called “detections” within the “data” section of the response. Each entry of the array is a JSON Object corresponding to a logo found in the query image. The “coordinates" field contains four x-y pairs representing the corners of the quadrilateral that encloses the detection, sorted in clockwise order from the top-left corner of the logo.

      1
      2
      3
      4
      5
      6
      7
      8
      9
      10
      11
      12
      13
      14
      15
      16
      17
      18
      19
      20
      21
      22
      23
      24
      25
      26
      27
      28
      29
      30
      31
      32
      33
      34
      35
      36
      37
      38
      39
      40
      41
      42
      43
      44
      45
      46
      47
      48
      49
      50
      51
      52
      53
      54
      55
      56
      57
      58
      59
      60
      61
      62
      63
      64
      65
      66
      67
      68
      69
      70
      71
      72
      73
      74
      75
      76
      77
      78
      79
      80
      81
      82
      83
      84
      85
      86
      87
      88
      89
      90
      91
      92
      93
      94
      95
      96
      97
      98
      99
      100
      101
      102
      103
      104
      105
      106
      107
      108
      109
      110
       {
       "dataRootName": "data",
       "data": {
        "sessionId": "cf9d7b8c088176b142f51ec08cc35888315db32a",
        "detections": [
         {
          "area": 4650.62,
          "validationFlags": [
           0.96
          ],
          "validated": 1,
          "size": "tiny",
          "confidence": 502.42,
          "areaPercentage": 0.0039,
          "coordinates": [
            969.38,
            380.5,
            1036.74,
            386.63,
            1031.21,
            456.08,
            964.05,
            448.22
          ],
          "name": "Ritz",
          "iconUrl": "https://s3-eu-west-1.amazonaws.com/s3.logograb.com/logograb/cache-dir-public/54aef37a19ae0b4151a9ac8e31bc4b92d230ecd4.png",
          "id": 1943,
          "confidencePercentage": 1,
          "confidenceALE": null
         },
         {
          "area": 11544.8,
          "validationFlags": [
           1
          ],
          "validated": 1,
          "size": "tiny",
          "confidence": 494.36,
          "areaPercentage": 0.0096,
          "coordinates": [
            522.67,
            552.45,
            697.33,
            556.06,
            695.12,
            621.56,
            520.41,
            619.05
          ],
          "name": "Oreo",
          "iconUrl": "https://s3-eu-west-1.amazonaws.com/s3.logograb.com/logograb/cache-dir-public/fec98f8dd74c499cc85fdd971410ebfc9b4af17a.png",
          "id": 1597,
          "confidencePercentage": 0.85,
          "confidenceALE": 1
         },
         {
          "area": 7281.66,
          "validationFlags": [
           0.99
          ],
          "validated": 1,
          "size": "tiny",
          "confidence": 105.36,
          "areaPercentage": 0.0061,
          "coordinates": [
            1315.52,
            400.12,
            1390.57,
            404.17,
            1377.25,
            501.4,
            1302.8,
            496.08
          ],
          "name": "Pringles",
          "iconUrl": "https://s3-eu-west-1.amazonaws.com/s3.logograb.com/logograb/cache-dir-public/1da26293043f8e48a46ddf3b22feb7426e35f156.png",
          "id": 1828,
          "confidencePercentage": 0.16,
          "confidenceALE": 1
         },
         {
          "area": 4506.28,
          "validationFlags": [
            0.99
          ],
          "validated": 1,
          "size": "tiny",
          "confidence": 46.24,
          "areaPercentage": 0.0038,
          "coordinates": [
            979.87,
            109.52,
            1031.29,
            137.03,
            993.56,
            204.58,
            942.19,
            176.62
          ],
          "name": "Pringles",
          "iconUrl": "https://s3-eu-west-1.amazonaws.com/s3.logograb.com/logograb/cache-dir-public/1da26293043f8e48a46ddf3b22feb7426e35f156.png",
          "id": 1828,
          "confidencePercentage": 0.14,
          "confidenceALE": 1
         }
        ],
        "status": 200
       },
       "requestUrl": "http://www.logograb.com/api/v2/detect.json"
       }

    Result: Highlighted Image

    Sample output showing logo detections in a brand photo

    Mobile Engagement API

  • Integrate LogoGrab Mobile Engagement in your mobile website.
  • No app required. Built entirely on mobile web so it works on any smartphone or tablet.
  • 100% customizable look and content.
  • Lightweight and reliable on any network, even in 2G conditions.
  • LogoGrab mobile engagement illustration

    HTML Template: jQuery

    Below is a template implementation of LogoGrab Mobile. This will show you how to include the LogoGrab Mobile functionality under your domain. It uses the LogoGrab jQuery plugin to process images acquired from the client device camera. The use of code is subject to the contract agreement between your organization and LogoGrab.

    Download HTML Template

      1
      2
      3
      4
      5
      6
      7
      8
      9
      10
      11
      12
      13
      14
      15
      16
      17
      18
      19
      20
      21
      22
      23
      24
      25
      26
      27
      28
      29
      30
      31
      32
      33
      34
      35
      36
      37
      38
      39
      40
      <!DOCTYPE html>
      <html>
      <head><title>LogoGrab WebScanner</title></head>
      <body>
      <script src="https://ajax.googleapis.com/ajax/libs/jquery/1.11.1/jquery.min.js">
      </script>
      <script src="https://www.logograb.com/webscanners/js/jquery-logograb.webscanner.min.js">
      </script>
    
      <div class="wrapper">
      <div id="stage_grab">
      <div id="logoGrabWebScannerButton">
      <button>Tap to grab</button>
      </div>
      </div>
      <br/><br/>
      <div id="stage_result">
      </div>
      </div>
      <script>
      $('#logoGrabWebScannerButton').logoGrabWebScanner({
       developerKey: 'YOUR-LOGOGRAB-DEVELOPER-KEY',
       onInputImage: function(imageData) {
        // Callback invoked after the image has been uploaded to the device
       },
       onStart: function() {
        // Callback invoked before the image is uploaded to the server
       },
       onEnd: function(response) {
        // Callback invoked when the response JSON is returned
        if (!response.logoName)
         $('#stage_result').html("No result");
        else
         $('#stage_result').html(response.logoName);
       }
      });
      </script>
      </body>
      </html>
                  

    Result: JSON Object

    The logo detection response (below) consists of a JSON Array called “detections” within the “data” section of the response. Each entry of the array is a JSON Object corresponding to a logo found in the query image. The “coordinates" field contains four x-y pairs representing the corners of the quadrilateral that encloses the detection, sorted in clockwise order from the top-left corner of the logo. Additionally, the best detection is also put directly within the "data" section for easier access.

      1
      2
      3
      4
      5
      6
      7
      8
      9
      10
      11
      12
      13
      14
      15
      16
      17
      18
      19
      20
      21
      22
      23
      24
      25
      26
      27
      28
      29
      30
      31
      32
      33
      34
      35
      36
      37
      38
      39
      40
      41
      42
      43
      44
      45
      46
      47
      48
      49
      50
      51
      52
      53
      54
      55
      56
      57
      58
      59
      60
      61
      62
      {
       "logoName": "Desperados",
       "icoUrl": "https://s3-eu-west-1.amazonaws.com/s3.logograb.com/logograb/cache-dir-public/39c3a511ae6e574ba7bd07341494ef11658f92c8.png",
       "sessionId": "a2d6de5e2431dcd5db9e520ad584b69aff1aecea",
       "detections": [
        {
         "area": 6376.73,
         "validationFlags": [
           0.11
         ],
         "validated": 1,
         "size": "tiny",
         "confidence": 51.84,
         "areaPercentage": 0.0053,
         "coordinates": [
           1115.45,
           128.34,
           1248.65,
           138.89,
           1243.15,
           184.69,
           1104.3,
           175.05
         ],
         "name": "Desperados",
         "iconUrl": "https://s3-eu-west-1.amazonaws.com/s3.logograb.com/logograb/cache-dir-public/d1c6650fd463d1b731cb2e3a487d66d6885bfda5.png",
         "id": 3501,
         "confidencePercentage": 0.63,
         "confidenceALE": null
        },
        {
         "area": 22806.39,
         "validationFlags": [
           0.74
         ],
         "validated": 1,
         "size": "small",
         "confidence": 542.44,
         "areaPercentage": 0.019,
         "coordinates": [
           1036.83,
           367.5,
           1238.08,
           395.8,
           1220.69,
           505.8,
           1018.78,
           478.94
         ],
         "name": "Desperados",
         "iconUrl": "https://s3-eu-west-1.amazonaws.com/s3.logograb.com/logograb/cache-dir-public/39c3a511ae6e574ba7bd07341494ef11658f92c8.png",
         "id": 3501,
         "confidencePercentage": 0.31,
         "confidenceALE": null
        }
       ],
       "status": 200
      }

    Result: Highlighted Image

    Sample output showing logo detections in a product photo