OPEN API

Authenticate and get a Bearer token

post

Returns a Bearer token in exchange for client credentials.

Authorizations

BearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

client_idstringRequired

The client ID for authentication.

client_secretstringRequired

The client secret for authentication.

Responses

200

Authentication successful, returns a Bearer token.

application/json

400

Bad Request. Invalid client credentials.

401

Unauthorized. Authentication failed.

post

/auth

HTTPcURLJavaScriptPython

POST /auth HTTP/1.1
Host: community.webamon.co.uk
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 43

{
  "client_id": "text",
  "client_secret": "text"
}

{
  "bearer": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
}

Submit URL/Domain to Sandbox

post

Scan A URL to retrieve 1st & 3rd party; resources, networks, locations, domains, dns, technology, screenshot, page DOM, certificates and more.

Authorizations

BearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

submission_urlstringOptionalExample: https://webamon.co.uk

Responses

200

Scan submission successful

No content

401

Unauthorized - Invalid or missing Bearer token

application/json

post

/scan

HTTPcURLJavaScriptPython

POST /scan HTTP/1.1
Host: community.webamon.co.uk
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 42

{
  "submission_url": "https://webamon.co.uk"
}

No content

Hunt Across All Sandbox Reports

get

Lucene query every available fields found in scan reports

Authorizations

BearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

urlparamsstringOptional

Optional query parameters to filter reports.

Responses

200

Returned reports matching query

No content

401

Unauthorized - Invalid or missing Bearer token

application/json

get

/report

HTTPcURLJavaScriptPython

GET /report HTTP/1.1
Host: community.webamon.co.uk
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

No content

Retrieve Full Scan Report

get

Retrieves a specific scan report by its ID

Authorizations

BearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

report_idstringRequired

The ID of the report to retrieve.

Responses

200

Details of the requested report

No content

401

Unauthorized - Invalid or missing Bearer token

application/json

404

Not Found - Report not found

application/json

get

/report/{report_id}

HTTPcURLJavaScriptPython

GET /report/{report_id} HTTP/1.1
Host: community.webamon.co.uk
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

No content

Hunt Across All Hosting Domains

get

Lucene query every available fields found in domain records.

Authorizations

BearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

urlparamsstringOptional

Optional query parameters to filter domains.

Responses

200

List of domains

No content

401

Unauthorized - Invalid or missing Bearer token

application/json

get

/domain

HTTPcURLJavaScriptPython

GET /domain HTTP/1.1
Host: community.webamon.co.uk
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

No content

Retrieve Full Domain Record

get

Retrieves a specific domain record by its name

Authorizations

BearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

namestringRequired

The name of the domain to retrieve.

Responses

200

Details of the requested domain

No content

401

Unauthorized - Invalid or missing Bearer token

application/json

404

Not Found - Domain not found

application/json

get

/domain/{name}

HTTPcURLJavaScriptPython

GET /domain/{name} HTTP/1.1
Host: community.webamon.co.uk
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

No content

Hunt Across All Servers Hosting Web Infrastructure

get

Lucene query every available fields found in server records.

Authorizations

BearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

urlparamsstringOptional

Optional query parameters to filter servers.

Responses

200

List of servers

No content

401

Unauthorized - Invalid or missing Bearer token

application/json

get

/server

HTTPcURLJavaScriptPython

GET /server HTTP/1.1
Host: community.webamon.co.uk
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

No content

Retrieve Full Server Record

get

Retrieve a full server record by its ip.

Authorizations

BearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

ipstringRequired

The IP address of the server to retrieve.

Responses

200

Details of the requested server

No content

401

Unauthorized - Invalid or missing Bearer token

application/json

404

Not Found - Server not found

application/json

get

/server/{ip}

HTTPcURLJavaScriptPython

GET /server/{ip} HTTP/1.1
Host: community.webamon.co.uk
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

No content

Search Raw Content Across All Web Resources

get

Lucene query every available fields found in resource records, including the raw content.

Authorizations

BearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

param1stringOptional

A query parameter for filtering.

param2stringOptional

Another query parameter for filtering.

Responses

200

Successful response

application/json

400

Bad Request

401

Unauthorized

get

/resource

HTTPcURLJavaScriptPython

GET /resource HTTP/1.1
Host: community.webamon.co.uk
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "data": [
    {}
  ]
}

Retrieve Raw Resource

get

Get a specific resource by its SHA256 identifier.

Authorizations

BearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

sha256string · sha256Required

SHA256 identifier of the resource.

Responses

200

Successful response

application/json

401

Unauthorized

404

Not Found

get

/resource/{sha256}

HTTPcURLJavaScriptPython

GET /resource/{sha256} HTTP/1.1
Host: community.webamon.co.uk
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "data": {}
}

Retrieve a screenshot

get

Get a screenshot by report ID.

Authorizations

BearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

report_idstringRequired

Identifier of the report.

Responses

200

Successful response

image/png

Responsestring · binary

401

Unauthorized

404

Not Found

get

/screenshot/{report_id}

HTTPcURLJavaScriptPython

GET /screenshot/{report_id} HTTP/1.1
Host: community.webamon.co.uk
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

binary

Submit Prompt to Webamon AI Model

post

Submit a prompt to the Webamon AI Model.

Authorizations

BearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

promptstringOptional

Responses

200

Successful response

application/json

400

Bad Request

401

Unauthorized

post

/web-assist

HTTPcURLJavaScriptPython

POST /web-assist HTTP/1.1
Host: community.webamon.co.uk
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 17

{
  "prompt": "text"
}

{
  "status": "scan initiated"
}