- Who it is for
- Marketplaces and classifieds
Everyone writes their own listing. The feed should look like one.
Sellers shoot in garages, driveways, and parking lots. Run the stream through one POST request, and every card in the feed comes back on a shared background, with the make, model, and dimensions for moderation right next to it.
curl -X POST https://auto.happyin.app/v1/frames \ -H "Authorization: Bearer $AUTO_API_KEY" \ -F "image=@ad_88213.jpg" \ -F "background=office-lot" \ -F "brand_rule=default"
POST /v1/batches
{
"background_id": "bgl_…",
"frames": [{ "name": "88213.jpg", "type": "image/jpeg", "size": 2400000 },
"… 499 more; the rest via POST /v1/batches/{id}/frames"]
}
# PUT each file to its uploads.frames[].url, then:
POST /v1/batches/{id}/submit
# once, not per batch:
POST /v1/webhooks
{ "url": "https://api.company.com/hooks/car", "events": ["batch.completed"] }import { Client } from "@happyin/auto";
const client = new Client(); // key from AUTO_API_KEY
const { image_url, vehicle } = await client.processFrame("ad_88213.jpg", {
background: "office-lot",
});
if (vehicle?.make?.code !== ad.make) flagForReview(ad.id);A synchronous call: the processed photo and vehicle data arrive in the same request.Batches of up to 10,000 photos, a webhook on completion. Retries are handled on our side.SDKs for Node and Python; the same fields as the REST API.
One listing's journey, from photo to card
Not just a picture. Moderation data too.
The model recognizes the car in the photo regardless of what the seller typed in the title. Cross-check the two and catch mistakes and substitutions before publishing.
vehicle.make / modelThe make and model from the photo, not from the listing title.vehicle.bodyBody type: sedan, liftback, crossover, wagon.vehicle.dimensions_mmLength, width, height, wheelbase, clearance.vehicle.*.confidenceModel confidence — you set the threshold for automatic moderation.brand.plateThe detected plate: hidden, replaced, or left as-is.{
"ok": true,
"frame": {
"id": "frm_6f1d0c9a2b8e4f7a9c3d5e1b0a2f4c6d",
"status": "done",
"image_url": "https://…/ad_88213.png?X-Amz-Expires=600&…",
"vehicle": {
"status": "unconfirmed",
"make": { "code": "skoda", "text": "Škoda", "source": "estimate", "confidence": 0.89 },
"body": { "code": "liftback", "source": "estimate", "confidence": 0.93 },
"dimensions_mm": {
"length": 4690, "width": 1830, "height": 1470,
"wheelbase": 2690, "source": "estimate"
}
},
"brand": { "plate": "replaced", "overlays": 0 }
}
}
Your platform's background — part of your brand
Send us your scene once and we add it to your background library. A default brand rule (POST /v1/brand/rules) then puts it on every listing.




A test key — right away, sandbox included.
The key arrives by email, and the sandbox returns the same fields as production. Your developer can wire it up on their own; if you need help, we'll get on a call and connect it together.
We'll price it to your volume; for streams over 100,000 a month, a separate rate applies.