SeoclerksDevelopers

Affiliates

Read only.

GET /affiliates

Affiliate click count

Scope: balance:read, or the broad read.

Parameters

NameWhereDescription
If-None-MatchheaderAn ETag from an earlier response.

Example request

curl "https://www.seoclerk.com/api/v1/affiliates" \
  -H "Authorization: Bearer $SEOCLERKS_API_KEY"

Response 200

FieldTypeDescription
clicksinteger
{
    "data": {
        "clicks": 1
    },
    "meta": {
        "request_id": "9f2c4e1ab07d3351"
    }
}

Errors

GET /affiliates/clicks

Alias of affiliates

Scope: balance:read, or the broad read.

Parameters

NameWhereDescription
If-None-MatchheaderAn ETag from an earlier response.

Example request

curl "https://www.seoclerk.com/api/v1/affiliates/clicks" \
  -H "Authorization: Bearer $SEOCLERKS_API_KEY"

Response 200

FieldTypeDescription
clicksinteger
{
    "data": {
        "clicks": 1
    },
    "meta": {
        "request_id": "9f2c4e1ab07d3351"
    }
}

Errors

GET /affiliates/earnings

Affiliate earnings posted to the balance

Scope: balance:read, or the broad read. Newest first, by id.

Parameters

NameWhereDescription
cursorquerymeta.next_cursor from the previous page. Up to 1024 characters.
limitqueryPage size. Above 100 is treated as 100. At least 1. Default 25.
If-None-MatchheaderAn ETag from an earlier response.

Example request

curl "https://www.seoclerk.com/api/v1/affiliates/earnings" \
  -H "Authorization: Bearer $SEOCLERKS_API_KEY"

Response 200

A page of these in data, with meta.limit and meta.next_cursor.

FieldTypeDescription
idinteger
amountmoney
payment_idinteger
created_attimestamp or null
sitestring
{
    "data": [
        {
            "id": 1024,
            "amount": {
                "amount": "12.50",
                "currency": "USD"
            },
            "payment_id": 1024,
            "created_at": "2026-10-10T14:03:22Z",
            "site": "SEOClerks"
        }
    ],
    "meta": {
        "limit": 1,
        "next_cursor": "string",
        "request_id": "9f2c4e1ab07d3351"
    }
}

Errors

GET /affiliates/members

Members you referred

Scope: balance:read, or the broad read. Newest first, by id.

Parameters

NameWhereDescription
cursorquerymeta.next_cursor from the previous page. Up to 1024 characters.
limitqueryPage size. Above 100 is treated as 100. At least 1. Default 25.
If-None-MatchheaderAn ETag from an earlier response.

Example request

curl "https://www.seoclerk.com/api/v1/affiliates/members" \
  -H "Authorization: Bearer $SEOCLERKS_API_KEY"

Response 200

A page of these in data, with meta.limit and meta.next_cursor.

FieldTypeDescription
idinteger
usernamestring
joined_attimestamp or null
{
    "data": [
        {
            "id": 1024,
            "username": "example",
            "joined_at": "2026-10-10T14:03:22Z"
        }
    ],
    "meta": {
        "limit": 1,
        "next_cursor": "string",
        "request_id": "9f2c4e1ab07d3351"
    }
}

Errors

GET /affiliates/payments

Payments by members you referred

Scope: balance:read, or the broad read. Newest first, by id.

Parameters

NameWhereDescription
cursorquerymeta.next_cursor from the previous page. Up to 1024 characters.
limitqueryPage size. Above 100 is treated as 100. At least 1. Default 25.
If-None-MatchheaderAn ETag from an earlier response.

Example request

curl "https://www.seoclerk.com/api/v1/affiliates/payments" \
  -H "Authorization: Bearer $SEOCLERKS_API_KEY"

Response 200

A page of these in data, with meta.limit and meta.next_cursor.

FieldTypeDescription
idinteger
order_idinteger
payment_amountmoney
statusintegerThe order's status.
cancelledboolean
credited_to_balancemoney or null
direct_paymentbooleanPaid to the seller's own gateway.
processedboolean
created_attimestamp or null
cleared_attimestamp or null
sitestring
buyer_idintegerOn balance/sales.
fee_paidbooleanOn affiliates/payments.
{
    "data": [
        {
            "id": 1024,
            "order_id": 1024,
            "payment_amount": {
                "amount": "12.50",
                "currency": "USD"
            },
            "status": 1,
            "cancelled": true,
            "credited_to_balance": {
                "amount": "12.50",
                "currency": "USD"
            },
            "direct_payment": true,
            "processed": true,
            "created_at": "2026-10-10T14:03:22Z",
            "cleared_at": "2026-10-10T14:03:22Z",
            "site": "SEOClerks",
            "buyer_id": 1024,
            "fee_paid": true
        }
    ],
    "meta": {
        "limit": 1,
        "next_cursor": "string",
        "request_id": "9f2c4e1ab07d3351"
    }
}

Errors