Skip to main content

API Integration

The Search API is the most capable integration.

Full API reference: Search API.

Credentials​

Copy id and pass from the Search API credentials in TAP, or follow the onboarding URL/email we send.

Quickstart Request​

GET https://api.jobs2careers.com/api/search.php?
  id=YOUR_PUBLISHER_ID&         # Required
  pass=YOUR_SEARCH_API_PASS&    # Required
  ip=USER_IP&                   # Ip address of the user
  q=nurse&                      # Query
  l=Austin,TX&                  # Location: "City, ST" or zipcode
  pid=USER_PID_HASH&            # Strongly recommended (see Personalization link below)
  extractions=1&                # Include fields extracted from the job description (optional)
  logo=1&                       # Include company logo url in the results (faster without)
  start=0&                      # Pagination: Result number to start at (0-index)
  limit=10&                     # Pagination: Maximum result count (max 200)
  full_desc=1&                  # Pull the full job description (faster without)
  link=1&                       # Includes the click url
  format=json                   # Return response as json
Domains

Bulk / asynchronous lanes (SMS, email, push) should use bulk.jobs2careers.com… instead of api...

Response​

{
  "jobs": [
    {
      "title": "Registered Nurse",
      "company": "Example Health",
      "description": "Example job description",
      "url": "https://www.jobs2careers.com/click.php?id=12345678.YOUR_ID&...",
      "city": ["Austin,TX"],
      "coordinates": ["30.328634,-97.6328"],
      "price": 12, // cpc cents
      "majorcategory0": "[Healthcare - Nursing]",
      "minorcategory0": "[Healthcare - Nursing] Registered Nurse (RN/BSN/ASN)",
      //logos
      "logo_url": "https://media.j2c.com/company-logos/example",
      "hero_image_url": "https://media.j2c.com/hero-images/example",
      // Extractions
      "all_requirements_normalized": `{"Must have a license": "112345", "Must like cookies": "0"}`,
      "all_preferences_normalized": `{"Proficiency with drinking water": "0"}
      "work_schedule": "M - F (occasional Saturday*)",
      "work_location_type": "onsite",
      "benefits": "Comprehensive benefits package including health, dental, vision, and life insurance",
      "compensation": "$21.00 - $27.50 / hour",
      "visa_status": "no_visa_information",
    }
  ],
  "total": 156,
  "start": 0,
  "count": 10
}
Tracking parameters
ParameterDescription
pidUnique, persistent user id hash, e.g. &pid=randomstringhere. See Personalization.
referrerOptional override for the source domain shown in reports. See Referrer.
t1, t2, t3Optional tags for segmenting earnings. See T-Values.
rdrIf you cache results, send the user back to you when the job isn't paying. See RDR.
Segmenting

Split different traffic sources onto different feeds. See Affiliate ID Segmenting.

Email, SMS, push, and registration traffic

If your API traffic comes from email, SMS, push notifications, or a registration flow, email publishers@talroo.com. We'll classify that traffic or put it on a separate feed.

Expired and Stale Clicks​

Expired means the job stopped accepting traffic at full value, for example because its budget ran out or it was paused or removed. These clicks can pay less. Talroo may replace the job with a similar active one.

Stale means a cached click URL's pricing window has ended. The old price no longer applies, and the click can pay less. Query at request time, and delete Search API results within 24 hours (required by the Terms of Service).

Pass rdr if you'd rather get the user back than show a dead or swapped job. More detail: Click Validation.

Setup​

Default query

If you are unsure what to search for, or you need to show jobs before the user enters a query, use q=jobs near me with their location (l, or inferred from ip).

  1. Call Search from your backend. Load id, pass, and the right hostname (api… vs bulk…; see the Domains note above) from TAP or onboarding.
    • Never put pass or other secrets in client-side code.
    • Attach tracking query params as needed (see the tip above).
    • Send q and/or l, and ip.
    • More options: Search API spec.
  2. Render results from your backend. When someone clicks a job, send them through the url Talroo returned. That keeps attribution correct. See Quality Score.
  3. Watch volume, earnings, and Quality Score in TAP before you scale.
danger

Do not change job titles, pay language, or use deceptive practices to get users to click on jobs. Doing so may result in termination from the Talroo Publisher Program.

See Also​