API Reference — 0w0.vc

Overview

The 0w0.vc API lets developers read public profile data programmatically — no authentication required. Use it to embed profile info in your own apps, bots, or integrations.

Opt-in only. Only profiles where the user has enabled Discover in their settings are accessible via the API. Users who have not opted in will return 404.

Base URL

https://0w0.vc/api

Endpoints

GET /api/user/@:username Fetch a user's public profile data

Path Parameters

Parameter	Type	Description
`username`	string	The user's username. Accepted with or without the leading `@` — both `alice` and `@alice` resolve to the same user.

Required Headers

Header	Value	Description
`User-Agent`	`Agent-0w0/<version>`	Required. Identifies your client. Example: `Agent-0w0/1.0`. Requests without a valid `User-Agent` matching this format return `400`.

Example Request

curl -H "User-Agent: Agent-0w0/1.0" https://0w0.vc/api/user/@alice

Response 200 OK

{
  "username": "alice",
  "displayName": "Alice",
  "bio": "Hello world!",
  "avatarUrl": "https://0w0.vc/img/<userId>/<file>",
  "backgroundUrl": "https://0w0.vc/img/<userId>/<file>",
  "backgroundIsVideo": false,
  "links": [
    {
      "label": "GitHub",
      "url": "https://github.com/alice"
    }
  ]
}

Error Responses

Status	Meaning
400	Missing or invalid `User-Agent` header (must match `Agent-0w0/<version>`)
404	User not found, not opted in to Discover, banned, or disabled
429	Rate limit exceeded

Notes

avatarUrl and backgroundUrl are empty strings if the user has not set them.
backgroundIsVideo is true when the background is a video file.
Links are returned in display order.
Users can opt out of Discover at any time — subsequent API calls will return 404.

Rate Limits

The API shares the platform-wide rate limit. Excessive requests will receive a 429 response. There is no separate API key system — the API is intended for lightweight lookups, not bulk scraping.