Flattr Developer Platform

Auto-submit URL

Instead of the embedded buttons you can use a specific kind of URL that just like the button will autocreate, "auto-submit", a Flattr thing on its first flattr. This is useful for when you can't use javascript on a site (or don’t want to) – just create a static link to an auto-submit URL instead.

The URL format for submitting a thing is the following: (newlines added for better visibility)

https://flattr.com/submit/auto?\
    user_id=[USERNAME]&url=[URL]&title=[TITLE]&\
    description=[DESCRIPTION]&language=[LANGUAGE]&\
    tags=[TAGS]&hidden=[HIDDEN]&category=[CATEGORY]

Note: The thing will be submitted to our catalog when it’s flattred for the first time.

Parameters

Linking

The URL you get from this can be linked in anyway you want, with text or image link.

If you want an image as a link you can use one of the available images.

Icon 16x16

Flattr icon image
URL: https://flattr.com/_img/icons/flattr_logo_16.png

Badge 93x20

Flattr badge image
URL: https://api.flattr.com/button/flattr-badge-large.png

Example

Create a 'Flattr API Documentation' thing. If it already exists a 'Flattr API Documentation' thing that thing will be displayed. If no thing exists we will autosubmit the thing. When you get your first flattr we will create the thing. This means you won't be able to see all your autosubmitted things until they get their first flattr.

URL we are using

Line breaks are added for better visibility.

https://flattr.com/submit/auto?user_id=flattr&
  url=http://developers.flattr.net&
  title=Flattr%20API%20Documentation&
  description=Flattr%20API%20Documentation&
  language=en_GB&
  tags=flattr,api,programming&
  category=text
Link the badge to a thing

Line breaks are added for better visibility.

<a href="https://flattr.com/submit/auto?
  user_id=flattr&url=http://developers.flattr.net&
  title=Flattr%20API%20Documentation&
  description=Flattr%20API%20Documentation&
  language=en_GB&tags=flattr,api,programming&category=text">

<img src="https://api.flattr.com/button/flattr-badge-large.png" 
  alt="Flattr our API Documentation" />
</a>

Result:

Flattr API Documentation

Visit Flattr.com to learn more about Flattr.