Social Fetch
Start for freeStart free
Behance hub

Behance Project API

One project by id, with its owners, covers, dominant colour and downloadable source files.

GET /v1/behance/projects/{projectId}

1 credit Failed requests are free

Try in playgroundFull API docs

About this endpoint

GET /v1/behance/projects/{projectId} returns data.lookupStatus and data.project. A found project carries id, name, url, slug, hasMatureContent, color, covers, owners, sourceFiles, linkedAssets, embedAllowed, isPrivate and isPublished.

slug comes from the project URL. Views, appreciations, comments, creative fields, gallery features, a linked-asset count and published or modified dates are not available on this endpoint, so those keys are absent from the project record. Each sourceFiles row carries title, category, licenseType, tier, unitAmount, currency, sizeBytes, extension, mimeType, description and a preview cover where one is available. unitAmount is the price in the currency's main unit, as shown. A preview that is only an unfilled template is returned as null, never as a URL with placeholders.

When the owner turns embedding off, embedAllowed is false and only id and name are readable, with the other fields this endpoint carries null or empty. A missing or private project returns lookupStatus: not_found with project: null.

Behance Project API FAQ

Where do I get the project id?

Use the number in the project URL, for example 77359879 in behance.net/gallery/77359879/Kia-Caraoke. The path accepts the numeric id only.

What happens when the owner disabled embedding?

The lookup is still found, but embedAllowed is false and only id and name are readable. The other fields this endpoint carries come back null or empty. The response tells you this case explicitly, so do not treat it as a miss.

Does a project include view or appreciation counts?

No. This endpoint does not expose views, appreciations, comments, creative fields, gallery features, a linked-asset count or published dates. Those keys are not part of the project record.

What is in sourceFiles?

Each row describes a downloadable file: title, category, licenseType, tier, unitAmount and currency when paid, sizeBytes, extension, mimeType, description, hidden, and a preview cover with its crop. unitAmount is the price in the currency's main unit. A preview that is only an unfilled template is null. hasUserPurchased is always false on a public lookup.

Are private or missing projects different?

Both return lookupStatus: not_found with project: null. HTTP 200 still means the request finished, so branch on lookupStatus before writing a row.

How many credits does a project lookup cost?

Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged: that field is the billing source of truth.

Other Behance endpoints