v1
In-guide features

Recheck the guide text against the latest information gain analysis

Réservé : en test, accès sur invitation. Reserved feature, in test, access by invitation. Accounts without access receive 403 FEATURE_NOT_AVAILABLE.

Recomputes only the guide column of the latest analysis (which facts the text states, in full or in part) without reading any competing page again. Call it after editing the text, to see the score and the missing facts move. It needs a done analysis; launch one with create_information_gain first.

Asynchronous, about 10 seconds. Wait about 10 seconds, then call get_information_gain (view=summary) until status is done or failed.

htmlContent is optional. When given, this HTML is checked (send the text as displayed, without mark tags); when omitted, the text saved in the guide is used. htmlContent is limited to 2,000,000 bytes (UTF-8) through the API, and to about 1 MB through the MCP server (the size of the whole MCP request).

Costs 5 tokens, charged when the recheck is launched (202, the body carries tokensCharged). Nothing is charged when the call is refused before the launch is attempted (invalid input, 403, 404, or 409 ANALYSIS_RUNNING and ANALYSIS_NOT_DONE read before charging). When the launch itself fails after the charge, whatever the status, the tokens are given back before the response and the body carries refunded (true when the credit is on the ledger, false when the refund failed and is logged for a manual replay). When an accepted recheck ends without a new verdict, its tokens are given back at the first read that sees it (get_information_gain), whose response then carries refunded and refundedTokens.

post/api/v1/information-gain/coverage

Request

  • Base URL: https://app.serpmantics.com (the document declares no server; this is the origin it was published from)
  • URL: https://app.serpmantics.com/api/v1/information-gain/coverage
  • Auth: HTTP bearer

Request body

guideIdstring required

ID of the guide (24 hexadecimal characters).

htmlContentstring

Optional HTML of the article to check, without mark tags. Omit it to check the text saved in the guide. At most 2,000,000 bytes (UTF-8) through the API, about 1 MB through the MCP server.

Example request

{
  "guideId": "507f1f77bcf86cd799439011"
}

Response

Recheck launched. Poll pollUrl (or call get_information_gain) until status is done or failed.

successboolean

Example response

{
  "success": true,
  "data": {
    "status": "pending",
    "tokensCharged": 5
  }
}

Changes

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