For the 2026 holiday season we built 32 gift-guide pages for OneFindMe — a free product search engine that works in 13 languages — in English, German, French, Italian and Spanish. Each page lists eight real products pulled from the AliExpress affiliate API, ranked by order count, with prices, plus local Amazon and eBay links for people who need delivery in days.
Generating pages is the easy part. Here are the four things that would have shipped broken without a check.
1. The API's keyword search mislabels products
Searching "rechargeable headlamp" sorted by volume returned a rotating bug-zapper racket as the top hit. "Jewelry box travel" returned a 15-slot watch box. "Christmas decoration" returned garden gnomes and Tesla badge stickers.
Fix: never auto-publish the top result per keyword. We print one candidate per keyword with title, price, orders and rating, and a human picks the eight. The script only enforces hard gates (price band, minimum orders, rating ≥ 85–88%).
2. US-local listings can't be promoted in Europe
AliExpress has US-warehouse listings (IDs starting 3256…) and global listings (1005…). The affiliate program only pays on the global ones outside the US, so the EU pages needed a separate pull: ship_to_country="DE", target_currency="EUR", filter to 1005*. One EUR set serves the whole eurozone.
3. A brand logo in a product photo is a counterfeit signal
A "portable tire inflator" with thousands of orders had a well-known US brand's logo printed on it in the main image. Text filters can't see that. Fix: before publishing, render all curated product images into one contact sheet and look at it. It takes thirty seconds and it caught the one product that could have cost us the affiliate account.
4. Structure for search engines and AI crawlers
Each page carries four JSON-LD blocks — Article, ItemList (with Offer and AggregateRating), FAQPage and HowTo — plus an "at a glance" HTML table and an order-by-date table. Tables and Q&A are the parts AI assistants quote. Every language version links to the others with hreflang (four EU languages + English + x-default), in both directions: we found and fixed one-way links where the English page didn't point back.
Small things that mattered
- Disclosure per language. Amazon's Associates sentence has an official wording in German, French, Italian and Spanish — use it, don't translate it yourself.
- Local facts. In Spain, children's gifts often come on 6 January (Reyes), which changes the order-by advice. EU kids' clothing sizes are by height in cm, not 2T–5T.
- Gentle publishing. Bulk updates go out as a single commit or with long pauses between requests — platforms read bursts of API calls as bot activity.
If you're curious, the English guides start at christmas-gifts-for-mom, and the full index in five languages is archived at gitlab.com/skazi1976/onefindme.
Disclosure: the guides contain affiliate links (AliExpress, Amazon, eBay); prices are the same for buyers.
Top comments (0)