Ontwikkelaarsgids
Bouw je eigen linkbuilding-automatisering met de BlogDrip API
Koppel je software direct aan BlogDrip en automatiseer gastpostbestellingen. Bouw aangepaste SEO-workflows, integreer je bestaande applicaties en beheer linkbuildingprocessen efficiënter.
Waarom automatiseren
Waarom je eigen linkbuilding-automatisering bouwen
SEO-bureaus en interne marketingteams lopen tegen hetzelfde operationele patroon aan: handmatig zoeken naar publicatiemogelijkheden, gastpostbestellingen opnieuw invoeren, meerdere klantcampagnes tegelijk managen, informatie tussen interne systemen overdragen, de voortgang van bestellingen volgen en proberen dit allemaal op te schalen zonder het aantal medewerkers evenredig te vergroten.
Een API-integratie haalt het repetitieve, mechanische werk van je bord en laat het via code verlopen. Je bestaande software — de CRM, het campagnebeheersysteem of het aangepaste dashboard waarin je team al werkt — praat rechtstreeks met de marketplace. Je team blijft gefocust op strategie, briefs en kwaliteitscontrole in plaats van op het invoeren van bestellingen.
Automatisering levert efficiëntie in workflows, geen hogere SEO-posities. Het zorgt er niet voor dat een slechte campagne succesvol wordt en vervangt geen menselijke afweging bij de selectie van uitgevers. Waar het wél goed in is, is het wegnemen van de laag van handmatige gegevensinvoer, zodat wanneer je beslist wat te kopen je het in elke gewenste schaal kunt uitvoeren.
Wat je kunt bouwen
Wat je met de BlogDrip API kunt bouwen
Praktische patronen voor software gebouwd op een programmatic marketplace-integratie.
Aangepast dashboard voor gastposts
Een interne applicatie die verbinding maakt met BlogDrip en ondersteunde gastpostbestellingen indient vanuit een UI die je team beheert.
Beheersysteem voor SEO-bureaus
Gastpostbestellingen geïntegreerd in de bestaande workflow van het bureau, zodat campagnemanagers het systeem dat ze al gebruiken niet hoeven te verlaten.
Geautomatiseerde orderindiening
API-aanvragen creëren ondersteunde gastpostbestellingen in batches, zonder de manuele invoerstap per bestelling.
Beheer van klantcampagnes
Koppel interne klant- en campagnedata aan BlogDrip-bestelworkflows — één enkele bron van waarheid voor wie wat koopt.
Workflowautomatisering
Activeer ondersteunde API-bewerkingen vanuit interne bedrijfsprocessen — goedkeuringen, kickoffs en geplande campagnegolven.
Rapportage en monitoring
Haal ordergerelateerde informatie naar aangepaste rapportagetools waar mogelijk. Richt je rapportage op wat de API daadwerkelijk blootlegt in plaats van uit te gaan van volledige realtimezichtbaarheid.
Architectuur
Voorbeeldarchitectuur voor automatisering
Een gezonde integratie verdeelt verantwoordelijkheden over vier lagen.
Bovenaan staat je externe automatiseringsapplicatie — een aangepast dashboard, SEO-agencysoftware, interne CRM of campagnebeheersysteem. Dit is waar je team dagelijks werkt.
Daaronder zit de backend van je applicatie. De verantwoordelijkheden zijn wat elke integratie goed moet regelen: sla `x-client-id` en `x-client-secret` veilig op, valideer input voordat het BlogDrip bereikt, bereid API-aanvragen voor en verstuur ze, verwerk `{ data, pagination }` responses, log operationele events en beheer retries veilig zodat een tijdelijke netwerkstoring niet resulteert in een dubbele betaalde bestelling.
Vervolgens bereiken de requests de BlogDrip Advertiser API — de publieke, versiegebonden interface onder `/api/public/*` — die de ondersteunde gastpostbestelfunctionaliteit blootlegt.
De API leidt bestellingen naar de BlogDrip marketplace — meer dan 275,000+ websites aan totale inventory — en vanaf daar naar de relevante orderverwerking en publicatieworkflow. Afhankelijk van de gekozen website kan publicatie handmatig aan de kant van de uitgever plaatsvinden of geautomatiseerd via de WordPress-plugin of de Agency API. Niet elke website in de marketplace ondersteunt Instant Publishing, dus je integratie moet publicatietiming als afhankelijk van de workflow behandelen, niet als direct.
Bouw je automatiseringstool, stap voor stap
Acht stappen van afbakening tot monitoring. Zie ze als referentie, niet als strikte volgorde — veel stappen lopen parallel.
Bepaal je automatiseringsworkflow
Identificeer welke taken geautomatiseerd moeten worden, welke informatie je applicatie nodig heeft, wanneer een bestelling ingediend moet worden, hoe dubbele bestellingen voorkomen worden, hoe fouten afgehandeld worden en hoe campagnedata opgeslagen wordt. Een concreet scope-voorbeeld: een bureau dat 20 klanten beheert, elk met 3–5 actieve campagnes, wil dat nieuwe campagnes automatisch bestellingen genereren voor een shortlist van vooraf goedgekeurde websites — maar alleen nadat een mens het campagnenbrief heeft goedgekeurd.
Vraag BlogDrip API-toegang aan
Open je account op app.blogdrip.com/settings en ga naar Mijn instellingen → API access om je credentials te vinden. Je ziet twee waarden: een `x-client-id` en een `x-client-secret`. Het secret wordt eenmaal weergegeven bij uitgifte of rotatie, kopieer het daarom direct naar je secret manager. Toegang vereist minimaal €500 per maand aan totale accountuitgaven — handmatige bestellingen tellen mee, API-bestellingen tellen mee, beide sporen gecombineerd. API-toegang wordt automatisch gedeactiveerd als het minimum in een maand niet bereikt wordt. De €500 is een bestedingsdrempel, geen aparte API-abonnementsvergoeding.
Lees de API-documentatie
De officiële docs op app.blogdrip.com/api/public/docs/index.html beschrijven de exacte endpoints onder de `/api/public/*` namespace, authenticatie (de twee header-paren hierboven genoemd), request-methodes, vereiste parameters, response-formaten (list-endpoints wikkelen responses in `{ data, pagination }` met 0-based `?page=0`), validatiefouten (`{ message }`) en beschikbare besteloperaties. Gebruik de documentatie als het gezaghebbende uitgangspunt: als een parameter niet gedocumenteerd is, ga er dan niet vanuit dat hij bestaat.
Bouw de API-verbinding
Maak een backend die zowel de `x-client-id` als de `x-client-secret` veilig opslaat (environment variables, secret manager — nooit in frontend-code), geauthenticeerde requests met beide headers verstuurt, responses parseert, fouten afhandelt en gestructureerde logs schrijft voor elke uitgaande call. Houd de API-client klein en goed getest zodat de rest van je applicatie nooit rechtstreeks met BlogDrip hoeft te praten.
Implementeer geautomatiseerde gastpostbestellingen
Koppel je interne workflow aan de ondersteunde BlogDrip-besteloperaties. Een typisch flow: een nieuwe campagne wordt aangemaakt in je systeem → er wordt een website geselecteerd (los het `marketSiteId` op via de marketplace-endpoints) → je applicatie bereidt de vereiste bestelgegevens voor (titel, URL, beschrijving, `categoryId`, `marketSiteId`, `campaignId`, optioneel `scheduleDate`, `linkNoFollow`) → de backend valideert de bestelling tegen je business rules → de applicatie dient de bestelling in via de Advertiser API → de response wordt opgeslagen in je systeem voor traceerbaarheid. Valideer elk veld tegen de OpenAPI-spec voordat je live gaat.
Handel fouten en dubbele bestellingen af
Valideer requests vóór verzending, voorkom per ongeluk dubbele bestellingen (een idempotentiesleutel of een server-side deduplicatiecheck aan jouw kant is een veilig patroon), log elke API-fout met genoeg context om later te debuggen, ga voorzichtig om met tijdelijke connectiviteitsproblemen en respecteer gedocumenteerde rate limits. Een vuistregel om te onthouden: retry nooit automatisch een niet-idempotente order creation request zonder expliciete menselijke of systeembekrachtiging — een retry op een succesvolle bestelling waarvan je de response niet zag veroorzaakt een dubbele afschrijving.
Test je integratie
Draai je integratie tegen een sandbox-omgeving als die in de documentatie staat. Als er geen sandbox beschikbaar is, test dan zorgvuldig in productie — draai nooit geautomatiseerde testsuites die echte betaalde bestellingen aanmaken zonder expliciete autorisatie. Gebruik een dedicated testcampagne met een mens-in-de-lus review voordat de eerste geautomatiseerde bestelling wordt verzonden, en beperk geautomatiseerde testruns tot een korte allow-list van websites die je vooraf hebt goedgekeurd voor integratietests.
Deploy en monitor
Zet credentials in je productie-secretstore, voeg monitoring toe voor integratiefouten en ongebruikelijke bestelpatronen, traceer orderresultaten end-to-end, bewaar operationele logs lang genoeg om een incident van twee weken oud te debuggen, monitor je accountuitgaven zodat je niet onverwacht API-toegang verliest door onder de €500 maandelijkse minimum te zakken, en houd de BlogDrip changelog in de gaten voor API-updates die onderhoud aan je integratie vereisen.
Integratiepatronen
Hoe een gezonde integratie eruitziet
De gezaghebbende bron voor uitvoerbare voorbeelden is de OpenAPI-specificatie op app.blogdrip.com/api/public/openapi.json en de leesbare docs op /api/public/docs. De spec is waar je code tegen gegenereerd of gecontroleerd moet worden — niet een landing-pagefragment dat verouderd kan raken.
In de praktijk volgt een nette integratie meestal hetzelfde patroon. Een dunne API-clientmodule in je voorkeursprogrammeeromgeving — één wrapperfunctie per benodigde operatie — regelt de mechanica: hij zet de `x-client-id` en `x-client-secret` headers op elke request, serialiseert de request-body, deserialiseert het `{ data, pagination }`-envelope op list-endpoints (0-based paging) en zet error-responses (`{ message }`) om in exceptions die je businesslogica schoon kan afhandelen. Elke wrapper heeft minstens één test die op de gedocumenteerde vorm asserteert, zodat een schemawijziging als een falende test zichtbaar wordt voordat het productie bereikt. Pas nadat die module stabiel is, koppel je hem aan de rest van je applicatie — campagne-triggers, orderqueues, retry-workers, rapportage.
Die volgorde houdt de integratie auditbaar: je API-client is een klein, goed getest oppervlak; alles buiten die client praat via hem met BlogDrip.
Best practices
Wat een API-integratie duurzaam maakt
Patronen die geautomatiseerde systemen gezond houden lang na de livegang.
Idempotentie door ontwerp
Behandel het aanmaken van bestellingen als duur en onomkeerbaar. Dedupliceer aan jouw kant vóórdat de request wordt verzonden — nooit erna.
Credentialhygiëne
API-credentials horen in een secret manager, per omgeving gescope. Roteer ze bij vertrek, niet alleen bij een breach.
Gestructureerde logging
Elke request + response krijgt een correlatie-ID. Je toekomstige zelf die een oude bestelling debugt zal je dankbaar zijn.
Rate-limit-aware clients
Respecteer de gedocumenteerde rate limits. Een client die netjes terugschakelt kan verder schalen dan een die agressief blijft retryen.
Mens in de lus
Bescherm de eerste productieaanroep met menselijke goedkeuring. Breid automatisering alleen uit nadat de integratie stabiel blijkt.
Bestedingsmonitoring
Waarschuw wanneer de maandelijkse accountuitgaven richting of onder €500 neigen. Halvering van API-toegang midden in een campagne is pijnlijk.
Veelgestelde vragen
Voor wie is de BlogDrip API bedoeld?
Advertiser-accounts die hun eigen software willen koppelen — een aangepast dashboard, een SEO-agencyplatform, een interne CRM — aan BlogDrip's workflow voor gastpostbestellingen. Typische gebruikers zijn bureaus die campagnes op volume beheren, interne SEO-teams die integreren met een bestaande stack en ontwikkelaars die operationele tools bouwen voor een specifieke klant of product.
Moet ik een ontwikkelaar zijn om de API te gebruiken?
Om de integratie zelf te bouwen: ja. De API is een programmatic interface — het gebruik ervan vereist code schrijven of samenwerken met een ontwikkelaar. Als je de operationele voordelen wilt zonder integratiewerk, dekt de marketplace-UI dezelfde bestelfunctionaliteit handmatig.
Wat zijn de toegangseisen?
Een actief BlogDrip-account dat in totaal ten minste €500 per maand besteedt — zowel handmatige als API-bestellingen tellen mee voor de drempel. API-toegang wordt automatisch gedeactiveerd als je account in een gegeven maand minder besteedt. De €500 is een volumedrempel, geen aparte API-abonnementsvergoeding.
Waar staat de API-documentatie?
De officiële API-documentatie staat op app.blogdrip.com/api/public/docs/index.html, met de machine-leesbare OpenAPI-specificatie op app.blogdrip.com/api/public/openapi.json. Beide beschrijven het authenticatieschema, het volledige endpointoverzicht onder de `/api/public/*` namespace, request- en responsevormen, het paginatieformaat en error-responses. Gebruik ze als de bron van waarheid voor je integratie.
Waar vind ik mijn API-credentials?
In Mijn instellingen → API access op app.blogdrip.com/settings. Je krijgt een `x-client-id` en een `x-client-secret`; beide moeten in elke geauthenticeerde request als HTTP-headers meegaan. Het secret wordt eenmaal getoond bij uitgifte of rotatie — kopieer het direct naar je secret manager, want je kunt het later niet meer ophalen. Credentials zijn per account; behandel ze als andere secrets en houd ze uit versiebeheer.
Hoe werkt paginatie op list-endpoints?
List-endpoints wikkelen hun responses in een `{ data, pagination }`-envelope en gebruiken 0-based paging — geef `?page=0` voor de eerste pagina, `?page=1` voor de tweede, enzovoort. Het pagination-block in de response vertelt of er meer pagina's bestaan. Als je migreert vanaf de legacy `/api/<path>`-interface, is de responsevorm ongewijzigd — alleen het basispad verhuist naar `/api/public/*`.
Ondersteunt de API webhooks?
Controleer de OpenAPI-spec op app.blogdrip.com/api/public/openapi.json voor de actuele lijst van ondersteunde callback- of event-notificatiemechanismen. Als een feature niet in de spec staat, bouw je integratie zonder ervan uit te gaan dat die bestaat — polling van de API op je eigen schema is een veilige fallback.
Is er een sandbox-omgeving?
Het definitieve antwoord staat in de actuele API-documentatie. Als er een sandbox vermeld wordt, gebruik die dan voor integratietests. Als er geen sandbox is, maak dan geen echte betaalde bestellingen tijdens geautomatiseerde tests zonder expliciete autorisatie — gebruik in plaats daarvan een dedicated testcampagne en een mens-in-de-lus review.
Kunnen API-bestellingen Instant Publishing gebruiken?
Beschikbaarheid van Instant Publishing hangt af van of de geselecteerde website een ondersteunde geautomatiseerde publicatie-integratie heeft (de BlogDrip WordPress-plugin of een Agency API-verbinding). Elke bestelling — API of handmatig — geplaatst op een geschikte website kan profiteren van geautomatiseerde publicatie. Niet elke website in de marketplace ondersteunt dit, dus je integratie moet publicatietiming per website behandelen, niet uniform.
Wat is het verschil tussen de Advertiser API en de Agency API?
De Advertiser API is bedoeld voor klanten die gastpostbestellingen vanuit hun eigen software willen automatiseren. De Agency API is bedoeld voor externe bureaus, linkbuildingplatforms en uitgeversnetwerken die hun eigen inventory aan BlogDrip willen koppelen en ondersteunde fulfillment willen automatiseren. Beide zijn standalone — het gebruik van de één vereist niet de ander.
Wat gebeurt er als ik een mislukte order creation request opnieuw probeer?
Als je geen bevestigde response hebt gezien, ga ervan uit dat de eerste request op de server mogelijk wel succesvol was. Retry niet automatisch een niet-idempotente order creation. Voeg een server-side deduplicatiesleutel toe, of zoek naar de mogelijk aangemaakte bestelling voordat je opnieuw probeert — wat het beste bij je workflow past. Een retry op een succesvolle-maar-niet-gezien bestelling veroorzaakt een dubbele afschrijving.
Klaar om je linkbuilding te automatiseren?
Open de API-documentatie, genereer je credentials en begin met bouwen. De marketplace schaalt met je automatisering — niet andersom.