Skip to main content
GET /v1/research/products?ids= takes up to 100 Etsy listing IDs, comma-separated or as repeated ids parameters, and returns a summary of each. It costs the same per product as opening each one, in one request instead of up to 100.
Every ID you send comes back exactly once, in one of four lists: GET /v1/research/products?ids= costs 1 API credit per product in data. The other lists are free. Alura needs enough API credits for every distinct ID before the call runs, and gives back what it didn’t use. Each never-seen ID counts against the workspace’s daily product fetch cap and its per-minute fetch rate. See Freshness and new items. Bulk lookups never refresh stale data. To refresh one product, open it with GET /v1/research/products/{id}. Keywords work the same way with GET /v1/research/keywords, which takes repeated q parameters; see Keyword research.