Behance hub

Behance Freelance Brief API

One brief with its budget range, categories, company, expiry, applicant count and AI-assistance disclosure.

GET /v1/behance/freelance-briefs/{briefId}

1 credit Failed requests are free

About this endpoint

GET /v1/behance/freelance-briefs/{briefId} returns data.lookupStatus and data.brief. A found brief carries id, title, description, budgetMin, budgetMax, currency, budgetText, categories, company, expiresAt, applicantCount, aiAssisted, aiDisclosure, isClosed, type and url. Each category carries id and name; a company carries name, url and logoUrl when the brief names one.

Budget amounts are in the currency's minor unit, as provided; budgetText gives the same range as money, for example Budget from $5 to $100. Briefs close, so use the briefs list for a current id. company, aiDisclosure, budgetMin and budgetMax can be null when the brief does not carry them. A brief that does not exist returns lookupStatus: not_found with brief: null.

Behance Freelance Brief API FAQ

Where do I get the brief id?

Use the number in the brief URL, for example 261879 in behance.net/joblist/freelance/261879/Poster-About-Renewable-Energy-Solar-Panels. The path accepts the numeric id only. Briefs close, so this example may have closed; the briefs list gives current ids.

How are the budget amounts expressed?

budgetMin and budgetMax are in the currency's minor unit, with currency naming the currency. budgetText formats the same range with that currency, for example Budget from $5 to $100. A brief can have only one end of the range, and either end can be null when it is not available.

How do I know whether a brief is still open?

Read isClosed and expiresAt. isClosed is a boolean when it is available; expiresAt is an ISO 8601 time. A missing brief is lookupStatus: not_found, which is different from a brief that has closed.

What does the AI disclosure tell me?

aiAssisted says whether the hirer disclosed AI assistance, and aiDisclosure carries the disclosure text when there is one. Both can be null when the brief does not carry the field.

How many credits does a brief 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.