Batch categorization

Batch categorization

ParseRail categorizes up to a hundred products, transactions, or tickets against your taxonomy in one call. Each item includes a confidence.

Cost: 3 credits ($0.03) — charged only on success.

post/v1/categorize

Request

  • Base URL: https://api.thecompound.tech
  • URL: https://api.thecompound.tech/v1/categorize
  • Auth: HTTP bearer

Headers

ParseRail-Dry-Run'1' | 'true'

Send 1 to dry-run the call. ParseRail runs auth, the throttle, body validation and the balance precheck. It returns 200 with the cost and the status a live call would get. No model runs and nothing is charged, so a key with a zero balance works. Dry runs count against the per-key rate limit.

Idempotency-Keystring

Key for one logical operation. Same body replays the result for 24 hours; a different body with the same key returns 409.

Request body

itemsstring[] required

The things to categorize.

taxonomystring[] required

Your categories.

multiboolean

Allow multiple categories per item.

instructionsstring

Response

The call succeeded. The response contains result fields and a usage envelope. With ParseRail-Dry-Run: 1 the body is a DryRun object instead.

OR

Changes

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