API Reference

API Documentation

Integrate ERIC·AI's patent risk detection into your workflow. Our REST API provides real-time risk assessment and visual similarity analysis.

Integration Guide

Getting started with ERIC·AI is straightforward. Our API follows RESTful principles and returns JSON-encoded responses.

01

Generate API Key

Create a unique identifier in your developer dashboard after signing up.

02

Base URL

https://api.eric-ai.com/v1
Note

The public API is currently in preview mode. Full access will be available in a future release.

Authentication

All API requests must include your API key in the X-API-KEY header.

Example
cURL
curl -X GET "https://api.eric-ai.com/v1/auth"
  -H "X-API-KEY: YOUR_SECRET_KEY"
  -H "Content-Type: application/json"

Image Analysis

POST/analyze/visual

Upload product images or URLs to compare against available design patent data sources. Returns risk scoring and visual similarity analysis.

Request Parameters

ParameterTypeRequired
image_urlStringYes
sensitivityFloatNo
categoryEnumNo

Request Body

JSON
{
  "image_url": "https://store.com/item_492.jpg",
  "sensitivity": 0.85,
  "options": {
    "depth_scan": true,
    "return_similar_patents": 5
  }
}

Sample Response

200 OK

Successful analysis with risk scoring

Success
{
  "status": "completed",
  "risk_score": 84,
  "risk_level": "HIGH",
  "matches": [
    {
      "patent_id": "US-10294-B2",
      "confidence": 0.97,
      "conflict_points": [
        "geometric_locking_mechanism",
        "asymmetric_pivot_joint"
      ]
    }
  ],
  "timestamp": "2024-05-20T14:22:01Z"
}