API Reference

Embed vendor trust scores directly in your checkout flow, lending platform, or marketplace. One API call returns a full trust score, summary, and advice.

RESTJSONNo SDK needed

Base URL

text

https://Vendorfy.ng/api

Authentication

Pass your API key in the Authorization header. Free tier allows 100 lookups/month with no key (identified by IP).

http

Authorization: Bearer YOUR_API_KEY

Endpoints

GET/api/vendor/:handle

Returns trust score, verdict, summary, sources, and advice for a vendor. Creates the vendor record automatically if it doesn't exist yet.

Example request

bash

curl https://Vendorfy.ng/api/vendor/zeeluxury_ng \
  -H "Authorization: Bearer YOUR_API_KEY"

Example response

json

{
  "handle": "zeeluxury_ng",
  "platform": "instagram",
  "trust_score": 73,
  "verdict": "mostly_legit",
  "total_reviews": 24,
  "legit_count": 20,
  "scam_count": 4,
  "summary": "Based on 24 community reviews, this vendor has a generally positive reputation. 20 reviewers reported a positive experience, while 4 reported a negative one.",
  "sources": [
    "24 community reviews submitted on Vendorfy.",
    "20 reviewers reported a positive transaction.",
    "4 reviewers reported a negative experience."
  ],
  "advice": [
    "Community reports suggest this vendor has a positive track record.",
    "As with any online transaction, consider using a secure payment method."
  ],
  "red_flags": [],
  "is_suspicious": false,
  "checked_at": "2026-06-19T10:00:00Z"
}

POST/api/vendor/:handle/report

Submit a community review for a vendor. No API key required — open to all.

Request body

json

{
  "verdict": "legit | scammed",
  "comment": "string (optional, max 500 chars)",
  "platform": "instagram | whatsapp | twitter | tiktok",
  "evidence_url": "string (optional)"
}

Example request

bash

curl -X POST https://Vendorfy.ng/api/vendor/zeeluxury_ng/report \
  -H "Content-Type: application/json" \
  -d '{"verdict":"scammed","comment":"Paid and never received my order","platform":"instagram"}'

Example response

json

{
  "success": true,
  "message": "Review submitted successfully. Thank you for keeping the community safe.",
  "review_id": "uuid"
}

GET/api/vendor/:handle/reviews

Returns paginated community reviews for a vendor.

bash

curl "https://Vendorfy.ng/api/vendor/zeeluxury_ng/reviews?page=1&limit=10" \
  -H "Authorization: Bearer YOUR_API_KEY"

Trust Verdicts

mostly_legit

70-100Strong community trust. Mostly positive reviews.

mixed

40-69Mixed reviews. Proceed with caution.

high_risk

0-39Predominantly negative reviews. Exercise significant caution.

unverified

< 3 reviewsNot enough data yet for a reliable assessment.

flagged

capped at 20Under review by moderation team.

Pricing

Free₦0100 lookups/monthNo key needed

Starter₦10,0001,000 lookups/monthPer month

Growth₦35,00010,000 lookups/monthPer month

Get an API Key

Get a free API key instantly. No credit card required.

Error Codes

400Bad request — invalid parameters

401Unauthorized — invalid or missing API key

404Vendor not found

409Conflict — API key already exists for this email

429Rate limit exceeded — upgrade your plan

500Server error — try again

Questions? Reach out at hello@Vendorfy.ng