Export text items

curl --request GET \
  --url https://api.dittowords.com/v2/textItems/export \
  --header 'Authorization: <api-key>'

const options = {method: 'GET', headers: {Authorization: '<api-key>'}};

fetch('https://api.dittowords.com/v2/textItems/export', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.dittowords.com/v2/textItems/export",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.dittowords.com/v2/textItems/export"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.dittowords.com/v2/textItems/export")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "@@locale": "en",
  "user-account-header": "{FullName}'s Account",
  "user-account-settings-label": "Account Settings",
  "user-account-settings-payment-header": "Payment Details",
  "welcome-header": "Welcome to Acme Inc., {FirstName}",
  "no-notifications-label": "No new notifications",
  "@welcome-header": {
    "placeholders": {
      "FirstName": {
        "type": "String"
      }
    }
  }
}

{
  "message": "Variant with id \"<variantId>\" not found"
}

GET

textItems

export

Export text items

curl --request GET \
  --url https://api.dittowords.com/v2/textItems/export \
  --header 'Authorization: <api-key>'

const options = {method: 'GET', headers: {Authorization: '<api-key>'}};

fetch('https://api.dittowords.com/v2/textItems/export', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.dittowords.com/v2/textItems/export",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.dittowords.com/v2/textItems/export"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.dittowords.com/v2/textItems/export")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "@@locale": "en",
  "user-account-header": "{FullName}'s Account",
  "user-account-settings-label": "Account Settings",
  "user-account-settings-payment-header": "Payment Details",
  "welcome-header": "Welcome to Acme Inc., {FirstName}",
  "no-notifications-label": "No new notifications",
  "@welcome-header": {
    "placeholders": {
      "FirstName": {
        "type": "String"
      }
    }
  }
}

{
  "message": "Variant with id \"<variantId>\" not found"
}

Authorizations

Authorization

string

header

required

Query Parameters

filter

string

Stringified JSON filter object. Supports the following filter fields:

projects: array of objects with id (project developer ID)
bases: array of objects with id (base developer ID)
statuses: array of status strings (NONE, WIP, REVIEW, FINAL). These are stored status keys; by default the web app and Figma plugin display them as NONE = "Draft", WIP = "In Progress", REVIEW = "In Review", FINAL = "Final" (a workspace may rename these or replace the set entirely, so none of these keys are guaranteed to exist — read the workspace's actual statuses from GET /v2/statuses or the list_statuses MCP tool rather than assuming this set).
tags: object with values (array of tag strings) and optional operator (AND or OR, defaults to OR)
assignee: email string to match assigned text items, or null for unassigned
integrated: boolean value to filter by items that are or are not integrated into development

Without any filters, the export will include text items from all projects and no base text items. If a projects filter is provided, only text items from the specified projects will be exported. If a bases filter is provided, only text items from the specified bases will be exported. The projects and bases filters may be used together to export items from both sources. (More details about bases coming soon!)

The status and assignee filters apply only to project text items. Base text items do not contain these fields and will be exported unfiltered.

Example: {"projects":[{"id":"project-id"}], "statuses":["NONE","WIP","FINAL","REVIEW"], "tags":{"values":["tag-1"],"operator":"OR"}, "assignee":"user@example.com", "integrated":true}

sort

enum<string>

Sort order for the returned text items (default: id):

id sorts all items alphabetically by developer ID.
project_order groups items by project, returned alphabetically by project developer ID, then sorts within projects based on the custom sort order set up in the web app.

Available options:

id,

project_order

richText

enum<string>

When set to html or html_paragraphs, returns HTML-formatted rich text instead of plain text.

html_paragraphs wraps all text in <p> tags. Matches legacy behavior.
html exports without wrapping tags and uses <br /> for line breaks.

Available options:

html,

html_paragraphs

variantId

string

By default, base text will be returned. Provide a variant parameter to specify which variant of the filtered base text items to return.

format

enum<string>

required

Output format for exported text items.

Available options:

json_icu,

json_i18next,

json_vue_i18n,

ios-strings,

ios-stringsdict,

android,

arb

variableSort

enum<string>

Order in which variables are indexed in positional format exports (ios-strings, ios-stringsdict, android). "alphabetical" assigns indices by variable name (a=1, b=2, ...); "default" preserves the existing creation-order assignment.

Available options:

default,

alphabetical

excludeVariantMetadata

When true, omits the __variant-name and __variant-description keys from variant exports in JSON formats (json_i18next, json_vue_i18n, json_icu). Defaults to false. Has no effect on any other formats nor any base text (non-variant) exports, which never include these keys.

Available options:

true

includeVariableSummary

When true, adds a __variables_used key to json_i18next and json_vue_i18n exports: a deduplicated, alphabetical array of the names of the variables used in the exported strings. Defaults to false. Has no effect on other formats.

Available options:

true

Response

Returns text item developer id - text item value key/value pairs in the desired format.

For json_icu, json_i18next, json_vue_i18n formats, object keys are developer-ids (strings) and values are text (strings). Variant exports in these formats also include __variant-name and __variant-description keys (strings) unless excludeVariantMetadata=true. When includeVariableSummary=true, json_i18next and json_vue_i18n exports also include a __variables_used key, whose value is an array of variable names. For arb, values are text (strings) except for the optional top-level @@locale key (string) and @<developer-id> metadata keys, which are objects.

{key}

The text value for the developer-id key, the __variant-name/__variant-description value for variant exports, or the @@locale value for arb exports

Start here

Concepts

CLI Reference

API Reference

String Formats

MCP Reference

Ditto Specs CLI

Additional Tools

Legacy

Export text items

Authorizations

Query Parameters

Response