Credly Badge Scraper

Scrape Credly's catalog of certification and skill badge programs, or verify individual earned badges by their public verification URL. Get badge names, issuers, levels, costs, descriptions, and images. HTTP-only via Credly's public endpoints. No auth, no proxy.

What this actor does

• Three modes: search (badge/certification catalog), byBadgeUrls (individual credential verification), and byOrganization (every public badge program from one or more issuers)
• Catalog search filters: type (Certification / Validation / Learning / Experience / Recognition / Membership), level (Foundational / Intermediate / Advanced), cost (Free / Paid) — apply to both search and byOrganization
• Optional deep data: full program description, skill tags, and published earning-criteria text per badge (includeBadgeDetails, mode=search); byOrganization includes description and skill tags for every badge automatically, with no extra request per badge
• Credential verification: confirms a specific person earned a specific badge — exactly what Credly's public badge links are designed for (LinkedIn, resumes, email signatures)
• Empty fields are always omitted — no null/sentinel values (including Credly's own "N/A" facet sentinel, which is stripped rather than passed through)

Output per record

Mode search (badge template)

• badgeTemplateId, name
• level, timeToEarn, cost, typeCategory
• issuerName, issuerId
• imageUrl
• badgeTemplateUrl — link to the badge program's public page
• description — full program description, only with includeBadgeDetails: true
• skills[] — skill tags the issuer associates with the badge, only with includeBadgeDetails: true
• earningCriteria[] — the published "how to earn this badge" requirements, only with includeBadgeDetails: true
• recordType: "badgeTemplate", scrapedAt

Mode byBadgeUrls (earned badge)

• badgeId, badgeName
• issuerName, earnerName
• description
• isExpired
• imageUrl
• badgeUrl — the public verification URL
• recordType: "earnedBadge", scrapedAt

Mode byOrganization (issuer badge browse)

• badgeTemplateId, name
• description, skills[] — always included, no extra request needed
• level, timeToEarn, cost, typeCategory
• issuerName, issuerId
• imageUrl
• badgeTemplateUrl — link to the badge program's public page
• updatedAt — when the issuer last updated the badge program on Credly
• activityUrl — issuer's own page describing how to earn/get involved, when published
• earnBadgeUrl — issuer's dedicated "earn this badge" link, when published
• recordType: "badgeTemplate", scrapedAt

Input

Field	Type	Default	Description
mode	string	search	search / byBadgeUrls / byOrganization
searchQuery	string	AWS	Free-text keyword (mode=search)
badgeUrls	array	–	Public badge verification URLs / paths / UUIDs (mode=byBadgeUrls)
organizationSlugs	array	–	Issuer vanity slugs or /org/<slug> URLs (mode=byOrganization)
typeCategories	array	–	One or more of 6 badge types (mode=search, byOrganization)
levels	array	–	One or more of 3 difficulty levels (mode=search, byOrganization)
costs	array	–	Free / Paid (mode=search, byOrganization)
includeBadgeDetails	bool	false	Fetch each badge program's page for full description, skill tags, and earning criteria (mode=search)
maxItems	int	50	Hard cap (1–1000); see note below for mode=search

Example: free AWS certifications

{
  "mode": "search",
  "searchQuery": "AWS",
  "typeCategories": ["Certification"],
  "costs": ["Free"],
  "maxItems": 50
}

Example: verify earned badges

{
  "mode": "byBadgeUrls",
  "badgeUrls": [
    "https://www.credly.com/badges/5bf99268-3956-49e4-b82a-f06bdf510fcf/public_url"
  ]
}

Example: browse an issuer's full badge catalog

{
  "mode": "byOrganization",
  "organizationSlugs": ["aws-community"],
  "maxItems": 200
}

Use cases

• Certification research — discover certification/skill badge programs by vendor, level, or cost
• HR / recruiting verification — confirm a candidate's claimed credential is real and current
• Training catalog analysis — compare badge offerings across issuers (AWS, Microsoft, GIAC, etc.)
• Credential auditing — batch-verify a list of badge URLs collected from resumes or LinkedIn profiles

Data source & limitations

Data comes from Credly's public search endpoint (the same one credly.com/search calls), its public organization badge-listing endpoint (the same one credly.com/org/<slug> calls to render an issuer's badge catalog), and its public badge-verification pages (the same server-rendered metadata shown when a badge link is shared on social media). Credly's search endpoint is a type-ahead search, not a paginated listing API — it returns at most ~50 results per distinct query regardless of maxItems; narrow with typeCategories/levels/costs or try a more specific searchQuery to reach different results. The byOrganization listing endpoint is fully paginated, so it is not subject to that 50-result cap. Badges that are private, revoked, or belong to an invalid/mistyped ID cannot be verified and will not appear in the output — this mirrors exactly what a visitor would see on Credly's own verification page.

Credly's combined /api/v1/global_search endpoint also mixes in Organization (issuer), Pathway (badge collections) and FaethmSkill (raw skill taxonomy) result types alongside BadgeTemplate. This actor deliberately scopes to badge templates and earned badges only: pathway detail pages are client-rendered single-page apps with no server-rendered data, so a reliable, JS-free record for that type isn't possible without adding a browser/proxy dependency this actor intentionally avoids to keep it fast and free of extra cost. Organization/issuer records themselves (name, logo, description) aren't emitted as their own record type, but every badge a given issuer publishes is fully covered via byOrganization.

FAQ

Can I look up all badges a specific person has earned? Not with this actor — Credly's public user-profile badge listing requires the profile owner to have made their full badge wall public and isn't exposed via a stable public endpoint; use byBadgeUrls with each badge's individual verification link instead.

Why did some of my badgeUrls not return a record? Credly badges can be revoked, expired past their verification window, or set to private by the earner — those correctly return no data, the same as if you visited the link in a browser.

Does search mode include badges I'd need to be logged in to see? No — only publicly listed badge programs appear; private/internal organization badges are not indexed here.