• API Documentation

• Terms of Service
• Introduction
• Getting Started
• Receiver Export Methods
• Supplier Import Methods
• Data Lookups
• Year/Make/Model/Submodel
• Engine
• Expanded Vehicle Info
• Categories
• Products by Category
• Products by Brand
• Product Attributes
• Vehicles by Brand/Product(s)
• Vehicles by Brand (Flat)
• Content Pages
• Content Token
• Product

Introduction

The SDC API, part of the Content-On-Demand project, is an evolving data entrypoint for suppliers and receivers of data alike. The overarching goal is to provide performant, best-in-breed webservices tailored to our members' needs.

Please review our terms of service.

Getting Started

A rate limit of 60 calls per minute has been implemented. Your rate is tracked and returned to you in the HTTP response header "RateLimit-Remaining", counting down from 60 and resetting each minute.

The first step in accessing the API is getting a security token. This token can be reused for subsequent API calls. Provide your PIMS (or SEMA Search) username and password

https://sdc.semadatacoop.org/sdcapi/token/get?userName=YOUR_USERNAME&password=YOUR_PASSWORD

Note: The SDC API response format is JSON by default. We encourage all of our partners to use this extremely lean format as less data will be transferred by comparison to XML.

To request XML data delivery, please specify "Accept: text/xml" in your request header.
For further reading on the benefits of JSON, click here.

On valid authentication, the token response will reply with a success property true and your token, or false, with a reason on why the authentication failed. Example success response:

                    {
                    "success": true,
                    "message": "",
                    "token": "abcd12345"
                    }
                    

Receiver / Export Methods

Brand Datasets

Brand datasets retrieves the list of authorized brands a receiver is authorized for. A request for a brand's data must be submitted to and approved by a supplier before it will be populated in this API call.

https://sdc.semadatacoop.org/sdcapi/export/branddatasets?token=YOUR_TOKEN

{
"success": true,
"message": "",
"BrandDatasets": [
    {
    "AAIABrandId": "AAFF",
    "BrandName": "Aeromotive Fuel System",
    "DatasetId": 66,
    "DatasetName": "Aeromotive Fuel System"
    },
    {
    "AAIABrandId": "AAGG",
    "BrandName": "Air Lift",
    "DatasetId": 67,
    "DatasetName": "Air Lift Company_Air Lift"
    }]
}

Export Plans

Export plans are the "push" exports that you have preconfigured. If you've scheduled an export through PIMS, all of those exports' information is accessible through this method call. These exports can be executed on-demand regardless of their scheduled time. Typically, your scheduled exports will run as expected -- if you happen to have the need to re-run an export programmatically, refer to this method as apporpriate:

https://sdc.semadatacoop.org/sdcapi/export/plans?token=YOUR_TOKEN

{
"success": true,
"message": "",
"ExportPlans": [
    {
    "ExportPlanId": 1234,
    "Name": "My Daily Export",
    "ExportModule": "PIES 6.5 XML",    
    "ExporType": "Full",        
    "AAIABrandId": "BBFG",
    "DatasetId": 66,
    "DatasetName": "Supplier Dataset 1",
    "DeliveryMethod": "FTP",
    "ScheduleData": "runschedule|Daily|0200|Su"
    },
    {
    "ExportPlanId": 1235,
    "Name": "My Monthly Export",
    "ExportModule": "ACES 3.0 XML",    
    "ExporType": "NetChange",        
    "AAIABrandId": "BBFF",
    "DatasetId": 67,
    "DatasetName": "Supplier Dataset 2",
    "DeliveryMethod": "FTP",
    "ScheduleData": "runschedule|Monthly|0200|1,15"
    }]
}

Run

Existing exports can be run when you know their ExportPlanID via the web request above by executing the following.
Only 10 exports at a time can be run via this method. Simply wait for exports to finish to run more.

https://sdc.semadatacoop.org/sdcapi/export/run?token=YOUR_TOKEN&exportPlanID=YOUR_EXPORTPLANID

Export Status

Returns scheduled exports' run status (running, complete, error)
If optional StartDate parameter is not specified, returns last 24 hours of export runs

https://sdc.semadatacoop.org/sdcapi/export/status?token=YOUR_TOKEN

{
"success": true,
"message": "",
"ExportStatuses": [
    {
      "ExportPlanId": 12345,
      "Name": "My Export Daily",
      "ExportModule": "ACES 3.0 XML",
      "ExportType": "NetChange",
      "Status": "Running",
      "StartTime": "2015-12-03T09:31:03.29"
    },
    {
      "ExportPlanId": 456789,
      "Name": "My Export Weekly 2",
      "ExportModule": "PIES 6.5 XML",
      "ExportType": "Full",
      "Status": "Complete",
      "StartTime": "2015-12-03T09:30:59.957"
    },
    {
      "ExportPlanId": 789123,
      "Name": "My Export Monthly",
      "ExportModule": "ACES 3.0 XML",
      "ExportType": "NetChange",
      "Status": "Error",
      "StartTime": "2015-12-03T09:30:55.927"
    }]
}

