beta

Statistic APIs

• Feed Impressions Statistics
• Feed Clicks Statistics
• Feed Actions Statistics
• Entry Clicks Statistics
• Client Impressions Statistics
• Client Clicks Statistics
• Client Actions Statistics

Feed Impressions Statistics

A feed owner can access detailed statistics about the number of impressions (hits) on each Feed within a particular date range via an API call.

URL

https://api.nooked.com/v1/feeds/<FEED_ID>/stats/hits.atom?from=<FROM_DATE>&to=<TO_DATE> (secure) or http://api.nooked.com/v1/feeds/<FEED_ID>/stats/hits.atom?from=<FROM_DATE>&to=<TO_DATE> (unsecured)

Authentication

Login via HTTP Basic Authentication using your active account or pass in the optional 'api_key" parameter to get your feeds' statistics data.

Request

The caller should send a HTTP GET request to this URL where:

• <FEED_ID> - the Feed ID
• <FROM_DATE> - the start date in the format YYYY-MM-DD
• <TO_DATE> - the to date in the format YYYY-MM-DD

Response

The platform responds with a 200 OK status code. The body of the response is an Atom Feed containing an Entry for each date in the range specified. Each entry title is a date and the content of each entry is the number of feed impressions (hits) for that date.

Feed Clicks Statistics

A feed owner can access detailed statistics about the total number of click throughs on entries in a Feed within a particular date range via an API call.

URL

https://api.nooked.com/v1/feeds/<FEED_ID>/stats/clicks.atom?from=<FROM_DATE>&to=<TO_DATE>(secure) or http://api.nooked.com/v1/feeds/<FEED_ID>/stats/clicks.atom?from=<FROM_DATE>&to=<TO_DATE> (unsecured)

Authentication

Login via HTTP Basic Authentication using your active account or pass in the optional 'api_key" parameter to get your feeds' statistics data.

Request

The caller should send a HTTP GET request where:

• <FEED_ID> - the Feed ID
• <FROM_DATE> - the start date in the format YYYY-MM-DD
• <TO_DATE> - the to date in the format YYYY-MM-DD

Response

The platform responds with a 200 OK status code. The body of the response is an Atom Feed containing an Entry for each date in the range specified. Each entry title is a date and the content of each entry is the total number of feed click throughs for that date.

Feed Actions Statistics

A feed owner can access detailed statistics about the total number of actions on entries in a Feed within a particular date range via an API call.

URL

https://api.nooked.com/v1/feeds/<FEED_ID>/stats/actions.atom?from=<FROM_DATE>&to=<TO_DATE> (secure) or http://api.nooked.com/v1/feeds/<FEED_ID>/stats/actions.atom?from=<FROM_DATE>&to=<TO_DATE>

Authentication

Login via HTTP Basic Authentication using your active account or pass in a 'api_key" parameter to get your feeds' statistics data.

Request

The caller should send a HTTP GET request where:

• <FEED_ID> - the Feed ID
• <FROM_DATE> - the start date in the format YYYY-MM-DD
• <TO_DATE> - the to date in the format YYYY-MM-DD

Response

The platform responds with a 200 OK status code. The body of the response is an Atom Feed containing an Entry for each date in the range specified. Each entry title is a date and the content of each entry is the total number of feed actions for that date.

Entry Clicks Statistics

A feed owner can access detailed statistics about the clicks-throughs for each Feed Entry within a particular date range via an API call.

URL

https://api.nooked.com/v1/feeds/<FEED_ID>/entries/<ENTRY_ID>/stats/clicks.atom?from=<FROM_DATE>&to=<TO_DATE> (secure) or http://api.nooked.com/v1/feeds/<FEED_ID>/entries/<ENTRY_ID>/stats/clicks.atom?from=<FROM_DATE>&to=<TO_DATE> (unsecured)

Authentication

Login via HTTP Basic Authentication using your active account or pass in a 'api_key" parameter to get your feeds' statistics data.

Request

The caller should send a HTTP GET request where:

• <FEED_ID> - the Feed ID
• <ENTRY_ID> - the Entry ID
• <FROM_DATE> - the start date in the format YYYY-MM-DD
• <TO_DATE> - the to date in the format YYYY-MM-DD

Response

