Listing Event

The listing event type is used when a user creates a content or product listing on a marketplace or platform. Monitoring listing events helps detect spam, counterfeit product listings, and scam activity.

Category: Non-monetary Relevant feedback outcomes: success, fail, fraud, dispute, rejected

note

Chargeback and refund outcomes do not apply to listing events. Disputes may occur if another party reports the listing.

Request Example

POST /api/v1/generic/validate HTTP/1.1
Host: api.sa.mubeen.ai
X-API-Key: <your_key>
Content-Type: application/json

{
  "event_type": "listing",
  "timestamp": "2025-03-15T20:10:00Z",
  "attempt_id": "att_listing_7788",
  "external_id": "listing_554433",
  "device_id": "fp_listing_pqr56789",
  "user_id": "usr_901234",
  "user_email": "[email protected]",
  "full_name": "Yusuf Al-Harbi",
  "phone_number": "+974590123456",
  "ip_address": "46.33.120.77",
  "ip_country": "QA",
  "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 14_0) Safari/17.0",
  "channel": "web",
  "platform": "web",
  "account_created_at": "2024-02-10T00:00:00Z"
}

Response Example

{
  "request_id": "d4e5f6a7-0004-4567-8901-def012345678",
  "decision": "log",
  "risk_score": 3,
  "risk_level": "low"
}

Feedback Examples

Successful Listing

{
  "request_id": "d4e5f6a7-0004-4567-8901-def012345678",
  "outcome": "success",
  "external_id": "listing_554433"
}

Fraudulent Listing (Scam)

{
  "request_id": "d4e5f6a7-0004-4567-8901-def012345678",
  "outcome": "fraud",
  "outcome_details": {
    "fraud_type": "scam_listing",
    "detection_method": "user_reports",
    "report_count": 5
  },
  "external_id": "listing_554433"
}

Disputed Listing

{
  "request_id": "d4e5f6a7-0004-4567-8901-def012345678",
  "outcome": "dispute",
  "outcome_details": {
    "dispute_reason": "counterfeit_product",
    "dispute_date": "2025-03-25"
  },
  "external_id": "listing_554433"
}

Key Fields for Listing Events

Field	Importance	Notes
user_id	Required	Identifies the seller/poster
device_id	Recommended	Multiple listings from same device across accounts indicate spam
ip_address	Recommended	Shared IPs across many listing accounts indicate coordinated spam