Trades (Want To Trade)

GET /wtt

Search trades, or list your own

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

Read only: trades can no longer be created.

Parameters

Example request

curl "https://www.seoclerk.com/api/v1/wtt" \
  -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,
            "title": "Logo design",
            "description": "A short description.",
            "category_id": 1024,
            "budget": {
                "amount": "12.50",
                "currency": "USD"
            },
            "delivery_days": 1,
            "created_at": "2026-10-10T14:03:22Z",
            "status": 1,
            "cancelled": true,
            "tags": "string",
            "skills": "string",
            "requirements": "string",
            "offering": "string",
            "images": [
                {}
            ]
        }
    ],
    "meta": {
        "limit": 1,
        "next_cursor": "string",
        "request_id": "9f2c4e1ab07d3351"
    }
}

Errors

GET /wtt/{id}

A trade

Scope: listings:read, or the broad read. Live requests, or your own in any state.

Parameters

Example request

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

Response 200

{
    "data": {
        "id": 1024,
        "member_id": 1024,
        "title": "Logo design",
        "description": "A short description.",
        "category_id": 1024,
        "budget": {
            "amount": "12.50",
            "currency": "USD"
        },
        "delivery_days": 1,
        "created_at": "2026-10-10T14:03:22Z",
        "status": 1,
        "cancelled": true,
        "tags": "string",
        "skills": "string",
        "requirements": "string",
        "offering": "string",
        "images": [
            {
                "id": "string",
                "url": "https://www.seoclerk.com/example"
            }
        ]
    },
    "meta": {
        "request_id": "9f2c4e1ab07d3351"
    }
}

Errors

GET /wtt/{id}/comments

Comments on a trade

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

Parameters

Example request

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

Response 200

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

{
    "data": [
        {
            "id": 1024,
            "parent_id": 1024,
            "member_id": 1024,
            "text": "Hello.",
            "created_at": "2026-10-10T14:03:22Z",
            "updated_at": "2026-10-10T14:03:22Z"
        }
    ],
    "meta": {
        "limit": 1,
        "next_cursor": "string",
        "request_id": "9f2c4e1ab07d3351"
    }
}

Errors

GET /wtt/{id}/responses

Offers on a trade

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

Parameters

Example request

curl "https://www.seoclerk.com/api/v1/wtt/1024/responses" \
  -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,
            "service_id": 1024,
            "title": "Logo design",
            "text": "Hello.",
            "price_public": true,
            "price": {
                "amount": "12.50",
                "currency": "USD"
            },
            "multiple_quantity": true,
            "created_at": "2026-10-10T14:03:22Z"
        }
    ],
    "meta": {
        "limit": 1,
        "next_cursor": "string",
        "request_id": "9f2c4e1ab07d3351"
    }
}

Errors