Skip to content

Commit 3391c1b

Browse files
committed
sort sources and reformat markdown
1 parent 53b477c commit 3391c1b

File tree

1 file changed

+73
-33
lines changed

1 file changed

+73
-33
lines changed

sources.md

+73-33
Original file line numberDiff line numberDiff line change
@@ -1,98 +1,138 @@
11
# Data Sources
22

3-
This project uses data from various sources that are openly licensed or in the public domain. Below are the sources and their respective information:
3+
This project uses data from various sources that are openly licensed or in the
4+
public domain. Below are the sources and their respective information:
5+
46

57
## CC Legal Tools
68

7-
**Description:** _A .txt provided by Timid Robot containing all legal tool paths. The data from Google Custom Search will only cover 50+ general, most significant categories of CC License for data collection quota constraint. As an additional note, the order of precedence of license the collected data's first column is sorted due to intermediate data analysis progress._
9+
**Description:** A `.txt` file provided by Timid Robot containing all legal
10+
tool paths.
811

912
**API documentation link:**
10-
- [List of all current CC legal tool paths by TimidRobot](https://github.com/creativecommons/quantifying/blob/main/google_custom_search/legal-tool-paths.txt)
13+
- [`google_custom_search/legal-tool-paths.txt`][tools-paths]: a list of all
14+
current CC legal tool paths by TimidRobot)
1115

1216
**API information:**
1317
- No API key required
1418
- No query limits
1519

20+
[tools-paths]:google_custom_search/legal-tool-paths.txt
21+
22+
1623
## Flickr
1724

