public-blog-votes

Vote on article helpfulness

Record an anonymous "Was this article helpful?" vote. One vote per voterKey per post: voting again changes the vote instead of adding one. Returns the updated counts. Rate-limited per IP.

post/public/blog/{slug}/helpful

Request

  • Base URL: https://api.aiapplyd.com/api/v1
  • URL: https://api.aiapplyd.com/api/v1/public/blog/{slug}/helpful
  • Auth: HTTP bearer

Path parameters

slugstring required

Blog post slug.

Example:how-to-beat-applicant-tracking-systems

Request body

helpfulboolean required

true = the article was helpful, false = it was not.

voterKeystring required

Opaque anonymous id generated and kept by the reader's browser. One vote per key per post; voting again changes the vote.

Example request

{
  "helpful": true,
  "voterKey": "k3v9Q2xL_7aB"
}

Response

Updated vote counts for the post.

successtrue required

Example response

{
  "data": {
    "counts": {
      "helpful": 42,
      "notHelpful": 3
    }
  },
  "meta": {
    "duration": 150,
    "requestId": "req_abc123",
    "timestamp": "2026-10-13T10:27:20.268Z",
    "version": "v1"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.