PIES Export

Runs and returns a PIES-compliant export based on a brand or dataset

HTTP POST: https://sdc.semadatacoop.org/sdcapi/export/piesexport

Note: You must be the brand owner or an authorized receiver within PIMS on any brands/datasets specified.
Note: Pricing information can only be returned when a dataset is specified.

{
"success": true,
"message": "",    
"ValidationWarnings": [],
"IsValid": true,
"ValidationErrors": [],
"PiesExport": "<?xml version="1.0" encoding="utf-8" ?><pies xmlns="http://www.aftermarket.org">
      ..."
      }

Export Progress

Returns the percentage complete an export is for monitoring purposes

HTTP POST: https://sdc.semadatacoop.org/sdcapi/export/progress

{
"success": true,
"message": "",    
"PercentComplete": 75%
      }

Digital Assets (CDN Delivery)

Returns a list of brand products with a downloadable link. Filterable by part numbers and asset types.

HTTP POST: https://sdc.semadatacoop.org/sdcapi/export/digitalassets

Warning: Do not hotlink (use the URLs) as a means of content delivery. Use the links to download the assets and then serve them from a content store. These links are not guaranteed to be static, and frequently change as the supplier's assets and/or the CDN domain changes.

{
"success": true,
"message": "",
"DigitalAssets": [
    {
      "PartNumber": "911-42010SL",
      "Link": "http://cdn.rackcdn.com/K&N/logo1.jpg",
      "AssetTypeCode": "LGO",
      "FileName": "logo1.jpg",
      "RecordModifiedDate": "2015-01-05T21:26:36.137"
    },
    {
      "PartNumber": "911-42010SL",
      "Link": "http://cdn.rackcdn.com/K&N/logo2.jpg",
      "AssetTypeCode": "LGO",
      "FileName": "logo2.jpg",
      "RecordModifiedDate": "2015-01-05T21:26:36.137"
    },
    {
      "PartNumber": "911-42010SL",
      "Link": "http://cdn.rackcdn.com/K&N/img1.jpg",
      "AssetTypeCode": "P04",
      "FileName": "img1.jpg",
      "RecordModifiedDate": "2015-01-05T21:26:36.137"
    }]
}

Supplier / Import Methods

Brand Datasets

Brand datasets retrieves the list of brands you own as a supplier.

https://sdc.semadatacoop.org/sdcapi/import/branddatasets?token=YOUR_TOKEN

{
"success": true,
"message": "",
"BrandDatasets": [
    {
    "AAIABrandId": "AAFF",
    "BrandName": "Aeromotive Fuel System",
    "DatasetId": 66,
    "DatasetName": "Aeromotive Fuel System"
    },
    {
    "AAIABrandId": "AAGG",
    "BrandName": "Air Lift",
    "DatasetId": 67,
    "DatasetName": "Air Lift Company_Air Lift"
    }]
}

Brand Import Reports

Import reports will return a listing of all your brand of the last time an import was received and the result, as well as the current SKU count Brand datasets retrieves the list of brands you own as a supplier.

https://sdc.semadatacoop.org/sdcapi/import/brandimportreport?token=YOUR_TOKEN

{
"success": true,
"message": "",
"Report": [
    "AAIABrandID": "ABCD",
    "BrandName": "The Brand",
    "Batch": "My Update Batch",           
    "UpdatedOn": "2016-07-27T09:39:51.39",
    "CreatedOn": "2016-07-28T09:39:51.39", 
    "BatchTotal": 100,
    "AddedTotal": 75,
    "UpdatedTotal": 25,
    "FailedValidation": 0,
    "BrandSKUTotal": 100,
    "ACESRecordTotal": 5000
    },
    {
    "Brand": "WXYZ",    
    "BrandName": "Another Brand",
    "Batch": "My Update Batch 2",      
    "UpdatedOn": "2016-07-27T09:39:51.39",
    "CreatedOn": "2016-07-28T09:39:51.39", 
    "BatchTotal": 100,
    "AddedTotal": 75,
    "UpdatedTotal": 25,
    "FailedValidation": 0,
    "BrandSKUTotal": 100,
    "ACESRecordTotal": 5000
    }]
}

Data Lookups

Year/Make/Model/Submodel

Years

Valid years as defined by the ACA VCdb

https://sdc.semadatacoop.org/sdcapi/lookup/years?token=YOUR_TOKEN

Note: You must be the brand owner or an authorized receiver within PIMS on any brands/datasets specified. If no brands are specified; results are based on all authorized brands

