Media v2.2 | Dokumentation

General information

This endpoint allows you to retrieve media linked to an article. It is designed to be flexible and supports various search parameters to refine your query.

Differences between v2.0/media and v2.1/media

In version v2.1/media, a new object called identifiers has been introduced for each article in articleList. This object contains additional identifiers that simplify data linkage between different systems. The following fields are included in identifiers:

finfoSupplierId: A unique ID identifying the supplier in our system.
supplierArticleId: The supplier’s own article number.
gtin: Global Trade Item Number, a standard for product identification.

Example of data in v2.1/media

JSON

"identifiers": {
  "finfoSupplierId": "12345",
  "supplierArticleId": "67890",
  "gtin": "0123456789012"
}

Differences between v2.1/media and v2.2/media

We have introduced AI-generated alt texts for all images. Here’s what it looks like for heroImage.

JSON

"heroImage": {
  "url": https://asset.productmarketingcloud.com/api/assetstorage/1311_65ef0247-0f10-4bf1-b128-c3064c512288/original/543787.jpg,
  "contentType": "productImageSingle",
  "altText": "Målarburk i metall med orange etikett och texten "Cuprinol Ädellasyr" synlig på framsidan.",
  "lastModified": "2025-02-27T09:51:07.0000000",
  "checksum": "46ec1a1f9700622b2288a5d48fbc776a",
  "linkIndex": 0,
  "createdDate": "2021-03-22T14:26:00.0000000"
},

Övriga bilder

JSON

"images": [
  {
    "url": https://...,
    "contentType": "...",
    "altText": "Beskrivning av bild",
    ...
  }
]

Time-Based Retrieval

If no time parameters are provided, only the date will be considered.
All dates are inclusive, for both from and to.
If time is included, it must be specified in UTC (e.g., 2023-07-05T12:17:30.974Z).
If only from is provided, to is assumed to be the current time.

Pagination is mandatory if the following variables are used:

finfoSupplierId without a complementary variable
changed-from-date

Additional Notes

supplierArticleId requires that finfoSupplierId is also provided.

If the variable changed-from-date is used, the response will be filtered for the recipient’s specific suppliers.

If other variables are used, the response may include articles not belonging to the recipient’s specific suppliers. Matching against finfoArticleId might be required.

Article Information

Field	Type	Length/Size	Description
`finfoArticleId`	int	9	Unique identification number for the article.
`lastModified`	datetime	-	Most recent modification date and time for the article.
`model`	string	50	Model designation for the article.

Text field

Field	Type	Length/Size	Description
`webName`	string	100	A designation tailored for e-commerce.
`ingress`	string	250	A concise product summary. Brief with a clear beginning and end. Complements a product image to create a compelling sales presentation.
`complete`	string	4000	Descriptive product text, complementing the product summary. Should be standalone and readable without the product summary.
`bullet`	string	1000	A list of attributes and features that make the product unique.
`aiText`	string	4000	A product description generated by Finfo, based on the summary and complete product text. OpenAI is used to generate the text.
`aiBullet`	string	1000	USPs generated by Finfo based on the submitted information in the bullet field. Corrected to avoid HTML and not begin with special characters. Each bullet is on a new line. All bullets are translated into Swedish. Each line ends without a period.

General Information on AI-Generated Texts

When developing services that process text using AI, extensive testing of the results has been conducted. Despite this, there are an infinite number of text combinations, meaning there is always a small risk of unexpected behavior from the systems. AI is programmed to only process existing text and not add new information.

Currently, OpenAI’s services are used, but other services may be adopted in the future based on performance and needs. Please note that no texts are allowed to be used for training new AI models.

General Information on Linked Resources

Images and documents can be retrieved in their original format via a URL. If a 1000x1000 pixel JPG is desired, the original can be substituted with previev and the file extension set to .jpg.

All resources come with a shared linkIndex for the link type. This means that all images, regardless of contentType, will be listed sequentially.

As an end user, it is possible to store only one copy of a resource if desired, even though Finfo handles them as separate files. The receiving import should first check if the checksum for the object exists in the system and, if so, link the existing object.

If no changes have been made to the resource since we began storing lastModified and createdDate, these will be sent as "1900-01-01T00:00:00.0000000".

To ensure optimal performance and security, it is necessary for all resources retrieved through our API – including images and documents – to be stored locally by the end user. Direct linking of these resources in public environments, such as e-commerce platforms, is not permitted. This requirement protects our server resources from overload and ensures that our content is used responsibly.

