Get store translation data

Requires read_translation access scope.
For more info, refer to:
access permission.
GET https://{handle}.myshopline.com/admin/openapi/v20260301/ugc/resource.json
handle : The store's unique identifier, which is the prefix of the store's domain name. For example, if a store's domain name is open001.myshopline.com , the store handle is open001 .
Get a store's translation data.
Query Parameters
  • outdated string
    Query outdated or up-to-date translation data. If the original content has been updated but the translation hasn't, the translation is marked as outdated.
    • true: Query outdated translation data.
    • false: Query up-to-date translation data.
  • resource_id string required
    The unique identifier for the resource.
    For example, when resource_type is PRODUCT, this parameter value is the product ID.
  • resource_type string required
    The type of the resource.
    Example: PRODUCT
  • locale string
    Language used in the market.
    Example: en
  • market string
    The primary market for the store.
    Example: 2805652120189036673434
Request Headers
  • Content-Type string required
    The field must be set to the fixed value application/json; charset=utf-8.
  • Authorization string required
    The access token for the API resource. Refer to App authorization to obtain the access token, and then pass the obtained token in the Bearer format.
    Example:
    Bearer eyJhbGciOiJIUzUxMiJ9.eyJhcHBLZXkiOiJmMjM3OWQyMTYyOGMzM2QxMWRiMWZkYjY5N2EzZjdjMjZlNGMwYTA5Iiwic2VsbGVySWQiOiIyMDAwMjM0ODgwIiwic3RvcmVJZCI6IjE2NzIzNjk3Mjk2MDYiLCJ2ZXJzaW9uIjoiVjIiLCJkb21haW4iOiJodHRwczovL3NsLW9wZW4tc2cubXlzaG9wbGluZS5jb20iLCJ0aW1lc3RhbXAiOjE2NzUzMTk0OTI0MzksImlzcyI6Inlzb3VsIiwiZXhwIjoxNzY5OTI3NDkyfQ.UwQzomM2veGCUaOZ0paUxq5dpc7DXuhHYFvsQ_uIAKduzWcb_j2E4q_36El83sp145D4cKbpcE5KCeeIz-JNQw
Status Codes
For the complete list of codes and messages, see Http status code.
Response Headers
  • traceId
    A globally unique identifier for the request. It is used to track the request flow throughout the system, allowing for easy location and debugging when issues arise.
Response Body
  • dataobject
    Response data.
  • content_listobject[]
    List of translation corpus corresponding to the resource.
  • locale string
    Language used in the market.
    Example: en
  • market string
    The primary market for the store.
    Example: 2805652120189036673434
  • outdated boolean
    Whether the translation data is outdated or up-to-date. If the original content has been updated but its translation has not, the translation data is considered to be outdated.
    • true: The translation data is outdated.
    • false: The translation data is up-to-date.
  • resource_content string
    Translated resource content.
    Example: The content of the key to the key of the cot
  • resource_content_type string
    The data type of the content returned by resource_content. For example, if resource_content returns the product title Multi-color stitching dress, resource_content_type returns STRING.
    Valid values are:
    • STRING: String
    • JSON_STRING: JSON string
    • LIST_MULTI_LINE_TEXT_FIELD: Multi-line text list
    • LIST_SINGLE_LINE_TEXT_FIELD: Single-line text list
    • LIST_URL: URL list
    • SINGLE_LINE_TEXT_FIELD: Single-line text
    • LIST_FILE_REFERENCE: File reference list
    • HTML: HTML
    • JSON: JSON data
    • URL: URL
    • FILE_REFERENCE: File Reference
    • MULTI_LINE_TEXT_FIELD: Multi-line text
    • RICH_TEXT_FIELD: Rich text
    • INLINE_RICH_TEXT: Inline rich text
  • resource_field string
    The attribute associated with the content of resource_content. For example, if resource_content returns a product title, resource_field returns title.
  • updated_at string
    The date and time when the translation data was last updated. Format: ISO 8601.
    Example: 2023-09-07T15:50:00Z
  • default_content_listobject[]
    Original untranslated corpus content list.
  • resource_content string
    The original corpus of the resource.
    Example: Title content
  • resource_content_type string
    The data type of the content returned by resource_content. For example, if resource_content returns the product title Multi-color stitching dress, resource_content_type returns STRING.
    Valid values are:
    • STRING: String
    • JSON_STRING: JSON string
    • LIST_MULTI_LINE_TEXT_FIELD: Multi-line text list
    • LIST_SINGLE_LINE_TEXT_FIELD: Single-line text list
    • LIST_URL: URL list
    • SINGLE_LINE_TEXT_FIELD: Single-line text
    • LIST_FILE_REFERENCE: File reference list
    • HTML: HTML
    • JSON: JSON data
    • URL: URL
    • FILE_REFERENCE: File Reference
    • MULTI_LINE_TEXT_FIELD: Multi-line text
    • RICH_TEXT_FIELD: Rich text
    • INLINE_RICH_TEXT: Inline rich text
  • resource_field string
    The attribute associated with the content of resource_content. For example, if resource_content is a product title, resource_field is title.
  • resource_id string
    The unique identifier for the resource.
    For example, when resource_type is PRODUCT, this parameter value is the product ID.
  • resource_type string
    The type of the resource.
    Example: PRODUCT
