Chrome Extension Downloader

Find extensions by name, description or category name. Returns metadata and pagination, ordered by user count. Use returned IDs for detail and analysis tools; not Chrome Web Store keyword search positions.

{
  "type": "object",
  "properties": {
    "q": {
      "description": "Text to match, e.g. password manager. Omit to browse the catalog by user count.",
      "type": "string",
      "maxLength": 120
    },
    "page": {
      "default": 1,
      "description": "Page number, starting at 1.",
      "type": "integer",
      "minimum": 1,
      "maximum": 10000
    },
    "pageSize": {
      "default": 20,
      "description": "Results per page, up to 100.",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Get collected store metadata for one extension, including users, ratings and version. Free without a key for basic metadata only; a key returns the full metadata record. Unknown IDs return not found, never trigger a crawl.

{
  "type": "object",
  "properties": {
    "eid": {
      "type": "string",
      "pattern": "^[a-p]{32}$",
      "description": "32-letter Chrome Web Store extension ID (a-p), not a URL, name or slug. Example: cjpalhdlnbpafiamejdnhcphjbkeiagm."
    }
  },
  "required": [
    "eid"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

Read one extension's user-count, store rating-count and average-star history with current metrics and deltas. Use for time-series analysis, not keyword ranks. Missing days are not zero values.

{
  "type": "object",
  "properties": {
    "eid": {
      "type": "string",
      "pattern": "^[a-p]{32}$",
      "description": "32-letter Chrome Web Store extension ID (a-p), not a URL, name or slug. Example: cjpalhdlnbpafiamejdnhcphjbkeiagm."
    },
    "days": {
      "default": 90,
      "description": "Look back this many days for stored metric snapshots, up to 365; coverage may be incomplete.",
      "type": "integer",
      "minimum": 1,
      "maximum": 365
    },
    "locale": {
      "default": "en",
      "description": "Preferred response content language, not a review-language filter or a store search market.",
      "type": "string",
      "enum": [
        "en",
        "zh-CN",
        "es",
        "pt-BR",
        "ru",
        "fr",
        "ja",
        "ko"
      ]
    }
  },
  "required": [
    "eid"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Track one extension's position in our overall and category user-count rankings. Returns per-scope history, not official store or keyword search positions. Untracked ranks may be missing.

{
  "type": "object",
  "properties": {
    "eid": {
      "type": "string",
      "pattern": "^[a-p]{32}$",
      "description": "32-letter Chrome Web Store extension ID (a-p), not a URL, name or slug. Example: cjpalhdlnbpafiamejdnhcphjbkeiagm."
    },
    "days": {
      "default": 365,
      "description": "Look back this many days for tracked ranking positions, up to 365.",
      "type": "integer",
      "minimum": 1,
      "maximum": 365
    }
  },
  "required": [
    "eid"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Inspect permission capabilities, observed permission changes and heuristic store risk signals. Reports evidence and incomplete assessments; not a malware scan, malware probability or safety guarantee.

{
  "type": "object",
  "properties": {
    "eid": {
      "type": "string",
      "pattern": "^[a-p]{32}$",
      "description": "32-letter Chrome Web Store extension ID (a-p), not a URL, name or slug. Example: cjpalhdlnbpafiamejdnhcphjbkeiagm."
    },
    "locale": {
      "default": "en",
      "description": "Preferred response content language, not a review-language filter or a store search market.",
      "type": "string",
      "enum": [
        "en",
        "zh-CN",
        "es",
        "pt-BR",
        "ru",
        "fr",
        "ja",
        "ko"
      ]
    }
  },
  "required": [
    "eid"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Compare up to four extensions side by side: users, stars, rating counts, versions, permissions and recent permission changes. For historical comparisons, call extension_trends for each ID; this is not code-similarity detection.

{
  "type": "object",
  "properties": {
    "eids": {
      "minItems": 1,
      "maxItems": 4,
      "type": "array",
      "items": {
        "type": "string",
        "pattern": "^[a-p]{32}$",
        "description": "32-letter Chrome Web Store extension ID (a-p), not a URL, name or slug. Example: cjpalhdlnbpafiamejdnhcphjbkeiagm."
      },
      "description": "One to four extension IDs to compare, in the desired display order. Use distinct IDs."
    }
  },
  "required": [
    "eids"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Browse extensions ranked by current users, average stars or store rating count. Free without a key for the first 10 by users only; omit arguments for that preview. Other sorts and pagination require a key.

{
  "type": "object",
  "properties": {
    "sort": {
      "default": "users",
      "description": "Free preview ranks by store user count only; omit to use this default.",
      "type": "string",
      "const": "users"
    },
    "page": {
      "default": 1,
      "description": "Free preview includes the first page only.",
      "type": "number",
      "const": 1
    },
    "pageSize": {
      "default": 10,
      "description": "Free preview returns at most 10 extensions; omit to use this default.",
      "type": "number",
      "const": 10
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

Find growing extensions using saved 7/14/30/90-day user or rating-count growth rankings. Candidates have 1K-1M users and at least 500 net new users in the window. Free without a key for the first 10 by 30-day user gain; omit arguments for that preview. Missing comparison data is not zero growth; requests never rebuild rankings.

{
  "type": "object",
  "properties": {
    "sort": {
      "default": "growth",
      "description": "Free preview ranks by net user gain, not percentage or rating-count gain.",
      "type": "string",
      "const": "growth"
    },
    "page": {
      "default": 1,
      "description": "Free preview includes the first page only.",
      "type": "number",
      "const": 1
    },
    "pageSize": {
      "default": 10,
      "description": "Free preview returns at most 10 extensions; omit to use this default.",
      "type": "number",
      "const": 10
    },
    "windowDays": {
      "default": 30,
      "description": "Free preview uses the saved 30-day growth window only.",
      "type": "number",
      "const": 30
    },
    "fastGrowth": {
      "default": false,
      "description": "Free preview does not apply the optional 20% user-growth filter.",
      "type": "boolean",
      "const": false
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false
}

Read our saved user-count leaderboard for one date, overall or within a category. Returns positions and pagination; not official store or keyword search ranks. Use extension_rank_history to follow one extension over time.

{
  "type": "object",
  "properties": {
    "rankDate": {
      "description": "Ranking date as YYYY-MM-DD in Asia/Shanghai. Omit for today; missing dates are not replaced with another date.",
      "type": "string",
      "format": "date",
      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"
    },
    "scopeType": {
      "default": "overall",
      "description": "Choose the overall catalog or one category leaderboard.",
      "type": "string",
      "enum": [
        "overall",
        "category"
      ]
    },
    "scopeKey": {
      "default": "all",
      "description": "Use all for overall scope; for category scope, use the recorded category key, not its translated display name.",
      "type": "string",
      "minLength": 1,
      "maxLength": 120
    },
    "page": {
      "default": 1,
      "description": "Page number, starting at 1.",
      "type": "integer",
      "minimum": 1,
      "maximum": 10000
    },
    "limit": {
      "default": 50,
      "description": "Ranking rows per page, up to 250.",
      "type": "integer",
      "minimum": 1,
      "maximum": 250
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Get an existing published AI summary of collected reviews, with pros and cons. Use extension_reviews for original comments. Returns null when unavailable and English when a translation is missing; never calls a model or generates a new summary.

{
  "type": "object",
  "properties": {
    "eid": {
      "type": "string",
      "pattern": "^[a-p]{32}$",
      "description": "32-letter Chrome Web Store extension ID (a-p), not a URL, name or slug. Example: cjpalhdlnbpafiamejdnhcphjbkeiagm."
    },
    "locale": {
      "default": "en",
      "description": "Preferred response content language, not a review-language filter or a store search market.",
      "type": "string",
      "enum": [
        "en",
        "zh-CN",
        "es",
        "pt-BR",
        "ru",
        "fr",
        "ja",
        "ko"
      ]
    }
  },
  "required": [
    "eid"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Read stored review statistics and star distribution for an extension, optionally by review language. These describe collected reviews, not all store ratings. Missing statistics return null; no refresh is triggered.

{
  "type": "object",
  "properties": {
    "eid": {
      "type": "string",
      "pattern": "^[a-p]{32}$",
      "description": "32-letter Chrome Web Store extension ID (a-p), not a URL, name or slug. Example: cjpalhdlnbpafiamejdnhcphjbkeiagm."
    },
    "language": {
      "default": "all",
      "description": "Original review language, e.g. en; all combines languages. This filters reviews rather than translating the response.",
      "type": "string",
      "minLength": 1,
      "maxLength": 20
    },
    "windowDays": {
      "default": 0,
      "description": "0 = all retained reviews; 365 = the stored one-year review window.",
      "anyOf": [
        {
          "type": "number",
          "const": 0
        },
        {
          "type": "number",
          "const": 365
        }
      ]
    }
  },
  "required": [
    "eid"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Read collected review counts grouped by original publication date and stars, plus version-level ratings and undated/unrated counts. Reconstructed from retained reviews, not historical store rating-count snapshots.

{
  "type": "object",
  "properties": {
    "eid": {
      "type": "string",
      "pattern": "^[a-p]{32}$",
      "description": "32-letter Chrome Web Store extension ID (a-p), not a URL, name or slug. Example: cjpalhdlnbpafiamejdnhcphjbkeiagm."
    }
  },
  "required": [
    "eid"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Read original stored reviews for one extension, with text, star and language filters combined using AND. Returns reviews and pagination. For cross-extension or OR queries, use extension_reviews_search.

{
  "type": "object",
  "properties": {
    "eid": {
      "type": "string",
      "pattern": "^[a-p]{32}$",
      "description": "32-letter Chrome Web Store extension ID (a-p), not a URL, name or slug. Example: cjpalhdlnbpafiamejdnhcphjbkeiagm."
    },
    "q": {
      "description": "Text to match in review bodies, e.g. subscription.",
      "type": "string",
      "maxLength": 500
    },
    "rating": {
      "description": "Exact star rating from 1 to 5.",
      "type": "integer",
      "minimum": 1,
      "maximum": 5
    },
    "language": {
      "description": "Original review language, e.g. en. Omit for all languages; does not translate reviews.",
      "type": "string",
      "maxLength": 20
    },
    "sort": {
      "default": "timestamp_desc",
      "description": "timestamp_desc/asc = newest/oldest first; rating_desc/asc = highest/lowest stars first.",
      "type": "string",
      "enum": [
        "timestamp_desc",
        "timestamp_asc",
        "rating_desc",
        "rating_asc"
      ]
    },
    "page": {
      "default": 1,
      "description": "Page number, starting at 1.",
      "type": "integer",
      "minimum": 1,
      "maximum": 10000
    },
    "pageSize": {
      "default": 20,
      "description": "Results per page, up to 100.",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    }
  },
  "required": [
    "eid"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Search original stored reviews across extensions with AND/OR field filters. Returns reviews and pagination. Example filter: {"field":"body","operator":"contains","value":"subscription"}. Use extensionEid to narrow to an extension.

{
  "type": "object",
  "properties": {
    "logic": {
      "default": "AND",
      "description": "AND requires every filter to match; OR requires at least one.",
      "type": "string",
      "enum": [
        "AND",
        "OR"
      ]
    },
    "filters": {
      "default": [],
      "description": "Up to 12 review filters. Example: [{\"field\":\"rating\",\"operator\":\"<=\",\"value\":2}]. Omit to browse retained reviews.",
      "maxItems": 12,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "field": {
            "type": "string",
            "enum": [
              "id",
              "extensionEid",
              "name",
              "authorPicture",
              "authorId",
              "authorName",
              "rating",
              "body",
              "timestamp",
              "language",
              "version",
              "helpfulCount"
            ],
            "description": "Review field to filter. name is the extension name; body is the original review text; rating is stars, not average extension rating."
          },
          "operator": {
            "type": "string",
            "enum": [
              "=",
              "!=",
              "oneOf",
              "contains",
              "notContains",
              "exists",
              "notExists",
              ">=",
              "<="
            ],
            "description": "oneOf requires an array; exists/notExists need no value. >= and <= apply only to rating, helpfulCount or timestamp; contains/notContains apply to text fields."
          },
          "value": {
            "description": "Scalar value, or an array for oneOf. rating uses 1-5; timestamp accepts Unix seconds/milliseconds or an ISO date/time. Omit for exists/notExists.",
            "anyOf": [
              {
                "type": "string",
                "minLength": 1,
                "maxLength": 500
              },
              {
                "type": "number"
              },
              {
                "minItems": 1,
                "maxItems": 100,
                "type": "array",
                "items": {
                  "anyOf": [
                    {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 500
                    },
                    {
                      "type": "number"
                    }
                  ]
                }
              }
            ]
          }
        },
        "required": [
          "field",
          "operator"
        ],
        "additionalProperties": false
      }
    },
    "sort": {
      "default": "timestamp_desc",
      "description": "timestamp_desc/asc = newest/oldest first; rating_desc/asc = highest/lowest stars first.",
      "type": "string",
      "enum": [
        "timestamp_desc",
        "timestamp_asc",
        "rating_desc",
        "rating_asc"
      ]
    },
    "page": {
      "default": 1,
      "description": "Page number, starting at 1.",
      "type": "integer",
      "minimum": 1,
      "maximum": 10000
    },
    "pageSize": {
      "default": 20,
      "description": "Results per page, up to 100.",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Find extensions by Manifest metadata, permission names, host patterns, descriptions or archived source file paths. Returns metadata matches and snippets, not full-text JavaScript search, source downloads or code-similarity analysis.

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "minLength": 2,
      "maxLength": 120,
      "description": "Text to match, e.g. webRequest, example.com or background.js. Uses case-insensitive substring matching."
    },
    "field": {
      "default": "all",
      "description": "Search target; source means archived file paths, not file contents. all searches metadata and paths.",
      "type": "string",
      "enum": [
        "all",
        "manifest",
        "permissions",
        "hosts",
        "description",
        "source"
      ]
    },
    "limit": {
      "default": 20,
      "description": "Maximum matches, up to 50, ordered by user count. No pagination.",
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    }
  },
  "required": [
    "q"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Read the current API key's daily REST/MCP usage and remaining key/account allowance. Requires a key, but remains available after its daily data quota is exhausted. Does not debit data quota; account minute limits still apply.

{
  "type": "object",
  "properties": {
    "days": {
      "default": 14,
      "description": "Daily usage history lookback, up to 90 days. Today's balances and reset time are included separately.",
      "type": "integer",
      "minimum": 1,
      "maximum": 90
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}