Sending Signals

24 March 2025

POSThttps://signals.gse.live/report /signal

Create a signal

Insert a set of new rows to the Signal feed

Attributes

Name
signal
Type
mediumstring
Description
The signal you want to share.
Name
report_date
Type
datetime
Description
Date & time the signal was reported.

Name

abuse_type

Type

string

Description

The type of abuse this signal represents. Must be one of the following types...

Value	Description
cloaking	Use this for Cloaking Identifiers
copyright	Use this for Copyright Identifiers
exploit	Use this for Exploit identifiers
fraud	Use this for Fraud Identifiers
impersonation	Use this for Impersonation Identifiers
malware	Use this for Malware Identifiers
phishing	Use this for Phishing Identifiers
piracy	Use this for Piracy Identifiers
scam	Use this for Scam identifiers
spam	Use this for Spam identifiers
trademark	Use this for Trademark Identifiers
unspecified	Use this for Unspecified -

If you would like to send us a different abuse type, please contact us

Name
predictive
Type
boolean (optional)
Description
An indication that this signal was generated using an algorithm rather than confirmed report.
Name
confidence_score
Type
integer (optional)
Description
The type of signal. If supplied, must be one of the following...
Name
signal_type
Type
string (optional)
Description
The type of signal. If supplied, must be one of the following...
Value Description
url https://signalexchange.test/pathname
hostname subdomain.signalexchange.test
domain name signalexchange.test
ip address 123.45.67.189
If not supplied we will attempt to detect this.
If you would like to send us a different signal type, please contact us

Value	Description
url	https://signalexchange.test/pathname
hostname	subdomain.signalexchange.test
domain name	signalexchange.test
ip address	123.45.67.189

Request

POST . /signal
curl -X POST https://signals.gse.live/report/signal \
  -H "API-KEY: 4tqaTgMkBAUzAgUI" \
  -H "API-SECRET: z0xgqjREXCMmnlYI" \

Payload

[
  {
    "signal": "https://somesignal.com",
    "report_date": "2020-01-23 14:24:06",
    "abuse_type": "phishing",
    "predictive": false,
    "signal_type": "url",
  },
// ...
]

GEThttps://signals.gse.live/report /signal

List all of the signals you have sent

Return all of the imported signals you have uploaded via your account.

Attributes

Name
limit
Type
integer
Description
Limit the number of results to the supplied number Defaults to 50. Max 10000
Name
offset
Type
integer
Description
Offset the results by the supplied number. Defaults to 0
Name
sort
Type
string
Description
Sort the results by supplying a column name and direction. eg signal|desc

Name

filter_{COLUMNNAME}

Type

string

Description

Filtering of the returned data can be effected by supplying parameters of the format filter_COLUMNNAME. The parameter value can either be simply a value for exact match filtering or a value followed by a | and a match type which should be one of the following values:

Value	Description
eq	for an equals match
neq	for a not equals match
null	for a null match
notnull	for a not null match
gt	for a greater than match
lt	for a less than match
gte	for a greater than or equals match
lte	for a less than or equals match
startswith	for a string starts with match
endswith	for a string ends with match
contains	for a string contains match

Example: filter_signal=somesignal|contains

Request

GET . /signal
curl -X GET https://signals.gse.live/report/signal \
  -H "API-KEY: 4tqaTgMkBAUzAgUI" \
  -H "API-SECRET: z0xgqjREXCMmnlYI" \
  -d limit=[[value]] \
  -d offset=[[value]] \
  -d sort=[[value]] \
  -d filter_{COLUMNNAME}=[[value]] \

Response

[
  {
    "signal": "https://somesignal.com",
    "report_date": "2020-01-23 14:24:06",
    "abuse_type": "phishing",
    "predictive": false,
    "signal_type": "url",
  },
// ...
]