Public profiles API: embed huevsites anywhere

We're opening a public JSON API + embed mode for iframes, so any platform can show off your huevsite. We launched it on nordelta.tech.

Equipo huevsite
Equipo huevsite
2 min read
Share:

Your huevsite no longer lives only on huevsite.io. We're opening a public profiles API so any platform can pull in your card and your full profile. We launched it by integrating it into nordelta.tech, the tech community in the north zone: each member connects their huevsite and shows up with a custom card + the embedded profile.

The endpoint

One GET, no auth, with open CORS —the data is the same that's already visible on your public profile:

GET https://huevsite.io/api/public/profile/{username}

Response:

{
  "username": "ada",
  "name": "Ada Lovelace",
  "headline": "Building the future, one block at a time",
  "avatar": "https://.../ada.png",
  "accentColor": "#C8FF00",
  "builderScore": 420,
  "url": "https://huevsite.io/ada"
}

If the user doesn't exist, it returns 404. The response is cached for 5 minutes.

Embed mode for iframes

Beyond the JSON, any profile can be embedded without the platform's chrome (nav, footer) by adding ?embed=1:

https://huevsite.io/{username}?embed=1

That leaves the header + the builder board, ready to drop into an <iframe>. We don't block framing, so it works out of the box.

Example: card + expanded profile

Here's the idea we used on nordelta: a condensed card with the JSON data, and when you tap "View huevsite" the full profile opens in an iframe.

// 1. Fetch the data for your card
const res = await fetch(`https://huevsite.io/api/public/profile/${username}`);
const profile = await res.json();

// 2. For the expanded profile, an iframe in embed mode
<iframe src={`https://huevsite.io/${username}?embed=1`} />

With that you get avatar, name, headline, accent color and Builder Score to paint your own UI, and the full profile one click away.

Why this matters to us

huevsite is a network: the more places that show off your huevsite, the more it's worth having one. If you run a community, a directory or your own site, you can now show off your people's huevsites and send traffic right back to each builder.

Are you going to integrate it somewhere? Show us what you build.

Let's buildRRR!