Specification for Twitter Service

Check out the specification below to see how easy it is to integrate Twitter into your solutions.

Specification

Each request to a feedzon web service requires a number of parameters, all listed below. All requests require an Service Key which was generated when you activated a key for that service. You can create multiple keys for each service, if required.

feedzon methods and parameters names are all case sensitive,e.g. PostTweet will work but postTweet will not; ServiceKey=abc123 will work and SERVICEKEY=abc123 will not.

Post Tweet

To post a tweet.

Request Format

https://api.feedzon.com/twitter/1.1/PostTweet.fz?{parameters}

Returns

"0"
"365853299005933184"

"0" means a successful result

"365853299005933184" is the unique ID number for the Tweet. You will need this number should you later wish to remove the Tweet.

Parameters

Name Type Description Example
ServiceKey String Your Service Key uYt892VbNBmKLE2K9upE83HhjeR6342L
Status String Your Tweet status (message) Welcome to feedzon

Remove Tweet

To remove a specified tweet.

Request Format

https://api.feedzon.com/twitter/1.1/RemoveTweet.fz?{parameters}

Returns

"0"

Parameters

Name Type Description Example
ServiceKey String Your Service Key uYt892VbNBmKLE2K9upE83HhjeR6342L
Id String The unique ID of the Tweet being removed 365853299005933184

Get Timeline User

Get the User Timeline for the named user. Enter your own user name or one of someone you follow. Returns up to 200 Tweets.

Request Format

https://api.feedzon.com/twitter/1.1/GetTimelineUser.fz?{parameters}

Returns

"0"
"374215939", "Chaim Bacon", "chaimbacon", "https://si0.twimg.com/profile_images/1544604810/Chaim_2005_normal.jpg", "Software developer, photographer, comedian, actor, mad genius, not too modest, in a relationship.", "Borehamwood, Hertfordshire", "http://t.co/4oXE6qDg7d", "362749201546887168", "2013.08.01 01:38:43", "We've launched feedzon Translate and Speech (text-to-speech conversion) into beta testing. Please get in touch if you want to get testing!"
"374215939", "Chaim Bacon", "chaimbacon", "https://si0.twimg.com/profile_images/1544604810/Chaim_2005_normal.jpg", "Software developer, photographer, comedian, actor, mad genius, not too modest, in a relationship.", "Borehamwood, Hertfordshire", "http://t.co/4oXE6qDg7d", "332157142926761984", "2013.05.08 15:36:48", "feedzon update: development is going really well. Will be launching new website and beta-testing program start June. http://t.co/DUS3sBMuau"

One tweet will be returned per line with the following fields: profile_id, profile_name, profile_user, profile_image, profile_description, profile_location, profile_url, message_id, message_time, message_text

Parameters

Name Type Description Example
ServiceKey String Your Service Key uYt892VbNBmKLE2K9upE83HhjeR6342L
User String A Twitter user name chaimbacon

Get Timeline Home

Get the Home Timeline for the named user. Enter your own user name or one of someone you follow. Returns up to 200 Tweets.

Request Format

https://api.feedzon.com/twitter/1.1/GetTimelineHome.fz?{parameters}

Returns

"0"
"135629930", "Theo Paphitis", "TheoPaphitis", "https://si0.twimg.com/profile_images/1281537726/image_normal.jpg", "Shopkeeper", "", "http://t.co/BVzFFQRBA2", "365781448919240704", "2013.08.09 11:27:48", "Guys and girls in #office had a visitor today ! Hope Gladys didn't get to those wires ! http://t.co/O3qmfhkzyD"
"1098045114", "feedzon", "feedzon", "https://si0.twimg.com/profile_images/378800000129835420/b1151b57a1e08e64555aabfba44c1b34_normal.png", "Bringing FileMaker into the 21st Century! A wide range of web services that enable you to do things you just couldn't do before.", "United Kingdom", "http://t.co/v7b18X4Kgx", "365627295622373379", "2013.08.09 01:15:14", "Just finished the feedzon Twitter app, all in FileMaker. Great for business! Will be releasing to you guys in the next few hours to test :)"

One tweet will be returned per line with the following fields: profile_id, profile_name, profile_user, profile_image, profile_description, profile_location, profile_url, message_id, message_time, message_text

Parameters

Name Type Description Example
ServiceKey String Your Service Key uYt892VbNBmKLE2K9upE83HhjeR6342L
User String A Twitter user name chaimbacon

Get Friend List (Following)

Get the list of people the named user is following (friends). Enter your own user name or one of someone you follow. Returns up to 20 friends, although further requests can be made to return additional friends.

Request Format

https://api.feedzon.com/twitter/1.1/GetFriendList.fz?{parameters}

Returns

