# XML Feed Reference

## General feed nodes

<table data-full-width="true"><thead><tr><th width="251.33333333333331">Element</th><th width="110">Required</th><th>Description</th><th>Example</th></tr></thead><tbody><tr><td><code>&#x3C;?xml ?></code></td><td><mark style="background-color:orange;"><strong>Yes</strong></mark></td><td>XML declaration</td><td><code>&#x3C;?xml version='1.0' encoding='UTF-8'?></code></td></tr><tr><td><code>&#x3C;Postings></code></td><td><mark style="background-color:orange;"><strong>Yes</strong></mark></td><td>Root node for the XML feed document.</td><td>—</td></tr><tr><td><code>&#x3C;Item></code></td><td><mark style="background-color:orange;"><strong>Yes</strong></mark></td><td>Job-specific metadata.</td><td>—</td></tr></tbody></table>

## Job feed elements

Job feed elements define job-specific metadata for a `<Item>` node.

<table data-full-width="true"><thead><tr><th width="252">Element</th><th width="103">Required</th><th>Description</th><th>Example</th></tr></thead><tbody><tr><td><code>&#x3C;Brand></code></td><td><mark style="background-color:orange;"><strong>Yes</strong></mark></td><td>The Brand name that is displayed on Snagajob search results.</td><td><code>&#x3C;![CDATA[ABC Company]]></code></td></tr><tr><td><code>&#x3C;Job_Title></code></td><td><mark style="background-color:orange;"><strong>Yes</strong></mark></td><td>The title of the job.</td><td><code>&#x3C;![CDATA[Data Entry Clerk]]></code></td></tr><tr><td><code>&#x3C;Employment_Type></code></td><td></td><td>The type of job, full- or part-time. Defaults to <code>FullTime,PartTime</code> if left blank. Accepted values:<br><code>FullTime</code><br><code>PartTime</code><br><code>Gig</code></td><td><code>&#x3C;![CDATA[FullTime]]></code></td></tr><tr><td><code>&#x3C;Wage></code></td><td></td><td>Preferably a number like <code>$10.00</code> (Including a currency symbol) or minimum to maximum range, and wording that uses hourly, such as “$10 - 15 per hour” are also acceptable.</td><td><code>&#x3C;![CDATA[$10 - 15 per hour]]></code></td></tr><tr><td><code>&#x3C;Location_Name></code></td><td></td><td>Preferably a store location number, street address, or city, state zip. <strong>Must be unique per location.</strong></td><td><code>&#x3C;![CDATA[Main Store 123]]></code></td></tr><tr><td><code>&#x3C;Address_Line_1></code></td><td></td><td>The street address of the job's primary work location. Please include the street name and number. Street address may be used by Snagajob to improve the precision of location-based job search and will be displayed to job seekers.</td><td><code>&#x3C;![CDATA[123 Main St]]></code></td></tr><tr><td><code>&#x3C;City></code></td><td><mark style="background-color:orange;"><strong>Yes</strong></mark></td><td>The city in which this job is located. Must be a valid city based on USPS validation. If an invalid city is sent, the job will not be posted.</td><td><code>&#x3C;![CDATA[Richmond]]></code></td></tr><tr><td><code>&#x3C;State></code></td><td><mark style="background-color:orange;"><strong>Yes</strong></mark></td><td>The state in which this job is located. <strong>Must be a State abbreviation</strong> (ex. VA, CA, FL)</td><td><code>&#x3C;![CDATA[VA]]></code></td></tr><tr><td><code>&#x3C;Zip></code></td><td></td><td>The postal code in which this job is located. <mark style="color:red;"><strong>If the zip is not provided, then Snagajob will assign one.</strong></mark> Zip is based on USPS standards and must only be the first five digits. The job will not be posted if the postal code and city do not align.</td><td><code>&#x3C;![CDATA[23225]]></code></td></tr><tr><td><code>&#x3C;Job_Description></code></td><td><mark style="background-color:orange;"><strong>Yes</strong></mark></td><td>Include HTML formatting with the Job Description text. The text will be displayed without formatting if HTML formatting is not included. <mark style="color:red;"><strong>Phone numbers and External URLs will be removed.</strong></mark></td><td><code>&#x3C;![CDATA[Something interesting about this posting.]]></code></td></tr><tr><td><code>&#x3C;Primary_Industry></code></td><td><mark style="background-color:orange;"><strong>Yes</strong></mark></td><td>See <a href="#industry-options">Industry Options</a> section</td><td><code>&#x3C;![CDATA[Automotive]]></code></td></tr><tr><td><code>&#x3C;URL></code></td><td><mark style="background-color:orange;"><strong>Yes</strong></mark></td><td>The URL for this job listing on your site.<br><br>The apply URL must begin with <code>http://</code> or <code>https://</code>.</td><td><code>&#x3C;![CDATA[http://www.exampleats.com/job1]]></code></td></tr><tr><td><code>&#x3C;External_Posting_ID></code></td><td><mark style="background-color:orange;"><strong>Yes</strong></mark></td><td>Unique identifier per job posting. Snagajob uses this element to identify each job. <strong>Avoid changing this number once you’ve set it.</strong></td><td><code>&#x3C;![CDATA[123_unique_id]]></code></td></tr><tr><td><code>&#x3C;Rate></code></td><td></td><td>The Cost Per Click (CPC) bidding Rate. Formatted as  <code>##.##</code></td><td><code>&#x3C;![CDATA[10.00]]></code></td></tr><tr><td><code>&#x3C;Location_Number></code></td><td></td><td>This field represents the Store number. While this element is not required, <strong>it’s highly encouraged to include</strong></td><td><code>&#x3C;![CDATA[123]]></code></td></tr><tr><td><code>&#x3C;TrackingUrl></code></td><td></td><td><p>The URL to which Snagajob will send click data. Snagajob creates a GET request to this URL each time a worker clicks the ‘Apply Now’ button on Snagajob. <br></p><p>See <a data-mention href="/pages/uLHQDbv8OHi4G79fIe94">/pages/uLHQDbv8OHi4G79fIe94</a></p></td><td><code>&#x3C;![CDATA[https://myapplicantapi.com/where-clicks-should-go]]></code></td></tr><tr><td><code>&#x3C;LogoUrl></code></td><td></td><td>An image URL for the brand associated with the posting. <strong>Strongly recommended for maximizing performance.</strong> Accepted content-types:  image/jpeg, image/png, image/gif, image/webp</td><td><code>&#x3C;![CDATA[https://myapplicantapi.com/where-snagajob-should-find-my-logo-image/logo.png]]></code></td></tr></tbody></table>

