You're about to label a chart “new product launches”. Your feed uses includeNewOnly and onlyNewProducts , so the wording feels defensible.
The catch: the former keeps products Sephora flags as new; the latter skips product IDs already returned under the same stateKey . Together, they select previously unseen product IDs carrying a current merchandising flag.
First observed is a collection event, not a launch date.
What does your new product count actually measure?
The tempting question is how many products launched during your reporting period. The answer available from this feed is narrower: how many eligible product IDs your collection encountered for the first time.
Those events can coincide. The settings don't establish that they did.
A product might enter your feed because it appeared in the category you monitor, because you expanded your coverage, or because its ID was absent from your saved history.…