stackinfolio

API

Your projects and stats as JSON, plus README badges.

https://www.stackinfolio.dev/api/public
GET/api/public/users/{username}

Profile, tech stack, links, experience and projects.

data

username
string
name · headline · bio · location
string | null
availability
string | null · OPEN_TO_WORK, OPEN_TO_FREELANCE or null
avatarUrl · githubUsername
string | null
profileUrl
string
joinedAt
date
stacks
string[] · e.g. React, Postgres
links
{ icon, url }[]
experience
Experience[] · newest first
projects
Project[] · newest first

Experience

kind
string · ROLE, CERTIFICATE or MILESTONE
title
string
org · url · description
string | null
startsOn
date · first of the month
endsOn
date | null · null while a role is current

Project

name · slug · description · url
string
status
string · BUILDING, LIVE, PAUSED or ARCHIVED
tag · category · emoji
string | null
coverUrl
string | null · null means the default cover is shown
hearts
number
shippedAt
date | null
createdAt
date
profileUrl
string · the project page
GET/api/public/users/{username}/journey

Latest 20 public Journey posts, newest first.

data

id
string
html
string · the post as written
text
string · plain text, for READMEs
imageUrl
string | null
hearts · replies
number
project
{ name, slug }
createdAt
date
url
string
GET/api/public/meAPI key

Your own stats, including what profiles don't show. Needs your API key.

data

followers · following
{ count, people[] } · people: newest 100
views.profile
{ total, last7Days }
views.projects
{ total, last7Days }
hearts
{ received, given }
projects
{ name, hearts, views, viewsLast7Days, … }[]
loved
{ name, owner, profileUrl, lovedAt }[] · projects you hearted
xp
{ total, today, level, xpIntoLevel, xpForNextLevel }

Person

username · profileUrl
string
name · avatarUrl
string | null
since
date · when they followed
Show your projects (JavaScript)
const res = await fetch("https://www.stackinfolio.dev/api/public/users/{username}");
const { data } = await res.json();

data.projects.forEach((p) => console.log(p.name, p.status, p.url));
Your stats (terminal or server)
curl https://www.stackinfolio.dev/api/public/me \
  -H "Authorization: Bearer $STACKINFOLIO_KEY"

Make your key in Settings. Keep it secret: /me only works from a server or build step, not from browser code.

Good to know

  • •Every response is { data } or { error }. Dates are ISO 8601 (UTC).
  • •404 unknown user · 401 missing or bad key · 429 over 60 calls a minute, wait 60s.
  • •Public data is cached for 5 minutes, your stats for 1. Calling more often won't get newer data.
  • •Public endpoints return only what profiles already show, and work from any website.

README badges

/badge/{username}.svg?type=…&style=… · /badge/{username}/{project}.svg

Type a username above to see its badges.