Behance

Get Behance project

Get a Behance project's id, name, URL, owners, covers, colour and downloadable source files.

GET/v1/behance/projects/{projectId}
1credit
x-api-keystringheader

API key (`sfk_...`)

Parameters
1
projectIdintegerrequiredpath

Project id, e.g. `77359879`.

≥ 1 · ≤ 999999999999

Response fields
68

Endpoint-specific response payload.

datalookupStatus
string

`not_found` when the project does not exist or is private.

one of: found, not_found

The project when `lookupStatus` is `found`; otherwise null.

dataprojectid
integer

Project id.

dataprojectname
stringnullable

Project name.

dataprojecturl
stringnullable

Project URL.

dataprojectslug
stringnullable

Project slug.

dataprojecthasMatureContent
booleannullable

Whether the project is marked mature.

Dominant colour; null when none is available.

dataprojectcolorr
integernullable

Red.

dataprojectcolorg
integernullable

Green.

dataprojectcolorb
integernullable

Blue.

Cover renditions.

dataprojectcovers[]url
string

Image URL, as provided.

dataprojectcovers[]width
integernullable

Width in pixels when available.

dataprojectcovers[]type
stringnullable

Image type when available, e.g. `JPG` or `WEBP`.

Project owners.

dataprojectowners[]id
integernullable

Owner id.

dataprojectowners[]username
stringnullable

Owner username.

dataprojectowners[]displayName
stringnullable

Display name.

dataprojectowners[]firstName
stringnullable

First name when shown.

dataprojectowners[]lastName
stringnullable

Last name when shown.

dataprojectowners[]url
stringnullable

Owner profile URL.

A location.

dataprojectowners[]locationtext
stringnullable

Location as shown.

dataprojectowners[]locationcountry
stringnullable

Country name.

dataprojectowners[]locationcountryCode
stringnullable

ISO 3166-1 alpha-2 country code, when one is available.

dataprojectowners[]locationcity
stringnullable

City name.

dataprojectowners[]locationstate
stringnullable

State or region name.

Avatar renditions.

dataprojectowners[]images[]url
string

Image URL, as provided.

dataprojectowners[]images[]width
integernullable

Width in pixels when available.

dataprojectowners[]images[]type
stringnullable

Image type when available, e.g. `JPG` or `WEBP`.

Downloadable source files.

dataprojectsourceFiles[]sourceFileId
integernullable

Source file id.

dataprojectsourceFiles[]assetId
stringnullable

Asset id.

dataprojectsourceFiles[]projectId
integernullable

Project the file belongs to.

dataprojectsourceFiles[]userId
integernullable

Uploader id.

dataprojectsourceFiles[]creatorUsername
stringnullable

Uploader username.

dataprojectsourceFiles[]title
stringnullable

File title.

dataprojectsourceFiles[]category
stringnullable

Asset category.

dataprojectsourceFiles[]licenseType
stringnullable

Licence tier, e.g. `personal_use` or `standard_license`.

dataprojectsourceFiles[]tier
stringnullable

`FREE` or `PAID`.

dataprojectsourceFiles[]unitAmount
numbernullable

Price in the currency's main unit, as shown. `tier` says `FREE` or `PAID`; a free file can still carry an amount.

dataprojectsourceFiles[]currency
stringnullable

Price currency.

dataprojectsourceFiles[]sizeBytes
integernullable

File size in bytes.

dataprojectsourceFiles[]extension
stringnullable

File extension.

dataprojectsourceFiles[]mimeType
stringnullable

MIME type.

dataprojectsourceFiles[]description
stringnullable

File description.

dataprojectsourceFiles[]hidden
booleannullable

Whether the file is hidden.

dataprojectsourceFiles[]hasUserPurchased
booleannullable

Whether the viewer has purchased this file; always false on a public lookup.

dataprojectsourceFiles[]renditionUrl
stringnullable

Preview rendition URL template, as provided.

Preview crop; null when the file has none.

dataprojectsourceFiles[]coverurl
stringnullable

Preview image URL; null when the file has no usable preview.

dataprojectsourceFiles[]coverx
numbernullable

Horizontal crop offset.

dataprojectsourceFiles[]covery
numbernullable

Vertical crop offset.

dataprojectsourceFiles[]coverscale
numbernullable

Preview scale.

Linked assets when available.

dataprojectlinkedAssets[]id
integernullable

Linked asset id.

dataprojectlinkedAssets[]name
stringnullable

Linked asset name.

dataprojectlinkedAssets[]url
stringnullable

Linked asset URL.

dataprojectembedAllowed
booleannullable

Whether the owner allows embedding. False means only the name is available.

dataprojectisPrivate
booleannullable

Whether the project is private.

dataprojectisPublished
booleannullable

Whether the project is published.

Metadata describing the request and billing outcome.

metarequestId
string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integer

Credits charged for this request.

≥ 0

metaversion
string

Public API version that served the response.

one of: v1

Code example

curl "https://api.socialfetch.dev/v1/behance/projects/77359879" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Get Behance project.