referrers.md

Referrers

• Top referrers
• New referrers
• Recent referrers

Top referrers

Get the top 30 referrers.

Request

GET /domains/:domainId/referrers?sorting=top
GET /domains/:domainId/referrers?sorting=top&range=daily
GET /domains/:domainId/referrers?sorting=top&range=weekly
GET /domains/:domainId/referrers?sorting=top&range=monthly
GET /domains/:domainId/referrers?sorting=top&range=allTime

Headers

Name	Example
Authorization	Authorization: Bearer :tokenId

Response

Status: 200 OK

{
	"type": "referrers",
	"data": [
		{
			"type": "referrer",
			"data": {
				"id": "https://www.example.com/",
				"count": 1
			}
		}
	]
}

New referrers

Get the 30 most recent referrers who have linked to your site for the first time.

Request

GET /domains/:domainId/referrers?sorting=new

Headers

Name	Example
Authorization	Authorization: Bearer :tokenId

Response

Status: 200 OK

{
	"type": "referrers",
	"data": [
		{
			"type": "referrer",
			"data": {
				"id": "https://www.example.com/",
				"count": 1,
				"created": "2019-09-19T15:54:00.020Z"
			}
		}
	]
}

Recent referrers

Get the 30 most recent referrers.

Request

GET /domains/:domainId/referrers?sorting=recent

Headers

Name	Example
Authorization	Authorization: Bearer :tokenId

Response

Status: 200 OK

{
	"type": "referrers",
	"data": [
		{
			"type": "referrer",
			"data": {
				"id": "https://www.example.com/",
				"created": "2019-09-19T15:54:00.020Z"
			}
		}
	]
}