"0"
"-12457936354740","48483683783572"
"35541920", "Sebastijan Bauman", "sebastijanb", "https://si0.twimg.com/profile_images/1724863158/DSC_4099_-_Version_2_normal.jpg", "Certified FileMaker Developer", "London, United Kingdom", "http://www.deliciousdata.co.uk", "108", "243", "41"
"21510805", "FileMaker DevCon", "filemakerdevcon", "https://si0.twimg.com/profile_images/3375270288/f7dfd233fb25d71f8f7eb01285606120_normal.jpeg", "Welcome to the official Twitter feed for the FileMaker Developer Conference 2013, Aug 12-15, held at the Hilton San Diego Bayfront, CA.", "San Diego, CA", "http://www.filemaker.com/developers/devcon/", "674", "69", "192"
"1098045114", "feedzon", "feedzon", "https://si0.twimg.com/profile_images/378800000129835420/b1151b57a1e08e64555aabfba44c1b34_normal.png", "Bringing FileMaker into the 21st Century! A wide range of web services that enable you to do things you just couldn't do before.", "United Kingdom", "http://www.feedzon.com", "30", "10", "31"

Note: Twitter returns the results in batches of 20 at a time. If the named user is following more than 20 people then Twitter provides something called a cursor value. The cursor is a number to specify in your next request if you want to see the next 20 people being followed. When you're on 21+, you'll also get a negative cursor which can be used to request the previous 20 people being followed. When no cursor value is specified in your request, only the first 20 people being followed are returned.

"0" means a successful result.

"-12457936354740","48483683783572" are the cursor numbers, enabling you to request a list of the 'previous' 20 or the 'next' 20 respectively.

One friend will be returned per line with the following fields: profile_id, profile_name, profile_user, profile_image, profile_description, profile_location, profile_url, count_follower, count_friend, count_tweet

Parameters

Name Type Description Example
ServiceKey String Your Service Key uYt892VbNBmKLE2K9upE83HhjeR6342L
User String A Twitter user name chaimbacon
Cursor String Optional value, see description above -12457936354740

Get Follower List

Get the list of followers for the named user. Enter your own user name or one of someone you follow. Returns up to 20 followers, although further requests can be made to return additional followers.

Request Format

https://api.feedzon.com/twitter/1.1/GetFollowerList.fz?{parameters}

Returns

"0"
"0","1435916383585727288"
"1098045114", "feedzon", "feedzon", "https://si0.twimg.com/profile_images/378800000129835420/b1151b57a1e08e64555aabfba44c1b34_normal.png", "United Kingdom", "Bringing FileMaker into the 21st Century! A wide range of web services that enable you to do things you just couldn't do before.", "http://www.feedzon.com", "30", "10", "31"
"1456855874", "Patryck Aguilar", "managyck", "https://si0.twimg.com/profile_images/3708013196/003c22e26f2a99040c537f2e279ca716_normal.jpeg", "", "Html5 gardener and FileMaker surgeon", "", "13", "63", "28"
"14197745", "Tim Cimbura", "timcimbura", "https://si0.twimg.com/profile_images/2755625085/95d0a8ca1678840218ede8b7682b3d3a_normal.jpeg", "Minneapolis, MN", "Innovative technology expert and inspiring speaker and entertainer.", "http://about.me/timcimbura", "412", "643", "1059"
"374215939", "Chaim Bacon", "chaimbacon", "https://si0.twimg.com/profile_images/1544604810/Chaim_2005_normal.jpg", "Borehamwood, Hertfordshire", "Software developer, photographer, comedian, actor, mad genius, not too modest, in a relationship.", "http://www.cccuk.co", "22", "16", "4"

Note: Twitter returns the results in batches of 20 at a time. If the named user has more than 20 followers then Twitter provides something called a cursor value. The cursor is a number to specify in your next request if you want to see the next 20 followers. When you're on 21+, you'll also get a negative cursor which can be used to request the previous 20 followers. When no cursor value is specified in your request, only the first 20 followers are returned.

"0" means a successful result.

"0","48483683783572" are the cursor numbers, enabling you to request a list of the 'previous' 20 or the 'next' 20 respectively.

One follower will be returned per line with the following fields: profile_id, profile_name, profile_user, profile_image, profile_description, profile_location, profile_url, count_follower, count_friend, count_tweet

Parameters

Name Type Description Example
ServiceKey String Your Service Key uYt892VbNBmKLE2K9upE83HhjeR6342L
User String A Twitter user name chaimbacon
Cursor String Optional value, see description above 1435916383585727288

Search Tweet

Returns a collection of up to 100 relevant Tweets matching your specified search criteria. Twitter says, "Please note that Twitter's search service is not meant to be an exhaustive source of Tweets since not all Tweets are indexed or made available via the search interface." FYI, in our own testing we have found search results vary widely between Twitter's own app, their web search and results provided to us.

Request Format

https://api.feedzon.com/twitter/1.1/SearchTweet.fz?{parameters}

Returns

