Documentation

v1.0.0

Getting started

First things first, you’ll need to request an API key so we can understand what you want to build and ensure we can make it happen.

Authorization

Authorization with 99designs requires the following HTTP headers are forwarded on every request: Api-Key-Id and Api-Key-Secret. The values for theses headers are provided by 99designs.

curl -H "Api-Key-Id:xxx" -H "Api-Key-Secret:xxx" https://api.99designs.com/resources/v1/designers

Designers

Search designers

Returns a list of designers that meet certain criteria in order of best match first.
Example request:
curl -X POST https://api.99designs.com/resources/v1/designers -H "Content-Type:application/json" -d '{
  "certifications": [
    ""
  ],
  "category": [
    "3d-design"
  ],
  "industry": [
    "accounting"
  ],
  "language": [
    "de"
  ],
  "designerLevel": [
    "entry"
  ],
  "lastActivity": "online_now",
  "designLimit": 10,
  "keywordQuery": "",
  "pageSize": 30,
  "page": 1,
  "country": [
    "US",
    "AU"
  ]
}'
Body parameters:
certifications
array

Filter designers based on certifications

category
array

Design category (one or more)

Values3d-designalbum-cover-designapp-designart-illustrationbanner-ad-designbook-cover-designbook-magazine-designbrand-guidebrand-identity-packbrochure-designbusiness-advertisingbusiness-card-designbuttons-iconscar-truck-van-wrap-designcard-invitation-designcharacter-mascot-designclothing-apparel-designclothing-merchandise-designcup-mug-designcustom-wordpress-themesemail-designfacebook-adfacebook-cover-designflash-animationflash-banner-designicon-button-designillustrationsinfographic-designlanding-page-designlogologo-brand-guidelogo-business-card-designlogo-designlogo-product-packaginglogo-websitemagazine-cover-designmenu-designmerchandise-designmobile-app-designnationbuilderotherother-art-illustrationother-book-magazine-designother-business-advertisingother-clothing-merchandise-designother-designother-design-tasksother-packaging-label-designother-website-app-designpackaging-label-designpodcast-cover-designpostcard-flyer-designposter-designpowerpoint-template-designprezi-designprint-designproduct-label-designproduct-packaging-designquickbooks-form-designsignage-designsocial-media-packsocial-media-page-designsquare-online-storesquarespacestationery-designsticker-designt-shirt-designtattoo-designtwitter-background-designtypesettingtypesetting-with-imageryweb-builderweb-designweb-design-codedwebsite-app-designwix-websitewordpress-theme-designzoom-background-design
industry
array

Industry (one or more)

Valuesaccountingagricultureanimalsarchitecturalartattorneyautomotivebarbusinesschildrencleaningcommunicationscommunitycomputerconstructioncosmeticsdatingeducationentertainmentenvironmentfashionfloralfoodgameshomeindustrialinternetlandscapingmedicalotherphotographyphysicalpoliticsrealestatereligiousrestaurantretailsecurityspasportstechnologytravelwedding
language
array

Designer language (one or more)

Valuesdeenesfritjanlpt
designerLevel
array

Designer level

Valuesentrymidtop
lastActivity
string

Filter designers based on their last login time

Valuesonline_nowwithin_7_days
designLimit
integer

Maximum number of example designs per designer

e.g. 10

keywordQuery
string

Keyword for filtering results

pageSize
integer

Maximum number of designers to return per page (defaults to 30)

e.g. 30

page
integer

Page of the results

e.g. 1

country
array

Filter designers based on ISO alpha-2 country codes i.e. (US, AU, DE)

e.g.[ "US", "AU" ]
Example response(s):
200An array of designers
{
  "totalPages": 10,
  "totalResults": 100,
  "designers": [
    {
      "id": 1,
      "coverImageUrl": "https://images-platform.99static.com/99designs-profiles/cover-images-v2/123123/123abc.jpg",
      "biography": "Professional brand designer.",
      "avatarUrl": "https://99designs.com/avatars/users/1/128",
      "displayName": "DesignerAllTheThings",
      "lastSeenAt": "2019-01-01T00:00:00Z",
      "designs": [
        {
          "description": "Logo for a cool company",
          "id": 123123,
          "imageUrl": "http://s3.amazonaws.com/projects-files/1/123/456/123abc.png",
          "title": "Cool company",
          "tags": [
            "technology"
          ]
        }
      ],
      "designerLevel": "TOP",
      "expertiseCategories": [
        "logo-design",
        "web-design"
      ],
      "review": {
        "count": 100,
        "rating": 5
      },
      "repeatCount": 20,
      "completedProjectsCount": 50
    }
  ]
}
400Bad input
{
  "message": "An error has occurred"
}

