API Documentation
Automate directory submissions programmatically. API access is available on Pro ($199) and Agency ($399) tiers.
Authentication
All authenticated endpoints require a Bearer token or API key in the request header:
# Using JWT token
Authorization: Bearer <access_token>
# Using API key (Pro/Agency only)
x-api-key: bk_live_xxxxxxxxxxxxxAccess tokens expire after 15 minutes. Use the refresh token endpoint to get a new one.
Rate Limits
Endpoints
/api/v1/auth/loginAuthenticate and get JWT access + refresh tokens
/api/v1/sitesList all your registered sites
/api/v1/sitesRegister a new site for directory submission
/api/v1/directoriesBrowse available directories (filtered by your tier DR cap)
/api/v1/directories/explorePublic directory explorer (limited fields, no auth required)
/api/v1/jobsCreate a submission job for a site + directory list
/api/v1/jobs/:idGet job status and progress details
/api/v1/backlinksList all discovered backlinks for your sites
/api/v1/directories/check-backlinksCheck if backlinks are live (up to 10 URLs per request)
/api/v1/api-keysCreate an API key for programmatic access
/api/v1/users/meGet current user profile and subscription details
Quick Start
Submit your site to directories in 3 API calls:
# 1. Login
curl -X POST https://backlynk.io/api/v1/auth/login \
-H "Content-Type: application/json" \
-d '{"email":"[email protected]","password":"..."}'
# 2. Add your site
curl -X POST https://backlynk.io/api/v1/sites \
-H "Authorization: Bearer <token>" \
-H "Content-Type: application/json" \
-d '{"url":"https://yoursite.com","name":"Your Site","description":"..."}'
# 3. Start submissions
curl -X POST https://backlynk.io/api/v1/jobs \
-H "Authorization: Bearer <token>" \
-H "Content-Type: application/json" \
-d '{"site_id":"<site_id>","directory_ids":[1,2,3,4,5]}'Full response schemas and error codes are available in the interactive API reference (coming soon).
SDKs & Libraries
Official JavaScript/Python SDKs are coming soon. In the meantime, use the REST API directly with any HTTP client.