OSINT

Open Source Intelligence gathering endpoints

Generate Personal OSINT Profile

POST

https://api.openpaws.ai

/v1/osint/personal-profile

Generate an Open Source Intelligence (OSINT) profile for an individual person. Aggregates publicly available information to create a comprehensive profile useful for advocacy outreach and due diligence.

Note: This endpoint is for personal profiles only. For company/organization OSINT, see the Investigate Company endpoint below.

Use Cases

Research decision-makers before outreach
Identify influencers and their positions on animal welfare
Prepare for meetings with legislators or executives
Due diligence for advocacy partnerships

Response Format

Returns streaming NDJSON. The workflow typically takes 5-10 minutes to complete.

Pricing

This endpoint costs $1.50 per request due to the computational resources required.

Generate Personal OSINT Profile › Headers

Authorization

string · required

The Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.

Generate Personal OSINT Profile › Request Body

firstName

string · minLength: 1 · maxLength: 100 · required

Person's first name

lastName

string · minLength: 1 · maxLength: 100 · required

Person's last name

companyName

string · maxLength: 200

Company or organization name (optional)

companyDomain

string · hostname

Company website domain (optional)

linkedinURL

string · uri · pattern: ^https?://(www\.)?li…

LinkedIn profile URL (optional)

reportGoal

string · maxLength: 500

Context for the report (optional)

Generate Personal OSINT Profile › Responses

Streaming NDJSON response with workflow progress and final report

oneOf

Exactly one variant must match.

Decision Table

Variant	Matching Criteria
	type = object · requires: type, metadata
	type = object · requires: type, content, metadata
	type = object · requires: type, metadata
	type = object · requires: type, metadata

Properties for Variant 1:

Marks the start of a workflow step

type

string · enum · required

Event type indicating step start

Enum values:

begin

object · required

Metadata attached to each streaming event

POST/v1/osint/personal-profile

curl --request POST \
  --url https://api.openpaws.ai/v1/osint/personal-profile \
  --header 'Authorization: <string>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "firstName": "John",
  "lastName": "Smith"
}
'

shell

Example Request Body

{
  "firstName": "John",
  "lastName": "Smith"
}

json

application/json

Example Responses

{
  "type": "begin",
  "metadata": {
    "nodeId": "3946d703-459c-4075-b507-6bccacb0cbad",
    "nodeName": "Step 1: Discovery",
    "itemIndex": 0,
    "runIndex": 0,
    "timestamp": 1768665539504
  }
}

json

application/x-ndjson

Investigate Company

POST

https://api.openpaws.ai

/v1/osint/company-profile

Start a comprehensive OSINT investigation on a company. Returns an immediate confirmation with a task ID. The full investigation report is delivered asynchronously via email (typically 45-60 minutes).

Research Areas

Animal welfare practices and violations
Corporate structure and beneficial ownership
Regulatory compliance and enforcement history
Public controversies and media coverage
Commitment gaps and greenwashing

Pricing

$1.50 per request (Pay As You Go plan).

Note

This is an async endpoint. You will receive an immediate taskId confirmation. The full report is delivered to the email associated with your account.

Investigate Company › Headers

Authorization

string · required

The Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.

Investigate Company › Request Body

companyName

string · minLength: 1 · maxLength: 200 · required

Company or organization name

website

string · uri · maxLength: 500

Company website URL

companyDomain

string · maxLength: 200

Company website domain (e.g., 'tysonfoods.com'). Improves accuracy of OSINT discovery.

researchFocus

string[]

Specific areas to focus the investigation on (e.g., ['animal welfare', 'supply chain'])

reportGoal

string · maxLength: 500

Additional context describing what the OSINT report should focus on (e.g., executives, risks, structure, financials)

Investigate Company › Responses

Task started confirmation

taskId

string · uuid

Unique identifier for the async task

message

string

Human-readable confirmation message

estimatedTime

string

Estimated time for completion

taskType

string

Type of task that was started

POST/v1/osint/company-profile

curl --request POST \
  --url https://api.openpaws.ai/v1/osint/company-profile \
  --header 'Authorization: <string>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "companyName": "Tyson Foods",
  "companyDomain": "tysonfoods.com"
}
'

shell

Example Request Body

{
  "companyName": "Tyson Foods",
  "companyDomain": "tysonfoods.com"
}

json

application/json

Example Responses

{
  "taskId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "message": "Company investigation started for Tyson Foods. Results will be delivered to your email.",
  "estimatedTime": "45-60 minutes",
  "taskType": "company_investigation"
}

json

application/json

Search Content

Generate Personal OSINT Profile

POST

https://api.openpaws.ai

/v1/osint/personal-profile

Note: This endpoint is for personal profiles only. For company/organization OSINT, see the Investigate Company endpoint below.

Use Cases

Research decision-makers before outreach
Identify influencers and their positions on animal welfare
Prepare for meetings with legislators or executives
Due diligence for advocacy partnerships

Response Format

Returns streaming NDJSON. The workflow typically takes 5-10 minutes to complete.

Pricing

This endpoint costs $1.50 per request due to the computational resources required.

Generate Personal OSINT Profile › Headers

Authorization

string · required

The Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.

Generate Personal OSINT Profile › Request Body

firstName

string · minLength: 1 · maxLength: 100 · required

Person's first name

lastName

string · minLength: 1 · maxLength: 100 · required

Person's last name

companyName

string · maxLength: 200

Company or organization name (optional)

companyDomain

string · hostname

Company website domain (optional)

linkedinURL

string · uri · pattern: ^https?://(www\.)?li…

LinkedIn profile URL (optional)

reportGoal

string · maxLength: 500

Context for the report (optional)

Generate Personal OSINT Profile › Responses

Streaming NDJSON response with workflow progress and final report

oneOf

Exactly one variant must match.

Decision Table

Variant	Matching Criteria
	type = object · requires: type, metadata
	type = object · requires: type, content, metadata
	type = object · requires: type, metadata
	type = object · requires: type, metadata

Properties for Variant 1:

Marks the start of a workflow step

type

string · enum · required

Event type indicating step start

Enum values:

begin

object · required

Metadata attached to each streaming event

Investigate Company

POST

https://api.openpaws.ai

/v1/osint/company-profile

Research Areas

Animal welfare practices and violations
Corporate structure and beneficial ownership
Regulatory compliance and enforcement history
Public controversies and media coverage
Commitment gaps and greenwashing

Pricing

$1.50 per request (Pay As You Go plan).

Note

This is an async endpoint. You will receive an immediate taskId confirmation. The full report is delivered to the email associated with your account.

Investigate Company › Headers

Authorization

string · required

The Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.

Investigate Company › Request Body

companyName

string · minLength: 1 · maxLength: 200 · required

Company or organization name

website

string · uri · maxLength: 500

Company website URL

companyDomain

string · maxLength: 200

Company website domain (e.g., 'tysonfoods.com'). Improves accuracy of OSINT discovery.

researchFocus

string[]

Specific areas to focus the investigation on (e.g., ['animal welfare', 'supply chain'])

reportGoal

string · maxLength: 500

Additional context describing what the OSINT report should focus on (e.g., executives, risks, structure, financials)

Investigate Company › Responses

Task started confirmation

taskId

string · uuid

Unique identifier for the async task

message

string

Human-readable confirmation message

estimatedTime

string

Estimated time for completion

taskType

string

Type of task that was started