{
"success": true,
"message": "",
"Years": [1999,2000,2001,2002,2003,2004,2005,2006,2007,2008,2009,2010,2011,2012,2013,2014,2015,2016]
}

Makes

Valid makes as defined by the ACA VCdb

https://sdc.semadatacoop.org/sdcapi/lookup/makes?token=YOUR_TOKEN

Note: You must be the brand owner or an authorized receiver within PIMS on any brands/datasets specified. If no brands are specified; results are based on all authorized brands

{
"success": true,
"message": "",
"Makes": [
    {
    "MakeID": 58,
    "MakeName": "Acura"
    },
    {
    "MakeID": 73,
   "MakeName": "Audi"
    },
    {
    "MakeID": 31,
    "MakeName": "BMW"
    }]
}

Models

Valid models as defined by the ACA VCdb

https://sdc.semadatacoop.org/sdcapi/lookup/models?token=YOUR_TOKEN

Note: BaseVehicleId is only populated when year/make is specified
Note: You must be the brand owner or authorized within PIMS on any brands/datasets specified. If no brands are specified; results are based on all authorized brands

{
"success": true,
"message": "",
"Models": [
    {
    "BaseVehicleID": 18488,
    "ModelID": 170,
    "ModelName": "325Ci"
    },
    {
    "BaseVehicleID": 18489,
    "ModelID": 173,
    "ModelName": "325i"
    },
    {
    "BaseVehicleID": 18490,
    "ModelID": 176,
    "ModelName": "325xi"
    }]
}

Submodels

Valid submodels as defined by the ACA VCdb

https://sdc.semadatacoop.org/sdcapi/lookup/submodels?token=YOUR_TOKEN

Note: VehicleId is only populated when year/make/model is specified
Note: You must be the brand owner or authorized within PIMS on any brands/datasets specified. If no brands are specified; results are based on all authorized brands

{
"success": true,
"message": "",
"Submodels": [
    {
    "VehicleID": 18488,
    "SubmodelID": 170,
    "SubmodelName": "LX"
    },
    {
    "VehicleID": 18489,
    "SubmodelID": 173,
    "SubmodelName": "SE"
    },
    {
    "VehicleID": 18490,
    "SubmodelID": 176,
    "SubmodelName": "ZTS"
    }]
}

Engine

Valid engines as defined by the ACA VCdb

https://sdc.semadatacoop.org/sdcapi/lookup/engines?token=YOUR_TOKEN

Note: VehicleId is only populated when year/make/model is specified
Note: You must be the brand owner or authorized within PIMS on any brands/datasets specified. If no brands are specified; results are based on all authorized brands

{
"success": true,
"message": "",
"Engines": [
    {
      "VehicleID": 5184,
      "Liter": "3.0",
      "CC": "2962",
      "CID": "181",
      "Cylinders": "6",
      "BlockType": "V",
      "EngBoreIn": "3.39",
      "EngBoreMetric": "86.0",
      "EngStrokeIn": "3.35",
      "EngStrokeMetric": "85.0",
      "ValvesPerEngine": "24",
      "AspirationName": "Naturally Aspirated",
      "CylinderHeadTypeName": "DOHC",
      "FuelTypeName": "GAS",
      "IgnitionSystemTypeName": "Distributorless",
      "MfrName": "GM Europe",
      "HorsePower": "U/K",
      "KilowattPower": "U/K",
      "EngineDesignationName": "D16Y5"
    }]
}

Expanded Vehicle Info

Returns expanded ACES vehicle information

https://sdc.semadatacoop.org/sdcapi/lookup/expandedvehicleinfo?token=YOUR_TOKEN

Note: Due to the number of additional possible vehicle configurations wheelbase provides (x10 in many cases), you must explicitly opt-in to receive this data via the includeWheelBase flag.

{
"success": true,
"message": "",
"Vehicles": [
    {"Year":2018,
     "Make":"Hyundai",
     "Model": "Sonata",
     "Submodel":"Eco",
     "Region":"United States",
     "Liter":"1.6",
     "Cylinders":"4",
     "BlockType":"L",
     "FuelDeliveryTypeName":"FI",
     "FuelTypeName":"GAS"

       ... (etc) ...

    }
]
}

Categories

Categories as defined by the ACA PCdb

HTTP POST: https://sdc.semadatacoop.org/sdcapi/lookup/categories 

Note: You must be the brand owner or authorized within PIMS on any brands/datasets specified. If no brands are specified; results are based on all authorized brands

