Documentation

Documentation

Everything you need to query bluglink from code.

Getting started

Quickstart

Create a free account, copy your API key from the Developers page and make your first request:

curl "https://bluglink.com/api/v1/jobs?remote=true&limit=5" \
  -H "X-Api-Key: YOUR_API_KEY"

Authentication

Authenticate every request with your API key in the X-Api-Key header. Keep your key secret — rotate it from the Developers page if it leaks.

Header
X-Api-Key: YOUR_API_KEY

Response format

Responses follow JSON:API conventions: a data array of resources (id, type, attributes).

Errors

Every error response includes a JSON body with an error code and, where relevant, a message.

400Invalid query parameters
401Missing or invalid API key
404Resource not found
429Rate limit exceeded
503Service temporarily unavailable

Posts

Posts

Public posts from the network. Each call is authenticated with your API key.

GET /api/v1/posts

Public posts, newest first.

GET /api/v1/posts/:id

A single post by id.

Query parameters

limitintegerResults per page, 1–100 (default 25)
cursorstringOpaque pagination cursor from the previous response
GET /api/v1/posts?limit=1
1{2  "data": [3    {4      "id": "7c3a1e40-2f5b-4a9d-9e2b-1e0c6a9d8b3f",5      "type": "post",6      "attributes": {7        "author": { "id": 42, "name": "Ana García", "headline": "Product Designer" },8        "content": "Excited to share our new design system is live!",9        "mediaUrls": [],10        "isPromoted": false,11        "likeCount": 18,12        "commentCount": 3,13        "createdAt": "2026-10-20T14:05:00Z"14      }15    }16  ],17  "meta": { "nextCursor": "eyJpZCI6Nzh9" }18}

Jobs

Jobs

Job listings aggregated from social networks, startups and manual submissions.

GET /api/v1/jobs

Job listings, newest first.

Query parameters

sourceenumOne of: reddit, instagram, facebook, tiktok, yc, manual
categorystringExact category
remotebooleantrue / false
limitintegerResults per page, 1–100 (default 25)
curl "https://bluglink.com/api/v1/jobs?remote=true&limit=1" \
  -H "X-Api-Key: YOUR_API_KEY"
200 OK
1{2  "data": [3    {4      "id": "3f1c2b90-11aa-4e4d-9c7a-5b6d8e0f1a22",5      "type": "job",6      "attributes": {7        "title": "Remote Frontend Engineer",8        "company": "Acme Inc.",9        "location": "Worldwide",10        "remote": true,11        "source": "yc",12        "sourceUrl": "https://...",13        "category": "Programming",14        "description": "Build and ship our customer-facing dashboard in Vue 3.",15        "postedAt": "2026-10-18T09:00:00Z"16      }17    }18  ]19}

Courses

Courses

Curated course listings across categories.

GET /api/v1/courses

Course listings.

Query parameters

categorystringExact category, e.g. Marketing
limitintegerResults per page, 1–100 (default 25)
GET /api/v1/courses?category=Marketing
1{2  "data": [3    {4      "id": "c4e9f2a1-7b3d-4a10-8f2e-9d1c0b4a6e33",5      "type": "course",6      "attributes": {7        "title": "Growth Marketing Fundamentals",8        "provider": "Coursera",9        "category": "Marketing",10        "iconKey": "Megaphone",11        "url": "https://...",12        "level": "Beginner",13        "language": "en"14      }15    }16  ]17}

Want to try these without code? Open the API Playground →