# Søg

> Søg efter virksomheder på navn, binavn eller CVR-nummer med filtre på postnummer og status.

## GET /v1/soeg

Søger på navn og binavne. Selskabsformen ignoreres, og æ/ae, ø/oe og å/aa matcher hinanden. Et CVR-nummer i `q` giver virksomheden direkte. Gratis pakke.

```bash curl
curl "https://cvrradar.dk/v1/soeg?q=havnens%20smedje&limit=5&aktiv=true" \
  -H "Authorization: Bearer cvr_DIN_NOEGLE"
```
```js JavaScript
const svar = await fetch("https://cvrradar.dk/v1/soeg?q=havnens%20smedje&limit=5&aktiv=true", {
  headers: {
    Authorization: "Bearer cvr_DIN_NOEGLE",
  },
});
if (!svar.ok) throw new Error(`cvrradar svarede ${svar.status}`);
const data = await svar.json();
```
```php PHP
$ch = curl_init("https://cvrradar.dk/v1/soeg?q=havnens%20smedje&limit=5&aktiv=true");
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        "Authorization: Bearer cvr_DIN_NOEGLE",
    ],
]);
$data = json_decode(curl_exec($ch), true);
```
```python Python
import requests

svar = requests.get(
    "https://cvrradar.dk/v1/soeg?q=havnens%20smedje&limit=5&aktiv=true",
    headers={"Authorization": "Bearer cvr_DIN_NOEGLE"},
    timeout=10,
)
svar.raise_for_status()
data = svar.json()
```

### Parametre

| Parameter | Påkrævet | Beskrivelse                                      |
| --------- | -------- | ------------------------------------------------ |
| `q`       | ja       | Søgetekst, 2 til 200 tegn                        |
| `limit`   | nej      | Antal resultater, 1 til 50 (standard 10)         |
| `postnr`  | nej      | Kun virksomheder med dette postnummer, fx `8000` |
| `aktiv`   | nej      | `true` giver kun aktive, `false` kun ophørte     |

### Svar

```json
{
  "resultater": [
    {
      "virksomhed": { "cvr": "10203040", "navn": "Havnens Smedje ApS", "aktiv": true },
      "lighed": 0.92,
      "score": 1.31
    }
  ]
}
```

`lighed` er tekstligheden mellem søgningen og navnet (0 til 1). `score` tager også højde for, om virksomheden er aktiv og stor, og resultaterne er sorteret efter den. `virksomhed` har de samme felter som [Virksomhed](https://cvrradar.dk/docs/endpoints/virksomhed.md).

> **Bemærk:**
>
> Søger du på et domæne eller en mailadresse, så brug [Domæne](https://cvrradar.dk/docs/endpoints/domaene.md). Det er mere præcist end navnesøgningen.