owo

API Docs

Notice

The owo.vc link generation API has been disabled until further notice due to abuse and overwhelming amounts of spam. It became no longer feasible to continue running the service for the small amount of legitimate users that exist. The original API documentation exists below.


The owo.vc API is allowed for programmatic use to anyone free of charge. Abuse of the API can and will lead to access being revoked. It is requested that you provide contact information in the User-Agent header, but not required.

POST /api/v2/link

Generates a new link. Requires a JSON body with the following structure.

{ "link": "https://gordhoard.org", "generator": "owo", "metadata": "OWOIFY" }

link is a valid HTTP/S scheme link that the user is to be redirected to.

generator is the generator format to use. Currently owo, gay, zws, and sketchy are available.

metadata is a string that determines how metadata for the shortened link should be handled. It can have the follow values:

GET /api/v2/link/:link

Return current information on the given owo.vc link. Link must be encoded as a URI component.

Deprecated Endpoints

As of 2023-11-12, the /generate and /info endpoints have been removed. Please update to the new v2 API.