OSINT API — Intelligence Reports#

AI-powered OSINT intelligence reports via API. Multiple RSS feeds across 15 categories with enriched analysis, domain recon, and automated feed health monitoring.

External Endpoints#

All requests go to a single hosted API:

EndpointMethodPurposeAuth Requiredhttps://osint.ahsan-tariq-ai.xyz/api/v1/reports/enrichedGETIntelligence briefingsYeshttps://osint.ahsan-tariq-ai.xyz/api/v1/reports/categoriesGETList categoriesYeshttps://osint.ahsan-tariq-ai.xyz/api/v1/recon/{domain}GETDomain recon (DNS/WHOIS/IP)Yeshttps://osint.ahsan-tariq-ai.xyz/api/v1/social/{username}GETSocial media profilesYeshttps://osint.ahsan-tariq-ai.xyz/api/v1/breach/{email}GETBreach database checkYes

Security & Privacy#

• API key required — all endpoints require OSINT_API_KEY environment variable
• Single external host — all requests go to osint.ahsan-tariq-ai.xyz only
• No local file access — the helper script reads no local files
• No data persistence — responses are returned and not saved locally
• HTTPS only — all traffic encrypted via TLS
• Helper script — scripts/osint_api.py is a thin Python wrapper that calls the API. It uses urllib.request (stdlib only), makes no shell calls, and performs no local I/O.

Required Environment#

bash

export OSINT_API_KEY="your_api_key_here"

Sign up for an API key at https://osint.ahsan-tariq-ai.xyz

Tools#

get_reports#

Get enriched intelligence briefings across 15 categories.

Endpoint: GET /reports/enriched

Parameters:

ParamTypeRequiredDefaultDescriptioncategorystringNoallFilter by category name

Usage:

bash

python3 scripts/osint_api.py reports
python3 scripts/osint_api.py reports --category geopolitics

Or via curl (with API key):

bash

curl -H "Authorization: Bearer $OSINT_API_KEY" \
  "https://osint.ahsan-tariq-ai.xyz/api/v1/reports/enriched"

Response:

json

{
  "status": "success",
  "date": "2026-04-06",
  "reports": [
    {
      "category": "geopolitics",
      "enriched": true,
      "confidence": 0.82,
      "article_count": 47,
      "briefing": "Escalating tensions in Eastern Europe..."
    }
  ],
  "total_categories": 15
}

get_categories#

List all available report categories with metadata.

Endpoint: GET /reports/categories

Usage:

bash

python3 scripts/osint_api.py categories

domain_recon#

Get DNS, WHOIS, and IP intelligence for any domain.

Endpoint: GET /recon/{domain}

Parameters:

ParamTypeRequiredDescriptiondomainstringYesDomain to investigate

Usage:

bash

python3 scripts/osint_api.py recon --domain google.com

social_lookup#

Find social media profiles for a username.

Endpoint: GET /social/{username}

Usage:

bash

python3 scripts/osint_api.py social --username username

breach_check#

Check if an email appears in known breach databases.

Endpoint: GET /breach/{email}

Usage:

bash

python3 scripts/osint_api.py breach --email user@example.com

Categories#

The engine collects from multiple RSS feeds across 15 categories:

CategoryFocuscybersecurityThreats, CVEs, vendor advisoriestech_aiAI/ML news, product launches, researchgeopoliticsWorld news, conflict, diplomacyfinanceMarkets, crypto, economicshealthcarePharma, biotech, medical researchlegal_regtechLaw, compliance, regulatory focusmarketing_adtechMarketing industry, ad techsupply_chainLogistics, freight, supply chainclimate_sustainabilityClimate change, ESG, green techreal_estate_proptechProperty, PropTecheducation_edtechEducation technologyenergy_utilitiesPower, energy, utilitiesagriculture_foodtechAgriculture, food techentertainment_mediaGaming, streaming, medialabor_workforceLabor market, workplace intelligence

Helper Script#

scripts/osint_api.py is a thin Python wrapper (stdlib only, no dependencies) that calls the OSINT API. It:

• Makes HTTPS requests to osint.ahsan-tariq-ai.xyz only
• Requires OSINT_API_KEY environment variable
• Reads no local files, writes no local files
• Executes no shell commands
• Sanitizes all input via urllib.parse.quote

Pricing#

TierPriceRequests/DayFeaturesFree$0/mo50Market Intelligence (15 categories), Domain ReconPro10 USDC/mo1,000Everything in Free + Social Lookup (10+ platforms), Breach CheckEnterprise50 USDC/mo10,000Everything in Pro + Dedicated Gateway, Enriched Briefings (LLM)

Notes#

• Reports are refreshed daily via cron — API responses are cached
• Confidence scores: 0.0-1.0 based on article count, source diversity, signal strength