• What Authentication Methods Does Data Distill Support?

  Data Distill uses API Key Authentication for secure access. You include your API key in the request headers:

  Authorization: Bearer your_api_key

  Authorization: Bearer your_api_key
  

• How Do I Handle Asynchronous Processing?

  Send a document for asynchronous processing by specifying a callback_url in your request payload. Results will be sent to your webhook when processing is complete.
  Example Payload:

  {"document_url": "https://yourapp.com/docs/invoice.pdf", "callback_url": "https://yourapp.com/webhook-endpoint"}

  {"document_url": "https://yourapp.com/docs/invoice.pdf", "callback_url": "https://yourapp.com/webhook-endpoint"}
  

• What File Formats Does the API Support?
  Data Distill supports:

  • Documents: PDF, DOCX, TXT
  • Images: JPG, PNG, TIFF
  • Audio: MP3, WAV

• How Do I Parse Tables in Documents?

  Data Distill’s API automatically detects and extracts tables, including nested tables andcomplex layouts. You receive the data in JSON format, preserving the table structure.

• What is the Maximum File Size I Can Process?
  The maximum file size limit depends on your plan:

  • Starter: 5 MB
  • Business: 20 MB
  • Premium & Enterprise: 100 MB

  For larger files, split them into smaller parts before uploading.

• How Do I Set Up Error Handling for API Requests?
  Check the status codes and error messages in the API response. Common errors include:

  • 400: Bad request (invalid payload)
  • 401: Unauthorized (Invalid API Key)
  • 500: Internal server error

  Example Error Response:

  { "error": "Invalid document format", "status": 400 }

  {
      "error": "Invalid document format",
      "status": 400
  }
  

• How Can I Optimize API Performance?
  The maximum file size limit depends on your plan:

  • Batch Processing: Submit multiple documents in a single API call.
  • Asynchronous Calls: Use asynchronous processing for large-scale tasks.
  • Webhooks: Receive real-time results via webhooks to avoid polling.

• How Do I Handle Rate Limiting?

  Rate limits vary by plan. If you exceed the limit, the API returns a 429 (Too Many Requests) response. Implement retry logic with exponential backoff.
  Example Retry Logic in Python:

  import time def retry_request(api_call, retries=3, delay=2): for attempt in range(retries): response = api_call() if response.status_code == 200: return response time.sleep(delay * (2 ** attempt)) # Exponential backoff

  import time
  
  def retry_request(api_call, retries=3, delay=2):
      for attempt in range(retries):
          response = api_call()
          if response.status_code == 200:
              return response
          time.sleep(delay * (2 ** attempt))  # Exponential backoff
  

• How Can I Customize Data Extraction Fields?

  Include a custom template in your API request to specify the fields you need
  Example Payload:

  { "document_url": "https://yourapp.com/docs/contract.pdf", "fields": ["date", "total_amount", "invoice_number"] }

  {
      "document_url": "https://yourapp.com/docs/contract.pdf",
      "fields": ["date", "total_amount", "invoice_number"]
  }
  

• How Do I Secure My Webhook Endpoint?
  Secure your webhook by:

  • Using HTTPS for encrypted communication.
  • Verifying Signatures: Check the signature included in the webhook payload to confirm authenticity.

• What Is the Response Format for Processed Data?
  { "invoice_number": "INV-12345", "date": "2024-06-01", "total_amount": 1500, "currency": "USD" }

  {
      "invoice_number": "INV-12345",
      "date": "2024-06-01",
      "total_amount": 1500,
      "currency": "USD"
  }
  

• How Do I Transcribe Audio Files with Data Distill?

  Send an audio file to the transcription API endpoint and specify your callback_url.Example Request:

  import requests API_URL = "https://api.datadistill.com/transcribe" API_KEY = "your_api_key" files = {'file': open('audio.mp3', 'rb')} payload = {"callback_url": "https://yourapp.com/webhook-endpoint"} headers = {'Authorization': f'Bearer {API_KEY}'} response = requests.post(API_URL, files=files, data=payload, headers=headers)

  import requests
  
  API_URL = "https://api.datadistill.com/transcribe"
  API_KEY = "your_api_key"
  files = {'file': open('audio.mp3', 'rb')}
  payload = {"callback_url": "https://yourapp.com/webhook-endpoint"}
  headers = {'Authorization': f'Bearer {API_KEY}'}
  
  response = requests.post(API_URL, files=files, data=payload, headers=headers)
  

• What Languages Does Data Distill Support for OCR and Transcription?

  Data Distill supports over 60 languages for OCR and transcription, including English, Spanish, French, German, Chinese, Japanese, and more.

• How Do I Monitor API Usage and Credit Consumption?

  SYou can monitor your credit usage via the dashboard or by making an API call to the usage endpoint.Example Usage Request:

  response = requests.get("https://api.datadistill.com/usage", headers={'Authorization': f'Bearer {API_KEY}'}) print(response.json())

  response = requests.get("https://api.datadistill.com/usage", headers={'Authorization': f'Bearer {API_KEY}'})
  print(response.json())
  

• How Do I Ensure Compliance with Data Protection Regulations?
  Data Distill is compliant with:

  • GDPR
  • HIPAA
  • CCPA We process data securely with end-to-end encryption and do not store any data. For maximum compliance, you can request a BAA (Business Associate Agreement) for HIPAA-related use cases.

Need More Technical Information?