Get designer by ID

Returns a single designer with the given ID.
Example request:
curl -X GET https://api.99designs.com/resources/v1/designers/{designerId}
Path parameters:
designerId
integer

ID of the designer

Example response(s):
200A designer
{
  "id": 1,
  "coverImageUrl": "https://images-platform.99static.com/99designs-profiles/cover-images-v2/123123/123abc.jpg",
  "biography": "Professional brand designer.",
  "avatarUrl": "https://99designs.com/avatars/users/1/128",
  "displayName": "DesignerAllTheThings",
  "lastSeenAt": "2019-01-01T00:00:00Z",
  "designs": [
    {
      "description": "Logo for a cool company",
      "id": 123123,
      "imageUrl": "http://s3.amazonaws.com/projects-files/1/123/456/123abc.png",
      "title": "Cool company",
      "tags": [
        "technology"
      ]
    }
  ],
  "designerLevel": "TOP",
  "expertise": [
    ""
  ],
  "expertiseCategories": [
    "logo-design",
    "web-design"
  ],
  "review": {
    "rating": 5,
    "count": 100
  },
  "reviews": [
    {
      "rating": 5,
      "message": "This was a fantastic designer to work with!",
      "displayName": "EmilyBakes"
    }
  ],
  "country": "AU",
  "repeatCount": 20,
  "responsivenessScore": 92.5,
  "completedProjectsCount": 50,
  "isAvailable": false,
  "workPreferences": {
    "squarespace": [
      "DESIGN"
    ]
  },
  "certifications": [
    ""
  ],
  "isBoosted": false
}
400Bad input
{
  "message": "An error has occurred"
}
404Not found
{
  "message": "An error has occurred"
}

Get designer reviews

Return customer reviews for a given designer
Example request:
curl -X GET https://api.99designs.com/resources/v1/designers/{designerId}/reviews?page=&pageSize=
Path parameters:
designerId
integer

ID of the designer

Query parameters:
page
integer

Page number

pageSize
integer

Page size limit

Example response(s):
200Reviews
{
  "totalPages": 10,
  "totalResults": 100,
  "reviews": [
    {
      "rating": 5,
      "message": "This was a fantastic designer to work with!",
      "displayName": "EmilyBakes"
    }
  ]
}

Get portfolio designs

Get all portfolio designs for a given designer
Example request:
curl -X GET https://api.99designs.com/resources/v1/designers/{designerId}/designs?page=&pageSize=&category=
Path parameters:
designerId
integer

ID of the designer

Query parameters:
page
integer

Page Number

pageSize
integer

Page size limit

category
array

Design category (one or more)

Values3d-designalbum-cover-designapp-designart-illustrationbanner-ad-designbook-cover-designbook-magazine-designbrand-guidebrand-identity-packbrochure-designbusiness-advertisingbusiness-card-designbuttons-iconscar-truck-van-wrap-designcard-invitation-designcharacter-mascot-designclothing-apparel-designclothing-merchandise-designcup-mug-designcustom-wordpress-themesemail-designfacebook-adfacebook-cover-designflash-animationflash-banner-designicon-button-designillustrationsinfographic-designlanding-page-designlogologo-brand-guidelogo-business-card-designlogo-designlogo-product-packaginglogo-websitemagazine-cover-designmenu-designmerchandise-designmobile-app-designnationbuilderotherother-art-illustrationother-book-magazine-designother-business-advertisingother-clothing-merchandise-designother-designother-design-tasksother-packaging-label-designother-website-app-designpackaging-label-designpodcast-cover-designpostcard-flyer-designposter-designpowerpoint-template-designprezi-designprint-designproduct-label-designproduct-packaging-designquickbooks-form-designsignage-designsocial-media-packsocial-media-page-designsquare-online-storesquarespacestationery-designsticker-designt-shirt-designtattoo-designtwitter-background-designtypesettingtypesetting-with-imageryweb-builderweb-designweb-design-codedwebsite-app-designwix-websitewordpress-theme-designzoom-background-design
Example response(s):
200Designs
{
  "totalPages": 10,
  "totalResults": 100,
  "designs": [
    {
      "description": "Logo for a cool company",
      "id": 123123,
      "imageUrl": "http://s3.amazonaws.com/projects-files/1/123/456/123abc.png",
      "title": "Cool company",
      "tags": [
        "technology"
      ]
    }
  ]
}