Social Fetch
Start for freeStart free
Behance hub

Behance Tag API

A tag record, related tags, freelance services, and the projects under it that carry downloadable source files.

GET /v1/behance/tags/{tag}

1 credit Failed requests are free

Try in playgroundFull API docs

About this endpoint

GET /v1/behance/tags/{tag} returns data.lookupStatus, data.tag, data.isEmpty, data.projects, data.relatedTags and data.services. The tag record carries id, title and category; each related tag has the same shape. Each service carries id, title, description, unitAmount, deliveryTime, revisions, concepts, url, categories, examples and a seller. unitAmount is in minor units, e.g. 25000 for 250.00; the listing does not name a currency.

Use the tag slug, percent-encoded where needed. A title with spaces uses its hyphenated slug, so Graphic Design is requested as graphic-design, not graphic%20design. A slash, hash, percent or question mark is part of a real tag, so UI/UX, C# and 100% are requested as ui%2Fux, c%23 and 100%25. Spaces, control characters, <, >, @ and \ are refused as bad input.

Each project carries id, name, url, slug, publishedAt, modifiedAt, covers, owners, stats, fields, sourceFiles, features, linkedAssetsCount and linkedAssets. This is the tag's assets view, so it lists up to 24 projects that have downloadable source files, not every project with the tag.

A tag that has a record but no projects returns lookupStatus: found, isEmpty: true and projects: []. A tag with no record returns lookupStatus: not_found, tag: null, projects: [], relatedTags: [] and services: []. That is a miss and is billed like any other completed lookup.

Behance Tag API FAQ

What does an unknown tag return?

An unknown tag returns lookupStatus: not_found with tag: null, projects: [], relatedTags: [] and services: []. Read lookupStatus first; an empty project list alone does not tell you whether the tag exists.

What if the tag exists but has no projects?

You get lookupStatus: found, isEmpty: true and projects: []. The tag record is present, so read data.tag for its id, title and category.

Does this return every project with the tag?

No. It returns the tag's assets view, up to 24 projects that carry downloadable source files. Projects with the tag but no source files are not in this list.

Can I look up a tag such as UI/UX, C# or 100%?

Yes. A slash, hash, percent or question mark can be part of a real tag. Send the tag percent-encoded in the path, for example ui%2Fux, c%23 or 100%25.

What are relatedTags and services?

relatedTags lists tags that are related to this one, each with id, title and category. services lists freelance services offered under the tag, with the seller, categories and example images.

What fields does each project have?

Each project carries id, name, url, slug, publishedAt, modifiedAt, covers, owners, stats, fields, sourceFiles, features, linkedAssetsCount and linkedAssets. sourceFiles includes title, licenseType, sizeBytes and extension.

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