Alternatives link a source article to substitute articles a customer could accept in its place. Pushing them lets Mercura offer a valid alternative when the requested article is unavailable or less suitable.

You can:

• POST /articles/alternatives — bulk-upsert up to 100,000 alternative links in a single call. Async — returns a JobAck; poll GET /jobs/{job_id} for status. Each row upserts the (source_article_number, alternative_article_number) pair.
• GET /articles/alternatives — cursor-paginated list of your alternative links. Pass source_article_number to list one article's alternatives, or modified_since on the first page to fetch only what changed.