---
title: "URL Info"
method: GET
path: "/url-info"
tags: ["WWW"]
---

# URL Info

`GET /url-info`

Parse, analyze and retrieve content from the supplied URL

## Query parameters

- `url` string, required
- `fetch-content` boolean
- `ignore-certificate-errors` boolean
- `timeout` integer
- `retry` integer

## Response `200`

OK

- URLInfoResponse — Structure of url-info
  - `http-status-message` string, required — The HTTP status message associated with the status code
  - `server-region` string, required — The servers IP geo-location: full region name (if detectable)
  - `query` object, required — A key-value map of the URL query parameters
  - `server-name` string, required — The name of the server software hosting this URL
  - `url-port` integer, required — The URL port
  - `server-country` string, required — The servers IP geo-location: full country name
  - `real` boolean, required — Is this URL actually serving real content
  - `server-city` string, required — The servers IP geo-location: full city name (if detectable)
  - `url-path` string, required — The URL path
  - `url` string, required — The fully qualified URL. This may be different to the URL requested if http-redirect is true
  - `valid` boolean, required — Is this a valid well-formed URL
  - `server-hostname` string, required — The servers hostname (PTR record)
  - `load-time` number, double, required — The time taken to load the URL content in seconds
  - `http-ok` boolean, required — True if this URL responded with an HTTP OK (200) status
  - `content-size` integer, required — The size of the URL content in bytes
  - `http-status` integer, required — The HTTP status code this URL responded with. An HTTP status of 0 indicates a network level issue
  - `server-country-code` string, required — The servers IP geo-location: ISO 2-letter country code
  - `content-encoding` string, required — The encoding format the URL uses
  - `server-ip` string, required — The IP address of the server hosting this URL
  - `url-protocol` string, required — The URL protocol, usually http or https
  - `content-type` string, required — The content-type this URL serves
  - `http-redirect` boolean, required — True if this URL responded with an HTTP redirect
  - `content` string, required — The actual content this URL responded with. Only set if the 'fetch-content' option was used
  - `is-timeout` boolean, required — True if a timeout occurred while loading the URL. You can set the timeout with the request parameter 'timeout'
  - `title` string, required — The document title
  - `language-code` string, required — The ISO 2-letter language code of the page. Extracted from either the HTML document or via HTTP headers
  - `is-error` boolean, required — True if an error occurred while loading the URL. This includes network errors, TLS errors and timeouts

## Other responses

- `400` — Your API request has been rejected. Check error code for details
- `403` — You have failed to authenticate
- `500` — We messed up, sorry! Your request has caused a fatal exception
- `default` — We messed up, sorry! Your request has caused an error

---

[API](https://skmtc.net/neutrinoapi/apis/neutrino-api.md) · [All operations](https://skmtc.net/neutrinoapi/apis/neutrino-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/neutrinoapi/neutrino-api/revisions/4ebd6b56de42/schema)