Services

PATCH /ratings/{id}

Change your rating of a seller

Scope: orders:write, or the broad write. Idempotency-Key is optional.

Only the member who left the rating. The id is the one GET services/{id}/ratings gives, or GET me/ratings for ratings of your listings (role=seller, the default; role=buyer ids are another kind of rating).

Parameters

Request body

Example request

curl -X PATCH "https://www.seoclerk.com/api/v1/ratings/1024" \
  -H "Authorization: Bearer $SEOCLERKS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"rating":"positive","comment":"Great work."}'

Response 200

{
    "data": {
        "id": 1024,
        "rating": "positive",
        "comment": "Great work."
    },
    "meta": {
        "request_id": "9f2c4e1ab07d3351"
    }
}

Errors

POST /ratings/{id}/helpful

Mark a rating helpful

Scope: account:write, or the broad write. Idempotency-Key is required.

Marking twice changes nothing. After six changes to one rating in half an hour, as on the website, the next answers 429 rate_limited.

Parameters

Example request

curl -X POST "https://www.seoclerk.com/api/v1/ratings/1024/helpful" \
  -H "Authorization: Bearer $SEOCLERKS_API_KEY" \
  -H "Idempotency-Key: markratinghelpful-1"

Response 200

{
    "data": {
        "id": 1024,
        "helpful": true,
        "helpful_total": 1
    },
    "meta": {
        "request_id": "9f2c4e1ab07d3351"
    }
}

Errors

DELETE /ratings/{id}/helpful

Take back a helpful mark

Scope: account:write, or the broad write. Idempotency-Key is optional.

Parameters

Example request

curl -X DELETE "https://www.seoclerk.com/api/v1/ratings/1024/helpful" \
  -H "Authorization: Bearer $SEOCLERKS_API_KEY"

Response 200

{
    "data": {
        "id": 1024,
        "helpful": true,
        "helpful_total": 1
    },
    "meta": {
        "request_id": "9f2c4e1ab07d3351"
    }
}

Errors

POST /ratings/{id}/reply

Reply to a rating of your listing

Scope: orders:write, or the broad write. Idempotency-Key is required.

Only the listing's seller. Sending it again changes the reply.

Parameters

Request body

Example request

curl -X POST "https://www.seoclerk.com/api/v1/ratings/1024/reply" \
  -H "Authorization: Bearer $SEOCLERKS_API_KEY" \
  -H "Idempotency-Key: replytorating-1" \
  -H "Content-Type: application/json" \
  -d '{"text":"Hello."}'

Response 200

{
    "data": {
        "id": 1024,
        "reply": "string"
    },
    "meta": {
        "request_id": "9f2c4e1ab07d3351"
    }
}

Errors

GET /services

Search the catalog, or list your own listings

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

Generated order-only listings are never listed.

Parameters

Example request

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

Response 200

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

{
    "data": [
        {
            "id": 1024,
            "seller_id": 1024,
            "title": "Logo design",
            "category_id": 1024,
            "type": 1,
            "status": 1,
            "price": {
                "amount": "12.50",
                "currency": "USD"
            },
            "delivery_days": 1,
            "created_at": "2026-10-10T14:03:22Z",
            "rating": 4.8,
            "sold_out": true,
            "position": 1
        }
    ],
    "meta": {
        "limit": 1,
        "next_cursor": "string",
        "request_id": "9f2c4e1ab07d3351"
    }
}

Errors

POST /services

Create a listing

Scope: listings:write, or the broad write. Idempotency-Key is required.

The sell form's own rules, through listing_write.php: title, description, instructions, category, price, delivery and media, then quick delivery, extras, tiers, subscription, sale, coupons, the abandoned-checkout discount, guarantee, affiliate commission, custom fields and included features. draft keeps it a draft; otherwise it goes live or to review as the website decides. Software and instant-download listings are website-only.

Parameters

Request body

Example request

