countdown

Animated countdown GIF from the current UTC time to endDate.

Animated countdown GIF from the current UTC time to endDate. Always uncached. Supports 5 templates (default, minimal, neon, retro, corporate) and full customization: colors, fonts, dimensions, padding, cell padding, labels, dividers. Animates for seconds frames at fps.

get/api/countdown/gif

Request

  • Base URL: https://2s.io
  • URL: https://2s.io/api/countdown/gif
  • Auth: API key in header PAYMENT-SIGNATURE

Query parameters

endDatestring date-time required

End of the date range (YYYY-MM-DD).

template'default' | 'minimal' | 'neon' | 'retro' | 'corporate'

Template.

secondsinteger

Seconds.

fpsinteger

Fps.

widthinteger

Width.

heightinteger

Height.

paddinginteger

Padding.

cellPaddinginteger

Cell padding.

digitFontSizeinteger

Digit font size.

labelFontSizeinteger

Label font size.

labelPaddingYinteger

Label padding y.

digitPaddingYinteger

Digit padding y.

letterSpacingnumber

Letter spacing.

bgstring

Bg.

fgstring

Fg.

labelColorstring

Label color.

dividerColorstring

Divider color.

digitFont'mono' | 'sans'

Digit font.

labelFont'mono' | 'sans'

Label font.

digitWeight'regular' | 'bold'

Digit weight.

boolean
OR
'true' | 'false' | '0' | '1'

Show labels.

boolean
OR
'true' | 'false' | '0' | '1'

Show days.

dividerCharstring

Divider char.

expiredTextstring

Expired text.

labelDaysstring

Label days.

labelHoursstring

Label hours.

labelMinutesstring

Label minutes.

labelSecondsstring

Label seconds.

trial1

Try before you buy. Set to 1 for one free real call per endpoint per hour — no wallet or payment needed — to verify the endpoint before paying. Equivalent to sending the "X-2s-Trial: 1" request header. Listed only on operations that offer a trial; the others always answer 402.

Response

OK

Changes

No recorded changes to this operation across all 1 revision of this API.