GeniuslinkAPI

<back to all web services

ProductMetadataLookupRequest

Requires Authentication
The following routes are available for this service:
GET/v3.5/product-metadata/lookup
ProductMetadataLookupRequest Parameters:
NameParameterData TypeRequiredDescription
UrlquerystringNo
ProductMetadataLookupResponse Parameters:
NameParameterData TypeRequiredDescription
ProductMetadataformProductDataNo
ResponseStatusformResponseStatusNo
ProductData Parameters:
NameParameterData TypeRequiredDescription
AttributesformProductAttributesNo
RetailerSpecificAttributesformRetailerSpecificAttributesNo
RawSourceDataformstringNo
ProductAttributes Parameters:
NameParameterData TypeRequiredDescription
RetailerformstringNo
RetailerGuidformGuidNo
StorefrontformstringNo
StorefrontIso2formstringNo
StorefrontGuidformGuidNo
CategoryformstringNo
CategoryGuidformGuidNo
BrandformstringNo
BrandGuidformGuidNo
ManufacturerformstringNo
ManufacturerGuidformGuidNo
IdentifiersformProductIdentifiersNo
ItemAttributesformItemAttributesNo
ProductIdentifiers Parameters:
NameParameterData TypeRequiredDescription
ProductGuidformGuidNo
GtinsformList<string>No
MpnsformList<string>No
Ean8formList<string>No
Ean13formList<string>No
Isbn9formList<string>No
Isbn10formList<string>No
Isbn13formList<string>No
ITF14formList<string>No
Upc12formList<string>No
ItemAttributes Parameters:
NameParameterData TypeRequiredDescription
BookformBookAttributesNo
AudiobookformAudiobookAttributesNo
EBookformEBookAttributesNo
BookAttributes Parameters:
NameParameterData TypeRequiredDescription
AuthorsformList<string>No
RetailerSpecificAttributes Parameters:
NameParameterData TypeRequiredDescription
NameformstringNo
DescriptionformstringNo
SkusformList<string>No
AsinformstringNo
UrlformUriNo
ProductImagesformDictionary<string, Uri>No
AdditionalDataformDictionary<string, string>No

To override the Content-type in your clients, use the HTTP Accept Header, append the .jsv suffix or ?format=jsv

HTTP + JSV

The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.

GET /v3.5/product-metadata/lookup HTTP/1.1 
Host: geniuslink-api-zane.dev.platform.georiot.com 
Accept: text/jsv
HTTP/1.1 200 OK
Content-Type: text/jsv
Content-Length: length

{
	productMetadata: 
	{
		attributes: 
		{
			retailer: String,
			storefront: String,
			storefrontIso2: String,
			category: String,
			brand: String,
			manufacturer: String,
			identifiers: 
			{
				gtins: 
				[
					String
				],
				mpns: 
				[
					String
				],
				ean8: 
				[
					String
				],
				ean13: 
				[
					String
				],
				isbn9: 
				[
					String
				],
				isbn10: 
				[
					String
				],
				isbn13: 
				[
					String
				],
				itf14: 
				[
					String
				],
				upc12: 
				[
					String
				]
			},
			itemAttributes: 
			{
				book: 
				{
					authors: 
					[
						String
					]
				},
				audiobook: 
				{
					authors: 
					[
						String
					]
				},
				ebook: 
				{
					authors: 
					[
						String
					]
				}
			}
		},
		retailerSpecificAttributes: 
		{
			name: String,
			description: String,
			skus: 
			[
				String
			],
			asin: String,
			productImages: {},
			additionalData: 
			{
				String: String
			}
		},
		rawSourceData: String
	},
	responseStatus: 
	{
		errorCode: String,
		message: String,
		stackTrace: String,
		errors: 
		[
			{
				errorCode: String,
				fieldName: String,
				message: String,
				meta: 
				{
					String: String
				}
			}
		],
		meta: 
		{
			String: String
		}
	}
}