Submission API

Directory-submission services and vendors can send tools to Software for Marketers automatically. Submissions go into the same review queue as the website form: a person checks each one against the tool's own website before it is listed, and listing isn't guaranteed.

Send a tool

curl -X POST https://softwareformarketers.com/api/v1/submissions   -H "Content-Type: application/json"   -d '{
    "url": "https://example.com",
    "name": "Example",
    "tagline": "One line on what it does",
    "description": "Two or three sentences, plain and factual.",
    "email": "contact@example.com",
    "categories": ["email-marketing"],
    "relationship": "owner"
  }'

• Required: url, name, tagline (160 characters at most), email and categories (1 to 3 slugs).
• Optional: description (600 characters), features, tags, pricingPageUrl, hasFreePlan, hasFreeTrial, relationship (owner, works-there, user or other), notes.
• Category slugs come from /api/v1/categories.
• Success returns {"ok": true}. Errors return {"ok": false, "error": "..."} with status 400 (invalid), 409 (already listed or already waiting for review), 429 (too many requests) or 503.

Rules

• One open submission per piece of software. A second one for the same website is refused until the first is reviewed.
• Up to 10 submissions per hour from one connection.
• Use the contact email of someone who can answer questions about the tool. We email it about the submission only.
• Facts must come from the tool's own website. Promotional wording and made-up details are removed or the submission is rejected.