About this API
Returns a paginated list of tracked links for a campaign with click counts. Supports search by URL or token.
Authentication
Include your API credential in the request header. Keep credentials on the server and never expose them in client-side applications.
Authorization: Bearer <TOKEN>YOUR_ACCESS_TOKENPath Parameters
Substitute these placeholders in the endpoint URL before sending the request.
idstringRequiredID of the campaign to retrieve link analytics for.Query Parameters
Append these values to the URL query string. Omit optional parameters when they are not needed.
pageintegerNot specifiedPage number (1-indexed).limitintegerNot specifiedNumber of rows per page (max 100).searchstringNot specifiedSearch term applied to original URL or token.Request Details
Provide identifiers in the path and any supported values in the query string.
Code Examples
Select your language and customize the request URL. Credential placeholders are intentionally preserved so secrets never appear in generated samples.
curl --request GET 'https://email.1spoc.com/api/user/campaigns/{id}/link-analytics' \
--header 'Authorization: Bearer <TOKEN>'
const response = await fetch('https://email.1spoc.com/api/user/campaigns/{id}/link-analytics', {
method: 'GET',
headers: {
"Authorization": "Bearer <TOKEN>"
},
});
if (!response.ok) throw new Error(`HTTP ${response.status}`);
const data = await response.json();
console.log(data);
const response = await fetch('https://email.1spoc.com/api/user/campaigns/{id}/link-analytics', {
method: 'GET',
headers: {
"Authorization": "Bearer <TOKEN>"
},
});
if (!response.ok) throw new Error(`HTTP ${response.status}`);
const data = await response.json();
console.log(data);
import json
import requests
url = 'https://email.1spoc.com/api/user/campaigns/{id}/link-analytics'
headers = {
"Authorization": "Bearer <TOKEN>"
}
response = requests.get(url, headers=headers)
response.raise_for_status()
print(response.json())
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
var client = HttpClient.newHttpClient();
var request = HttpRequest.newBuilder(URI.create("https://email.1spoc.com/api/user/campaigns/{id}/link-analytics"))
.header("Authorization", "Bearer <TOKEN>")
.method("GET", HttpRequest.BodyPublishers.noBody())
.build();
var response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.statusCode());
System.out.println(response.body());
<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => 'https://email.1spoc.com/api/user/campaigns/{id}/link-analytics',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CUSTOMREQUEST => 'GET',
CURLOPT_HTTPHEADER => ["Authorization: Bearer <TOKEN>"],
]);
$response = curl_exec($curl);
if ($response === false) throw new Exception(curl_error($curl));
curl_close($curl);
echo $response;
using System.Net.Http.Headers;
using System.Text;
using var client = new HttpClient();
client.DefaultRequestHeaders.Authorization = AuthenticationHeaderValue.Parse("Bearer <TOKEN>");
var response = await client.GetAsync("https://email.1spoc.com/api/user/campaigns/{id}/link-analytics");
response.EnsureSuccessStatusCode();
Console.WriteLine(await response.Content.ReadAsStringAsync());
package main
import (
"fmt"
"io"
"net/http"
)
func main() {
request, err := http.NewRequest("GET", "https://email.1spoc.com/api/user/campaigns/{id}/link-analytics", nil)
if err != nil { panic(err) }
request.Header.Set("Accept", "application/json")
request.Header.Set("Authorization", "Bearer <TOKEN>")
response, err := http.DefaultClient.Do(request)
if err != nil { panic(err) }
defer response.Body.Close()
data, err := io.ReadAll(response.Body)
if err != nil { panic(err) }
if response.StatusCode >= 400 { panic(fmt.Sprintf("HTTP %d: %s", response.StatusCode, data)) }
fmt.Println(string(data))
}
Response
A successful request returns the documented response payload. Delivery and asynchronous events may arrive separately through configured webhooks.
{}
{
"type": "object",
"properties": {
"data": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid"
},
"token": {
"type": "string",
"example": "abc123"
},
"ipAddress": {
"type": "string",
"example": "192.0.2.1",
"nullable": true
},
"clickCount": {
"type": "integer",
"example": 42
},
"originalUrl": {
"type": "string",
"example": "https://example.com/sale"
}
}
}
},
"filters": {
"type": "object",
"properties": {
"search": {
"type": "string",
"example": "example.com",
"nullable": true
}
}
},
"campaignId": {
"type": "string",
"format": "uuid"
},
"pagination": {
"type": "object",
"properties": {
"page": {
"type": "integer",
"example": 1
},
"limit": {
"type": "integer",
"example": 10
},
"totalPages": {
"type": "integer",
"example": 3
},
"totalRecords": {
"type": "integer",
"example": 25
}
}
}
}
}
Status Codes
200Campaign link analytics retrieved successfully.400Invalid request parameters.401Unauthorized (missing or invalid user access token)404Campaign not found or deleted.500Internal server error