IntelFetch API Documentation
All requests to the IntelFetch API require the Authorization header with a Bearer token in the format:
Authorization: Bearer YOUR_API_KEY
Rate Limits
- Global: 100 requests per minute on every endpoint
- IntelX (systemid): 30 searches per day
- IntelX (systemid) cooldown: 10 seconds on each request
- HTTP 429 returned if rate limit exceeded
1. GitHub Search
Endpoint: GET https://api.intelfetch.net/github
Parameters:
- username (required)
Description: Retrieves GitHub user information (profile data, top repositories, and emails found in commits).
Example:
GET /github?username=octocat
Authorization: Bearer YOUR_API_KEY
Response: JSON data containing user profile, top repositories, and up to three emails found in commits.
2. IntelX Search (System ID only)
Endpoint: GET https://api.intelfetch.net/ix
Parameters:
- type (required): must be systemid
- systemid (required if type=systemid)
Description: Performs IntelX searches by system ID. 100 searches per day with a 10-second cooldown per request.
Example:
GET /ix?type=systemid&systemid=7f9fbcac-bf12-4fe0-bc39-4198df963b2d
Authorization: Bearer YOUR_API_KEY
Response: JSON data containing IntelX results for the given system ID.
3. FetchBase Search
Endpoint: GET https://api.intelfetch.net/fetchbase
Parameters:
- query (required)
Description: Searches data using FetchBase.
Example:
GET /fetchbase?query=test@gmail.com
Authorization: Bearer YOUR_API_KEY
Response: JSON search results.
4. Discord Search
Endpoint: GET https://api.intelfetch.net/discord
Parameters:
- query (required)
Description: Retrieves Discord user information for the given query (e.g., username#1234).
Example:
GET /discord?query=testuser#1234
Authorization: Bearer YOUR_API_KEY
Response: JSON data with matching Discord user details.
5. Snusbase Search
Endpoint: GET https://api.intelfetch.net/snusbase
Parameters:
- query (required)
Description: Searches Snusbase records (e.g., by email or username).
Example:
GET /snusbase?query=example@example.com
Authorization: Bearer YOUR_API_KEY
Response: JSON data containing any found breaches or associated records.
6. Log Search
Endpoint: GET https://api.intelfetch.net/logs
Parameters:
- query (required)
- size (optional)
Description: Searches logs for information related to the provided query.
Example:
GET /logs?query=errorlog&size=5
Authorization: Bearer YOUR_API_KEY
Response: JSON data with log entries.
7. Court Search
Endpoint: GET https://api.intelfetch.net/courtsearch
Parameters:
- mode (required: name or phrase)
- terms (required, must be at least 6 characters)
- cancel (optional, boolean)
Description: Initiates a court records search by name or phrase, or cancels an ongoing search.
Examples:
GET /courtsearch?mode=name&terms=John%20Doe
GET /courtsearch?cancel=true
Authorization: Bearer YOUR_API_KEY
Response: JSON data indicating search results or cancelation confirmation.
8. Domain Lookup
Endpoint: GET https://api.intelfetch.net/domain
Parameters:
- domain (required; letters, digits, . or -)
Description: Retrieves DNS records (A, NS, MX, TXT) for the domain.
Example:
GET /domain?domain=example.com
Authorization: Bearer YOUR_API_KEY
Response: JSON data containing DNS records.
9. IP Lookup (New)
Endpoint: POST https://api.intelfetch.net/ip_lookup
Method: POST
JSON Body:
- ip (string, required)
Description: Retrieves IP details from ipwho.is.
Example:
curl -X POST "https://api.intelfetch.net/ip_lookup" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"ip": "8.8.8.8"}'
Response: JSON data with IP location, ISP, timezone, currency, etc.
10. Crypto Search (New)
Endpoint: POST https://api.intelfetch.net/crypto_search
Method: POST
JSON Body:
- crypto_type (string, required: BTC, ETH, or LTC)
- address (string, required)
Description: Retrieves balance and transaction count for the given BTC, ETH, or LTC address.
Example:
curl -X POST "https://api.intelfetch.net/crypto_search" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"crypto_type":"BTC","address":"bc1qh5zzv7fvay2qetcaygr225k6pqz9kgffwxxv3n"}'
Response: JSON data with balance, transaction count, and crypto type.
11. SEON Lookup (New)
Endpoint: POST https://api.intelfetch.net/seon
Method: POST
JSON Body:
- lookup_type (string, required: phone, email, or ip)
- query (string, required)
Description: Queries SEON fraud detection data for phone, email, or IP addresses.
Examples:
Phone:
curl -X POST "https://api.intelfetch.net/seon" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"lookup_type":"phone","query":"+1234567890"}'
Email:
curl -X POST "https://api.intelfetch.net/seon" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"lookup_type":"email","query":"user@example.com"}'
IP:
curl -X POST "https://api.intelfetch.net/seon" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"lookup_type":"ip","query":"8.8.8.8"}'
Response: JSON data with SEON insights for the queried item.
Error Handling
- 400 Bad Request: Invalid parameters
- 401 Unauthorized: Invalid API key
- 403 Forbidden: Active plan required or quota limit reached
- 422 Unprocessable Entity: Could not process the request
- 429 Too Many Requests: Rate limit exceeded
- 500 Internal Server Error: Unexpected server error
Example cURL Command
curl -X GET "https://api.intelfetch.net/domain?domain=example.com" \
-H "Authorization: Bearer YOUR_API_KEY"