GeniuslinkAPI

<back to all web services

ProductMetadataLookupRequest

Requires Authentication
The following routes are available for this service:
GET/v3.5/product-metadata/lookup
using System;
using System.IO;
using System.Collections;
using System.Collections.Generic;
using System.Runtime.Serialization;
using ServiceStack;
using ServiceStack.DataAnnotations;
using GeniuslinkAPI.ServiceModel.V4.Products.Requests;
using GeniuslinkAPI.ServiceModel.V4.Products.Responses;
using Geniuslink.Products.QueuedService.Contracts.V1.DTOs;

namespace Geniuslink.Products.QueuedService.Contracts.V1.DTOs
{
    [DataContract]
    public partial class AudiobookAttributes
        : BookAttributes
    {
    }

    [DataContract]
    public partial class BookAttributes
    {
        [DataMember(Name="authors", EmitDefaultValue=false)]
        public virtual List<string> Authors { get; set; }
    }

    [DataContract]
    public partial class EBookAttributes
        : BookAttributes
    {
    }

    [DataContract]
    public partial class ItemAttributes
    {
        [DataMember(Name="book", EmitDefaultValue=false)]
        public virtual BookAttributes Book { get; set; }

        [DataMember(Name="audiobook", EmitDefaultValue=false)]
        public virtual AudiobookAttributes Audiobook { get; set; }

        [DataMember(Name="ebook", EmitDefaultValue=false)]
        public virtual EBookAttributes EBook { get; set; }
    }

    [DataContract]
    public partial class ProductAttributes
    {
        [DataMember(Name="retailer", EmitDefaultValue=false)]
        public virtual string Retailer { get; set; }

        [DataMember(Name="retailerGuid", EmitDefaultValue=false)]
        public virtual Guid RetailerGuid { get; set; }

        [DataMember(Name="storefront", EmitDefaultValue=false)]
        public virtual string Storefront { get; set; }

        [DataMember(Name="storefrontIso2", EmitDefaultValue=false)]
        public virtual string StorefrontIso2 { get; set; }

        [DataMember(Name="storefrontGuid", EmitDefaultValue=false)]
        public virtual Guid StorefrontGuid { get; set; }

        [DataMember(Name="category", EmitDefaultValue=false)]
        public virtual string Category { get; set; }

        [DataMember(Name="categoryGuid", EmitDefaultValue=false)]
        public virtual Guid CategoryGuid { get; set; }

        [DataMember(Name="brand", EmitDefaultValue=false)]
        public virtual string Brand { get; set; }

        [DataMember(Name="brandGuid", EmitDefaultValue=false)]
        public virtual Guid BrandGuid { get; set; }

        [DataMember(Name="manufacturer", EmitDefaultValue=false)]
        public virtual string Manufacturer { get; set; }

        [DataMember(Name="manufacturerGuid", EmitDefaultValue=false)]
        public virtual Guid ManufacturerGuid { get; set; }

        [DataMember(Name="identifiers", EmitDefaultValue=false)]
        public virtual ProductIdentifiers Identifiers { get; set; }

        [DataMember(Name="itemAttributes", EmitDefaultValue=false)]
        public virtual ItemAttributes ItemAttributes { get; set; }
    }

    [DataContract]
    public partial class ProductData
    {
        [DataMember(Name="attributes", EmitDefaultValue=false)]
        public virtual ProductAttributes Attributes { get; set; }

        [DataMember(Name="retailerSpecificAttributes", EmitDefaultValue=false)]
        public virtual RetailerSpecificAttributes RetailerSpecificAttributes { get; set; }

        [DataMember(Name="rawSourceData", EmitDefaultValue=false)]
        public virtual string RawSourceData { get; set; }
    }

    [DataContract]
    public partial class ProductIdentifiers
    {
        [DataMember(Name="productGuid", EmitDefaultValue=false)]
        public virtual Guid ProductGuid { get; set; }

        [DataMember(Name="gtins", EmitDefaultValue=false)]
        public virtual List<string> Gtins { get; set; }

        [DataMember(Name="mpns", EmitDefaultValue=false)]
        public virtual List<string> Mpns { get; set; }

        [DataMember(Name="ean8", EmitDefaultValue=false)]
        public virtual List<string> Ean8 { get; set; }

        [DataMember(Name="ean13", EmitDefaultValue=false)]
        public virtual List<string> Ean13 { get; set; }

        [DataMember(Name="isbn9", EmitDefaultValue=false)]
        public virtual List<string> Isbn9 { get; set; }

        [DataMember(Name="isbn10", EmitDefaultValue=false)]
        public virtual List<string> Isbn10 { get; set; }

        [DataMember(Name="isbn13", EmitDefaultValue=false)]
        public virtual List<string> Isbn13 { get; set; }

        [DataMember(Name="itf14", EmitDefaultValue=false)]
        public virtual List<string> ITF14 { get; set; }

        [DataMember(Name="upc12", EmitDefaultValue=false)]
        public virtual List<string> Upc12 { get; set; }
    }

    [DataContract]
    public partial class RetailerSpecificAttributes
    {
        [DataMember(Name="name", EmitDefaultValue=false)]
        public virtual string Name { get; set; }

        [DataMember(Name="description", EmitDefaultValue=false)]
        public virtual string Description { get; set; }

        [DataMember(Name="skus", EmitDefaultValue=false)]
        public virtual List<string> Skus { get; set; }

        [DataMember(Name="asin", EmitDefaultValue=false)]
        public virtual string Asin { get; set; }

        [DataMember(Name="url", EmitDefaultValue=false)]
        public virtual Uri Url { get; set; }

        [DataMember(Name="productImages", EmitDefaultValue=false)]
        public virtual Dictionary<string, Uri> ProductImages { get; set; }

        [DataMember(Name="additionalData", EmitDefaultValue=false)]
        public virtual Dictionary<string, string> AdditionalData { get; set; }
    }

}

namespace GeniuslinkAPI.ServiceModel.V4.Products.Requests
{
    [DataContract]
    public partial class ProductMetadataLookupRequest
        : IProductMetadataLookupRequest
    {
        [DataMember(Name="url")]
        public virtual string Url { get; set; }
    }

}

namespace GeniuslinkAPI.ServiceModel.V4.Products.Responses
{
    public partial class ProductMetadataLookupResponse
        : IProductMetadataLookupResponse
    {
        [DataMember(Name="productMetadata")]
        public virtual ProductData ProductMetadata { get; set; }

        [DataMember(Name="responseStatus")]
        public virtual ResponseStatus ResponseStatus { get; set; }
    }

}

C# ProductMetadataLookupRequest DTOs

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
		}
	}
}