Cookies Scanner API

Cookies Scanner API - ckScanAPI (also known as Cookies Detector API) is a cross browsers REST API which get a JSON input with a string containing a url of a webpage (this is NOT a crawler for pages in a website, so you have to make requests to each page of the website you need to be scanned for cookies) and returns a JSON string which contains details about each cookie detected on the webpage as you may see at the response parameters below. Our cookies scanner detects both first-party cookies and third-party cookies. The response to each request it may take some time depending on how big is the webpage to be scanned for cookies.

Allthough this Automatic Cookies Scanner API (currently we do not offer a Cookies Scanner sdk) is intended for software development and therefore developers, we have also here an Cookies Scanner online application that may be used to check the input and output JSONs of the API. The necessary steps are written below, basically for this real time Cookies Scanner API you send an authorized POST request in JSON format to the API endpoint and you get as JSON response the output as described below through parameters and examples.

This Cookies Scanner API is useful for domains like building apps for detection of cookies related with European GDPR cookies, Californian CCPA cookies, Brazilian LGPD cookies, Canadian PIPEDA cookies, e-commerce and presentations websites, blogs, social etc. You own the commercial copyright of the resulted JSON with no additional fee meaning you may use it in your own apps for sale.

For using our Cookies Scanner API and/or APP you must create an account (free of charge, no card required), activate it from your received email, login and then start your TRIAL package with no fees as you can see at our pricing packages. After you have tested the API and/or APP and you are satisfied, you may buy a paid package. You will always see at your Admin Console page the real resources consumption in real time, your invoices, you may see/edit/delete your profile or export log consents as GDPR instructed, you may read our FAQs.

Cookies Scanner APP

Url of the webpage



API Endpoint (method POST):
https://gatiosoft.ro/ckscanapi.aspx
Headers:
Authorization: Basic //Your username:password are base64 encoded string
Content-Type: application/json
Accept: application/json
JSON Request Body (change inputs here and see in real time below):
                   {
  "url": "https://example.com"
}
               
JSON Response From API (change inputs here and see in real time below):
{
  "cookies": [
    {
      "name": "YSC",
      "value": "MRnYlVbJcwY",
      "domain": ".youtube.com",
      "path": "/",
      "expires": -1.0,
      "size": 14,
      "httpOnly": true,
      "secure": true,
      "session": true,
      "sameSite": "None",
      "priority": "Medium",
      "sameParty": false,
      "sourceScheme": "Secure",
      "sourcePort": 443
    },
    {
      "name": "VISITOR_INFO1_LIVE",
      "value": "aB-XAYXXGNQ",
      "domain": ".youtube.com",
      "path": "/",
      "expires": 1.69984077E+09,
      "size": 29,
      "httpOnly": true,
      "secure": true,
      "session": false,
      "sameSite": "None",
      "priority": "Medium",
      "sameParty": false,
      "sourceScheme": "Secure",
      "sourcePort": 443
    }
  ]
}
JSON Response (Example) From API in case of ERROR:

 [
  {
    "cd": "1001",
    "description": "The authorization header Is either empty Or isn't Basic"
  }
]

Request Parameters Table

Parameter Name
Parameter Description
url
This is the url of the webpage to be scanned for cookies [string].

Response Parameter Table

Parameter Name
Parameter Description
name 
This is the name as  [string] of the cookie.
value
This is the value as  [string] of the cookie.
domain
This is the domain as [string] of the cookie.
path
This is the path as [string] of the cookie.
expires
This is the expiration date as [integer] of the cookie in UNIX time.
size
This is the size as[integer] of the cookie in bytes.
httpOnly
This parameter is [boolean] and the values may be "true" or "false".
secure
This parameter is [boolean] and the values may be "true" or "false".
session
This parameter is [boolean] and the values may be "true" or "false".
sameSite
This parameter as [string] is used to designate cookie for cross-site access.
priority
This parameter as [string] specifies the level of cookie priority.
sameParty
This parameter is [boolean] and specifies if cookie is allowed to be set or sent in contexts where all ancestor frames belong to the same First-Party Set.
sourceScheme
This is parameter as [string] specifies the type of the cookie.
sourcePort
This parameter as [integer] specifies the cookie source port. Valid values are {-1, [1, 65535]}, -1 indicates an unspecified port. An unspecified port value allows protocol clients to emulate legacy cookie scope for the port..

Response Error Codes Table

Parameter Name
Parameter Description
cd

This is the error code which may be:

  • 1001
  • 1002
  • 1003
  • 1004
  • 1005
  • 1006
  • 1007
  • 1008
  • 1009
  • 1010
  • 1011
  • 1012
  • 1013
  • 1014
  • 1015
  • 1016
  • 2001
description

