Research

One-shot topic research endpoints

Research Topics

POST

https://api.openpaws.ai

/v1/research/topics

Run a one-shot research query on animal advocacy topics. Returns streamed NDJSON results from a general research workflow. Use this for immediate research — for ongoing monitoring, create a tracking subscription via POST /v1/tracking/subscriptions instead.

Pricing

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

Research Topics › 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.

Research Topics › Request Body

topics

string[]

Topic IDs to track

frequency

string · enum

How often to receive updates

Enum values:

daily

weekly

realtime

Default: weekly

customKeywords

string[]

Custom keywords to monitor

specificInterests

string · maxLength: 1000

Additional context about tracking interests

Research Topics › Responses

Tracking setup 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/research/topics

curl --request POST \
  --url https://api.openpaws.ai/v1/research/topics \
  --header 'Authorization: <string>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "topics": [
    "animal_welfare",
    "environment"
  ],
  "frequency": "weekly",
  "customKeywords": [
    "cage-free",
    "factory farming ban",
    "animal testing prohibition"
  ],
  "specificInterests": "Focus on US federal and state legislation affecting farmed animals"
}
'

shell

Example Request Body

{
  "topics": [
    "animal_welfare",
    "environment"
  ],
  "frequency": "weekly",
  "customKeywords": [
    "cage-free",
    "factory farming ban",
    "animal testing prohibition"
  ],
  "specificInterests": "Focus on US federal and state legislation affecting farmed animals"
}

json

application/json

Example Responses

{
  "taskId": "c3d4e5f6-a7b8-9012-cdef-123456789012",
  "message": "Issue tracking set up successfully. Updates will be delivered to your email weekly.",
  "estimatedTime": "First update within 24 hours",
  "taskType": "issue_tracking"
}

json

application/json

Legal Tracking

Research Topics

POST

https://api.openpaws.ai

/v1/research/topics

Pricing

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

Research Topics › 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.

Research Topics › Request Body

topics

string[]

Topic IDs to track

frequency

string · enum

How often to receive updates

Enum values:

daily

weekly

realtime

Default: weekly

customKeywords

string[]

Custom keywords to monitor

specificInterests

string · maxLength: 1000

Additional context about tracking interests

Research Topics › Responses

Tracking setup 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