## Aggregate Job Feed Elements

<table data-full-width="true"><thead><tr><th>Element</th><th width="131">Required</th><th>Description</th><th>Example</th></tr></thead><tbody><tr><td><code>&#x3C;Feed_Source></code></td><td></td><td>A unique string to group employers so that a given partner can provide more than 1 aggregate file.</td><td><code>&#x3C;![CDATA[Feed_ID_1]]></code></td></tr><tr><td><p></p><p><code>&#x3C;Employer_ID></code> </p></td><td><mark style="background-color:orange;"><strong>Yes when uploading an</strong></mark> <a href="/pages/3R5CRirXKSNlHUHuCTvi"><mark style="background-color:orange;"><strong>aggregate feed</strong></mark></a></td><td>An ID that uniquely identifies an employer. This while preferability match the ID of the employer in your system.</td><td><code>&#x3C;![CDATA[12345]]></code></td></tr><tr><td><code>&#x3C;Employer_Name></code></td><td><mark style="background-color:orange;"><strong>Yes when uploading an</strong></mark> <a href="/pages/3R5CRirXKSNlHUHuCTvi"><mark style="background-color:orange;"><strong>aggregate feed</strong></mark></a></td><td><p>The parent organization name. </p><p></p><p>For example, if subsidiaries or franchises have multiple <code>&#x3C;Brand></code> names under the same company, the <code>&#x3C;Employer_Name></code> would be the same for all those jobs.</p></td><td><code>&#x3C;![CDATA[Parent Company Inc]]></code></td></tr></tbody></table>