curl -X POST "https://www.seoclerk.com/api/v1/services" \
  -H "Authorization: Bearer $SEOCLERKS_API_KEY" \
  -H "Idempotency-Key: createservice-1" \
  -H "Content-Type: application/json" \
  -d '{"title":"Logo design","description":"A short description.","instructions":"string","category_id":1024,"tags":"string","price":1,"delivery_days":1,"media":["string"]}'

Response 201

{
    "data": {
        "id": 1024,
        "status": 1,
        "url": "https://www.seoclerk.com/example"
    },
    "meta": {
        "request_id": "9f2c4e1ab07d3351"
    }
}

Errors

POST /services/positions

Order your own listings

Scope: listings:write, or the broad write. Idempotency-Key is required.

The order of your listings on your Manage services page. Every id must be one of your listings that is not deleted, or nothing changes (404). Each listing's position is in its reads.

Parameters

Request body

Example request

curl -X POST "https://www.seoclerk.com/api/v1/services/positions" \
  -H "Authorization: Bearer $SEOCLERKS_API_KEY" \
  -H "Idempotency-Key: setservicepositions-1" \
  -H "Content-Type: application/json" \
  -d '{"service_ids":[1]}'

Response 200

{
    "data": {
        "positions": [
            {
                "id": 1024,
                "position": 1
            }
        ]
    },
    "meta": {
        "request_id": "9f2c4e1ab07d3351"
    }
}

Errors

GET /services/{id}

A listing

Scope: listings:read, or the broad read.

A listing that is not public is visible to its seller only.

Parameters

Example request

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

Response 200

{
    "data": {
        "id": 1024,
        "seller_id": 1024,
        "title": "Logo design",
        "category_id": 1024,
        "type": 1,
        "status": 1,
        "price": {
            "amount": "12.50",
            "currency": "USD"
        },
        "delivery_days": 1,
        "created_at": "2026-10-10T14:03:22Z",
        "rating": 4.8,
        "sold_out": true,
        "position": 1,
        "description": "A short description.",
        "subscription": {
            "enabled": true,
            "interval": "string",
            "interval_days": 1
        },
        "allow_multiple": true,
        "instant_delivery": true,
        "quantity_available": 1,
        "tiers": [
            {
                "id": 1024,
                "name": "Example",
                "price": {
                    "amount": "12.50",
                    "currency": "USD"
                },
                "delivery_days": 1,
                "features": "string",
                "quick_delivery_days": "string",
                "quick_delivery_price": {
                    "amount": "12.50",
                    "currency": "USD"
                }
            }
        ]
    },
    "meta": {
        "request_id": "9f2c4e1ab07d3351"
    }
}

Errors

PATCH /services/{id}

Edit your listing

Scope: listings:write, or the broad write. The seller only; anyone else gets 404. Software and instant-download listings are edited on the website. Idempotency-Key is optional.

Only the fields sent change. publish publishes a draft. An edit that moves a live or paused listing from a category outside review into one inside sends it to review. media names image ids from POST images, or the listing's own ids as GET services/{id} gives them; left out, the gallery stays. The owner's GET services/{id} carries an editable object with exactly these fields, and sending it back changes nothing but the edit time.

Parameters

Request body

Example request

curl -X PATCH "https://www.seoclerk.com/api/v1/services/1024" \
  -H "Authorization: Bearer $SEOCLERKS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"title":"Logo design"}'

Response 200

{
    "data": {
        "id": 1024,
        "status": 1
    },
    "meta": {
        "request_id": "9f2c4e1ab07d3351"
    }
}

Errors

DELETE /services/{id}

Delete your listing

Scope: listings:write, or the broad write. The seller only; anyone else gets 404. Idempotency-Key is optional.

Parameters

Example request

curl -X DELETE "https://www.seoclerk.com/api/v1/services/1024" \
  -H "Authorization: Bearer $SEOCLERKS_API_KEY"

Response 204

No body.

Errors

POST /services/{id}/activate

Activate your listing

Scope: listings:write, or the broad write. The seller only; anyone else gets 404. Idempotency-Key is required.

Parameters

Example request

