Tools API

The Tools API provides public utility endpoints for common data transformations, such as extracting the creation timestamp from a social post URL or parsing a full name into its first and last name components.

Authentication Required

All API requests require authentication. See API Overview for details.

---

Social URL Timestamp

Get the UTC creation time of a social media post.

GET /api/tools/social-url-timestamp

Query Parameters

Parameter	Type	Required	Description
url	string	Yes	A social post/activity URL.

Response

{
  "id": "7349008612637241345",
  "timestamp": "2025-07-10T09:36:31.230000Z",
  "unix_ms": 1752140191230
}

Response Fields

Field	Type	Description
id	string	The numeric social post/activity ID extracted from the input
timestamp	string	UTC creation time decoded from the ID
unix_ms	integer	Creation time as Unix milliseconds

Rate Limiting

• 500 requests per minute per API key

Example Request

cURL

curl -H "X-API-Key: your_api_key_here" \
     "https://production.viacurrent.com/api/tools/social-url-timestamp?url=https://www.social.com/posts/johndoe_activity-7349008612637241345"

JavaScript

const url = new URL('https://production.viacurrent.com/api/tools/social-url-timestamp');
url.searchParams.append('url', 'https://www.social.com/posts/johndoe_activity-7349008612637241345');

const response = await fetch(url, {
  headers: {
    'X-API-Key': 'your_api_key_here'
  }
});

const data = await response.json();

Python

import httpx

url = "https://production.viacurrent.com/api/tools/social-url-timestamp"
headers = {"X-API-Key": "your_api_key_here"}
params = {"url": "7349008612637241345"}

response = httpx.get(url, headers=headers, params=params)
data = response.json()

---

Parse Name

Split a full name string into first and last name components. Handles complex names with prefixes, suffixes, and multiple parts.

GET /api/tools/parse-name

Query Parameters

Parameter	Type	Required	Description
name	string	Yes	A full name to split into first and last name

Response

{
  "first_name": "John",
  "last_name": "Doe"
}

Response Fields

Field	Type	Description
first_name	string	Parsed first name
last_name	string	Parsed last name

Rate Limiting

• 500 requests per minute per API key

Example Request

cURL

curl -H "X-API-Key: your_api_key_here" \
     "https://production.viacurrent.com/api/tools/parse-name?name=John%20Doe"

JavaScript

const url = new URL('https://production.viacurrent.com/api/tools/parse-name');
url.searchParams.append('name', 'John Doe');

const response = await fetch(url, {
  headers: {
    'X-API-Key': 'your_api_key_here'
  }
});

const data = await response.json();

Python

import httpx

url = "https://production.viacurrent.com/api/tools/parse-name"
headers = {"X-API-Key": "your_api_key_here"}
params = {"name": "John Doe"}

response = httpx.get(url, headers=headers, params=params)
data = response.json()

---

Error Responses

400 Bad Request

When providing an invalid URL or ID that we can't parse.

{
  "detail": "Input not valid: https://www.social.com/in/johndoe"
}

429 Too Many Requests

{
  "detail": "Rate limit exceeded"
}