Quick Start

Get started with the Jungler API in minutes. This guide walks you through making your first API call and retrieving data.

Prerequisites

Before you begin, you'll need:

• A Jungler account
• An API key (create one at app.jungler.ai/settings/integrations)

Step 1: Get Your API Key

1. Navigate to https://app.jungler.ai/settings/integrations
2. Click "Create API Key"
3. Copy and save your key securely - you won't be able to see it again

Step 2: Get Your Workspace ID

Every API request requires a workspace ID. List your available workspaces:

cURL

curl -H "X-API-Key: your_api_key_here" \
     https://production.viacurrent.com/api/workspaces

Python

import httpx

response = httpx.get(
    'https://production.viacurrent.com/api/workspaces',
    headers={'X-API-Key': 'your_api_key_here'}
)
print(response.json())

Response:

[
  {
    "_id": "507f1f77bcf86cd799439011",
    "name": "My Company Workspace",
    "role": "admin"
  }
]

Save the _id - this is your workspace ID for subsequent requests.

Step 3: List Your Searches

Check which searches are collecting posts in your workspace:

cURL

curl -H "X-API-Key: your_api_key_here" \
     "https://production.viacurrent.com/api/searches?workspace_id=507f1f77bcf86cd799439011"

Python

import httpx

response = httpx.get(
    'https://production.viacurrent.com/api/searches',
    headers={'X-API-Key': 'your_api_key_here'},
    params={'workspace_id': '507f1f77bcf86cd799439011'}
)
print(response.json())

Response:

[
  {
    "_id": "507f1f77bcf86cd799439012",
    "name": "Tech Industry Leaders",
    "query": "CTO OR \"Chief Technology Officer\"",
    "query_type": "keyword",
    "is_activated": true
  }
]

Save the search _id to filter posts.

Step 4: Retrieve Posts

Get posts from your searches with filters:

cURL

curl -H "X-API-Key: your_api_key_here" \
     "https://production.viacurrent.com/api/posts?workspace_id=507f1f77bcf86cd799439011&search_ids=507f1f77bcf86cd799439012&page_size=10&match=relevant"

Python

import httpx

response = httpx.get(
    'https://production.viacurrent.com/api/posts',
    headers={'X-API-Key': 'your_api_key_here'},
    params={
        'workspace_id': '507f1f77bcf86cd799439011',
        'search_ids': '507f1f77bcf86cd799439012',
        'page_size': 10,
        'match': 'relevant'
    }
)
print(response.json())

Response:

{
  "items": [
    {
      "_id": "507f1f77bcf86cd799439013",
      "content": "Excited to announce...",
      "author": {
        "name": "Jane Smith",
        "profile_url": "https://linkedin.com/in/janesmith",
        "function": "ENG",
        "authority": "L"
      },
      "posted_at": "2024-01-15T10:30:00Z",
      "reaction_count": 42,
      "comment_count": 8
    }
  ],
  "total": 150,
  "page": 1,
  "page_size": 10,
  "pages": 15
}

Next Steps

Extract Post Interactions

Want to get comments and reactions from a specific post? See the Workbooks API Quick Start.

Advanced Filtering

Explore powerful filtering options:

cURL

# Filter by sentiment and function
curl -H "X-API-Key: your_api_key_here" \
     "https://production.viacurrent.com/api/posts?workspace_id=507f1f77bcf86cd799439011&search_ids=507f1f77bcf86cd799439012&sentiment=positive&function=ENG,PRD&authority=L"

# Filter by date range
curl -H "X-API-Key: your_api_key_here" \
     "https://production.viacurrent.com/api/posts?workspace_id=507f1f77bcf86cd799439011&search_ids=507f1f77bcf86cd799439012&created_after=2024-01-01&created_before=2024-01-31"

# Filter by company size and industry
curl -H "X-API-Key: your_api_key_here" \
     "https://production.viacurrent.com/api/posts?workspace_id=507f1f77bcf86cd799439011&search_ids=507f1f77bcf86cd799439012&company_size=L,XL,XXL&company_industry=TECH_INFO_MEDIA"

Python

import httpx

# Filter by sentiment and function
response = httpx.get(
    'https://production.viacurrent.com/api/posts',
    headers={'X-API-Key': 'your_api_key_here'},
    params={
        'workspace_id': '507f1f77bcf86cd799439011',
        'search_ids': '507f1f77bcf86cd799439012',
        'sentiment': 'positive',
        'function': 'ENG,PRD',
        'authority': 'L'
    }
)

# Filter by date range
response = httpx.get(
    'https://production.viacurrent.com/api/posts',
    headers={'X-API-Key': 'your_api_key_here'},
    params={
        'workspace_id': '507f1f77bcf86cd799439011',
        'search_ids': '507f1f77bcf86cd799439012',
        'created_after': '2024-01-01',
        'created_before': '2024-01-31'
    }
)

# Filter by company size and industry
response = httpx.get(
    'https://production.viacurrent.com/api/posts',
    headers={'X-API-Key': 'your_api_key_here'},
    params={
        'workspace_id': '507f1f77bcf86cd799439011',
        'search_ids': '507f1f77bcf86cd799439012',
        'company_size': 'L,XL,XXL',
        'company_industry': 'TECH_INFO_MEDIA'
    }
)

See the Posts API documentation for all available filters.

Common Issues

401 Unauthorized

• Cause: Invalid or missing API key
• Solution: Verify your API key is correct and included in the X-API-Key header

403 Forbidden

• Cause: No access to the specified workspace or search
• Solution: Check that you have access to the workspace ID and that the search belongs to that workspace

429 Too Many Requests

• Cause: Rate limit exceeded
• Solution: Implement exponential backoff and reduce request frequency

400 Bad Request

• Cause: Invalid parameters or format
• Solution: Check parameter names, value formats, and ensure required fields are provided

Rate Limits

Endpoint	Rate Limit
GET /workspaces	30/minute
GET /searches	30/minute
GET /posts	60/minute
POST /workbooks	6/minute
GET /workbooks/*	12/minute

Further Reading

• API Reference - Complete API documentation
• Posts API - Detailed filtering options
• Workbooks API - Extract post interactions
• Searches API - Manage searches