heroImage

Always has "contentType": "productImageSingle" and "linkIndex": 0. The system always attempts to enrich the heroImage before placing the productImageSingle under the images relation. There can be no more than one (1) heroImage. There is no strict limitation regarding file formats for these images.

JSON

 "heroImage": {
        "url": "https://asset.productmarketingcloud.com/api/assetstorage/1311_6ff1cdc0-5e48-4d2b-8e65-f64fdc0881cc/original/253103.png",
        "contentType": "productImageSingle",
        "lastModified": "1900-01-01T00:00:00.0000000",
        "checksum": "fd5ed1879a6ebc8074fa1df4f3223f6d",
        "linkIndex": 0,
        "createdDate": "1900-01-01T00:00:00.0000000"
      }

images

The supplier has the option to submit images, where each image can be specified by its contentType. There is no strict limitation regarding file formats for these images, providing flexibility to use various types of image files.

contentType	Description	Recommended max number per product
`productImageSingle`	Product Image, Single	9
`inContextProductImage`	In Context Image	9
`productInActionImage`	Action Image	9
`productImageGroup`	Product Image Group	9
`brandLogo`	Brand Logo	9
`lineDrawing`	Line Drawing	9
`colorSampleImage`	Color Sample	9
`productSurfaceImage`	Product Surface Image	9

documents

The supplier has the option to submit a range of document types, with each document clearly defined by its unique contentType. Please note that all documents submitted must be in PDF format.

contentType	Description	Recommended max number per product
`safetyDataSheet`	Safety Data Sheet	2
`productDataSheet`	Product Data Sheet	9
`userManual`	User Manual	9
`explodedView`	Exploded View	9
`productCatalog`	Product Catalog	9
`performanceDeclaration`	Performance Declaration (CE)	1
`installationInstructions`	Installation Instructions	9
`environmentalProductDeclaration`	Environmental Product Declaration (EPD)	1
`constructionProductDeclaration`	Construction Product Declaration (BVD)	1
`certificate`	Certificate	9
`operationAndMaintenance`	Operation And Maintenance	9
`disassemblyInstructions`	Disassembly Instructions	9

designFiles

contentType	Description	Recommended max number per product
`cadFile`	CAD-file	2

energyLabels

contentType	Description	Recommended max number per product
`energyLabelingStickerPdf`	Energy Labeling Sticker (pdf)	1
`energyLabelingStickerImage`	Energy Labeling Sticker(Image)	1
`productDataSheetEnergyLabeling`	EPREL Documentation	1

externalAssets

Currently, there are two externalAssets: youtubeInstallation and youtubeMarketing. The recommendation for the supplier is to use a shortened URL like "https://youtu.be/HR-lEiGKBFs?si=hTE0FyXw_Nqo3xY1" . Finfo uses YouTubes APIs to check that the link is alive over time.

accessories / spareParts

Accessories and spare parts are linked to the product via finfoArticleId.

JSON

 "spareParts": [
        6753710,
        6753711,
        7494337,
        3988015,
        7655013
      ],
 "accessories": [
        6753710,
        6753711,
        7494337,
        7655012
      ]

Example of an API response (JSON)

JSON

