App.net Search API Documentation

Please note that at this time, this service has no guarantee of uptime or of valid responses.

Also note that this is not provided by App.net itself. In the future this service may charge a fee for access to this API.

To request access please email adn@nanek.net

Authentication

All API endpoints require basic authentication. A username and password will be provided. Your application will need to pass a valid Authorization header in the format below:

Authorization: Basic [base64 encoded username:password]

Post Search API

Description

A query is provided and a full-text search of ADN posts is executed. A JSON array of ADN posts is returned.

Endpoint

https://api.nanek.net/search

Parameters

NameRequired?TypeDescription
qRequiredstringA URL encoded search query. Full-text searches the ADN Post object.
pageOptionalintegerThe page number to return results from. Starts at 1.
per_pageOptionalintegerThe number of results to return per page up to 20.

Example

https://api.nanek.net/search?q=Hello

{ "results": [ { ... } ], "page": 1

User Search API

Description

A query is provided and a full-text search of ADN users is executed. A JSON array of ADN users is returned.

Endpoint

https://api.nanek.net/users

Parameters

NameRequired?TypeDescription
qRequiredstringA URL encoded search query. Full-text searches the name, username, and text fields of a ADN User object.
pageOptionalintegerThe page number to return results from. Starts at 1.
per_pageOptionalintegerThe number of results to return per page up to 20.

Example

https://api.nanek.net/users?q=nanek

{ "results": [ { ... } ], "page": 1

Trending API

Description

Top hashtags and mentions from the past three hours.

Endpoint

https://api.nanek.net/trends

Parameters

None

Example

https:/api.nanek.net/trends

{ "hashtags": [ { "term": "superbowl", "count": 8 }, ... ], "mentions": [ { "term": "nanek", "count": 52 }, ... ] }