Acuity Lab API Documentation - Patents & IP Data Repository

Base URL: https://acuitylab.net/api/patents

Authentication

All requests to the Patents & IP Data API require an API key. Include the API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

Error Responses

200 OK: Request was successful.
400 Bad Request: The request was invalid.
401 Unauthorized: API key is missing or invalid.
403 Forbidden: The API key does not have permissions for the requested resource.
404 Not Found: The requested resource could not be found.
500 Internal Server Error: Something went wrong on the server side.

7.1 GET /patents/search

Retrieve patent data by keyword, patent number, or technology field, including filing country and status.

GET https://acuitylab.net/api/patents/search?keyword=blockchain&country=US&status=granted

{
    "keyword": "blockchain",
    "country": "US",
    "results": [
        {
            "patent_number": "US1234567",
            "title": "Blockchain-based Voting System",
            "filing_date": "2022-08-15",
            "grant_date": "2023-09-01",
            "status": "granted",
            "inventor": "John Doe",
            "assignee": "Tech Innovations LLC"
        },
        {
            "patent_number": "US9876543",
            "title": "Secure Blockchain Payment System",
            "filing_date": "2021-06-10",
            "grant_date": "2023-04-15",
            "status": "granted",
            "inventor": "Jane Smith",
            "assignee": "Blockchain Solutions Inc."
        }
    ]
}

7.2 GET /patents/countries

Retrieve a list of countries where a patent is filed, including grant status and expiration date.

GET https://acuitylab.net/api/patents/countries?patent_number=US1234567

{
    "patent_number": "US1234567",
    "international_filings": [
        {
            "country": "US",
            "status": "granted",
            "grant_date": "2023-09-01",
            "expiration_date": "2043-09-01"
        },
        {
            "country": "EU",
            "status": "pending",
            "filing_date": "2023-01-20"
        },
        {
            "country": "JP",
            "status": "granted",
            "grant_date": "2023-12-05",
            "expiration_date": "2043-12-05"
        }
    ]
}

7.3 GET /patents/value-assessment

Retrieve a patent’s value assessment based on its scope, market applicability, citations, and legal status.

GET https://acuitylab.net/api/patents/value-assessment?patent_number=US1234567

{
    "patent_number": "US1234567",
    "value_assessment": {
        "market_applicability": "high",
        "citations": 45,
        "scope": "broad",
        "legal_challenges": "none",
        "estimated_value": "$2,500,000"
    }
}

7.4 GET /patents/legal-status

Retrieve the current legal status of a patent, including challenges, licensing, and litigation history.

GET https://acuitylab.net/api/patents/legal-status?patent_number=US1234567

{
    "patent_number": "US1234567",
    "legal_status": {
        "litigations": [
            {
                "case_id": "CASE12345",
                "plaintiff": "Innovative Tech Co.",
                "defendant": "Blockchain Solutions Inc.",
                "status": "settled",
                "settlement_amount": "$500,000",
                "settlement_date": "2024-01-10"
            }
        ],
        "licenses": [
            {
                "licensee": "VotingTech Inc.",
                "license_type": "exclusive",
                "start_date": "2023-05-01",
                "end_date": "2033-05-01"
            }
        ]
    }
}

7.5 GET /patents/citations

Retrieve citation information for a patent, including forward citations (patents citing this one) and backward citations (patents cited by this one).

GET https://acuitylab.net/api/patents/citations?patent_number=US1234567

{
    "patent_number": "US1234567",
    "forward_citations": [
        {
            "citing_patent_number": "US2345678",
            "title": "Decentralized Payment Systems",
            "filing_date": "2024-02-01",
            "assignee": "Tech Pay Corp."
        }
    ],
    "backward_citations": [
        {
            "cited_patent_number": "US9876543",
            "title": "Cryptographic Secure Messaging",
            "filing_date": "2020-03-05",
            "assignee": "Security Tech Ltd."
        }
    ]
}

7.6 GET /patents/inventors

Retrieve information about the inventors associated with a patent, including their total patents and co-inventors.

GET https://acuitylab.net/api/patents/inventors?patent_number=US1234567

{
    "patent_number": "US1234567",
    "inventors": [
        {
            "name": "John Doe",
            "total_patents": 15,
            "co_inventors": ["Jane Smith", "Alice Green"]
        },
        {
            "name": "Jane Smith",
            "total_patents": 12,
            "co_inventors": ["John Doe", "Peter Johnson"]
        }
    ]
}

7.7 GET /patents/market-analysis

Retrieve market analysis related to a patent, including its potential market size, technology adoption, and competitive landscape.

GET https://acuitylab.net/api/patents/market-analysis?patent_number=US1234567

{
    "patent_number": "US1234567",
    "market_analysis": {
        "market_size": "$50 billion",
        "technology_adoption": "emerging",
        "key_competitors": [
            "Blockchain Solutions Inc.",
            "SecureVote LLC",
            "Digital Ledger Co."
        ]
    }
}

7.8 GET /patents/expiration-status

Retrieve the expiration status of a patent, including maintenance fees, grace periods, and renewal options.

GET https://acuitylab.net/api/patents/expiration-status?patent_number=US1234567

{
    "patent_number": "US1234567",
    "expiration_date": "2043-09-01",
    "maintenance_fees": {
        "last_paid": "2024-09-01",
        "next_due": "2025-09-01"
    },
    "grace_period": "none",
    "renewal_options": "available for up to 5 years"
}