Jobs (Want To Buy)

GET /wtb

Search jobs, or list your own

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

Parameters

Example request

curl "https://www.seoclerk.com/api/v1/wtb" \
  -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

POST /wtb

Post a job, or a draft of one

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

The website's job form rules apply, including five jobs per 15 minutes (429 rate_limited). Images are optional.

Parameters

Request body

Example request

curl -X POST "https://www.seoclerk.com/api/v1/wtb" \
  -H "Authorization: Bearer $SEOCLERKS_API_KEY" \
  -H "Idempotency-Key: createjob-1" \
  -H "Content-Type: application/json" \
  -d '{"title":"Logo design","description":"A short description.","requirements":"string","category_id":1024,"budget":1,"delivery_days":1,"bidding_days":1,"skills":"string"}'

Response 201

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

Errors

GET /wtb/{id}

A job

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/wtb/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

PATCH /wtb/{id}

Edit your job, or publish a draft

Scope: requests:write, or the broad write. The owner. Idempotency-Key is optional.

Parameters

Request body

Example request

curl -X PATCH "https://www.seoclerk.com/api/v1/wtb/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 /wtb/{id}

Delete your job

Scope: requests:write, or the broad write. The owner. Idempotency-Key is optional.

Parameters

Example request

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

Response 204

No body.

Errors

POST /wtb/{id}/close

Close your job to new bids

Scope: requests:write, or the broad write. The owner. Idempotency-Key is required.

Parameters

Example request

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

Response 200

{
    "data": {
        "id": 1024,
        "cancelled": true
    },
    "meta": {
        "request_id": "9f2c4e1ab07d3351"
    }
}

Errors

GET /wtb/{id}/comments

Comments on a job

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

Parameters

Example request

curl "https://www.seoclerk.com/api/v1/wtb/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

POST /wtb/{id}/comments

Comment on a job, or reply to a comment

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

Parameters

Request body

Example request

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

Response 201

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

Errors

PATCH /wtb/{id}/comments/{comment_id}

Edit your comment

Scope: requests:write, or the broad write. The comment's author. Idempotency-Key is optional.

Parameters

Request body

Example request

curl -X PATCH "https://www.seoclerk.com/api/v1/wtb/1024/comments/1024" \
  -H "Authorization: Bearer $SEOCLERKS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text":"Hello."}'

Response 200

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

Errors

DELETE /wtb/{id}/comments/{comment_id}

Delete your comment, or one on your job

Scope: requests:write, or the broad write. The comment's author or the job's owner. Idempotency-Key is optional.

Parameters

Example request

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

Response 204

No body.

Errors

POST /wtb/{id}/reopen

Reopen your job

Scope: requests:write, or the broad write. The owner. Idempotency-Key is required.

Parameters

Example request

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

Response 200

{
    "data": {
        "id": 1024,
        "cancelled": true
    },
    "meta": {
        "request_id": "9f2c4e1ab07d3351"
    }
}

Errors

GET /wtb/{id}/responses

Bids on a job

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

Parameters

Example request

curl "https://www.seoclerk.com/api/v1/wtb/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

POST /wtb/{id}/responses

Bid on a job

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

Parameters

Request body

Example request

curl -X POST "https://www.seoclerk.com/api/v1/wtb/1024/responses" \
  -H "Authorization: Bearer $SEOCLERKS_API_KEY" \
  -H "Idempotency-Key: createbid-1" \
  -H "Content-Type: application/json" \
  -d '{"title":"Logo design","text":"Hello.","price":1}'

Response 201

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

Errors

DELETE /wtb/{id}/responses/{response_id}

Withdraw your bid

Scope: requests:write, or the broad write. The bidder. Idempotency-Key is optional.

Parameters

Example request

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

Response 204

No body.

Errors

POST /wtb/{id}/responses/{response_id}/order

Buy a bid with the balance

Scope: checkout:write. The broad write grant does not include it. The job's owner, or anyone when the bid's price is public. Never the bidder. Idempotency-Key is required.

The same purchase as POST orders, at the bid's price. A closed job's owner can still buy a bid.

Parameters

Request body

Example request

curl -X POST "https://www.seoclerk.com/api/v1/wtb/1024/responses/1024/order" \
  -H "Authorization: Bearer $SEOCLERKS_API_KEY" \
  -H "Idempotency-Key: orderbid-1" \
  -H "Content-Type: application/json" \
  -d '{"expected_total":"25.00"}'

Response 201

{
    "data": {
        "id": 1024,
        "service_id": 1024,
        "buyer_id": 1024,
        "seller_id": 1024,
        "title": "Logo design",
        "status": 1,
        "unit_price": {
            "amount": "12.50",
            "currency": "USD"
        },
        "quantity": 1,
        "total": {
            "amount": "12.50",
            "currency": "USD"
        },
        "paid_from": "balance",
        "request_id": 1024,
        "response_id": 1024
    },
    "meta": {
        "request_id": "9f2c4e1ab07d3351"
    }
}

Errors