search

JeroenDeDauw / QueryrAPI

🖹 REST API for Wikibase data
https://wikibase.consulting
7 stars 0 forks source link

Add item element counts #35

Open jane023 opened 8 years ago

jane023 commented 8 years ago

It would be nice to get the total number of statements per item

Also the total number of sitelinks per item

JeroenDeDauw commented 8 years ago

Thanks for the suggestion! What location do you have in mind? /items, /items/$id or both?

jane023 commented 8 years ago

Is there a difference? BTW I couldn't really see any clear syntax examples besides when I looked at the urls after clicking on links from the demo. I expected something like this in the documentation: Get a list of the statements in the item: http://queryr.wmflabs.org/api/?item=Q597999/?getstatements Get the number of the statements in the item: http://queryr.wmflabs.org/api/?numberofstatements Get a list of the sitelinks in the item: http://queryr.wmflabs.org/api/?item=Q597999/?getsitelinks Get the number of the sitelinks in the item: http://queryr.wmflabs.org/api/?numberofsitelinks

Ideally if I am working on a list of painters I want to know how much info is already on Wikidata plus the impact of working on those items (number of projects that might benefit from such work)

On Tue, Dec 1, 2015 at 2:31 PM, Jeroen De Dauw notifications@github.com wrote:

Thanks for the suggestion! What location do you have in mind? /items, /items/$id or both?

— Reply to this email directly or view it on GitHub https://github.com/JeroenDeDauw/QueryrAPI/issues/35#issuecomment-160968965 .

JeroenDeDauw commented 8 years ago

While the demo thing is nice to give you some idea of the item response format, it is a very poor way to discover the API endpoints or learn how they function. For that, please look at the API documentation. Also note that the API is largely self documenting, so you can just hit the root endpoint.

Is there a difference?

Yes.

JeroenDeDauw commented 8 years ago

@jane023 ping. Can you also create a list of totals/counts you'd like to see on items?

"sitelinks" are currently not accessible via the API at all, so having a count for them would be weird. "statements" are not exposed as statements, so counting those probably also does not make sense. Could count the number of properties that have an exposed value, or perhaps the total number of exposed values. What would be the usecase for this though? And are there other counts/totals that could make sense?

jane023 commented 8 years ago

For the Content Translation Tool it would be helpful to know if an item is out there with any sitelinks. No sitelinks means no Wikipedia article at all, and 3 sitelinks means it's probably worth translating in your language and we probably have enough references available in one of the existing articles for it to withstand the AfD queue in your language.

On Sun, Dec 6, 2015 at 6:20 AM, Jeroen De Dauw notifications@github.com wrote:

@jane023 https://github.com/jane023 ping. Can you also create a list of totals/counts you'd like to see on items?

"sitelinks" are currently not accessible via the API at all, so having a count for them would be weird. "statements" are not exposed as statements, so counting those probably also does not make sense. Could count the number of properties that have an exposed value, or perhaps the total number of exposed values. What would be the usecase for this though? And are there other counts/totals that could make sense?

— Reply to this email directly or view it on GitHub https://github.com/JeroenDeDauw/QueryrAPI/issues/35#issuecomment-162271669 .

JeroenDeDauw commented 8 years ago

For that use case, are you not better served with a "give me articles with no site links" or "give me articles with 3 or more site links"? Or will users be looking at an article for some other reason, and for this article you want to then know the site link count?

jane023 commented 8 years ago

Depending on the use case, I would be interested in both, so e.g. it is definitely interesting to find all artists born in the netherlands with zero sitelinks, but idem dito for 3+ sitelinks. The number of sitelinks is a rough estimate of how "notable" something is.

On Tue, Dec 8, 2015 at 12:52 PM, Jeroen De Dauw notifications@github.com wrote:

For that use case, are you not better served with a "give me articles with no site links" or "give me articles with 3 or more site links"? Or will users be looking at an article for some other reason, and for this article you want to then know the site link count?

— Reply to this email directly or view it on GitHub https://github.com/JeroenDeDauw/QueryrAPI/issues/35#issuecomment-162860092 .

JeroenDeDauw commented 8 years ago

If you want to find items that have some number of site links, this API is not going to help you. The goal here is to provide simple access to the data, not to provide ways to search through it. The later is already done by existing services such as the SPARQL endpoint.