Whilst I can understand and agree with this statement, the results for a generic website search (no "shop location" & no "Delivers to" aka https://www.etsy.com/search?q=scarf&order=[date_desc/price_asc/price_desc]&view_type=gallery&ship_to=ZZ) returns exactly the same results for generic findAllListingActive API method with score_on=created/price with sort_order=up/down. Only website relevancy search ("&order=most_relevant") is wildly different (not even close!) to findAllListingActive API method with score_on=score.
If I was to take "User's locale settings" into consideration, my understanding of what you are saying is that the website Regional settings (found in website footer) has an influence over the results returned. Here is how I'm setting up the call to match the website:
- Website "Delivers To" field ("&ship_to=US" = United States can be changed > not a field for findAllListingActive API method
- Website "Shop Location" field ("&locationQuery=6252001" = United States) can be changed > I assume this is the region="us", location(??), & geo_level=country fields for findAllListingActive API method
- then the "User's locale settings" would be the website Region settings (Region = United States) > lat="37.09024" & lon="-95.712891" (for the US) fields for findAllListingActive API method
- Website Sort by: Relevancy field > sort_on=score for findAllListingActive API method
I have found that passing a value in the API "location" field yields 0 (zero) results. There is no documentation on what type of data can be passed or how it is used in general.
When searching the website, basic keyword searches can yield item counts over 50,000 yet when we call findAllListingActive API method, the resultcount field returns counts capped at 50,100 and not the true search count.
3-1. How does one use the location field for findAllListingActive API method? Can the documentation be updated to reflect this?
3-2. For generic API searches, what do you recommend to pass for generic (global location) search for near results for website & API?
3-3. How do I get the actual item result count (like the website) and not the capped result count (50,100) returned by the API?
3-4-1. How is it possible that some websites, claiming to be using the Etsy API, are able to achieve identical search results to Etsy website relevancy search (when the API clearly does not match) and can report the correct item count (which is clearly not available via the API), and not the capped count?
3-4-2. Etsy's TOUs (ref: https://www.etsy.com/developers/terms-of-use) state: "The API is the only supported method for users to access data programmatically from Etsy. [...trimmed...] For example, you agree not to: 'Screen scrape' pages on the Etsy Website, even if such data is not available in the Etsy API". How are they able to do this with out scraping and being in breech of Etsy's TOUs???
You received this message because you are subscribed to the Google Groups "Etsy API" group.
To unsubscribe from this group and stop receiving emails from it, send an email to etsy-api-v2...@googlegroups.com.
For more options, visit https://groups.google.com/d/optout.
Should we expect to have that matching slowly fall out of sync with Etsy's web search over time in v3?