v10

latestOpenAPI 3.1.02026-08-0452108384.4 KB

Saved Searches

Create Saved Search

post/v0/saved_searches

Request body

namestring nullable

Name of the saved search

type'companies' | 'jobs' required

is_alert_activeboolean

Is the alert active

Example request

{
  "body": {
    "company_name_or": [],
    "company_name_case_insensitive_or": [],
    "company_id_or": [],
    "company_id_not": [],
    "company_domain_or": [],
    "company_domain_not": [],
    "company_name_not": [],
    "company_name_partial_match_or": [],
    "company_name_partial_match_not": [],
    "company_linkedin_url_or": [],
    "property_exists_or": [],
    "property_exists_and": [],
    "limit": 25,
    "job_filters": {
      "job_title_or": [],
      "job_title_not": [],
      "job_title_pattern_and": [],
      "job_title_pattern_or": [],
      "job_title_pattern_not": [],
      "job_country_code_or": [],
      "job_country_code_not": [],
      "job_description_pattern_or": [],
      "job_description_pattern_not": [],
      "job_description_pattern_and": [],
      "job_description_contains_or": [],
      "job_description_contains_not": [],
      "job_description_pattern_case_sensitive_or": [],
      "job_id_or": [],
      "job_id_not": [],
      "job_seniority_or": [],
      "job_location_pattern_or": [],
      "job_location_pattern_not": [],
      "job_location_or": [],
      "job_location_not": [],
      "url_domain_or": [],
      "url_domain_not": [],
      "employment_statuses_or": [],
      "property_exists_or": [],
      "property_exists_and": []
    }
  }
}

Response

Successful Response

idinteger required

ID of the saved search

namestring required

Name of the saved search

type'companies' | 'jobs' required

is_alert_activeboolean

Is the alert active

user_idinteger required

Owner of the saved search

team_idinteger required

Team of the saved search

created_atstring date-time required

Date and time when the saved search was created

updated_atstring date-time required

Date and time when the saved search was last updated

querystring nullable

Query of the request

pathstring nullable

Path of the request

querystring_paramsobject nullable

Dictionary containing the querystring parameters of the request.

is_archivedboolean

Is the saved search archived

has_active_webhooksboolean

Has active webhooks

frequency'daily' | 'weekly'

emails_subscribedstring[] nullable

Emails subscribed to the saved search alerts.

Example response

{
  "body": {
    "company_name_or": [],
    "company_name_case_insensitive_or": [],
    "company_id_or": [],
    "company_id_not": [],
    "company_domain_or": [],
    "company_domain_not": [],
    "company_name_not": [],
    "company_name_partial_match_or": [],
    "company_name_partial_match_not": [],
    "company_linkedin_url_or": [],
    "property_exists_or": [],
    "property_exists_and": [],
    "limit": 25,
    "job_filters": {
      "job_title_or": [],
      "job_title_not": [],
      "job_title_pattern_and": [],
      "job_title_pattern_or": [],
      "job_title_pattern_not": [],
      "job_country_code_or": [],
      "job_country_code_not": [],
      "job_description_pattern_or": [],
      "job_description_pattern_not": [],
      "job_description_pattern_and": [],
      "job_description_contains_or": [],
      "job_description_contains_not": [],
      "job_description_pattern_case_sensitive_or": [],
      "job_id_or": [],
      "job_id_not": [],
      "job_seniority_or": [],
      "job_location_pattern_or": [],
      "job_location_pattern_not": [],
      "job_location_or": [],
      "job_location_not": [],
      "url_domain_or": [],
      "url_domain_not": [],
      "employment_statuses_or": [],
      "property_exists_or": [],
      "property_exists_and": []
    }
  }
}