TypeScript SDK for the European Patent Office's Open Patent Services (OPS) API with OAuth support
npm install epo-ops-sdkA TypeScript SDK for the European Patent Office's Open Patent Services (OPS) API with OAuth support.
``bash`
npm install epo-ops-sdk
The SDK uses OAuth 2.0 client credentials flow for authentication. You need to:
1. Register at the EPO OPS website to get your credentials
2. Create a .env file in your project root with your credentials:`
`
EPO_CLIENT_ID=your_client_id
EPO_CLIENT_SECRET=your_client_secret
- Valid client ID and client secret from EPO OPS
- Proper headers including:
- Content-Type: application/x-www-form-urlencoded
- Accept: application/json
- Connection: Keep-Alive
- Host: ops.epo.org
- X-Target-URI: http://ops.epo.org
`typescript
import { EpoOpsClient } from 'epo-ops-sdk';
import dotenv from 'dotenv';
// Load environment variables
dotenv.config();
// Initialize the client
const client = new EpoOpsClient({
clientId: process.env.EPO_CLIENT_ID,
clientSecret: process.env.EPO_CLIENT_SECRET
});
// Search for patents
const searchResults = await client.searchPatents('TI=(artificial intelligence)');
// Get bibliographic data
const biblio = await client.getBibliographicData({
type: 'publication',
format: 'docdb',
number: 'EP1234567A1'
});
// Get patent claims
const claims = await client.getClaims({
type: 'publication',
format: 'docdb',
number: 'EP1234567A1'
});
// Get patent family members
const family = await client.getFamily({
type: 'publication',
format: 'docdb',
number: 'EP1234567A1'
});
// Get legal status
const legalStatus = await client.getLegalStatus({
type: 'publication',
format: 'docdb',
number: 'EP1234567A1'
});
// Get classification details
const classification = await client.getClassification('G06F', {
ancestors: true,
navigation: true,
depth: 'all'
});
// Convert patent numbers between formats
const converted = await client.convertNumber(
'publication',
'docdb',
'EP1234567A1',
'epodoc'
);
`
- OAuth 2.0 authentication with automatic token refresh
- Patent search
- Bibliographic data retrieval
- Claims retrieval
- Family member lookup
- Legal status information
- Classification data
- Patent number format conversion
- TypeScript support with full type definitions
- Zod schema validation for responses
The SDK includes comprehensive error handling for common issues:
- AuthenticationError: When there are issues with OAuth authenticationRateLimitError
- : When API rate limits are exceededValidationError
- : When request parameters are invalidEpoOpsError
- : For general API errors
If you encounter authentication issues:
1. Verify your credentials are correct in the .env file
2. Check that your client ID and secret are properly formatted (no extra spaces)
3. Ensure you have the correct permissions for the OPS API
4. Verify your network connection to ops.epo.org
5. Check if your credentials have expired
For detailed API documentation, please refer to OPS.md.
- Node.js >= 16.15.1
- TypeScript >= 4.5.0 (for development)
MIT
1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)git commit -m 'Add some amazing feature'
3. Commit your changes ()git push origin feature/amazing-feature`)
4. Push to the branch (
5. Open a Pull Request