18-
**Description:** _With over 5 billion photos (many with valuable metadata such as tags, geolocation,
19-
and Exif data), the Flickr community creates wonderfully rich data. The Flickr API is how you can
20-
access that data. In fact, almost all the functionality that runs flickr.com is available through
21-
the API._ ([Flickr: The Flickr Developer Guide](https://www.flickr.com/services/developer/))
25+
**Description:** _With over 5 billion photos (many with valuable metadata such
26+
as tags, geolocation, and Exif data), the Flickr community creates wonderfully
27+
rich data. The Flickr API is how you can access that data. In fact, almost all
28+
the functionality that runs flickr.com is available through the API._ ([Flickr:
29+
The Flickr Developer Guide](https://www.flickr.com/services/developer/))
2230

23-
**API documentation link:**
31+
**API documentation link:**
2432
- [API documentation - Flickr Services](https://www.flickr.com/services/api/)
2533

2634
**API information:**
2735
- API key required
2836
- Query limit: 3600 requests per hour
2937
- Data available through CSV format
3038

39+
3140
## Google Custom Search JSON API
3241

33-
**Description:** _The Custom Search JSON API allows user-defined detailed query and access towards related query data using a programmable search engine._
42+
**Description:** The Custom Search JSON API allows user-defined detailed query
43+
and access towards related query data using a programmable search engine.
3444

3545
**API documentation links:**
36-
- [Custom Search JSON API Reference | Programmable Search Engine | Google Developers](https://developers.google.com/custom-search/v1/reference/rest)
37-
- [Method: cse.list | Custom Search JSON API | Google Developers](https://developers.google.com/custom-search/v1/reference/rest/v1/cse/list)
46+
- [Custom Search JSON API Reference | Programmable Search Engine | Google
47+
Developers][google-json]
48+
- [Method: cse.list | Custom Search JSON API | Google Developers][cse-list]
3849

3950
**API information:**
4051
- API key required
4152
- Query limit: 100 queries per day for free version
4253
- Data available through JSON format
4354

55+
**Notes:**
56+
- The data from Google Custom Search will only cover 50+ general, most
57+
significant categories of CC License for data collection quota constraint.
58+
As an additional note, the order of precedence of license the collected
59+
data's first column is sorted due to intermediate data analysis progress.
60+
61+
[google-json]: https://developers.google.com/custom-search/v1/reference/rest
62+
[cse-list]: https://developers.google.com/custom-search/v1/reference/rest/v1/cse/list)
63+
64+
4465
## Internet Archive Python Interface
4566

46-
**Description:** _A python interface to archive.org to achieve API requests towards internet archive._
67+
**Description:** A python interface to archive.org to achieve API requests
68+
towards internet archive.
4769

48-
**API documentation link:**
49-
- [internetarchive.Search - Internetarchive: A Python Interface to archive.org](https://internetarchive.readthedocs.io/en/stable/internetarchive.html#internetarchive.Search)
70+
**API documentation link:**
71+
- [internetarchive.Search - Internetarchive: A Python Interface to
72+
archive.org][ia-search]
5073

5174
**API information:**
5275
- No API key required
5376
- No query limits
5477

78+
[ia-search]: https://internetarchive.readthedocs.io/en/stable/internetarchive.html#internetarchive.Search
79+
80+
81+
## MediaWiki Action API
82+
83+
**Description:** _The MediaWiki Action API is a web service that allows access
84+
to some wiki features like authentication, page operations, and search. It can
85+
provide meta information about the wiki and the logged-in user._ ([API:Main
86+
page - MediaWiki](https://www.mediawiki.org/wiki/API:Main_page))
87+
88+
**API documentation link:**
89+
- [MediaWiki Action API](https://www.mediawiki.org/wiki/API:Main_page)
90+
91+
**API information:**
92+
- No API key required
93+
- Query limit: depends on user status and request type
94+
- Data available through XML or JSON format
95+
96+
5597
## The Metropolitan Museum of Art Collection API
5698

57-
**Description:** _An API endpoint for receiving Metropolitan Muesum of Art Collection's CC-Licensed works._
99+
**Description:** _The Met’s Open Access datasets are available through our API.
100+
The API (RESTful web service in JSON format) gives access to all of The Met’s
101+
Open Access data and to corresponding high resolution images (JPEG format) that
102+
are in the public domain._ ([The Metropolitan Museum of Art Collection
103+
API](https://metmuseum.github.io/))
58104

59-
**API documentation link:**
60-
- [Latest Updates | The Metropolitan Museum of Art Collection API](https://metmuseum.github.io/)
105+
**API documentation link:**
106+
- [Latest Updates | The Metropolitan Museum of Art Collection
107+
API](https://metmuseum.github.io/)
61108

62109
**API information:**
63110
- No API key required
64111
- 80 queries per second
65112

113+
66114
## Vimeo API
67115

68-
**Description:** _The Vimeo API allows users to perform filtered, advanced search on Vimeo videos._
116+
**Description:** The Vimeo API allows users to perform filtered, advanced
117+
search on Vimeo videos.
69118

70-
**API documentation link:**
119+
**API documentation link:**
71120
- [Getting Started with the Vimeo API](https://developer.vimeo.com/api/start)
72121

73122
**API information:**
74123
- API key required
75124
- Query limit: 5000 authenticated requests per day
76125
- Data available through JSON format
77126

78-
## MediaWiki Action API
79127

80-
**Description:** _The MediaWiki Action API is a web service that allows access to some wiki features like authentication, page operations, and search. It can provide meta information about the wiki and the logged-in user._
81-
82-
**API documentation link:**
83-
- [MediaWiki Action API](https://www.mediawiki.org/wiki/API:Main_page)
84-
85-
**API information:**
86-
- No API key required
87-
- Query limit: depends on user status and request type
88-
- Data available through XML or JSON format
89-
90128
## YouTube Data API
91129

92-
**Description:** _An API from YouTube for platform users to upload videos, adjust video parameters, and obtain search results._
130+
**Description:** An API from YouTube for platform users to upload videos,
131+
adjust video parameters, and obtain search results.
93132

94-
**API documentation link:**
95-
- [Search: list | YouTube Data API | Google Developers](https://developers.google.com/youtube/v3/docs/search/list)
133+
**API documentation link:**
134+
- [Search: list | YouTube Data API | Google
135+
Developers](https://developers.google.com/youtube/v3/docs/search/list)
96136

97137
**API information:**
98138
- API key required

0 commit comments

Comments
 (0)