LogoSignature Detection API

API Documentation

Learn how to integrate signature detection into your applications

Authentication

All API requests require authentication using an API key. Include your API key in the request header:

x-api-key: your_api_key_here

You can generate API keys from your dashboard.

Endpoints

POST/api/detect

Detect signatures in an image. Costs 1 credit per request.

Request Body

{
  "imageUrl": "https://example.com/document.jpg",
  "confidenceThreshold": 0.1
}

Parameters

  • imageUrl (required): URL of the image to analyze
  • confidenceThreshold (optional): Detection threshold (0.01-1.0, default: 0.1)

Response

{
  "success": true,
  "result": {
    "detections": [
      {
        "bbox": {
          "x1": 321.23,
          "y1": 373.39,
          "x2": 647.21,
          "y2": 501.68
        },
        "confidence": 0.192,
        "class": 0,
        "class_name": "signature"
      }
    ],
    "count": 1,
    "confidenceThreshold": 0.1
  },
  "creditsRemaining": 9999,
  "detectionId": "clxxxx..."
}

Error Codes

401Unauthorized

Invalid or missing API key

402Payment Required

Insufficient credits. Purchase more credits to continue.

400Bad Request

Invalid request parameters

500Internal Server Error

Server error. Please try again later.

Code Examples

JavaScript / Node.js

const response = await fetch('https://signature-detector.com/api/detect', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'x-api-key': 'your_api_key_here'
  },
  body: JSON.stringify({
    imageUrl: 'https://example.com/document.jpg',
    confidenceThreshold: 0.1
  })
});

const data = await response.json();
console.log('Signatures found:', data.result.count);

Python

import requests

response = requests.post(
    'https://signature-detector.com/api/detect',
    headers={
        'Content-Type': 'application/json',
        'x-api-key': 'your_api_key_here'
    },
    json={
        'imageUrl': 'https://example.com/document.jpg',
        'confidenceThreshold': 0.1
    }
)

data = response.json()
print(f"Signatures found: {data['result']['count']}")

cURL

curl -X POST https://signature-detector.com/api/detect \
  -H "Content-Type: application/json" \
  -H "x-api-key: your_api_key_here" \
  -d '{
    "imageUrl": "https://example.com/document.jpg",
    "confidenceThreshold": 0.1
  }'

Rate Limits & Pricing

Cost per Detection

1 credit per API request

Pricing

$10 = 100,000 credits (100,000 detections)

Minimum purchase: $1 (10,000 credits)

Rate Limits

No rate limits - only limited by your available credits

Support

Need help? Here are some resources:

  • Try the playground to test the API interactively
  • Check your dashboard for usage statistics
  • Make sure your image URLs are publicly accessible
  • Adjust the confidence threshold based on your use case (lower for more detections, higher for fewer false positives)