OSINT

نسخه 2

OSINT

با یک کلید API، همان فهرست کشورها و نام‌هایی را که در سایت می‌بینید به‌صورت JSON دریافت کنید. این API هم مثل خود سایت نمایشی است: همهٔ مقادیر تصادفی و ساختگی‌اند و فقط ۱۰۰ ردیف اول هر فهرست مقدار دارد.

پلن‌های API

Sandbox

رایگان

۱٬۰۰۰ درخواست در روز
۶۰ درخواست در دقیقه
حداکثر ۵۰ ردیف در هر صفحه
نام، نام خانوادگی و ملیت
فیلدهای قفل‌شده

…

Live

قیمت نمایشی ماهانه

سهمیه روزانه بالاتر
حداکثر ۱۰۰ ردیف در هر صفحه
پشتیبانی اولویت‌دار
فیلدهای قفل‌شده (فقط در طراحی)

برای خرید وارد شوید

احراز هویت و آدرس پایه

همه درخواست‌ها به این آدرس فرستاده می‌شوند:

http://localhost:8000/v1

کلید را در هدر زیر بفرستید: X-API-Key. Authorization: Bearer هم پذیرفته می‌شود.

X-API-Key: YOUR_API_KEY

کلید را فقط در سمت سرور نگه دارید و در کد سمت مرورگر یا مخزن عمومی قرار ندهید.

مسیرها

GET/v1/schema

دسته‌ها و عنوان فیلدهای قفل‌شده، برای ساختن ستون‌های جدول در سمت خودتان.

GET/v1/countries

فهرست همه کشورها با جمعیت تقریبی و اینکه فایل نام دارند یا نه.

GET/v1/countries/{code}

جزئیات یک کشور: ملیت‌ها و تعداد ردیف قابل نمایش هر ملیت.

پارامتر	توضیح
`code`	کد دوحرفی ISO کشور، مثل DE

GET/v1/countries/{code}/people

فهرست صفحه‌بندی‌شده نام‌ها (حداکثر ۱ میلیون ردیف). ۱۰۰ ردیف اول هر فهرست در fields مقدار نمونهٔ تصادفی دارد؛ بقیه locked=true و fields=null است.

پارامتر	توضیح
`nationality`	اختیاری؛ کلید ملیت مثل german. پیش‌فرض: بزرگ‌ترین ملیت کشور
`page`	شماره صفحه، از ۱
`page_size`	تعداد ردیف؛ حداکثر ۵۰ در Sandbox

GET/v1/countries/{code}/people/{rank}/search-history

پارامتر	توضیح
`rank`	شمارهٔ ردیف فرد
`nationality`	کلید ملیت (اختیاری)

GET/v1/usage

مصرف امروز و سهمیه باقی‌مانده کلید.

نمونه درخواست

curl "http://localhost:8000/v1/countries/DE/people?page=1&page_size=20" \
  -H "X-API-Key: YOUR_API_KEY"

نمونه پاسخ

{
  "country": "DE",
  "nationality": "german",
  "source": "names",
  "page": 1,
  "page_size": 20,
  "total": 1000000,
  "pages": 50000,
  "preview_rows": 100,
  "items": [
    {
      "rank": 1,
      "first_name": "Lukas",
      "last_name": "Müller",
      "nationality": "آلمانی",
      "preview": true,
      "fields": {
        "identity.1": "1990-04-12",
        "contact.0": "+49 155 0100123",
        "location.2": "Berlin",
        "medical.0": "A+"
      }
    },
    {
      "rank": 250,
      "first_name": "Mia",
      "last_name": "Schäfer",
      "nationality": "آلمانی",
      "preview": false,
      "fields": {}
    }
  ]
}

مستندات تعاملی (Swagger) هم در دسترس است: http://localhost:8000/docs

فهرست کامل فیلدها

کلید هر فیلد در آبجکت fields ثابت است (مثل identity.1) و با تغییر عنوان در پنل مدیریت عوض نمی‌شود. در پلن رایگان فقط ۱۰۰ ردیف اول این مقادیر را دارند و همه ساختگی‌اند.

هویتی (identity)

identity.0 father name
identity.1 birth date
identity.2 birth place
identity.3 gender
identity.4 ethnicity
identity.5 mother tongue
identity.6 marital status
identity.7 national id
identity.8 birth-cert no.
identity.9 passport no.
identity.10 licence no.

تماس (contact)

contact.0..2 mobile 1–3
contact.3 landline
contact.4..6 email 1–3
contact.7 telegram
contact.8 whatsapp
contact.9 instagram
contact.10 other socials

مکانی (location)

location.0 country
location.1 province
location.2 city
location.3 district
location.4 full address
location.5 postal code
location.6 geo point

دیجیتال (digital)

digital.0..2 IP 1–3
digital.3 MAC
digital.4 device model
digital.5 OS
digital.6 browser
digital.7 device id
digital.8 cookies
digital.9 browsing history

مالی (financial)

financial.0 income chart
financial.1 job & employer
financial.2 account no.
financial.3 card no.
financial.4 IBAN
financial.5 tx history
financial.6 net worth

تحصیلی (education)

education.0 degree
education.1 field
education.2 university
education.3 grad year
education.4 experience
education.5 resume
education.6 skills

پزشکی (medical)

medical.0 blood type
medical.1 conditions

رفتاری (behavioral)

behavioral.0 interests
behavioral.1 purchases
behavioral.2 searches
behavioral.3 online hours

خطاها و محدودیت‌ها

خطاها با کد وضعیت HTTP و بدنهٔ {"detail": {"code": "...", "message": "..."}} برمی‌گردند. هر پاسخ موفق هدرهای X-RateLimit-Limit و X-RateLimit-Remaining دارد.

وضعیت	کد	معنی
401	`missing_api_key`	کلید ارسال نشده است.
401	`invalid_api_key`	کلید نامعتبر است.
403	`revoked_api_key`	کلید باطل شده است.
404	`—`	کشور یا ملیت پیدا نشد.
429	`rate_limited`	بیش از ۶۰ درخواست در دقیقه. هدر Retry-After زمان انتظار را می‌گوید.
429	`daily_quota_exceeded`	سهمیه روزانه تمام شده است.

این API بخشی از یک پروژهٔ نمایشی است؛ کلید Live قابل خرید نیست و هیچ پرداختی انجام نمی‌شود.