Search TM content

Search TM content within a single Translation Memory (TM) with metadata filters. Interpreting found results * Searching a TARGET locale → response contains the matching target TUV + the source TUV for that TU. * Searching a SOURCE locale → response contains the full TU (matching source TUV + all target TUVs). One TU counts as a single found item, but the UI should render N <srcTUV, targetTUV> pairs. Query modes 1) Exact query (plain text without wildcard markers and not regex mode) * If `sourceOperator|targetOperator: IS|IS_NOT` (exact mode) → the whole field must (not) match exactly. * If `sourceOperator|targetOperator: CONTAINS|DOES_NOT_CONTAIN` (contains mode) → the text may appear anywhere within the field. 2) Wildcard query (`sourceUseRegex|targetUseRegex: false`) * Uses '?' (single character) and '*' (multi-character) placeholders. * IMPORTANT: '\*' is only supported as a terminal suffix (end of word/token). Example: 'trans*' matches 'translation', 'transfer'; 'tr?nslate' matches 'translate'/'trenslate'. 3) Regex query (`sourceUseRegex|targetUseRegex: true`) * REGEXP searches for substrings (not whole-word by default). * Elasticsearch 8.14.3 / Lucene 9.10 supports \w, \W, \d, \D, \s, \S; word boundaries \b/\B are NOT supported. Prefer WILDCARD for word-based matching. Metadata filters (`filters`) * You can provide multiple metadata filters (projects, domain, subdomains, ...) - AND logic is applied. Defaults & limitations * Whitespace is normalized; WILDCARD processor can filter out Phrase tags. * Post-filtering: even WILDCARD results are validated to enforce correct word order. * The single query might be capped at certain limit (currently 10k results) Execution & performance notes * REGEXP uses non-analyzed normalized fields; additional post-validation ensures fidelity to the original query text. * Matching TUVs are collected until `batchSize` is reached; only then are sibling TUVs from the same TU loaded. * For pagination (changing `index`), ES results are re-processed to keep `totalElements` accurate.

POST /api2/v1/transMemories/{transMemoryUid}/searchContent

Search TM content

cURL

curl --request POST \
  --url https://cloud.memsource.com/web/api2/v1/transMemories/{transMemoryUid}/searchContent \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "filters": [
    {
      "clients": [
        {
          "uid": "<string>"
        }
      ],
      "createdByUsers": [
        {
          "uid": "<string>"
        }
      ],
      "createdFrom": "2023-11-07T05:31:56Z",
      "createdTo": "2023-11-07T05:31:56Z",
      "domains": [
        {
          "uid": "<string>"
        }
      ],
      "filename": "<string>",
      "keyName": "<string>",
      "lastModifiedFrom": "2023-11-07T05:31:56Z",
      "lastModifiedTo": "2023-11-07T05:31:56Z",
      "modifiedByUsers": [
        {
          "uid": "<string>"
        }
      ],
      "projects": [
        {
          "uid": "<string>"
        }
      ],
      "subdomains": [
        {
          "uid": "<string>"
        }
      ]
    }
  ],
  "sourceMatchCase": true,
  "sourceQuery": "<string>",
  "sourceUseRegex": true,
  "targetLangs": [
    "<string>"
  ],
  "targetMatchCase": true,
  "targetQuery": "<string>",
  "targetUseRegex": true,
  "tuId": "<string>"
}
'

200

{
  "batchSize": 123,
  "content": [
    {
      "srcTuv": {
        "client": {
          "name": "<string>",
          "uid": "<string>"
        },
        "createdAt": "2023-11-07T05:31:56Z",
        "createdBy": {
          "name": "<string>",
          "uid": "<string>"
        },
        "ctxSegmentKey": "<string>",
        "domain": {
          "name": "<string>",
          "uid": "<string>"
        },
        "filename": "<string>",
        "locale": "<string>",
        "modifiedAt": "2023-11-07T05:31:56Z",
        "modifiedBy": {
          "name": "<string>",
          "uid": "<string>"
        },
        "nextSegmentKey": "<string>",
        "previousSegmentKey": "<string>",
        "project": {
          "name": "<string>",
          "uid": "<string>"
        },
        "subdomain": {
          "name": "<string>",
          "uid": "<string>"
        },
        "text": "<string>",
        "textMatches": [
          {
            "endIndex": 123,
            "startIndex": 123
          }
        ]
      },
      "targetLocaleToTuv": {},
      "tmName": "<string>",
      "tmUid": "<string>",
      "tuId": "<string>"
    }
  ],
  "currentIndex": 123,
  "hasMore": true,
  "totalElements": 123
}

Authorizations

ApiTokenOAuth2

Authorization · string · header · required

Get a token from auth/login endpoint and then pass it in the Authorization HTTP header in every subsequent API call. For more information visit our help center.

Path Parameters

transMemoryUid · string · required

Query Parameters

index · integer<int32> · default: 0

Required range: x >= 0

batchSize · integer<int32> · default: 50

Batch size, accepts values between 1 and 100, default 50

Required range: 0 <= x <= 100

Body

application/json

filters · object[]

Filter for related metadata (e.g. project, client, ...). It's possible to provide multiple filter criteria of same type (AND logic applied)

Show child attributes

sourceMatchCase · boolean

If true, sourceQuery will be considered case-sensitive

sourceOperator · enum<string>

Matching operator for sourceQuery. Default: IS

Available options: IS, IS_NOT, CONTAINS, DOES_NOT_CONTAIN

sourceQuery · string

Query string for source part of segment. Provide either sourceQuery or targetQuery (not both)

sourceUseRegex · boolean

If true, sourceQuery will be considered to be regular expression

targetLangs · string[]

Target languages/locales of the given TM to search in. Example: en_us

targetMatchCase · boolean

If true, targetQuery will be considered case-sensitive

targetOperator · enum<string>

Matching operator for targetQuery. Default: IS

Available options: IS, IS_NOT, CONTAINS, DOES_NOT_CONTAIN

targetQuery · string

Query string for target part of segment. Provide either sourceQuery or targetQuery (not both)

targetUseRegex · boolean

If true, targetQuery will be considered to be regular expression

tuId · string

ID of the translation unit

Response

200

application/json

successful operation

batchSize · integer<int32>

content · object[]

Show child attributes

currentIndex · integer<int32>

hasMore · boolean

totalElements · integer<int32>