The platform responds with a 200 OK status code. The body of the response is an Atom Feed containing an Entry for each date in the range specified. Each entry title is a date and the content of each entry is the number of clicks for that date.

Entry Actions Statistics

A feed owner can access detailed statistics about the actions completed for each Feed Entry within a particular date range via an API call.

URL

http://api.nooked.com/v1/feeds/<FEED_ID>/entries/<ENTRY_ID>/stats/actions.atom?from=<FROM_DATE>&to=<TO_DATE> (secure) or https://api.nooked.com/v1/feeds/<FEED_ID>/entries/<ENTRY_ID>/stats/actions.atom?from=<FROM_DATE>&to=<TO_DATE> (unsecured)

Authentication

Login via HTTP Basic Authentication using your active account to get your feeds' statistics data.

Request

The caller should send a HTTP GET request to where:

• <FEED_ID> - the Feed ID
• <ENTRY_ID> - the Entry ID
• <FROM_DATE> - the start date in the format YYYY-MM-DD
• <TO_DATE> - the to date in the format YYYY-MM-DD

Response

The platform responds with a 200 OK status code. The body of the response is an Atom Feed containing an Entry for each date in the range specified. Each entry title is a date and the content of each entry is the number of actions for that date.

Client Impressions Statistics

A client owner can access detailed statistics about the number of impressions (hits) on each Client within a particular date range via an API call.

URL

https://api.nooked.com/v1/clients/<CLIENT_ID>/instances/impressions.atom?from=<FROM_DATE>&to=<TO_DATE> (secure) or http://api.nooked.com/v1/clients/<CLIENT_ID>/instances/impressions.atom?from=<FROM_DATE>&to=<TO_DATE> (unsecured)

Authentication

Login via HTTP Basic Authentication using your active account or pass in the optional 'api_key" parameter to get your feeds' statistics data.

Request

The caller should send a HTTP GET request to this URL where:

• <CLIENT_ID> - the ID of your client (widget)
• <FROM_DATE> - the start date in the format YYYY-MM-DD
• <TO_DATE> - the to date in the format YYYY-MM-DD

Response

The platform responds with a 200 OK status code. The body of the response is an Atom Feed containing an Entry for each date in the range specified. Each entry title is a date and the content of each entry is the number of client impressions for that date.

Client Clicks Statistics

A client owner can access detailed statistics about the number of clicks on specified client within a particular date range via an API call.

URL

https://api.nooked.com/v1/clients/<CLIENT_ID>/instances/clicks.atom?from=<FROM_DATE>&to=<TO_DATE> (secure) or http://api.nooked.com/v1/clients/<CLIENT_ID>/instances/clicks.atom?from=<FROM_DATE>&to=<TO_DATE> (unsecured)

Authentication

Login via HTTP Basic Authentication using your active account or pass in the optional 'api_key" parameter to get your feeds' statistics data.

Request

The caller should send a HTTP GET request to this URL where:

• <CLIENT_ID> - the ID of your client (widget)
• <FROM_DATE> - the start date in the format YYYY-MM-DD
• <TO_DATE> - the to date in the format YYYY-MM-DD

Response

The platform responds with a 200 OK status code. The body of the response is an Atom Feed containing an Entry for each date in the range specified. Each entry title is a date and the content of each entry is the number of clicks generated by client for that date.

Client Actions Statistics

A client owner can access detailed statistics about the number of actions on specified client within a particular date range via an API call.

URL

https://api.nooked.com/v1/clients/<CLIENT_ID>/instances/actions.atom?from=<FROM_DATE>&to=<TO_DATE> (secure) or http://api.nooked.com/v1/clients/<CLIENT_ID>/instances/actions.atom?from=<FROM_DATE>&to=<TO_DATE> (unsecured)

Authentication

Login via HTTP Basic Authentication using your active account or pass in the optional 'api_key" parameter to get your feeds' statistics data.

Request

The caller should send a HTTP GET request to this URL where:

• <CLIENT_ID> - the ID of your client (widget)
• <FROM_DATE> - the start date in the format YYYY-MM-DD
• <TO_DATE> - the to date in the format YYYY-MM-DD

Response

The platform responds with a 200 OK status code. The body of the response is an Atom Feed containing an Entry for each date in the range specified. Each entry title is a date and the content of each entry is the number of actions generated by client for that date.