API Branding guide
branding guide
- Edmunds API logos
- Additional branding requirements
- How to install Edmunds logo
- Edmunds logo formats
- Restrictions
Follow this guide to properly attribute Edmunds when you use any of our API content on your site or in a client application.
Edmunds API logos
Use the Edmunds API web logo on every desktop and mobile page that interacts with the Edmunds API or displays the Edmunds API data.
Only the following logos are allowed for branding attribution on your site or in your app. They’re to be used at full size, so select the logo that best fits your needs.
additional branding requirements
-
The Edmunds API logo shouldn’t be the most prominent element or logo on the page, nor the only branding on the page.
-
Place the Edmunds API web logo right next to where the Edmunds API data is being interacted with or displayed.
-
The Edmunds API logo must directly link to http://www.edmunds.com/?id=apis.
how to install Edmunds logo
Webpage
-
Put a tag on your page next to where the Edmunds data is or is being displayed.
-
Paste the following URL to the src attribute (in this format):
https://open-api.edmunds.com/api/openapi/v1/logo?size={size}&format={format}&retina={retina}&color={color}&api_key={api_key} -
Change the parameters of the URL with the following values (and remove the brackets):
- size - 100px, 220px, 300px
- format - horizontal, ad, square
- retina - true, false
- color - blue, gray
- api_key - your own API key
Example:
-
<a href="http://www.edmunds.com/?id=apis"> <img src="https://open-api.edmunds.com/api/openapi/v1/logo?size=100&format=ad&retina=true&color=white&api_key=111111111111111111111111"> </a>
Mobile apps
-
Create a remote image container on the page in the acceptable sizes <w, h> and <w, h>
-
Paste the following URL to the image container (in this format):
https://open-api.edmunds.com/api/openapi/v1/logo?size={size}&format={format}&retina={retina}&color={color}&api_key={api_key} -
Change the parameters of the URL with the following values (and remove the brackets):
- size - 100px, 220px, 300px
- format - horizontal, ad, square
- retina - true, false
- color - blue, gray
- api_key - your own API key
Example iOS Objective-C:
-
NSURL *url = [NSURL URLWithString:path]; NSData *data = [NSData dataWithContentsOfURL:url]; UIImage *img = [[UIImage alloc] initWithData:data]; UIImageView *imageView = [[UIImageView alloc] initWithImage:img];
Example iOS Swift:
-
var url = NSURL(string: path) var data = NSData(contentsOfURL : url!) let imageView = UIImageView.init(image: UIImage.init(data: data!, scale: 1.0))
Example Android:
-
URL newurl = new URL(path); mIcon_val = BitmapFactory.decodeStream(newurl.openConnection() .getInputStream()); imageView.setImageBitmap(mIcon_val);
Edmunds logo formats
300px horizontal
Blue on white background
Dark on gray background
300px horizontal (Retina)
Blue on white background
Dark on gray background
300px ad format
Blue on white background
Dark on gray background
300px ad format (Retina)
Blue on white background
Dark on gray background
220px horizontal
Blue on white background
Dark on gray background
220px horizontal (Retina)
Blue on white background
Dark on gray background
100px square
Blue on white background
Dark on gray background
100px square (Retina)
Blue on white background
Dark on gray background
Restrictions
Please don’t use our logo or text attribution in a way that would suggest Edmunds promotes or endorses you or any third party—or the causes, ideas, websites, products or services of you or any third party.
Please contact Edmunds before publishing your application if it doesn’t easily support logos, or where Edmunds data are used in alternative media formats. We’ll give you alternative branding instructions.
Prior written consent from Edmunds is required to use Edmunds data without attribution.