API Documentation — Jerry Sniffs

Authentication

All product APIs require authentication. Use either the session cookie returned by login or an API token in the Authorization: Bearer header.

Login — obtain session cookie

curl -sS -c cookies.txt "https://jerrysniffs.online/api/v1/auth/login" \ -H "Content-Type: application/json" \ -d '{"email":"[email protected]","password":"your-password"}'

Create API token (requires session)

curl -sS -b cookies.txt "https://jerrysniffs.online/api/v1/auth/api-tokens" \
  -H "Content-Type: application/json" \
  -d '{"label":"my agent"}'

Store the returned token and use it for all subsequent requests:

Use API token

export TOKEN="your-api-token-here"

MCP Setup

Use the official jerrysniffs-mcp package to connect JerrySniffs to MCP-compatible agents. Create an API token from the dashboard first; the MCP server reads it from the API_KEY environment variable and runs over stdio transport.

Install globally

npm install -g jerrysniffs-mcp

Claude Code, Claude Desktop, Cline, PI, and compatible mcp.json clients

{
  "mcpServers": {
    "jerrysniffs": {
      "command": "npx",
      "args": ["-y", "jerrysniffs-mcp"],
      "env": {
        "API_KEY": "your-api-key-here"
      }
    }
  }
}

Note: If you are using PI agent, you might need to tell your LLM to first connect to jerrysniffs MCP by specifically asking for it. This is an issue with PI and only has to be done the first time.

Codex ~/.codex/config.toml

[mcp_servers.jerrysniffs]
command = "npx"
args = ["-y", "jerrysniffs-mcp"]
tool_timeout_sec = 300

[mcp_servers.jerrysniffs.env]
API_KEY = "your-api-key-here"

Note: Add both Codex blocks: [mcp_servers.jerrysniffs] and [mcp_servers.jerrysniffs.env].

OpenCode ~/.config/opencode/opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "jerrysniffs": {
      "type": "local",
      "command": ["npx", "-y", "jerrysniffs-mcp"],
      "enabled": true,
      "environment": {
        "API_KEY": "your-api-key-here"
      }
    }
  }
}

search twitter_search tweet_lookup reddit_search_posts url_to_markdown

POST /api/v1/search Auth required

Search

Search the web through the configured provider chain. Returns real-time results with URL, title, and snippet for each result.

Request

curl -sS "https://jerrysniffs.online/api/v1/search" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "site:docs.stripe.com webhooks",
    "limit": 10,
    "country": "US",
    "page": 1,
    "start": 0,
    "tbs": "qdr:w"
  }'

Parameter	Type	Description
query	string	Search query. Supports `site:` operators and advanced syntax.
limit	number	Number of results to return.
country	string	Country code for localized results (e.g. `US`, `GB`).
page	number	Page number for pagination (1-based).
start	number	Result offset for pagination.
tbs	string	Time-based search filter. Values: `qdr:h` (last hour), `qdr:d` (last day), `qdr:w` (last week), `qdr:m` (last month), `qdr:y` (last year). Custom range: `cdr:1,cd_min:01/01/2026,cd_max:03/31/2026`.

ok query urls count

POST /api/v1/url_to_markdown Auth required

URL to Markdown

Fetch any public URL and convert its content to clean, LLM-ready Markdown. Supports an optional proxy for pages that require it.

Request

curl -sS "https://jerrysniffs.online/api/v1/url_to_markdown" \ -H "Authorization: Bearer $TOKEN" \ -H "Content-Type: application/json" \ -d '{ "url": "https://example.com/article", "proxy": "http://username:[email protected]:8080" }'

Parameter	Type	Description
url	string	The public URL to fetch and convert.
proxy	string	Optional HTTP proxy URL (e.g. `http://user:pass@host:port`).

ok url markdown is_proxy_used

POST /api/v1/twitter_search Auth required

Twitter / X Search

Search Twitter/X posts in real time. Returns tweet text, author info, engagement metrics, and more. Useful for social signal monitoring and research.

Request

curl -sS "https://jerrysniffs.online/api/v1/twitter_search" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "openai agents",
    "search_type": "Latest",
    "limit": 10
  }'

Parameter	Type	Description
query	string	Search query for Twitter/X.
search_type	string	One of `Top` (default) or `Latest`.
limit	number	Number of tweets to return.

ok tweets

POST /api/v1/tweet_lookup Auth required

Tweet Lookup

Look up a single tweet by its numeric ID. Returns full tweet details including author, text, engagement stats, and media.

Request

curl -sS "https://jerrysniffs.online/api/v1/tweet_lookup" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"id":"1234567890123456789"}'

Parameter	Type	Description
id	string	Numeric tweet ID.

ok tweet

POST /api/v1/reddit_search_posts Auth required

Reddit Search

Search Reddit posts across all subreddits or within a specific one. Supports sorting and time-range filters.

Request

curl -sS "https://jerrysniffs.online/api/v1/reddit_search_posts" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "best docs search api",
    "subreddit": "SaaS",
    "sort": "top",
    "time": "month",
    "limit": 10
  }'

Parameter	Type	Description
query	string	Search query for Reddit posts.
subreddit	string	Optional — restrict search to a specific subreddit.
sort	string	One of `relevance` (default), `hot`, `top`, `new`, `comments`.
time	string	One of `hour`, `day`, `week`, `month`, `year`, `all` (default).
limit	number	Number of posts to return.

ok posts posts[].id posts[].createdAt posts[].postTitle posts[].url posts[].content posts[].score posts[].commentCount posts[].authorInfo posts[].upvoteRatio posts[].subreddit

GET /api/v1/call_logs Auth required

Call Logs

Search your API invocation logs. Every call to the above endpoints is logged with endpoint, input, output, status, HTTP code, duration, and timestamp. Useful for debugging, auditing, and cost tracking.

Request

curl -sS "https://jerrysniffs.online/api/v1/call_logs?q=searchWeb&page=1&limit=25" \
  -H "Authorization: Bearer $TOKEN"

Parameter	Type	Description
q	string	Plain text search across endpoint, status, HTTP code, input, output, and error.
endpoint	string	Filter by exact endpoint name (e.g. `searchWeb`, `urlToMarkdown`).
status	string	`success` or `failure`.
page	number	1-based page number.
limit	number	Page size (capped by server config).
sort_by	string	`created_at`, `endpoint`, `status`, `http_code`, or `duration_ms`.
sort_dir	string	`asc` or `desc`.

rows page limit total totalPages