Semiocast API Documentation
Micromessage analysis examples for Twitter

About

Analysis of micromessage from Twitter: status update, timelines, search results.

Read Micromessage analysis for a complete description.

Single status update

Get a Twitter status update thanks to its id:

Short result:

• Default analysis (message language and user location):
  curl -E semiocast-api.pem:PASSWORD --data-urlencode data@status.json "https://api.semiocast.com/1/analyze/twitter.json"
  { "language":{"script_code":"latn","language_code":"en"}, "location":{"country_code":"US","city_name":"New York City"} }
• Only message language:
  curl -E semiocast-api.pem:PASSWORD -d ident=language --data-urlencode data@status.json "https://api.semiocast.com/1/analyze/twitter.json"
  { "language":{"script_code":"latn","language_code":"en"} }
• Only user location:
  curl -E semiocast-api.pem:PASSWORD -d ident=location --data-urlencode data@status.json "https://api.semiocast.com/1/analyze/twitter.json"
  { "location":{"country_code":"US","city_name":"New York City"} }

Enriched message:

• Default analysis (message language and user location):
  curl -E semiocast-api.pem:PASSWORD -d output=enriched --data-urlencode data@status.json "https://api.semiocast.com/1/analyze/twitter.json"
  {"in_reply_to_user_id":null,"source":"web","created_at":..., "annotations":[ "language":{"provider":"http://semiocast.com/", "script_code":"latn","language_code":"en"}, "location":{"provider":"http://semiocast.com/", "country_code":"US","city_name":"New York City"} ] }
• Only message language:
  curl -E semiocast-api.pem:PASSWORD -d output=enriched -d ident=language --data-urlencode data@status.json "https://api.semiocast.com/1/analyze/twitter.json"
  {"in_reply_to_user_id":null,"source":"web","created_at":..., "annotations":[ "language":{"provider":"http://semiocast.com/", "script_code":"latn","language_code":"en"}, ] }
• Only user location:
  curl -E semiocast-api.pem:PASSWORD -d ident=location --data-urlencode data@status.json "https://api.semiocast.com/1/analyze/twitter.json"
  {"in_reply_to_user_id":null,"source":"web","created_at":..., "annotations":[ "location":{"provider":"http://semiocast.com/", "country_code":"US","city_name":"New York City"} ] }

Home timeline

Get your Twitter home timeline:

• Short result:
  curl -E semiocast-api.pem:PASSWORD --data-urlencode data@home_timeline.json "https://api.semiocast.com/1/analyze/twitter.json"
  [... {"id":"16475229000","language":{"script_code":"latn","language_code":"id"}, "location":{"country_code":"ID","city_name":null}}, {"id":"16475228000","language":{"script_code":"jpan","language_code":"ja"}, "location":{"country_code":"JP","city_name":"福岡市"}}, {"id":"16475227000","language":{"script_code":"latn","language_code":"id"}, "location":{"country_code":"ID","city_name":"Jakarta"}}, {"id":"16475226000","language":{"script_code":"latn","language_code":"pt"}, "location":{"country_code":"BR","city_name":"Vitória"}}, {"id":"16475225000","language":{"script_code":"latn","language_code":"pt"}, "location":{"country_code":"BR","city_name":"São Paulo"}}, {"id":"16475222000","language":{"script_code":"latn","language_code":"id"}, "location":{"country_code":"FR","city_name":"Paris"}}, {"id":"16475221000","language":{"script_code":"latn","language_code":"en"}, "location":{"country_code":"MX","city_name":"Chihuahua"}}, {"id":"16475220000","language":{"script_code":"latn","language_code":"en"}, "location":{"country_code":null,"city_name":null}}, {"id":"16475219000","language":{"script_code":"latn","language_code":"es"}, "location":null}, {"id":"16475215000","language":{"script_code":"latn","language_code":"en"}, "location":{"country_code":"CA","city_name":"Oromocto"}}, ...]
• Enriched result:
  curl -E semiocast-api.pem:PASSWORD -d output=enriched --data-urlencode data@timeline.json https://api.semiocast.com/1/analyze/twitter.json
  [..., {"in_reply_to_user_id":null,"geo":null,..., "text":"sipp\" teh, sama\" ; ) RT @heyvira: thanks follownya :) @heeyjeng @malindayuse", "annotations":[{"language":{"script_code":"latn","language_code":"id"}}, {"location":{"country_code":"ID","city_name":null}}], ...}, ...]