curl -X POST "https://www.seoclerk.com/api/v1/services/1024/activate" \
  -H "Authorization: Bearer $SEOCLERKS_API_KEY" \
  -H "Idempotency-Key: activateservice-1"

Response 200

{
    "data": {
        "id": 1024,
        "status": 1
    },
    "meta": {
        "request_id": "9f2c4e1ab07d3351"
    }
}

Errors

GET /services/{id}/addons

Alias of extras

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

Parameters

Example request

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

Response 200

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

{
    "data": [
        {
            "id": "string",
            "name": "Example",
            "price": {
                "amount": "12.50",
                "currency": "USD"
            },
            "delivery_days": 1,
            "quick_delivery": true,
            "quick_delivery_days": 1
        }
    ],
    "meta": {
        "limit": 1,
        "next_cursor": "string",
        "request_id": "9f2c4e1ab07d3351"
    }
}

Errors

GET /services/{id}/bumps

A listing's boost history

Scope: listings:read, or the broad read. The seller only; anyone else gets 404. Newest first, by id.

Parameters

Example request

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

Response 200

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

{
    "data": [
        {
            "id": 1024,
            "type": "string",
            "created_at": "2026-10-10T14:03:22Z",
            "paid": true,
            "rebumped": true
        }
    ],
    "meta": {
        "limit": 1,
        "next_cursor": "string",
        "request_id": "9f2c4e1ab07d3351"
    }
}

Errors

POST /services/{id}/bumps

Boost your listing

Scope: bumps:write, or the broad write. The seller only. Idempotency-Key is required.

Parameters

Request body

Example request

curl -X POST "https://www.seoclerk.com/api/v1/services/1024/bumps" \
  -H "Authorization: Bearer $SEOCLERKS_API_KEY" \
  -H "Idempotency-Key: boostservice-1" \
  -H "Content-Type: application/json" \
  -d '{"type":"free"}'

Response 201

{
    "data": {
        "id": 1024,
        "service_id": 1024,
        "spent": "string",
        "reboost": true,
        "created_at": "2026-10-10T14:03:22Z",
        "balance": {
            "free": 1,
            "paid": 1
        }
    },
    "meta": {
        "request_id": "9f2c4e1ab07d3351"
    }
}

Errors

GET /services/{id}/extras

A listing's extras

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

In stored order, not by id. Editing the listing invalidates an outstanding cursor.

Parameters

Example request

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

Response 200

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

{
    "data": [
        {
            "id": "string",
            "name": "Example",
            "price": {
                "amount": "12.50",
                "currency": "USD"
            },
            "delivery_days": 1,
            "quick_delivery": true,
            "quick_delivery_days": 1
        }
    ],
    "meta": {
        "limit": 1,
        "next_cursor": "string",
        "request_id": "9f2c4e1ab07d3351"
    }
}

Errors

POST /services/{id}/pause

Pause your listing

Scope: listings:write, or the broad write. The seller only; anyone else gets 404. Idempotency-Key is required.

Parameters

Example request

curl -X POST "https://www.seoclerk.com/api/v1/services/1024/pause" \
  -H "Authorization: Bearer $SEOCLERKS_API_KEY" \
  -H "Idempotency-Key: pauseservice-1"

Response 200

{
    "data": {
        "id": 1024,
        "status": 1
    },
    "meta": {
        "request_id": "9f2c4e1ab07d3351"
    }
}

Errors

GET /services/{id}/ratings

A listing's ratings

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

Parameters

Example request

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

Response 200

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

{
    "data": [
        {
            "id": 1024,
            "member_id": 1024,
            "rater_id": 1024,
            "service_id": 1024,
            "positive": true,
            "negative": true,
            "comment": "Great work.",
            "created_at": "2026-10-10T14:03:22Z",
            "edited_at": "2026-10-10T14:03:22Z",
            "reply": "string"
        }
    ],
    "meta": {
        "limit": 1,
        "next_cursor": "string",
        "request_id": "9f2c4e1ab07d3351"
    }
}

Errors