Extensions API

Query and analyze Chrome extensions using the Extension Auditor API.

The Extensions API provides access to our comprehensive database of Chrome extensions, including metadata, security analysis, versions, and reviews.

List Extensions

Retrieve a paginated list of extensions with optional filtering and sorting.

GET /api/v1/extensions

Query Parameters

Parameter	Type	Default	Description
`page`	integer	1	Page number (starts at 1)
`page_size`	integer	25	Items per page (max 100)
`sort`	string	`updated_at`	Sort field: `name`, `rating`, `usercount`, `updated_at`
`order`	string	`desc`	Sort order: `asc`, `desc`
`search`	string	-	Search by name or description
`status`	string	-	Filter: `active`, `obsolete`
`category`	string	-	Filter by Chrome Web Store category
`item_category`	string	-	Filter by item category
`payment_type`	string	-	Filter: `free`, `in_app`, `in_store`

Example Request

curl -X GET "https://extensionauditor.com/api/v1/extensions?page=1&page_size=10&search=adblocker&status=active" \
  -H "Cookie: session=your_session_cookie"

Example Response

{
  "success": true,
  "result": [
    {
      "extension_id": "blemhmgimpnomifkjoinlelbmgoljddm",
      "name": "AdBlock Plus - free ad blocker",
      "description": "Block ads on YouTube, Facebook, and your favorite websites.",
      "version": "3.14.2",
      "status": "active",
      "user_count": 10000000,
      "rating_value": 4.5,
      "rating_count": 175000,
      "category": "productivity",
      "is_trusted_publisher": true,
      "last_update": "2024-01-15T10:30:00Z"
    }
  ],
  "page": 1,
  "page_size": 10,
  "total_count": 1250,
  "total_pages": 125
}

Get Extension by ID

Retrieve detailed information about a specific extension.

GET /api/v1/extensions/{extensionId}

Path Parameters

Parameter	Type	Description
`extensionId`	string	32-character Chrome extension ID

Example Request

curl -X GET "https://extensionauditor.com/api/v1/extensions/blemhmgimpnomifkjoinlelbmgoljddm" \
  -H "Cookie: session=your_session_cookie"

Example Response

{
  "success": true,
  "data": {
    "extension_id": "blemhmgimpnomifkjoinlelbmgoljddm",
    "name": "AdBlock Plus - free ad blocker",
    "description": "Block ads on YouTube, Facebook...",
    "version": "3.14.2",
    "status": "active",
    "user_count": 10000000,
    "rating_value": 4.5,
    "rating_count": 175000,
    "category": "productivity",
    "is_trusted_publisher": true,
    "by_google": false,
    "is_featured": true,
    "payment_type": "free",
    "publisher_id": "abc123-def456",
    "extension_publishers": {
      "publisher_id": "abc123-def456",
      "author": "Adblock Plus",
      "total_extensions": 3,
      "active_extensions": 2,
      "risk_level": "low"
    },
    "extension_versions": [
      {
        "extension_version_id": "uuid-here",
        "version": "3.14.2",
        "size": 1245678,
        "created_at": "2024-01-15T10:30:00Z"
      }
    ],
    "extension_media": [
      {
        "type": "icon",
        "media_url": "https://..."
      }
    ]
  }
}

Get Extension Reviews

Retrieve user reviews for a specific extension.

GET /api/v1/extensions/{extensionId}/reviews

Query Parameters

Parameter	Type	Default	Description
`page`	integer	1	Page number
`page_size`	integer	25	Items per page (max 100)
`rating`	integer	-	Filter by rating (1-5)
`search`	string	-	Search in review text
`sort`	string	-	Sort: `reviewer_name`, `rating`, `review_date`
`order`	string	`desc`	Sort order

Example Request

curl -X GET "https://extensionauditor.com/api/v1/extensions/blemhmgimpnomifkjoinlelbmgoljddm/reviews?rating=1&page_size=10" \
  -H "Cookie: session=your_session_cookie"

Example Response

{
  "success": true,
  "result": [
    {
      "extension_id": "blemhmgimpnomifkjoinlelbmgoljddm",
      "reviewer_name": "John D.",
      "rating": 1,
      "review_date": "2024-01-10",
      "review_text": "Extension stopped working after update...",
      "review_text_hash": "sha256hash..."
    }
  ],
  "page": 1,
  "page_size": 10,
  "total_count": 45,
  "total_pages": 5
}

Get Extension Manifest

Retrieve the manifest.json for a specific extension version.

GET /api/v1/extensions/{extensionId}/versions/{version}/manifest

Example Request

curl -X GET "https://extensionauditor.com/api/v1/extensions/blemhmgimpnomifkjoinlelbmgoljddm/versions/3.14.2/manifest" \
  -H "Cookie: session=your_session_cookie"

Example Response

{
  "success": true,
  "data": {
    "manifest_version": 3,
    "name": "AdBlock Plus",
    "version": "3.14.2",
    "description": "Block ads...",
    "permissions": ["storage", "webRequest"],
    "host_permissions": ["<all_urls>"],
    "background": {
      "service_worker": "background.js"
    },
    "content_scripts": [
      {
        "matches": ["<all_urls>"],
        "js": ["content.js"]
      }
    ]
  }
}

Trigger Security Analysis

Queue a security analysis for a specific extension version.

POST /api/v1/extensions/{extensionId}/versions/{version}/analysis

Request Body

{
  "extensionId": "blemhmgimpnomifkjoinlelbmgoljddm",
  "version": "3.14.2",
  "priority": "high"
}

Field	Type	Default	Description
`extensionId`	string	required	Extension ID
`version`	string	required	Version to analyze
`priority`	string	`high`	Priority: `low`, `normal`, `high`

Example Response (Analysis Queued)

{
  "success": true,
  "data": {
    "message": "Risk analysis triggered successfully",
    "status": "processing",
    "messageId": "msg-uuid-here"
  }
}

Example Response (Analysis Exists)

{
  "success": true,
  "data": {
    "message": "Security analysis already exists",
    "status": "completed",
    "report": {
      "risk_score": 35,
      "risk_level": "medium",
      "findings": [
        {
          "category": "permissions",
          "severity": "medium",
          "title": "Broad host permissions",
          "description": "Extension requests access to all URLs"
        }
      ]
    }
  }
}

Error Responses

Status Code	Description
400	Invalid request parameters
401	Authentication required
404	Extension not found
429	Rate limit exceeded
500	Internal server error

Next Steps

Publishers API - Query publisher data
Monitors API - Set up monitoring
PermHash API - Analyze permission patterns