Embed widget docs

All widgets accept these query parameters:

• theme — light (default), dark, or auto (follows the visitor’s system setting).
• attribution_key — optional partner token (pub_…). Ties impressions to your account; required for the paid-tier options below.
• attribution=false — hide the “Powered by Hireoven” footer. Honored only with a paid-tier attribution_key; ignored otherwise (the footer is mandatory on the free tier).
• accent=%23rrggbb — custom accent color, paid tier only. Free tier and malformed values fall back to the default.
• Set the iframe width/height to fit your layout. Widgets are responsive up to ~460px wide.

Top employers by certified LCA filings. Optional state (2-letter), sort (volume or cert_rate), exclude_staffing=true, and limit (3–15).

<iframe src="https://hireoven.com/embed/v1/leaderboard?theme=light&limit=10"
  width="460" height="520" style="border:0;max-width:100%"
  loading="lazy" title="Top H-1B Sponsors"></iframe>

One company’s H-1B sponsorability grade. Use the company’s Hireoven id (the UUID in its profile URL).

<iframe src="https://hireoven.com/embed/v1/company-scorecard/COMPANY_ID?theme=light"
  width="460" height="250" style="border:0;max-width:100%"
  loading="lazy" title="H-1B Scorecard"></iframe>

Your own sponsorability scorecard. Publish it from your dashboard to get a share token, then embed it. If you later make the card private or revoke the link, the widget shows an “unavailable” card instead of breaking.

<iframe src="https://hireoven.com/embed/v1/personal-scorecard/SHARE_TOKEN?theme=light"
  width="460" height="320" style="border:0;max-width:100%"
  loading="lazy" title="My H-1B Scorecard"></iframe>

The widgets are plain iframes, so they work anywhere that allows embed/HTML blocks:

• WordPress — add a Custom HTML block and paste the snippet. (The Classic editor needs the “Text” tab, not “Visual”.)
• Notion — paste the iframe src URL on its own line and choose Create embed.
• Webflow / Squarespace / Wix — use the built-in Embed / Code element and paste the snippet.
• Generic HTML — paste the snippet directly into your page markup.
• GitHub README — GitHub strips iframes, so embeds don’t render there. Link your public scorecard instead: [My H-1B scorecard](https://hireoven.com/scorecard/SHARE_TOKEN).

The widgets are free for any non-commercial or editorial use. The free tier shows a small “Powered by Hireoven” link, which must remain visible. Removing attribution requires a partner plan token. Data is sourced from public DOL and USCIS disclosures; see the methodology.

Widgets set no cookies and run no tracking script on your page. For aggregate analytics we record only the embedding site’s domain and a hashed, truncated user-agent — never IP addresses, full URLs, or any visitor identity.