Partner Submit API

How it works

1. 1. You authenticate every request with your partner key.
2. 2. Your form loads our category list so labels map to the ones we publish.
3. 3. When a customer submits, you POST their product details to us.
4. 4. We create a submission under your partner name, review it, then publish the listing and email the submitter if they gave an address.

Rules

• • HTTPS product URL required; one submission per product.
• • Description of at least 120 characters, in English.
• • 1–3 categories from our published list.
• • 60 submissions per key per day.
• • Listings are free and editorial — a submission is not a guarantee of listing.

1. Get a key

Email hi@trendyinai.com with your platform name and the domain your form runs on. Keep the key server-side and send it as a bearer token on every request.

Base URL: https://trendyinai.com/api/public/partner/v1
Authorization: Bearer YOUR_PARTNER_KEY

2. Load categories

Call this once when your form opens and cache the result. Submit the exact strings you get back.

GET https://trendyinai.com/api/public/partner/v1/categories
Authorization: Bearer YOUR_PARTNER_KEY

200 OK
{ "categories": ["AI Marketing", "AI Automation", "GEO & AEO", "..."] }

3. Submit a product

POST https://trendyinai.com/api/public/partner/v1/tools
Authorization: Bearer YOUR_PARTNER_KEY
Content-Type: application/json

{
  "name": "Example AI",
  "websiteUrl": "https://example.com",
  "description": "What the product does, who it is for, and how it is priced (120+ chars).",
  "categories": ["AI Marketing"],
  "pricing": "Free plan + Pro from $29/mo",
  "submitterEmail": "customer@example.com",
  "partner": "your-platform-name"
}

201 Created
{ "ok": true, "status": "pending", "name": "Example AI", "reviewUrl": "https://trendyinai.com/tools" }

Errors

Suggested form flow

1. 1. Load categories once when the form mounts.
2. 2. Validate the URL and description client-side before posting.
3. 3. POST /tools, then show the customer a “submitted for review” confirmation.
4. 4. Log our response body so you can debug rejected submissions.