Skip to main content

API Integration

API Feeds are Talroo's most powerful integration. You automatically benefit from Talroo's algorithmic and technological advances when you call the Search API.

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",
      "visa_status": "no_visa_information",
    }
  ],
  "total": 156,
  "start": 0,
  "count": 10
}
Important tracking parameters
TipDescription
Personalization (pid)add a unique and persistent user id hash as a query parameter for your API requests like &pid=randomstringhere to unlock extra value through personalized results. Read More
Referrer (referrer)add &referrer=yourdomain.com on each Search request to gain visibility in the Talroo network and is also viewable in the earnings report Read More
Tracking tags (t1, t2, t3)add optional query parameters t1, t2, t3 for help with tracking segments. Viewable in the earnings report. Learn More
Redirect (rdr)useful if you are caching data and want to avoid expired clicks Learn More
Segmenting

Traffic from multiple sources should be segmented into multiple feeds to allow for better targeting. Read More

API SubTypes

If you are using api credentials for Email, SMS (text messages), Registration Path, or Push Notifications, please contact publishers@talroo.com to get your traffic correctly classified or split into another api feed.

Setup​

  1. Work with your developers so only your backend calls the Search API. Load id, pass, and the correct 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 above tip)
    • Issue requests from the server with q and/or l, and ip
    • Addtional options available: Search API spec.
  2. Render results from your backend to jobseekers. When someone clicks a job AND the click reflects real intent to explore or apply then direct them through the url Talroo provides.
  3. Run a pilot with real traffic. Open the Publisher Dashboard and confirm volume, earnings, and Quality Score look like what you expect for your traffic mix before you scale.
tip

Issue Search API requests at query time (limit caching) so results stay aligned with budgets, pauses, and inventory.

danger

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

See Also​