Skip to contentDevelopersPrezly website
Stories

Get Story Translation Suggestions

Read saved translation candidates when the account has access to the suggestions feature.

Personal tokens are not supported for this endpoint. Use an integration API key. Your account must also have access to the requested data. Authentication

Read the guide

GET
/stories/{story_id}/translation-suggestions

Requires the story_translation_suggestions feature. Returns up to five saved candidates visible to the caller. Cross-site candidates additionally require cross_site_translations. This request never generates embeddings or links stories. No fresh matches returns an empty array. Similarity scores are cosine similarities, not translation probabilities. Candidates require body similarity >= 0.85 and title similarity >= 0.60, different cultures, matching publication state and visibility, and eligibility to link into the source translation group. Results rank by body similarity, then publication-date distance for ties, within the saved top-20 candidates.

Personal access tokens are not supported for this endpoint. Use an integration API key with the required permissions.

Authorization

API_key
headerAuthorizationBearer <token>

Bearer authentication using an integration API key, or a personal access token only where the operation explicitly supports it. Every listed personal-token scope is required; owner permissions and newsroom access still apply.

Path Parameters

story_id*string

Story UUID or ID

Length1 <= length

Response Body

Saved translation suggestions

application/json
  1. response
suggestions*array<>
Itemsitems <= 5
Example Request
curl -X GET 'https://api.prezly.com/v2/stories/string/translation-suggestions'
Example Response
{  "suggestions": [    {      "story": {        "id": 0,        "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",        "title": "string",        "culture_code": "string",        "newsroom_id": 0,        "publication_status": "string",        "visibility": "public",        "published_at": "2019-08-24T14:15:22Z"      },      "similarity": {        "title": 0,        "body": 0      },      "publication_date_distance_days": 0    }  ]}