Skip to main content

Export feeds

Built-in RSS and XML feeds, plus custom filtered feeds with tokens.

Written by Traian

Export feeds push your jobs out to the rest of the internet: job aggregators, RSS readers, automation tools, and partner sites. Every feed is generated live from your board, so it always reflects your current published jobs. There is nothing to regenerate or re-upload.

To open the feeds page: in the sidebar, open Distribution and click Export feeds.

The Export feeds page with the three built-in feeds and an empty custom feeds list

The three built-in feeds

Every board ships with three feeds, served from your board's own domain. You will see each one listed with its full URL, a copy button, and an open-in-new-tab button:

  • Jobs RSS feed at /jobs.rss: all published jobs as a standard RSS 2.0 feed. Item titles read like "Engineer at Acme (Berlin)". Use this for RSS readers, Zapier-style automation tools, and subscribers.

  • Jobs XML feed at /jobs.xml: an aggregator-ready XML feed using the Indeed-style schema (fields like referencenumber, title, url, apply_url, company, location, jobtype, category). This is the format most job aggregators ask for when you submit your board.

  • Blog RSS feed at /blog.rss: your published blog posts as RSS.

If your board uses a custom domain, the feeds are served from that domain too.

Turn a built-in feed on or off

  1. In the sidebar, open Distribution and click Export feeds.

  2. In the Built-in feeds card, flip the switch next to the feed you want to change. The change saves immediately, there is no separate save button.

All three feeds are on by default. Turning one off makes its URL return a 404 and removes the feed autodiscovery link from your board's pages, so readers and crawlers stop finding it. Turn it back on and the same URL works again.

Create a custom feed

Custom feeds are filtered slices of your jobs with their own private URL. The typical use: one feed per partner or aggregator, each with its own filters and its own tracking tag.

  1. In the sidebar, open Distribution and click Export feeds.

  2. Under Custom feeds, click Add feed.

  3. In the Details card, enter a Feed name (for example "ZipRecruiter export"). The name is also used as the feed's channel title, so pick something a consumer of the feed would recognize.

  4. Choose a Format: RSS: for readers and automation, XML: for job aggregators (Indeed-style), or JSON: for developers. If a partner told you what they need, match it; when in doubt, aggregators usually want XML.

  5. Leave Active on. An inactive feed returns 404 at its URL, which is useful later if you want to pause a partner without deleting the feed.

  6. In the Job filters card, narrow down which published jobs the feed includes. Every filter is optional; leave a filter empty and the feed simply does not filter by it:

    • Search term: matches the job title and company name (for example "react").

    • Job type and Category: pick one from your board's classifications, or leave them on Any job type / Any category.

    • Employer: start typing to search your employers and pick one to include only their jobs. Clear the field for all employers.

    • Location: matches anywhere in the job's location text ("Berlin" matches "Berlin, Germany").

    • Remote jobs only: flip this on to include only jobs marked as remote.

  7. In the Advanced card:

    • Jobs limit: the maximum number of jobs in the feed, newest first. Default is 100; you can set 1 to 1000. Some partners cap what they accept, so check their requirements.

    • UTM source: a short tag (letters, numbers, dots, hyphens and underscores only, for example "ziprecruiter"). It is appended to every job link in the feed as ?utm_source=..., so traffic from this feed is attributable in your analytics. Leave it empty and job links carry no tracking parameter.

  8. Click Create feed (bottom right, or via the "Unsaved changes" bar at the top).

After creating, you land on the feed's edit page, and the feed appears in the Custom feeds table with an Active badge.

Share the feed URL

Each custom feed lives at /feeds/<token> on your board's domain, where the token is a random 20-character string. In the Custom feeds table, click the copy icon on the feed's row to copy the full URL, then send it to your partner.

The URL requires no login or API key: the unguessable token is the only protection. Share each feed URL only with the partner it is meant for, and create a separate feed per partner so you can cut one off without affecting the others.

Check whether a partner is actually using it

The Last accessed column in the Custom feeds table updates every time the feed URL is fetched. It shows Never until the first request, then times like "5 min ago". If a partner claims they are polling your feed and this still says Never, they are not.

Edit, pause, or delete a feed

  1. In the Custom feeds table, click the pencil icon on the feed's row to reopen the form. Change any filter or setting, then click Save changes. The feed URL stays the same.

  2. To pause a feed without deleting it, turn Active off and save. Its URL returns 404 until you reactivate it.

  3. To delete a feed, click the trash icon and confirm with Delete. Anything consuming its URL will get a 404 from that moment on, and the URL cannot be recreated.

What a feed includes (and what it never does)

Feeds only ever contain published, non-expired jobs. Drafts, jobs pending moderation, and expired jobs never appear, so publishing and expiring jobs on your board (see Post and manage jobs) automatically updates every feed. Job descriptions are included as sanitized HTML.

Related: feeds are the outbound half of syndication. To pull jobs into your board from other sources, see Import jobs from feeds. For programmatic access with authentication and write operations, use the REST API.

Did this answer your question?