forked from yql/yql-tables
-
Notifications
You must be signed in to change notification settings - Fork 0
/
usatoday.articles.search.xml
79 lines (70 loc) · 4.42 KB
/
usatoday.articles.search.xml
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
<?xml version="1.0" encoding="UTF-8" ?>
<table xmlns="http://query.yahooapis.com/v1/schema/table.xsd">
<meta>
<author>Sebastian Spier (http://twitter.com/#!/sebastianspier/)</author>
<description>
USA TODAY Articles API - Search + Tag
</description>
<documentationURL>http://developer.usatoday.com/docs/read/articles</documentationURL>
<sampleQuery>SELECT * FROM {table} WHERE api_key='YOUR_API_KEY' AND search='Germany'</sampleQuery>
<sampleQuery>SELECT * FROM {table} WHERE api_key='YOUR_API_KEY' AND reporter='Zillgitt'</sampleQuery>
<sampleQuery>SELECT * FROM {table} WHERE api_key='YOUR_API_KEY' AND tag='barack obama'</sampleQuery>
</meta>
<bindings>
<select itemPath="json.stories" produces="JSON" description="Search for USAToday articles">
<urls>
<url env="all">http://api.usatoday.com/open/articles</url>
</urls>
<paging model="page">
<start id="page" default="1" />
<pagesize id="count" max="100" />
<total default="10" />
</paging>
<inputs>
<!-- general parameters -->
<key id="api_key" type="xs:string" paramType="query" required="true" description="API key for USAToday" />
<key id="encoding" type="xs:string" paramType="query" const="true" default="json" description="Format in which to return the results. Either JSON or RSS. (I am fixing this to JSON)" />
<!-- specifics for this table -->
<key id="search" type="xs:string" paramType="query" required="false" description="The search string" />
<key id="tag" type="xs:string" paramType="query" required="false" description="The tag to search for" />
<!--
##########################
Developers may further customize their story feeds by using the following parameters.
##########################
-->
<key id="csp" type="xs:string" paramType="query" description="Appends the designated CSP value to each hyperlink." />
<key id="days" type="xs:string" paramType="query" description="Returns stories that are no older than X days old, where X equals the input value." />
<key id="reporter" type="xs:string" paramType="query" description="Returns only stories from a specific reporter. Query searches byline field." />
<key id="source" type="xs:string" paramType="query" description="Returns only stories from a specific news source." />
<key id="tickersonly" type="xs:string" paramType="query" description="When set to Y, returns only stories with embedded stock values. Best used with Money stories." />
</inputs>
</select>
<select itemPath="json.stories" produces="JSON" description="Search for USAToday articles by 'tag'">
<urls>
<url env="all">http://api.usatoday.com/open/articles</url>
</urls>
<paging model="page">
<start id="page" default="1" />
<pagesize id="count" max="100" />
<total default="10" />
</paging>
<inputs>
<!-- general parameters -->
<key id="api_key" type="xs:string" paramType="query" required="true" description="API key for USAToday" />
<key id="encoding" type="xs:string" paramType="query" const="true" default="json" description="Format in which to return the results. Either JSON or RSS. (I am fixing this to JSON)" />
<!-- specifics for this table -->
<key id="tag" type="xs:string" paramType="query" required="true" description="The search string" />
<!--
##########################
Developers may further customize their story feeds by using the following parameters.
##########################
-->
<key id="csp" type="xs:string" paramType="query" description="Appends the designated CSP value to each hyperlink." />
<key id="days" type="xs:string" paramType="query" description="Returns stories that are no older than X days old, where X equals the input value." />
<key id="reporter" type="xs:string" paramType="query" description="Returns only stories from a specific reporter. Query searches byline field." />
<key id="source" type="xs:string" paramType="query" description="Returns only stories from a specific news source." />
<key id="tickersonly" type="xs:string" paramType="query" description="When set to Y, returns only stories with embedded stock values. Best used with Money stories." />
</inputs>
</select>
</bindings>
</table>