## Easy Apply feed elements

<table data-full-width="true"><thead><tr><th>Element</th><th width="131">Required</th><th>Description</th><th>Example</th></tr></thead><tbody><tr><td><code>&#x3C;PostUrl></code></td><td><mark style="background-color:orange;"><strong>Yes for Easy Apply</strong></mark></td><td>The URL to which Snagajob will post the application data.<br><br>See: <a data-mention href="/pages/H84BsY9EhboIgdBssmfE#posturl">/pages/H84BsY9EhboIgdBssmfE#posturl</a></td><td><code>&#x3C;![CDATA[https://myapplicantapi.com/where-applications-should-go]]></code></td></tr><tr><td><p></p><p><code>&#x3C;ScreeningQuestionsUrl></code> </p></td><td><mark style="background-color:orange;"><strong>Yes for Easy Apply</strong></mark></td><td>A URL that returns a JSON-formatted string of questions to be asked during the Easy Apply application process. Refer to Using screener questions for more information about creating questions.<br><br>See: <a data-mention href="/pages/H84BsY9EhboIgdBssmfE#using-screening-questions">/pages/H84BsY9EhboIgdBssmfE#using-screening-questions</a></td><td><code>&#x3C;![CDATA[https://myapplicantapi.com/where-we-find-questions]]></code></td></tr></tbody></table>

## Campaign feed elements

{% hint style="info" %}
**Note:** These elements are not required for clients managing campaigns via the [Sponsorship API](/job-sponsorship/sponsoring-postings-via-snagajobs-sponsorship-api.md).
{% endhint %}

<table data-full-width="true"><thead><tr><th width="230">Field Name</th><th width="134">Required</th><th width="272">Description</th><th>Example</th></tr></thead><tbody><tr><td><code>&#x3C;Campaign_Id></code></td><td><mark style="background-color:orange;"><strong>Yes for campaigns</strong></mark></td><td>The unique ID for a campaign in your system. This ID will correspond to the ID value passed in the XML feed.</td><td><code>&#x3C;![CDATA[123_test_id]]></code></td></tr><tr><td><code>&#x3C;Campaign_Name></code></td><td><mark style="background-color:orange;"><strong>Yes for feed campaigns</strong></mark></td><td>The name of the campaign. It does not have to be unique.</td><td><code>&#x3C;![CDATA[Test_Campaign_123]]></code></td></tr><tr><td><code>&#x3C;Application_Goal></code></td><td></td><td>The targeted number of applications for this campaign.</td><td><code>&#x3C;![CDATA[10]]></code></td></tr><tr><td><code>&#x3C;CPA_Goal></code></td><td><mark style="background-color:blue;">Recommend for best performance</mark></td><td>The target cost per application (CPA) value for a campaign. This is a goal, not the actual bid value. Your campaigns performance will be optimized using this value. <br><br><mark style="color:red;"><strong>Note: You must have</strong></mark> <a data-mention href="/pages/OSum4y35F6rtwgWaKcjB">/pages/OSum4y35F6rtwgWaKcjB</a><mark style="color:red;"><strong>configured for campaign optimizations to occur.</strong></mark> </td><td><code>&#x3C;![CDATA[15]]></code></td></tr><tr><td><code>&#x3C;CPC></code></td><td></td><td>The value of an actual bid set at the campaign level.</td><td><code>&#x3C;![CDATA[6]]></code></td></tr><tr><td><code>&#x3C;Budget></code></td><td></td><td>The designated budget for the campaign.</td><td><code>&#x3C;![CDATA[150]]></code></td></tr><tr><td><code>&#x3C;Campaign_Start></code></td><td></td><td>The intended start date of the campaign. If left null, the campaign will commence immediately. <br><br>We recommend the <a href="https://en.wikipedia.org/wiki/ISO_8601">ISO-8601 standard format</a> for dates and times.</td><td><code>&#x3C;![CDATA[2023-08-01T00:00:000Z]]></code></td></tr><tr><td><code>&#x3C;Campaign_End></code></td><td></td><td>The desired end date of the campaign. If left null, the campaign will remain active until manually paused or the entire budget is exhausted.<br><br>We recommend the <a href="https://en.wikipedia.org/wiki/ISO_8601">ISO-8601 standard format</a> for dates and times.</td><td><code>&#x3C;![CDATA[2023-08-31T00:00:000Z]]></code></td></tr></tbody></table>