{
  "pagination": {
    "offset": 0,
    "limit": 0,
    "totalCount": 1
  },
  "articleList": [
    {
      "finfoArticleId": 5061033,
      "identifiers": {
        "finfoSupplierId": 40,
        "supplierArticleId": "123456789012345678"
      },
      "lastModified": "2025-03-31T14:35:08.0000000",
      "model": "INSPEKTIONSLUCKA STÅL",
      "text": {
        "webName": "INSPEKTIONSLUCKA STÅL VIT 150X150",
        "ingress": "Inspektionslucka i vitlackerat stål med låsbar lucka för montering i vägg och tak inomhus. ",
        "complete": "Inspektionslucka i vit- eller svartlackerat stål med låsbar lucka för montering i vägg och tak inomhus. Med integrerade beslag för montering. Dörren är avtagbar vilket underlättar installation. Med 7 mm fyrkantlås och nyckel.",
        "bullet": "Pulverlackerad galvaniserad stål\nAvtagbar dörr\nMed monteringskonsoller\nMed lås och nyckel",
        "aiText": "Inspektionslucka i vit- eller svartlackerat stål med låsbar lucka för montering i vägg och tak inomhus. Med integrerade beslag för montering. Dörren är avtagbar vilket underlättar installation. Med 7 mm fyrkantlås och nyckel.",
        "aiBullet": "Pulverlackerad galvaniserad stål\nAvtagbar dörr\nMed monteringskonsoller\nMed lås och nyckel"
      },
      "heroImage": {
        "url": "https://asset.productmarketingcloud.com/api/assetstorage/1311_319f6aaf-44fa-4abc-81a5-81bef3c47f7e/original/758988.jpg",
        "contentType": "productImageSingle",
        "lastModified": "2025-03-28T12:56:00.0000000",
        "checksum": "92d583e72d27490245ee8df8b7e9f1b2",
        "linkIndex": 0,
        "createdDate": "2025-03-28T10:10:45.0000000",
        "altText": "Vit kvadratisk panel ovanför en blå kvadratisk yta, i en delvis isärmonterad position."
      },
      "images": [
        {
          "url": "https://asset.productmarketingcloud.com/api/assetstorage/1311_30c11dc8-bab3-4ae7-b3b2-8b3ac14a91c1/original/758989.webp",
          "contentType": "productImageGroup",
          "lastModified": "2025-03-28T12:56:13.0000000",
          "checksum": "8ce8ca0eecaf09418f3855167cf0b5fd",
          "linkIndex": 0,
          "createdDate": "2025-03-28T10:10:45.0000000",
          "altText": "Tre runda transparenta plastlock med två små trekantiga öppningar på varje lock."
        },
        {
          "url": "https://asset.productmarketingcloud.com/api/assetstorage/1311_cfac7b3b-d4df-4048-b3f1-36909a23da81/original/758990.jpg",
          "contentType": "inContextProductImage",
          "lastModified": "2025-03-28T12:56:14.0000000",
          "checksum": "8090344e2778ac0e6f7b1b9e10c05b0c",
          "linkIndex": 1,
          "createdDate": "2025-03-28T10:10:46.0000000",
          "altText": "Öppet tak med lucka som visar rörsystem med röda och blå ventiler i taket."
        },
        {
          "url": "https://asset.productmarketingcloud.com/api/assetstorage/1311_96fca36e-8cd0-48ee-bed4-7e36223aa68e/original/758991.jpg",
          "contentType": "productInActionImage",
          "lastModified": "2025-03-28T12:56:14.0000000",
          "checksum": "cab332a85fcda6eba27a383079940d5e",
          "linkIndex": 2,
          "createdDate": "2025-03-28T10:10:47.0000000",
          "altText": "Två armar i skjortärmar skriver med pennor på ett vitt papper på ett bord."
        },
        {
          "url": "https://asset.productmarketingcloud.com/api/assetstorage/1311_b491dc9b-08f8-46fc-a16f-5e43edc5b63d/original/758992.png",
          "contentType": "lineDrawing",
          "lastModified": "2025-03-28T12:56:15.0000000",
          "checksum": "a659bb87aaa19b09ac1255e028f2f856",
          "linkIndex": 3,
          "createdDate": "2025-03-28T10:10:48.0000000",
          "altText": "Tvärsnitt av ett tak med flera lager, inkluderar isolering och strukturella element. Numrerade etiketter visar olika delar av konstruktionen."
        },
        {
          "url": "https://asset.productmarketingcloud.com/api/assetstorage/1311_f8d5a263-c017-4e7d-b10e-03a0b12609fd/original/758993.png",
          "contentType": "brandLogo",
          "lastModified": "2025-03-28T12:56:16.0000000",
          "checksum": "87ace2bfb15d9da9e172570d72500b2b",
          "linkIndex": 4,
          "createdDate": "2025-03-28T10:10:48.0000000",
          "altText": "Svart logotyp med texten \"LOGIQ\" bredvid en kvadratisk ikon snedställd som en romb."
        },
        {
          "url": "https://asset.productmarketingcloud.com/api/assetstorage/1311_41359c8f-297a-44dd-9e87-10e44681cf98/original/758994.jpg",
          "contentType": "productSurfaceImage",
          "lastModified": "2025-03-28T12:56:17.0000000",
          "checksum": "99c6a421436b747e4b926f01027cbdcc",
          "linkIndex": 5,
          "createdDate": "2025-03-28T10:10:49.0000000",
          "altText": "Vit och något texturerad yta med en svag ljusglans i hörnet."
        },
        {
          "url": "https://asset.productmarketingcloud.com/api/assetstorage/1311_86de45e7-9212-4ef6-9961-551015738822/original/758995.webp",
          "contentType": "colorSampleImage",
          "lastModified": "2025-03-28T12:56:18.0000000",
          "checksum": "a489a38afb3d00ee9adf943801bdf6de",
          "linkIndex": 6,
          "createdDate": "2025-03-28T10:10:50.0000000",
          "altText": "Vit kräm eller lotion smetad i en cirkel mot en vit bakgrund."
        }
      ],
      "documents": [
        {
          "url": "https://asset.productmarketingcloud.com/api/assetstorage/1311_c7acd6bc-224f-4413-84fa-38e4c1d00180/original/758996.pdf",
          "contentType": "productDataSheet",
          "lastModified": "2025-03-28T12:56:35.0000000",
          "checksum": "8e55bc4304ae618b0853031832b256f9",
          "linkIndex": 0,
          "createdDate": "2025-03-28T10:11:07.0000000",
          "altText": ""
        },
        {
          "url": "https://asset.productmarketingcloud.com/api/assetstorage/1311_e710cfea-d1d8-44ea-b481-7e3d038d108e/original/758997.pdf",
          "contentType": "safetyDataSheet",
          "lastModified": "2025-03-28T12:56:36.0000000",
          "checksum": "6daee30fb8727814ff0af630c6f9798f",
          "linkIndex": 1,
          "createdDate": "2025-03-28T10:11:08.0000000",
          "altText": ""
        },
        {
          "url": "https://asset.productmarketingcloud.com/api/assetstorage/1311_722d1201-e1ea-488f-9da7-204053d25eb9/original/758998.pdf",
          "contentType": "constructionProductDeclaration",
          "lastModified": "2025-03-28T12:56:37.0000000",
          "checksum": "7bb87594bd429524ed2e11a947eb6ee4",
          "linkIndex": 2,
          "createdDate": "2025-03-28T10:11:08.0000000",
          "altText": ""
        },
        {
          "url": "https://asset.productmarketingcloud.com/api/assetstorage/1311_d425a6d8-bd73-433d-928c-3f2ccd35ff63/original/758999.pdf",
          "contentType": "environmentalProductDeclaration",
          "lastModified": "2025-03-28T12:56:38.0000000",
          "checksum": "fc43498903678cb132acaa657d6c1a7e",
          "linkIndex": 3,
          "createdDate": "2025-03-28T10:11:11.0000000",
          "altText": ""
        },
        {
          "url": "https://asset.productmarketingcloud.com/api/assetstorage/1311_4ce40b2b-3809-4d69-91a7-f46b3edc99bb/original/759000.pdf",
          "contentType": "userManual",
          "lastModified": "2025-03-28T12:56:40.0000000",
          "checksum": "f3b8179431bf114225d2a76fd96bf070",
          "linkIndex": 4,
          "createdDate": "2025-03-28T10:11:12.0000000",
          "altText": ""
        },
        {
          "url": "https://asset.productmarketingcloud.com/api/assetstorage/1311_46cce9e5-2e06-4b9d-90c2-dd0cabb7a09a/original/759001.pdf",
          "contentType": "installationInstructions",
          "lastModified": "2025-03-28T12:56:41.0000000",
          "checksum": "54fdc52492d257ecceb6088bbbfef872",
          "linkIndex": 5,
          "createdDate": "2025-03-28T10:11:12.0000000",
          "altText": ""
        },
        {
          "url": "https://asset.productmarketingcloud.com/api/assetstorage/1311_84f6eeb1-78a2-4fb8-baa6-e4938152a757/original/759002.pdf",
          "contentType": "explodedView",
          "lastModified": "2025-03-28T12:56:42.0000000",
          "checksum": "b2006303629bc85e76a4e4ca10d20894",
          "linkIndex": 6,
          "createdDate": "2025-03-28T10:11:14.0000000",
          "altText": ""
        },
        {
          "url": "https://asset.productmarketingcloud.com/api/assetstorage/1311_54364669-a7f6-4ae6-aeec-e02d45cd2233/original/759003.pdf",
          "contentType": "performanceDeclaration",
          "lastModified": "2025-03-28T12:56:42.0000000",
          "checksum": "1e3542e19f050e842f782ec119e1b576",
          "linkIndex": 7,
          "createdDate": "2025-03-28T10:11:15.0000000",
          "altText": ""
        },
        {
          "url": "https://asset.productmarketingcloud.com/api/assetstorage/1311_f6d7058e-0580-4e81-b9df-585f59d94217/original/759004.pdf",
          "contentType": "operationAndMaintenance",
          "lastModified": "2025-03-28T12:56:44.0000000",
          "checksum": "24e43183ada90cd6e0fa9d65187b66bd",
          "linkIndex": 8,
          "createdDate": "2025-03-28T10:11:16.0000000",
          "altText": ""
        },
        {
          "url": "https://asset.productmarketingcloud.com/api/assetstorage/1311_45140c1c-66b3-4f14-bc11-dd9115851c00/original/759005.pdf",
          "contentType": "certificate",
          "lastModified": "2025-03-28T12:56:45.0000000",
          "checksum": "4fd7ad945554ce16ee68b98a25ddf7bd",
          "linkIndex": 9,
          "createdDate": "2025-03-28T10:11:16.0000000",
          "altText": ""
        },
        {
          "url": "https://asset.productmarketingcloud.com/api/assetstorage/1311_1bca7850-a1f3-47dd-a678-250b0f1d84b9/original/759006.pdf",
          "contentType": "disassemblyInstructions",
          "lastModified": "2025-03-28T12:56:47.0000000",
          "checksum": "d680c54f69e95b501c76ac2f92faf90a",
          "linkIndex": 10,
          "createdDate": "2025-03-28T10:11:17.0000000",
          "altText": ""
        }
      ],
      "energyLabels": [
        {
          "url": "https://asset.productmarketingcloud.com/api/assetstorage/1311_ec2458d2-7b03-40fb-84b1-4f2a75e2d48c/original/759007.pdf",
          "contentType": "energyLabelingStickerPdf",
          "lastModified": "2025-03-28T12:57:52.0000000",
          "checksum": "b86bdc6942e0422d5bc6dc53e45e405f",
          "linkIndex": 0,
          "createdDate": "2025-03-28T10:11:25.0000000",
          "altText": ""
        },
        {
          "url": "https://asset.productmarketingcloud.com/api/assetstorage/1311_42e3e585-b875-47cc-82da-455f78d3480a/original/759008.png",
          "contentType": "energyLabelingStickerImage",
          "lastModified": "2025-03-28T12:57:52.0000000",
          "checksum": "922a335942d848d850574aa5cfeafa85",
          "linkIndex": 1,
          "createdDate": "2025-03-28T10:11:25.0000000",
          "altText": ""
        },
        {
          "url": "https://asset.productmarketingcloud.com/api/assetstorage/1311_fd75e766-cd16-46de-bb64-6ebff46f3964/original/759009.pdf",
          "contentType": "productDataSheetEnergyLabeling",
          "lastModified": "2025-03-28T12:57:53.0000000",
          "checksum": "e994aa1bb84bf127e9606a0227a16345",
          "linkIndex": 2,
          "createdDate": "2025-03-28T10:11:26.0000000",
          "altText": ""
        }
      ],
      "designFiles": [
        {
          "url": "https://asset.productmarketingcloud.com/api/assetstorage/1311_9ea76412-b21a-4fad-aa87-c0ce6814ad92/original/759010.dwg",
          "contentType": "cadFile",
          "lastModified": "2025-03-28T12:57:35.0000000",
          "checksum": "9d585313457056bbe38959731638fc9f",
          "linkIndex": 0,
          "createdDate": "2025-03-28T10:11:29.0000000",
          "altText": ""
        }
      ],
      "externalAssets": {
        "youtubeInstallation": "https://youtu.be/u_i0zRzBPOQ?si=L3HSmF0sqh1zCFW7",
        "youtubeMarketing": "https://youtu.be/u_i0zRzBPOQ?si=L3HSmF0sqh1zCFW7"
      },
      "spareParts": [
        6364041
      ],
      "accessories": [
        4197202
      ]
    }
  ]
}

General information

Differences between v2.0/media and v2.1/media

Example of data in v2.1/media

Differences between v2.1/media and v2.2/media

Time-Based Retrieval

Pagination - Limitation/Offset Required for Certain Variables

Additional Notes

Article Information

Text field

General Information on AI-Generated Texts

General Information on Linked Resources

heroImage

images

documents

designFiles

energyLabels

externalAssets

accessories / spareParts

Example of an API response (JSON)