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 Concepts link below)
  referrer=yoursite.com&        # Traffic source domain for Analytics / earnings (see tip 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.
referrer&referrer=yourdomain.com on each Search request. Shows up in Analytics. 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.

API subtypes

If you use API credentials for email, SMS, registration path, or push notifications, contact publishers@talroo.com so we can classify that traffic or split it onto another API feed.

Expired and Stale Clicks​

Expired means the job itself stopped taking full-price traffic (budget, pause, taken down). Those clicks pay about 6 cents unless we swap in a live job.

Stale means the click URL is too old (often 24 hours). API clicks are not stale unless you cache results. 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​