API


/ Base URL /

The base URL for all requests is https://seeit.lol/api/v1


/ Authentication /

You can authenticate to the seeit API using an API-KEY. The Authorization header is required on all endpoints for authentication.

When you make API requests, pass an authorization header of the following format: X-API-Key: api-key


/ Endpoint /

https://seeit.lol/api/v1/unshorten/

POST requests that accept JSON payloads and require a Content-Type header set to application/json.

The following parameters can be passed to the endpoint. They can be included in the body of the payload of POST requests:

  • u: The short URL. string required
  • f: You can get the response in XML or JSON. Default: JSON string optional
  • d: Go deeper. Default: false. boolean optional

/ Inovaction /

https://seeit.lol/api/v1/unshorten/   POST

Payload

{
	"u":"https://shorturl.at/wyUW3",
	"d":true,
	"f":"json"
}

CURL example


curl -X POST https://seeit.lol/api/v1/unshorten/
   -H 'Content-Type: application/json'
   -H "X-API-Key: API-KEY"
   -d '{"u":"https://shorturl.at/wyUW3","d":true, "f":"json"}'


JSON Response


{
	"resolvedUrl": "https://openai.com/",
	"remoteAddress": "13.107.253.40",
	"statusCode": 200,
	"statusText": "OK",
	"lastModfied": "Mon, 01 May 2023 18:52:19 GMT",
	"contentType": "text/html",
	"contentLength": "87.55 KiB",
	"page": {
		"title": "OpenAI",
		"description": "Introducing GPT-4, OpenAI’s most advanced system",
		"image": "https://openaicom.imgix.net/fb4a2ba6-9109-4c7b-af4d-cae530c3fa78/recruitment-video-poster.jpg?auto=compress%2Cformat&fit=min&fm=jpg&q=80&rect=0%2C0%2C3840%2C2160",
		"icon": "https://openai.com",
		"twitter": {
		"card": "summary_large_image",
		"creator": "@OpenAI",
		"image": "https://openaicom.imgix.net/fb4a2ba6-9109-4c7b-af4d-cae530c3fa78/recruitment-video-poster.jpg?auto=compress%2Cformat&fit=min&fm=jpg&q=80&rect=0%2C0%2C3840%2C2160"
		}
	},
	"status": 200
}	

Payload

{
	"u":"https://shorturl.at/cgHJX",
	"d":true,
	"f":"xml"
}

CURL example


curl -X POST https://seeit.lol/api/v1/unshorten/
   -H 'Content-Type: application/json'
   -H "X-API-Key: API-KEY"
   -d '{"u":"https://shorturl.at/cgHJX","d":true, "f":"xml"}'

XML Response


<response>
	<resolvedUrl>https://elpais.com/america/</resolvedUrl>
	<remoteAddress>23.222.4.140</remoteAddress>
	<server>openresty</server>
	<statusCode>200</statusCode>
	<statusText>OK</statusText>
	<lastModfied>Mon, 01 May 2023 19:24:31 GMT</lastModfied>
	<cookies>arc-geo={"georegion":"288","countrycode":"US","regioncode":"VA","timezone":"EST","continent":"NA"}; expires=Mon, 01-May-2023 19:40:37 GMT; path=/</cookies>
	<cookies>eptz=US; path=/; domain=.elpais.com</cookies>
	<cookies>hpage=2; expires=Tue, 30-Apr-2024 19:25:37 GMT; path=/; domain=.elpais.com</cookies>
	<contentType>text/html; charset=utf-8</contentType>
	<contentLength>0</contentLength>
		<page>
			<title>EL PAÍS Edición América: el periódico global</title>
			<description>Noticias de última hora de América Latina, México, Estados Unidos y la actualidad internacional: política, economía, deportes, cultura, sociedad, tecnología, gente, opinión, viajes, moda, televisión, los blogs y las firmas de EL PAÍS. Además especiales, vídeos, fotos, audios, gráficos, entrevistas y todos los servicios de EL PAÍS.</description>
			<type>website</type>
			<siteName>El País América</siteName>
			<image>https://imagenes.america.elpais.com/resizer/q1Bzvi_vytH6svtum46Q9iiKu8Q=/300x300/arc-anglerfish-eu-central-1-prod-prisa.s3.amazonaws.com/public/PSMME3J7ZBDOHK4S6ZIIFVDEAQ.png</image>
			<icon>https://static.elpais.com/dist/resources/images/favicon.ico</icon>
			<twitter/>
		</page>
	<status>200</status>
</response>		
	

Error response

seeit implements the customary HTTP response codes to signify the outcome of an API request. Response codes within the 2xx range denote success, while those within the 4xx Response codes within the 2xx range denote success, while those within the 4xx range indicate an error caused by a failed parameter, for instance. On the other hand, codes within the 5xx range denote an error originating from seeit's server.


{
	"error": "The API is limited to 10 requests per hour",
	"status": 429
}	

/ Limitations /

The utilization of the API is constrained to a maximum of 10 requests per hour.

You can request your API KEY by sending an email to [contact].

It is important to note that account creation is a manual process and can take up to 24 hours to be completed. Check your spam folder.

Is the current limit of 10 requests per hour proving to be insufficient for your needs?
Contact me at: [contact]

[Top][Index][Why][API][Contact]