GeniuslinkAPI

GetProductMatchesByUrlRequest

The following routes are available for this service:
GET	/v3.5/product/matches

**GetProductMatchesByUrlRequest** Parameters:
Name	Parameter	Data Type	Required	Description
Url	query	string	No
IncludeRaw	query	bool	No

**GetProductMatchesByUrlResponse** Parameters:
Name	Parameter	Data Type	Required	Description
Products	form	IEnumerable<ProductMetadata>	No
ResponseStatus	form	ResponseStatus	No

**ProductMetadata** Parameters:
Name	Parameter	Data Type	Required
Title	form	string	No
Author	form	string	No
Url	form	Uri	No
Description	form	string	No
Retailer	form	string	No
ProductImages	form	IDictionary<string, Uri>	No
RawAttributes	form	MatchResult	No

**MatchResult** Parameters:
Name	Parameter	Data Type	Required
Retailer	form	string	No
RetailerGuid	form	Guid	No
Storefront	form	string	No
StorefrontIso2	form	string	No
StorefrontGuid	form	Guid	No
Data	form	ProductData	No
Errors	form	List<MatchError>	No
MatchAccuracy	form	string	No
MatchingRuleName	form	string	No
DataSource	form	string	No

**ProductData** Parameters:
Name	Parameter	Data Type	Required
Attributes	form	ProductAttributes	No
RetailerSpecificAttributes	form	RetailerSpecificAttributes	No
RawSourceData	form	string	No

**ProductAttributes** Parameters:
Name	Parameter	Data Type	Required
Retailer	form	string	No
RetailerGuid	form	Guid	No
Storefront	form	string	No
StorefrontIso2	form	string	No
StorefrontGuid	form	Guid	No
Category	form	string	No
CategoryGuid	form	Guid	No
Brand	form	string	No
BrandGuid	form	Guid	No
Manufacturer	form	string	No
ManufacturerGuid	form	Guid	No
Identifiers	form	ProductIdentifiers	No
ItemAttributes	form	ItemAttributes	No

**ProductIdentifiers** Parameters:
Name	Parameter	Data Type	Required
ProductGuid	form	Guid	No
Gtins	form	List<string>	No
Mpns	form	List<string>	No
Ean8	form	List<string>	No
Ean13	form	List<string>	No
Isbn9	form	List<string>	No
Isbn10	form	List<string>	No
Isbn13	form	List<string>	No
ITF14	form	List<string>	No
Upc12	form	List<string>	No

**ItemAttributes** Parameters:
Name	Parameter	Data Type	Required
Book	form	BookAttributes	No
Audiobook	form	AudiobookAttributes	No
EBook	form	EBookAttributes	No

**BookAttributes** Parameters:
Name	Parameter	Data Type	Required	Description
Authors	form	List<string>	No

**RetailerSpecificAttributes** Parameters:
Name	Parameter	Data Type	Required
Name	form	string	No
Description	form	string	No
Skus	form	List<string>	No
Asin	form	string	No
Url	form	Uri	No
ProductImages	form	Dictionary<string, Uri>	No
AdditionalData	form	Dictionary<string, string>	No

**MatchError** Parameters:
Name	Parameter	Data Type	Required	Description
Message	form	string	No
Code	form	ErrorCode	No

**ErrorCode** Enum:
Throttled
TargetRetailerProductNotFound
Unknown
NullMatchResult
NullSourceData
SourceDataProcessingFailure
LocalizationFailure

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

HTTP + XML

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

GET /v3.5/product/matches HTTP/1.1 
Host: geniuslink-api-zane.dev.platform.georiot.com 
Accept: application/xml

HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: length

<GetProductMatchesByUrlResponse xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/GeniuslinkAPI.ServiceModel.V4.Products.Responses">
  <Products xmlns:d2p1="http://schemas.datacontract.org/2004/07/Geniuslink.Products.QueuedService.Contracts.V1.DTOs" i:nil="true" />
  <ResponseStatus xmlns:d2p1="http://schemas.servicestack.net/types">
    <d2p1:ErrorCode>String</d2p1:ErrorCode>
    <d2p1:Message>String</d2p1:Message>
    <d2p1:StackTrace>String</d2p1:StackTrace>
    <d2p1:Errors>
      <d2p1:ResponseError>
        <d2p1:ErrorCode>String</d2p1:ErrorCode>
        <d2p1:FieldName>String</d2p1:FieldName>
        <d2p1:Message>String</d2p1:Message>
        <d2p1:Meta xmlns:d5p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
          <d5p1:KeyValueOfstringstring>
            <d5p1:Key>String</d5p1:Key>
            <d5p1:Value>String</d5p1:Value>
          </d5p1:KeyValueOfstringstring>
        </d2p1:Meta>
      </d2p1:ResponseError>
    </d2p1:Errors>
    <d2p1:Meta xmlns:d3p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
      <d3p1:KeyValueOfstringstring>
        <d3p1:Key>String</d3p1:Key>
        <d3p1:Value>String</d3p1:Value>
      </d3p1:KeyValueOfstringstring>
    </d2p1:Meta>
  </ResponseStatus>
</GetProductMatchesByUrlResponse>