# Run a saved screen

> Run one of the screener's ready-made screens, or one of your saved screens, by its id from the screener filter list: the matching stocks, answered the way a screen of your own filters is.

Source: https://wiseview.ai/docs/api/screener-screen

`GET https://api.wiseview.ai/v1/screener/screens/{id}`

Run one of the screener's ready-made screens, or one of your saved screens, by its id from the screener filter list: the matching stocks, answered the way a screen of your own filters is.

Each call counts against your allowance.

## Parameters

| Name | In | Type | What it does |
| --- | --- | --- | --- |
| `id` (required) | path | id | The screen's id, from the screener filter list. |
| `view` | query | one of the values | Which columns: search shows the figure each filter names; the others are the screener's fixed column sets. One of `search`, `overview`, `valuation`, `ownership`, `performance`, `financial`, `technical`. Leave it out for `search`. |
| `limit` | query | whole number, 1–500 | How many matching stocks. Leave it out for `100`. |

## Answer

`data`, abridged — real answers carry more fields:

```json
{
  "screen": {
    "id": "6710c0ffee0000000000ad01",
    "name": "Pre-Market Bullish Gappers"
  },
  "view": "search",
  "count": 14,
  "returned": 14,
  "truncated": false,
  "results": [
    {
      "ticker": "NVDA",
      "company": "NVIDIA Corp",
      "sector": "Technology",
      "marketCap": 4410000000000,
      "pe": 52.3,
      "price": 181.2,
      "change": 0.021
    }
  ]
}
```

## Samples

```bash
curl "https://api.wiseview.ai/v1/screener/screens/SCREEN_ID" \
  -H "Authorization: Bearer $WISEVIEW_API_KEY"
```

```python
import os
import requests

response = requests.get(
    "https://api.wiseview.ai/v1/screener/screens/SCREEN_ID",
    headers={"Authorization": f"Bearer {os.environ['WISEVIEW_API_KEY']}"},
)
response.raise_for_status()
print(response.json())
```

```javascript
const response = await fetch("https://api.wiseview.ai/v1/screener/screens/SCREEN_ID", {
  headers: { "Authorization": `Bearer ${process.env.WISEVIEW_API_KEY}` },
});
if (!response.ok) throw new Error(`WiseView answered ${response.status}`);
console.log(await response.json());
```