"0"
"50748504", "Steven H. Blackwell", "filemakersecure", "https://si0.twimg.com/profile_images/282469619/Blackwell_normal.jpg", "", "FileMaker Certified Developer 7|8|9|10|11|12--FileMaker Platinum Member Emeritus-FileMaker Authorized Trainer 9|10|11|12", "", "365870643964682240", "2013.08.09 16:22:13", "RT @soliantconsult: Don't miss our sessions at FileMaker DevCon next week! http://t.co/uLi9Iy3IS0 #FileMaker #DevCon"
"70989468", "Soliant Consulting", "soliantconsult", "https://si0.twimg.com/profile_images/1748988000/soliant_logo_60_normal.jpg", "IL, CA, PA", "Soliant Consulting creates custom software applications in FileMaker Pro, PHP/SQL, and Salesforce. Call 800-582-0170 or visit our site http://t.co/sWBGYR2om2.", "http://t.co/sWBGYR2om2", "365869403276980224", "2013.08.09 16:17:17", "Don't miss our sessions at FileMaker DevCon next week! http://t.co/uLi9Iy3IS0 #FileMaker #DevCon"

"0" means a successful result.

One Tweet will be returned per line with the following fields: profile_id, profile_name, profile_user, profile_image, profile_description, profile_location, profile_url, message_id, message_time, message_text

Parameters

Name Type Description Example
Service Key String Your Service Key uYt892VbNBmKLE2K9upE83HhjeR6342L
Query String The search word Filemaker

Send Message

Post a new direct message to the specified user. Direct messages can only be sent to people who are following you.

Request Format

https://api.feedzon.com/twitter/1.1/SendMessage.fz?{parameters}

Returns

"0"
"365881096342208512"

"0" means a successful result.

"365853299005933184" is the unique ID number for the message. You will need this number should you later wish to remove the message.

Parameters

Name Type Description Example
ServiceKey String Your Service Key uYt892VbNBmKLE2K9upE83HhjeR6342L
User String A Twitter user name chaimbacon
Text String The message you're sending. Come down this week for a special 15% discount on all ladies clothes. Quote TWFZ8724

Remove Message

Removed the specified direct message. Only the recipient can remove the message.

Request Format

https://api.feedzon.com/twitter/1.1/RemoveMessage.fz?{parameters}

Returns

"0"

Parameters

Name Type Description Example
ServiceKey String Your Service Key uYt892VbNBmKLE2K9upE83HhjeR6342L
Id String The unique ID of the message being removed 365881096342208512

Get Message List

Gets a list of up to 200 incoming direct messages. Currently this doesn't include a copy of direct messages sent, although we will add this shortly.

Request Format

https://api.feedzon.com/twitter/1.1/GetMessageList.fz?{parameters}

Returns

"0"
"123321123321", "James King", "jking65", "https://si0.twimg.com/profile_images/14214158/DFC_4192.jpg", "Certified FileMaker Developer", "London, United Kingdom", "http://t.co/2yKHbG6fdD4", "17353427264", "2013.08.01 13:28:56", "Welcome to feedzon"
"756821125256", "Penelope Pitstop", "ppstop", "https://si0.twimg.com/profile_images/19464534/DFC_7621.jpg", "Certified Lady of the night", "London, United Kingdom", "http://t.co/hfthRegGjs", "84634268475", "2013.08.01 22:11:03", "What you up to tonight?"

"0" is a successful result"

One direct message will be returned per line with the following fields: profile_id, profile_name, profile_user, profile_image, profile_description, profile_location, profile_url, message_id, message_time, message_text

Parameters

Name Type Description Example
ServiceKey String Your Service Key uYt892VbNBmKLE2K9upE83HhjeR6342L

Get Account Info

Returns your profile information.

Request Format

https://api.feedzon.com/twitter/1.1/GetAccountInfo.fz?{parameters}

Returns

"0"
"1098045114", "feedzon", "feedzon", "https://si0.twimg.com/profile_images/378800000129835420/b1151b57a1e08e64555aabfba44c1b34_normal.png", "Bringing FileMaker into the 21st Century! A wide range of web services that enable you to do things you just couldn't do before.", "United Kingdom", "http://t.co/v7b18X4Kgx", "30", "10", "31"

"0" means a successful result.

Includes the following fields: profile_id, profile_name, profile_user, profile_image, profile_description, profile_location, profile_url, count_follower, count_friend, count_tweet

Parameters

Name Type Description Example
ServiceKey String Your Service Key (as part of the TO email address) uYt892VbNBmKLE2K9upE83HhjeR6342L

Response Errors

 

Error Description Cause Resolution
-1 Function doesn't exist The function name doesn't exist or has been spelled incorrectly. Please check your syntax for any errors since all function names and parameter names are case sensitive.
1000 Service Key is invalid The Service Key used to access feedzon was not recognised or has been disabled. Please check your Service Key, re-enable the service or contact us for further assistance.
1010 Missing parameters One or more parameters are missing Please check the parameters section to identify which parameters are required for the specified method.
3000 Twitter API error Error connecting to your Twitter account Log onto your feedzon Twitter account in the My Services page and click the 'Link Twiter' button.
3010 Rate limit exceeded You have exceeded one of Twitter's limits See here for more details about the limits Twitter imposes: Twitter Limits