## XML Examples

### Single Customer Feed XML Example &#x20;

```markup
<?xml version='1.0' encoding='UTF-8'?>
<Postings>   
    <Item>
        <Brand><![CDATA[Feed Cleaning Co]]></Brand>
        <Job_Title><![CDATA[Meat Server]]></Job_Title>
        <Employment_Type><![CDATA[Gig]]></Employment_Type>
        <Wage><![CDATA[$10.00]]></Wage>
        <Location_Name><![CDATA[Surrugiv]]></Location_Name>
        <Address_Line_1><![CDATA[714 Naskog Drive]]></Address_Line_1>
        <City><![CDATA[Glen Allen]]></City>
        <State><![CDATA[VA]]></State>
        <Zip><![CDATA[23060]]></Zip>
        <Job_Description><![CDATA[Delish]]></Job_Description>
        <Primary_Industry><![CDATA[CustomerService]]></Primary_Industry>
        <URL><![CDATA[https://google.com]]></URL>
        <External_Posting_ID><![CDATA[4116484012]]></External_Posting_ID>
        <Location_Number><![CDATA[54]]></Location_Number>
        <LogoUrl><![CDATA[https://myapplicantapi.com/where-snagajob-should-find-my-logo-image/logo.png]]></LogoUrl>
        <TrackingUrl><![CDATA[https://myapplicantapi.com/where-clicks-should-go]]></TrackingUrl>
        <!--BEGIN EASY APPLY INFO-->
        <!--Easy Apply elements are only applicable to partners with an Easy Apply integration-->
        <PostUrl><![CDATA[https://myapplicantapi.com/where-applications-should-go]]></PostUrl>
        <ScreeningQuestionsUrl><![CDATA[https://myapplicantapi.com/where-we-find-questions]]></ScreeningQuestionsUrl>
        <!--END EASY APPLY INFO-->
        <!--BEGIN CAMPAIGN INFO-->
        <!--campaign details are only applicable to those managing campaigns using their XML feed-->
        <Campaign_Id><![CDATA[another_test_id]]></Campaign_Id>
        <Budget><![CDATA[1000]]></Budget>
        <CPA_Goal><![CDATA[10]]></CPA_Goal>
        <Campaign_Name><![CDATA[Test_Campaign_1]]></Campaign_Name>
        <Campaign_Start><![CDATA[2023-06-02T00:00:000Z]]></Campaign_Start>
        <Campaign_End><![CDATA[2023-06-30T00:00:000Z]]></Campaign_End>
        <!--END CAMPAIGN INFO-->
    </Item>
</Postings>
```

### Aggregate Feed XML Example