API Explorer
https://openapiceshidianpu.myshopline.com/admin/openapi/v20260301

ParamOptions

— query required
— query required
— header required
— query
— query
— query

Language

curl --request GET \
     --url https://openapiceshidianpu.myshopline.com/admin/openapi/v20260301/ugc/resource.json \
     --header 'Authorization: Bearer eyJhbGciOiJIUzUxMiJ9.eyJhcHBLZXkiOiJmMjM3OWQyMTYyOGMzM2QxMWRiMWZkYjY5N2EzZjdjMjZlNGMwYTA5Iiwic2VsbGVySWQiOiIyMDAwMjM0ODgwIiwic3RvcmVJZCI6IjE2NzIzNjk3Mjk2MDYiLCJ2ZXJzaW9uIjoiVjIiLCJkb21haW4iOiJodHRwczovL3NsLW9wZW4tc2cubXlzaG9wbGluZS5jb20iLCJ0aW1lc3RhbXAiOjE2NzUzMTk0OTI0MzksImlzcyI6Inlzb3VsIiwiZXhwIjoxNzY5OTI3NDkyfQ.UwQzomM2veGCUaOZ0paUxq5dpc7DXuhHYFvsQ_uIAKduzWcb_j2E4q_36El83sp145D4cKbpcE5KCeeIz-JNQw' \
     --header 'Content-Type: application/json; charset=utf-8' \
     --header 'accept: application/json'
Examples
Get the original and translated data of a specific resource, market, and language
Response
{
  "data": {
    "contentList": {
      "Value": [
        {
          "locale": "en",
          "market": "2805979406510623080534",
          "outdated": false,
          "resourceContent": "test content",
          "resourceContentType": "STRING",
          "resourceField": "title",
          "updatedAt": "2025-01-04T07:01:17Z"
        }
      ]
    },
    "defaultContentList": {
      "Value": [
        {
          "locale": "DEFAULT",
          "market": "DEFAULT",
          "outdated": false,
          "resourceContent": "test content",
          "resourceContentType": "STRING",
          "resourceField": "title",
          "updatedAt": ""
        }
      ]
    },
    "resourceId": "12259794083525432746782293",
    "resourceType": "COLLECTION"
  }
}
Was this article helpful to you?
SHOPLINE
SHOPLINE
SHOPLINE Enterprise
Legal
Privacy
Terms
Developer Agreement
LinkedInEmail
LinkedInEmail
© Copyright 2013-2025 SHOPLINE Limited.