Available

Recommendations

get/v1/recommendations/sellers/{sellerId}

Personalized "for you" feed for a seller: the best trade candidates across all of the seller's active listings, each shown once.

curl -X GET https://api.tbbnetwork.com/v1/recommendations/sellers/{sellerId} \
  -H "Authorization: Bearer sk_sandbox_..." \

Parameters

sellerId	path	required
limit	query	optional

Response (200)

Field	Type	Required
sellerId	string (uuid)	—
recommendations	object[]	—

Example 200 response

{
  "sellerId": "a1b2c3d4-5e6f-4a7b-8c9d-0e1f2a3b4c5d",
  "recommendations": [
    {
      "listingId": "a1b2c3d4-5e6f-4a7b-8c9d-0e1f2a3b4c5d",
      "merchantId": "a1b2c3d4-5e6f-4a7b-8c9d-0e1f2a3b4c5d",
      "title": "title",
      "category": "category",
      "subcategory": null,
      "brand": null,
      "condition": null,
      "originalPrice": 1,
      "currency": "USD",
      "score": 1,
      "matchedAgainstListingId": "a1b2c3d4-5e6f-4a7b-8c9d-0e1f2a3b4c5d"
    }
  ]
}

Possible errors

Any other failure (validation, auth, rate limiting, a resource that doesn't exist) returns this same envelope with a non-2xx status — error.code is stable and safe to branch on; error.requestId is worth logging and including in a support request.

Example error response

{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "A human-readable description of what went wrong.",
    "requestId": "req_01hxyz..."
  }
}