{
"success": true,
"message": "",
"Categories": [
    {
      "ParentId": 1,
      "CategoryId": 3903,
      "Name": "Brake",
      "Categories": [
        {
          "ParentId": 3903,
          "CategoryId": 4512,
          "Name": "Drums and Rotors",
          "Categories": [
            {
              "ParentId": 4512,
              "CategoryId": 4531,
              "Name": "Disc Brake Rotor",
              "Categories": []
            }]
        }
      ]}
}

Products by Category

Returns product information given a category

HTTP POST:https://sdc.semadatacoop.org/sdcapi/lookup/productsbycategory

{
"success": true,
"message": "",
"Products": [
    {    
    "ProductId": 20664458
    "PartNumber": "911-42011SR",
    "PiesAttributes": [
    {
        "PiesSegment": "C10_DEF_EN",
        "Value": "Disc Brake Rotor"
    },
    {
        "PiesSegment": "C10_SHO_EN",
        "Value": "4000 Series Rotor"
    },
    {
        "PiesSegment": "P05_LGO_WhiteLogo.pdf",
        "Value": "WhiteLogo.pdf"
    }]
}

Products by Brand

Returns product information given a brand's dataset ID or AAIA brand ID

HTTP POST: https://sdc.semadatacoop.org/sdcapi/lookup/products 

Note: You must be the brand owner or an authorized receiver within PIMS on any brands/datasets specified

{
"success": true,
"message": "",
"Products": [
    {        
    "ProductId": 20664458
    "PartNumber": "911-42011SR",
    "PiesAttributes": [
    {
        "PiesSegment": "C10_DEF_EN",
        "Value": "Disc Brake Rotor"
    },
    {
        "PiesSegment": "C10_SHO_EN",
        "Value": "4000 Series Rotor"
    },
    {
        "PiesSegment": "P05_LGO_WhiteLogo.pdf",
        "Value": "WhiteLogo.pdf"
    }]
}

Product Attributes

Returns a distinct list of product attributes labels and all corresponding attribute data

HTTP POST:https://sdc.semadatacoop.org/sdcapi/lookup/productattributes

{
"success": true,
"message": "",
"Attributes": [
        {
            "AttributeID": "12345",
            "AttributeIDLabel": "Bracket Color",
            "AttributeData": [
                "black/gold"
            ]
        },
        {
            "AttributeID": "Capacity",
            "AttributeIDLabel": "Capacity",
            "AttributeData": [
                "15 Gallons",
                "17",
                "20 Gallons",
                "22",
                "6",
                "6 Gallons"
            ]
        }]

}

Vehicles by Brand/Product(s)

Returns vehicles that will fit a given brand or brand's partnumber(s)

HTTP POST: https://sdc.semadatacoop.org/sdcapi/lookup/vehiclesbyproduct

Note: You must be the brand owner or an authorized receiver within PIMS on any brands/datasets specified

{
"success": true,
"message": "",
"Vehicles": [
    {
    "Year": 2014,
    "MakeName": "Ford",
    "ModelName": "F-150",
    "SubmodelName": "FX2"
    },
    {
    "Year": 2014,
    "MakeName": "Ford",
    "ModelName": "F-150",
    "SubmodelName": "FX4"
    }]
}

Vehicles by Brand (Flat)

Returns vehicles that will fit a given brand or brand's partnumber(s)

HTTP POST: https://sdc.semadatacoop.org/sdcapi/lookup/vehiclesbybrand

Note: You must be the brand owner or an authorized receiver within PIMS on any brands/datasets specified. If no brands are specified, results are based on all authorized brands
Note: Results for this API call are calcluated daily. Updates throughout the day will not reflect until the following business day.

{
"success": true,
"message": "",
"BrandVehicles": [
    {
    "AAIA_BrandID": "ABCD",
    "BrandName": "My Manufacturer",
    "Year": 2014,
    "MakeName": "Ford",
    "ModelName": "F-150",
    "SubmodelName": "FX2"
    },
    {
    "AAIA_BrandID": "ABCD",
    "BrandName": "My Manufacturer",
    "Year": 2014,
    "MakeName": "Ford",
    "ModelName": "F-150",
    "SubmodelName": "FX4"
    }]
}

Content Pages

The SDC now provides a page to display content for various items. You can now use the API to display a product (and future others planned).

Content Token

You need to request a content token and use them in the querystring when accessing these pages - this token expires and is an extra layer of security.

https://sdc.semadatacoop.org/sdcapi/token/getcontenttoken?token=YOUR_TOKEN

On valid authentication, the token response will reply with a success property true and your token, or false, with a reason on why the authentication failed. Example success response:

{
"success": true,
"message": "",
"contenttoken": "abcd12345"
}

Product

Returns an HTML page displaying a product

https://sdc.semadatacoop.org/sdcapi/content/product?contenttoken=YOUR_TOKEN&productid=PRODUCTID

Note: You must be the brand owner or an authorized receiver within PIMS on any products specified

Full Page

Mobile / Responsive