🧩 Thingiverse Scraper & Trend Extractor

Récupère des modèles 3D depuis Thingiverse et les renvoie sous forme de données structurées (JSON, CSV, Excel). Chaque modèle est accompagné d'un score de tendance qui indique lesquels gagnent en popularité en ce moment.

🔍 Ce que fait cet Actor

• Recherche des modèles par mot-clé, ou parcourt un catalogue Thingiverse au choix si aucun mot-clé n'est fourni : les populaires, les plus récents ou la sélection de l'équipe Thingiverse.
• Renvoie pour chaque modèle : nom, lien, créateur, nombre de likes, de collections, de commentaires et de réalisations (« makes »), date de publication et miniature.
• Calcule un score de tendance = nombre de likes par jour depuis la publication. Un modèle récent très apprécié obtient un score élevé, même s'il a moins de likes au total qu'un ancien modèle déjà installé.
• Filtre les résultats pour ne garder que les tendances récentes, grâce à un âge maximum et à un nombre de likes minimum.

⚙️ Paramètres

Paramètre	Rôle
Mot-clé	Terme recherché. Laisser vide pour parcourir un catalogue complet.
Tri	Pertinence, populaire, récent, sélection Thingiverse ou réalisations. Sans mot-clé, « récent » et « sélection » parcourent les catalogues dédiés de Thingiverse.
Trier par tendance	Réordonne les résultats par score de tendance (du plus « chaud » au plus faible).
Trier par modèles vraiment imprimés	Classe par réalisations pour 100 likes — une proportion, pas un total. Prioritaire sur le tri par tendance.
Âge maximum (jours)	Ne conserve que les modèles publiés au cours des N derniers jours.
Likes minimum	Ne conserve que les modèles ayant au moins ce nombre de likes.
Inclure les tags	Ajoute les tags de chaque modèle (thème, catégorie, style). Une requête par modèle : l'exécution est plus longue, et les tags ne sont récupérés que pour les 100 premiers résultats (au-delà, tags vaut null).
Nombre de résultats	Entre 1 et 500.
Token Thingiverse	Optionnel. Un token par défaut est déjà fourni ; utilisez le vôtre pour de gros volumes (gratuit sur thingiverse.com/apps/create).

💡 Exemple : repérer les tendances du moment

Activez « Trier par tendance », mettez un âge maximum de 90 jours et un minimum de 20 likes. Vous obtenez les modèles récents qui gagnent le plus de likes par jour actuellement, sans être noyés sous les anciens classiques ni sous les modèles peu suivis.

🗂️ Les versions

🟢 0.0.13 — la plus récente

• 💎 Tri « modèles vraiment imprimés » : un like ne coûte rien, imprimer un modèle demande des heures et du filament. Le nouveau champ makeRatio (réalisations pour 100 likes) révèle ceux qui sont réellement imprimés, pas seulement admirés — souvent invisibles derrière les gros compteurs de likes. C'est une proportion : 120 réalisations pour 500 likes passe devant 1838 pour 75 000.

🔵 0.0.9

• 🏷️ Option « inclure les tags » : récupère les tags de chaque modèle (thème, catégorie, style). Idéal pour classer les résultats ou repérer une niche. Les tags ne sont demandés que pour les modèles finalement retenus, afin de limiter le temps d'exécution.

🔵 0.0.7

• 🎯 Le tri fonctionne enfin sans mot-clé. Auparavant, si aucun mot-clé n'était renseigné, le tri choisi était ignoré et l'Actor renvoyait toujours les modèles populaires. Désormais « récent » et « sélection » parcourent les catalogues dédiés de Thingiverse.
• ✨ Nouveau tri « Sélection Thingiverse » : les modèles mis en avant par l'équipe du site.

🔵 0.0.4

• 🗓️ Filtre « âge maximum » : n'affiche que les modèles publiés récemment, pour voir ce qui monte maintenant.
• 👍 Filtre « likes minimum » : écarte les modèles peu suivis et ne garde que le solide.

