Resolve a single URL to metadata

GET

/api/v1/resolve

curl --request GET \
  --url 'https://fixem.be/api/v1/resolve?url=https%3A%2F%2Fexample.com&media=proxied' \
  --header 'Authorization: Bearer <token>'

Authorizations

• bearerAuth

Parameters

Query Parameters

url

required

string format: uri

media

string

Allowed values: proxied

Responses

200

A resolve result (branch on status).

Media typeapplication/json

object

status

required

string

Allowed values: ok degraded no-adapter

platform

string

canonicalUrl

string format: uri

cacheHit

boolean

reason

string

kind

string

Allowed values: video image gallery link

title

string

description

string

author

object

name

string

url

string

siteName

string

themeColor

string

nsfw

boolean

image

object

url

string

width

integer

height

integer

video

object

url

required

Raw upstream URL

string format: uri

width

integer

height

integer

mimeType

required

string

needsProxy

required

Upstream is IP/cookie-locked

boolean

playableUrl

Signed /v/ URL

string format: uri

Example

{
  "status": "ok",
  "kind": "video"
}

Headers

X-RateLimit-Limit

integer

X-RateLimit-Remaining

integer

400

Malformed or oversized request.

Media typeapplication/json

object

error

string

Example^generated

{
  "error": "example"
}

401

Missing or invalid bearer key.

Media typeapplication/json

object

error

string

Example^generated

{
  "error": "example"
}

429

Rate limit exceeded.

Media typeapplication/json

object

error

string

Example^generated

{
  "error": "example"
}

Headers

Retry-After

integer