# GitHub · Search advisories

Get product, price and seller data with GitHub · Search advisories from Alexandria through one Spiral API key. Search advisories. It runs in the background and returns structured JSON. Pay as you go, with no subscription.

- Provider: Alexandria
- Category: E-commerce
- Runs: In the background
- Returns: json
- Tool id: `alexandria` / `github-com/repositories/search_advisories`
- Page: https://spiral.ai/tools/alexandria/github-com/repositories/search_advisories

## Pricing

$0.00873 per call.

## Limits

- Longest queue wait: 1 hour
- Run deadline: 5 minutes
- Longest run, end to end: 225 minutes
- Largest inline input: 1 MB
- Largest input file: 2 GB
- Largest output: 5 GB

## Input

| Field | Kind | Allowed | Default | Description |
| --- | --- | --- | --- | --- |
| `cwes` | list |  | — | CWE ids such as CWE-79 or 79; matches advisories with any of them. |
| `sort` | one of | published, updated, epss_percentage, epss_percentile | published | sort |
| `type` | one of | reviewed, unreviewed, malware | reviewed | reviewed (GitHub-curated, the default), unreviewed (imported from NVD, often without packages) or malware. |
| `cursor` | text |  | — | next_cursor from the previous page. Pattern: ^[A-Za-z0-9+/=%_-]+$. |
| `cve_id` | text |  | — | CVE id, for example CVE-2021-44228. Pattern: ^[Cc][Vv][Ee]-\d{4}-\d{4,19}$. |
| `affects` | list |  | — | Package names or name@version (Maven as group:artifact, Go as module path); matches advisories affecting any of them. |
| `updated` | text |  | — | Last update date: YYYY-MM-DD, >=YYYY-MM-DD (also >, <, <=) or YYYY-MM-DD..YYYY-MM-DD. Pattern: ^(?:(?:[<>]=?)?\d{4}-\d{2}-\d{2}\|\d{4}-\d{2}-\d{2}\.\.\d{4}-\d{2}-\d{2})$. |
| `modified` | text |  | — | Publication or update date: YYYY-MM-DD, >=YYYY-MM-DD (also >, <, <=) or YYYY-MM-DD..YYYY-MM-DD. Pattern: ^(?:(?:[<>]=?)?\d{4}-\d{2}-\d{2}\|\d{4}-\d{2}-\d{2}\.\.\d{4}-\d{2}-\d{2})$. |
| `per_page` | number | 1 to 100 | 30 | per_page |
| `severity` | one of | unknown, low, medium, high, critical | — | severity |
| `direction` | one of | asc, desc | desc | direction |
| `ecosystem` | one of | rubygems, npm, pip, maven, nuget, composer, go, rust, erlang, actions, pub, other, swift | — | Package ecosystem. pip is PyPI, rust is crates.io, composer is Packagist, actions is GitHub Actions. |
| `published` | text |  | — | Publication date: YYYY-MM-DD, >=YYYY-MM-DD (also >, <, <=) or YYYY-MM-DD..YYYY-MM-DD. Pattern: ^(?:(?:[<>]=?)?\d{4}-\d{2}-\d{2}\|\d{4}-\d{2}-\d{2}\.\.\d{4}-\d{2}-\d{2})$. |
| `is_withdrawn` | true or false |  | — | true: only withdrawn advisories; false: only active ones. |

## Example

```bash
curl https://api.spiral.ai/v1/runs \
  -H "Authorization: Bearer $SPIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "provider": "alexandria",
    "model": "github-com/repositories/search_advisories",
    "input": {
      "cwes": [
        "<cwes>"
      ]
    }
  }'
```

Try it in the Playground: https://spiral.ai/start?provider=alexandria&model=github-com%2Frepositories%2Fsearch_advisories

## Common questions

### GitHub · Search advisories

**How much does GitHub · Search advisories cost?**

$0.00873 per call. You pay as you go from one Spiral balance, with no subscription, and a failed run is not charged.

**How do I use GitHub · Search advisories through an API?**

Send `POST /v1/runs` with `"provider": "alexandria"`, `"model": "github-com/repositories/search_advisories"` and the input fields on this page, using one Spiral API key. It runs in the background: poll the run, or name a webhook to be told when it finishes.

**Do I need an account with Alexandria to use GitHub · Search advisories?**

No. Spiral runs it on its own Alexandria account and charges your Spiral balance.

**Can my AI agent use GitHub · Search advisories?**

Yes. Agents find and run it through Spiral's MCP server, CLI or agent skill, with the same API key.