This is the description of the error code which may be:

  • 1001 - The authorization header is either empty or isn't Basic.
  • 1002 - Daily requests number exceeded in TRIAL mode!
  • 1003 - Trial expired!
  • 1004 - Requests number exceeded!
  • 1005 - Package expired!
  • 1006 - No invoice!
  • 1007 - Reader is NULL for TRIAL!
  • 1008 - Cannot Read if TRIAL exists!
  • 1009 - Error connecting to database looking for TRIAL! (and a detailed description message of the encountered error)
  • 1010 - Reader is NULL for Invoice!
  • 1011 - Cannot Read if Invoice exists!
  • 1012 - Error connecting to database! (and a detailed description message of the encountered error)
  • 1013 - Input request too long! Maximum 20 chars per request are allowed / Nothing to upload / Only Digits allowed
  • 1014 - Invalid request data! (and a detailed description message of the encountered error)
  • 2001 - Invalid request data after passing to the API (and a detailed description message of the encountered error)

Source Code Examples for Using Our Cookies Scanner API

                       
Imports System
Imports System.Text
imports System.Collections.Generic
Imports System.Net
Imports Newtonsoft.Json

Public Class cookies_scanner_api
    Public Class ResponseFields
        Public Property cookies As New List(Of ckFields)
    End Class
    Public Class ckFields
        Public Property name As String
        Public Property value As String
        Public Property domain As String
        Public Property path As String
        Public Property expires As Integer
        Public Property size As Integer
        Public Property httpOnly As Boolean
        Public Property secure As Boolean
        Public Property session As Boolean
        Public Property sameSite As String
        Public Property priority As String
        Public Property sameParty As Boolean
        Public Property sourceScheme As String
        Public Property sourcePort As Integer
    End Class

    Public Class ErrorFields
        Public Property cd As String
        Public Property description As String
    End Class

    Protected Sub SendRequest()
        Dim Client As WebClient = New WebClient()
        Dim credentials As String = Convert.ToBase64String(Encoding.ASCII.GetBytes("your_username:your_password"))
        Client.Headers(HttpRequestHeader.Authorization) = String.Format("Basic {0}", credentials)
        Client.Headers(HttpRequestHeader.Accept) = "application/json"
        Client.Headers(HttpRequestHeader.ContentType) = "application/json"
	Client.BaseAddress = "https://gatiosoft.ro/ckscanapi.aspx"
        Dim resString As String = ""

        Try
            Dim js As String = "Replace this string with your JSON Request Body string like in the example above on the website"
            Dim reqString As Byte() = Encoding.UTF8.GetBytes(js)
            Dim url As Uri = New Uri(Client.BaseAddress)
            Dim resByte As Byte() = Client.UploadData(url, "post", reqString)
            resString = Encoding.UTF8.GetString(resByte)

	    If resString.IndexOf("httpOnly") > 0 Then
                Dim r As ResponseFields = New ResponseFields()
                r = JsonConvert.DeserializeObject(Of ResponseFields)(resString)
                Console.Write(resString)
            Else
		Dim e As list(of ErrorFields) = New list(of ErrorFields)
		e = JsonConvert.DeserializeObject(Of list(of ErrorFields))(resString)
                Console.Write(e(0).cd)
                Console.Write(e(0).description)
            End If

            Client.Dispose()
        Catch exception As Exception
            Dim ex As System.Exception = exception
            Console.Write("ERROR: " & resString & ex.Message)
        End Try
    End Sub

    Public Shared Sub Main()
	Dim b As cookies_scanner_api = New  cookies_scanner_api
        b.SendRequest()
    End Sub
End Class



ckScanAPI Online Video Presentation

Cookies Scanner API, ckScanAPI is in the video presentation below. There are several search terms which you may use like: Cookies Scanner api, Cookies Scanner sdk, Cookies Scanner c#, Cookies Scanner online, Cookies Scanner, automatic Cookies Scanner, Cookies Scanner python, Cookies Scanner python, real time Cookies Scanner python, python Cookies Scanner, Cookies Detector.

 



Pricing Packages

Please choose one of the below pricing packages for start using our Cookies Scanner API and online APP!

Start TRIAL
No catches

  • 7 days TRIAL
  • Use our cloud REST API and online APP
  • Maximum 50 requests per DAY in trial period
  • You do NOT own the commercial copyright for using the API in your apps in trial period.
  • Get First-Party cookies.
  • Get Third-Party cookies.
  • Get all details from each detected cookie.
  • Unlimited Devices
  • Administration console
  • Support through online chat and/or tickets
  • We do NOT allow spam accounts for TRIAL



Monthly TIER
Popular

  • 80 USD per month
  • Use our cloud REST API and online APP
  • Maximum 10000 requests per month
  • Maximum 1 requests per MINUTE
  • You own the commercial copyright to use it in your apps.
  • Get First-Party cookies.
  • Get Third-Party cookies.
  • Get all details from each detected cookie.
  • Unlimited Devices
  • Administration console
  • Premium support through online chat and/or tickets, very supportive help and quick responses.



Yearly TIER
(15% Discount)

  • 816 USD per year
  • Use our cloud REST API and online APP
  • Maximum 10000 requests per month
  • Maximum 1 requests per MINUTE
  • You own the commercial copyright to use it in your apps.
  • Get First-Party cookies.
  • Get Third-Party cookies.
  • Get all details from each detected cookie.
  • Unlimited Devices
  • Administration console
  • Premium support through online chat and/or tickets, very supportive help and quick responses.



Note: VAT rate may be added or not, function to your country and/or if you are a taxable person or company.