USPTO

{
  "service_type": "platform",
  "base_url": "https://developer.uspto.gov",
  "auth_method": "api_key",
  "auth_config": {
    "header": "X-Api-Key",
    "key_required": true,
    "key_obtainable_at": "https://developer.uspto.gov/api-catalog",
    "auth_type": "api_key"
  },
  "endpoints": [
    {
      "name": "Patent Examination Data System (PEDS) API",
      "path": "/api/v1/patent/application/",
      "method": "GET",
      "description": "Search and retrieve patent application data including status, documents, and transactions.",
      "auth": "api_key"
    },
    {
      "name": "Patent Application Information Retrieval (PAIR) API",
      "path": "/api/v1/patent/application/",
      "method": "GET",
      "description": "Legacy system for retrieving application status and file history (deprecated in favor of PEDS).",
      "auth": "api_key"
    },
    {
      "name": "Patent Full-Text Search API",
      "path": "/api/v1/patent/search",
      "method": "GET",
      "description": "Full-text search of published patent documents.",
      "auth": "api_key"
    },
    {
      "name": "Trademark Search API",
      "path": "/api/v1/trademark/search",
      "method": "GET",
      "description": "Search and retrieve trademark data from the USPTO Trademark database.",
      "auth": "api_key"
    },
    {
      "name": "Trademark Assignment API",
      "path": "/api/v1/trademark/assignment",
      "method": "GET",
      "description": "Retrieve trademark assignment information.",
      "auth": "api_key"
    },
    {
      "name": "Patent Assignment API",
      "path": "/api/v1/patent/assignment",
      "method": "GET",
      "description": "Retrieve patent assignment information.",
      "auth": "api_key"
    },
    {
      "name": "Open Data Portal (ODP) Bulk Download",
      "path": "/api/v1/patent/download",
      "method": "GET",
      "description": "Access bulk data files for patent and trademark datasets.",
      "auth": "api_key"
    }
  ],
  "pricing_model": {
    "type": "free",
    "details": {
      "free_tier": "Access to public APIs is free of charge.",
      "api_key_required": true,
      "bulk_data": "Bulk data files are available at no cost, but require agreement to terms.",
      "premium": "Some advanced datasets or support services may require payment (not applicable for basic API)."
    }
  },
  "rate_limits": "Not explicitly documented. However, USPTO recommends contacting the help desk for high-volume access and may impose throttling. Typical limits are around 120 requests per minute per IP for public APIs.",
  "capabilities": [
    "Patent search and retrieval (applications, grants, full-text)",
    "Trademark search and retrieval (statuses, renewals, assignments)",
    "Bulk data download for patents and trademarks",
    "Access to prosecution history and document images",
    "Status tracking and updates for patent applications",
    "API key management for authenticated access",
    "Data for innovation research, analytics, and IP management"
  ],
  "raw_analysis": "The USPTO Open Data and Mobility program provides free, programmatic access to US patent and trademark data through a set of RESTful APIs. These APIs are used by legal professionals, IP analysts, researchers, and developers building tools for patent search, monitoring, and analysis. The core services include the Patent Examination Data System (PEDS) for application status and history, full-text search for published patents, and trademark search APIs. The platform is mature, maintained by a government agency, and widely used in the IP community. Authentication requires an API key, which can be obtained from the developer portal. There are no official rate limits documented, but users are advised to consider fair use and contact the help desk for bulk access. The data is open, and the platform supports bulk downloads, making it a valuable source for large-scale analyses. Integration possibilities include linking with patent management systems, legal analytics tools, academic research, and IP portfolio management software. Overall, it's a stable, authoritative source of US IP data."
}

3/3 tests passed

```json
{
  "overall": 72,
  "dimensions": {
    "token_efficiency": 8.0,
    "first_try_success": 7.0,
    "response_parseability": 9.0,
    "error_clarity": 6.0,
    "doc_quality": 7.0,
    "auth_simplicity": 6.0,
    "latency": 8.0,
    "consistency": 7.0
  },
  "pricing_normalized": {
    "free_tier": true,
    "requires_api_key": true,
    "bulk_data_available": true
  },
  "issues": [
    "API key required but no mention of OAuth or SSO signup flow — may involve manual registration",
    "No explicit error documentation or rate limit details in the capability description",
    "llms.txt returns the same SPA shell as other routes (no dedicated LLM-friendly content)"
  ],
  "recommendations": [
    "Provide a dedicated llms.txt with API endpoints, key endpoints, and examples to help agents discover the platform",
    "Add rate limit and error code documentation for clearer agent integration",
    "Consider offering SSO or magic link auth to reduce onboarding friction"
  ]
}
```