daydreamer-json's picture
feat(api): add sticker video download endpoint documentation
153d158 verified

API Documentation

This proxy server provides endpoints to access LINE Store API and CDN resources.

Base URL: http://localhost:3000 (replace with your actual server URL)
Demo server URL: https://daydreamer-json-line-stamp-api-proxy.hf.space

Root Endpoint

GET /

Returns information about the proxy server and example usage.


Search Products

GET /api/search

Search for LINE products (stickers, emoji, etc.).

Query Parameters

  • category: string (required)
    • Values: 'sticker', 'emoji', 'theme', 'family'
  • type: string (required)
    • Values: 'ALL', 'OFFICIAL', 'CREATORS', 'SUBSCRIPTION'
  • query: string (required)
    • Search query string
  • offset: number (required)
    • Pagination offset
  • limit: number (required)
    • Number of results to return
  • lang: string (optional)
    • Language code for search results (e.g., 'en', 'ja')

Response

Returns the search results from LINE Store API in JSON format.


Get Product Metadata

Sticker Metadata

GET /api/meta/sticker/:productId

Get metadata for a sticker product.

Path Parameters

  • productId: number (integer)
    • Sticker product ID

Query Parameters

  • device_type: string (optional, default: 'ios')
    • Values: 'ios', 'android', 'pc'

Emoji Metadata

GET /api/meta/emoji/:productId

Get metadata for an emoji product.

Path Parameters

  • productId: string (hexadecimal)
    • Emoji product ID

Query Parameters

  • device_type: string (optional, default: 'ios')
    • Values: 'ios', 'android'

Download Stickers

Sticker Package ZIP

GET /api/download/sticker/zip/:productId

Download a ZIP file containing all stickers in a product.

Path Parameters

  • productId: number (integer)
    • Sticker product ID

Query Parameters

  • device_type: string (optional, default: 'ios')
    • Values: 'ios', 'android'
  • is_static: boolean (optional, default: false)
    • If true, downloads static stickers only
  • size: number (optional, default: 2)
    • Values: 1 (normal), 2 (high resolution)

Individual Sticker

GET /api/download/sticker/single/:stickerId

Download a single sticker image.

Path Parameters

  • stickerId: number (integer)
    • Individual sticker ID

Query Parameters

  • device_type: string (optional, default: 'ios')
    • Values: 'ios', 'android'
  • is_static: boolean (optional, default: false)
    • If true, downloads static version
  • size: number (optional, default: 2)
    • Values: 1 (normal), 2 (high resolution)
  • gif: boolean (optional, default: false)
    • If true and the sticker is animated, converts to GIF format

Sticker Thumbnail

GET /api/download/sticker/thumb/:productId

Download the thumbnail image for a sticker product.

Path Parameters

  • productId: number (integer)
    • Sticker product ID

Query Parameters

  • device_type: string (optional, default: 'ios')
    • Values: 'ios', 'android', 'pc'

Individual Sticker Sound

GET /api/download/sticker/sound/single/:stickerId

Download the sound file for an individual sticker.

Path Parameters

  • stickerId: number (integer)
    • Individual sticker ID

Query Parameters

  • device_type: string (optional, default: 'ios')
    • Values: 'ios', 'android', 'pc'

Product Sound Thumbnail

GET /api/download/sticker/sound/thumb/:productId

Download the main sound file for a sticker product.

Path Parameters

  • productId: number (integer)
    • Sticker product ID

Query Parameters

  • device_type: string (optional, default: 'ios')
    • Values: 'ios', 'android', 'pc'

Sticker video (MP4)

GET /api/download/sticker/mp4/single/:stickerId

Download a video file combining sticker image and sound.

Path Parameters

  • stickerId: number (integer)
    • Individual sticker ID

Query Parameters

  • device_type: string (optional, default: 'ios')
    • Values: 'ios', 'android'
  • is_static: boolean (optional, default: false)
    • If true, downloads static version
  • size: number (optional, default: 2)
    • Values: 1 (normal), 2 (high resolution)

Download Emojis

Emoji Package ZIP

GET /api/download/emoji/zip/:productId

Download a ZIP file containing all emojis in a product.

Path Parameters

  • productId: string (hexadecimal)
    • Emoji product ID

Query Parameters

  • device_type: string (optional, default: 'ios')
    • Values: 'ios', 'android'
  • is_static: boolean (optional, default: false)
    • If true, downloads static emojis only

Individual Emoji

GET /api/download/emoji/single/:productId/:iconIndex

Download a single emoji image.

Path Parameters

  • productId: string (hexadecimal)
    • Emoji product ID
  • iconIndex: number (integer)
    • Emoji icon index

Query Parameters

  • device_type: string (optional, default: 'ios')
    • Values: 'ios', 'android'
  • is_static: boolean (optional, default: false)
    • If true, downloads static version
  • gif: boolean (optional, default: false)
    • If true and the emoji is animated, converts to GIF format

Emoji Thumbnail

GET /api/download/emoji/thumb/:productId

Download the thumbnail image for an emoji product.

Path Parameters

  • productId: string (hexadecimal)
    • Emoji product ID

Get Product JSON-LD Metadata

Get JSON-LD metadata from LINE Store web pages.

Sticker Web Metadata

GET /sticker/:productId

Get JSON-LD metadata for a sticker product from the LINE Store web page.

Path Parameters

  • productId: number (integer)
    • Sticker product ID

Headers

  • Accept-Language: string (optional)
    • Language preference for the web page (e.g., 'ja', 'en', 'ko'). Defaults to 'ja' if not provided.

Response

Returns the JSON-LD metadata found in the web page's <head> section.

Emoji Web Metadata

GET /emoji/:productId

Get JSON-LD metadata for an emoji product from the LINE Store web page.

Path Parameters

  • productId: string (hexadecimal)
    • Emoji product ID (hexadecimal string)

Headers

  • Accept-Language: string (optional)
    • Language preference for the web page (e.g., 'ja', 'en', 'ko'). Defaults to 'ja' if not provided.

Response

Returns the JSON-LD metadata found in the web page's <head> section.