🔵 0.0.3

• 🔥 Score de tendance (likes par jour) pour repérer ce qui monte, et pas seulement les vieux hits.
• ↕️ Tri par tendance et token par défaut : plus besoin de fournir le sien pour commencer.

⚪ 0.0.1

• 🔎 Première version : recherche par mot-clé, tri, et export structuré des principales statistiques de chaque modèle.

⭐ Un retour ?

Cet outil vous a été utile ? Laisser un avis prend dix secondes et aide énormément — cela permet à d'autres makers de le trouver. Une idée d'amélioration ou un souci ? Écrivez-le dans les Issues, chaque retour est lu.

---

🧩 Thingiverse Scraper & Trend Extractor (English)

Fetches 3D models from Thingiverse and returns them as structured data (JSON, CSV, Excel). Each model comes with a trend score that shows which ones are gaining popularity right now.

🔍 What it does

• Searches models by keyword, or browses a Thingiverse catalogue of your choice when no keyword is given: popular, newest, or the Thingiverse team's featured picks.
• Returns for each model: name, link, creator, number of likes, collections, comments and makes, publication date and thumbnail.
• Computes a trend score = number of likes per day since publication. A recent, well-liked model scores high even if it has fewer total likes than an older, established one.
• Filters results to keep only recent trends, using a maximum age and a minimum number of likes.

⚙️ Parameters

Parameter	Purpose
Keyword	Search term. Leave empty to browse a full catalogue.
Sort	Relevant, popular, newest, featured or makes. Without a keyword, "newest" and "featured" browse Thingiverse's dedicated catalogues.
Sort by trend	Reorders results by trend score (hottest first).
Sort by actually printed	Ranks by makes per 100 likes — a ratio, not a total. Takes priority over trend sorting.
Max age (days)	Keeps only models published within the last N days.
Min likes	Keeps only models with at least this many likes.
Include tags	Adds each model's tags (theme, category, style). One request per model, so runs take longer, and tags are fetched for the first 100 results only (beyond that, tags is null).
Number of results	Between 1 and 500.
Thingiverse token	Optional. A default token is provided; use your own for large volumes (free at thingiverse.com/apps/create).

💡 Example: find current trends

Turn on "Sort by trend", set a maximum age of 90 days and a minimum of 20 likes. You get the recent models gaining the most likes per day right now, without being buried under old classics or low-interest models.

🗂️ Versions

🟢 0.0.13 — latest

• 💎 "Actually printed" sorting: a like is free, printing a model takes hours and filament. The new makeRatio field (makes per 100 likes) surfaces the models people actually print, not just admire — often hidden behind big like counts. It's a ratio: 120 makes on 500 likes beats 1,838 on 75,000.

🔵 0.0.9

• 🏷️ "Include tags" option: fetches each model's tags (theme, category, style). Great for classifying results or spotting a niche. Tags are only requested for the models actually kept, to limit run time.

🔵 0.0.7

• 🎯 Sorting finally works without a keyword. Previously, with no keyword the chosen sort order was ignored and the Actor always returned popular models. "Newest" and "featured" now browse Thingiverse's dedicated catalogues.
• ✨ New "Featured" sort: the models highlighted by the Thingiverse team.

🔵 0.0.4

• 🗓️ "Max age" filter: shows only recently published models, to see what is rising now.
• 👍 "Min likes" filter: removes low-interest models and keeps only the solid ones.

🔵 0.0.3

• 🔥 Trend score (likes per day) to surface rising models, not just old hits.
• ↕️ Sort by trend and a default token: no need to bring your own to get started.

⚪ 0.0.1

• 🔎 First release: keyword search, sorting, and structured export of each model's main statistics.

⭐ Feedback?

Was this tool useful? Leaving a review takes ten seconds and helps a lot — it makes the Actor easier for other makers to find. Got an idea or hit a problem? Open an Issue, every message is read.

---

Données issues de l'API publique Thingiverse. / Data from the public Thingiverse API.