```xml
<?xml version='1.0' encoding='UTF-8'?>
<Postings>
    <Feed_Source><![CDATA[SomeUniqueSourceThatGroupsEmployersTogether]]></Feed_Source>
    <Item>
        <!--posting associated with the first <Employer_ID>-->
        <Employer_ID><![CDATA[12345]]></Employer_ID>
        <Employer_Name><![CDATA[The Parent Employer Inc]]></Employer_Name>
        <Brand><![CDATA[YourCompany]]></Brand>
        <Job_Title><![CDATA[Search Engine Evaluator - Work From Home]]></Job_Title>
        <Employment_Type><![CDATA[FullTime]]></Employment_Type>
        <Wage><![CDATA[$10.00 - $15.00 per hour]]></Wage>
        <Location_Name><![CDATA[Glen Allen Store 123]]></Location_Name>
        <Address_Line_1><![CDATA[123 Test Street]]></Address_Line_1>
        <City><![CDATA[Glen Allen]]></City>
        <State><![CDATA[VA]]></State>
        <Zip><![CDATA[23260]]></Zip>
        <Rate><![CDATA[10.00]]></Rate>
        <Job_Description><![CDATA[Thanks for your interest!]]></Job_Description>
        <Primary_Industry><![CDATA[Customer Service]]></Primary_Industry>
        <URL><![CDATA[https://www.yourats.com/12345_testID]]></URL>
        <External_Posting_ID><![CDATA[12345_testID]]></External_Posting_ID>
        <Location_Number><![CDATA[123]]></Location_Number>
        <LogoUrl><![CDATA[https://myapplicantapi.com/where-snagajob-should-find-my-logo-image/logo.png]]></LogoUrl>
        <TrackingUrl><![CDATA[https://myapplicantapi.com/where-clicks-should-go]]></TrackingUrl>
        <!--BEGIN EASY APPLY INFO-->
        <!--Easy Apply elements are only applicable to partners with an Easy Apply integration-->
        <PostUrl><![CDATA[https://myapplicantapi.com/where-applications-should-go]]></PostUrl>
        <ScreeningQuestionsUrl><![CDATA[https://myapplicantapi.com/where-we-find-questions]]></ScreeningQuestionsUrl>
        <!--END EASY APPLY INFO-->
        <!--BEGIN CAMPAIGN INFO-->
        <!--campaign details are only applicable to those managing campaigns using their XML feed-->
        <Campaign_Id><![CDATA[another_test_id]]></Campaign_Id>
        <Budget><![CDATA[1000]]></Budget>
        <CPA_Goal><![CDATA[10]]></CPA_Goal>
        <Campaign_Name><![CDATA[Test_Campaign_1]]></Campaign_Name>
        <Campaign_Start><![CDATA[2023-06-02T00:00:000Z]]></Campaign_Start>
        <Campaign_End><![CDATA[2023-06-30T00:00:000Z]]></Campaign_End>
        <!--END CAMPAIGN INFO-->
    </Item>
    <Item>
        <!--posting associated with a second <Employer_ID>-->
        <Employer_ID><![CDATA[employer2]]></Employer_ID>
        <Employer_Name><![CDATA[TheEmployerName2]]></Employer_Name>
        <Brand><![CDATA[YourCompany]]></Brand>
        <Job_Title><![CDATA[Search Engine Evaluator - Work From Home]]></Job_Title>
        <Employment_Type><![CDATA[FullTime]]></Employment_Type>
        <Wage><![CDATA[$10.00 - $15.00 per hour]]></Wage>
        <Location_Name><![CDATA[Glen Allen Store 123]]></Location_Name>
        <Address_Line_1><![CDATA[123 Test Street]]></Address_Line_1>
        <City><![CDATA[Glen Allen]]></City>
        <State><![CDATA[VA]]></State>
        <Zip><![CDATA[23260]]></Zip>
        <Rate><![CDATA[10.00]]></Rate>
        <Job_Description><![CDATA[Thanks for your interest!]]></Job_Description>
        <Primary_Industry><![CDATA[Customer Service]]></Primary_Industry>
        <URL><![CDATA[https://www.yourats.com/12345_testID]]></URL>
        <External_Posting_ID><![CDATA[12345_testID]]></External_Posting_ID>
        <Location_Number><![CDATA[123]]></Location_Number>
        <LogoUrl><![CDATA[https://myapplicantapi.com/where-snagajob-should-find-my-logo-image/logo.png]]></LogoUrl>
    </Item>
</Postings>
```

## Appendix

### **Industry Options**

* Accounting & Finance
* Administration & Office Support
* Agriculture & Environment
* Automotive
* Computers & Technology
* Construction
* Customer Service
* Education
* Food & Restaurant
* Government & Military
* Healthcare
* Hotel & Hospitality
* Installation & Repair
* Law Enforcement & Security
* Legal
* Maintenance & Janitorial
* Management
* Media & Entertainment
* Other
* Personal Care & Services
* Retail
* Sales & Marketing
* Salon/Spa/Fitness
* Social Services
* Transportation
* Warehouse & Production
* Wellness
* Work at Home


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.snagajob.com/posting-creation/xml-feed-reference.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.