Gå til indhold

Find et segment og hent listen

Et segment er en liste over virksomheder, erhvervspersoner eller ejendomme, der opfylder jeres filtre. Via API’et kan I måle et segment, før I køber det, og hente hele listen bagefter.

1. Mål segmentet med et filteropslag

Et filteropslag giver det samlede antal og de 3 første emner. Her er alle virksomheder under konkurs:

Terminal window
curl "https://ownr.dk/api/v2/company/segments?statuses[]=UNDER%20KONKURS" \
-H "Authorization: Bearer ACCESS_TOKEN"
{ "status": "success", "data": { "items": [ ], "count": 7364 } }
  • Der er et endpoint pr. emnetype: /company/segments, /person/segments og /property/segments. Alle filtre står i referencen.
  • Filtre, jeres licens ikke omfatter, bliver ignoreret, så count kun afspejler de filtre, I har adgang til.
  • En ukendt parameter giver 400.
  • Filteropslag tæller i API-kvoten.

2. Køb segmentet i ownr

Selve købet sker i ownr, ikke via API’et. Byg det samme segment under Segmenter, og køb det dér.

3. Hent listen

GET /segments/downloads viser jeres købte segmenter. Hent ét med dets id:

Terminal window
curl "https://ownr.dk/api/v2/segments/downloads/42" \
-H "Authorization: Bearer ACCESS_TOKEN"
  • Svaret har 20 rækker pr. side. Brug page til at bladre.
  • Rækkerne har de samme kolonner som CSV- og XLSX-eksporten.
  • Et segment, der ikke er betalt, svarer 402.
  • Et købt segment kan hentes i 3 år. Et ubetalt udløber efter 30 dage.
  • Download af købte segmenter tæller ikke i API-kvoten.

4. Følg med i ændringer

Abonnerer I på et segment, sender ownr en webhook, når emner kommer ind i eller går ud af det. Se Hændelser for segmenter. I downloadet beholder emner, der er gået ud, deres række med afgangsdato udfyldt.