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:
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/segmentsog/property/segments. Alle filtre står i referencen. - Filtre, jeres licens ikke omfatter, bliver ignoreret, så
countkun 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:
curl "https://ownr.dk/api/v2/segments/downloads/42" \ -H "Authorization: Bearer ACCESS_TOKEN"- Svaret har 20 rækker pr. side. Brug
pagetil 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.