Listening Post API (0.0.1)

Download OpenAPI specification:

Listening Post, Inc.: support@listeningpost.ai License: Proprietary

API for Listening Post AI services, including leads, files and job tracking

jobs

Long running background jobs, such as report runs and exports

Job details

Get the status of a job, including results if completed. Poll until "done" or "error" status is returned. Job ID is provided by report/run and report/export endpoints.

Authorizations:
Authorization
query Parameters
id
string

Return job status, ID is provided by report/run and report/export endpoints

Responses

Response samples

Content type
application/json
{
  • "id": 0,
  • "status": "new",
  • "results": { }
}

file

File info

File details

Get file details and download URL for a file by ID

Authorizations:
Authorization
query Parameters
id
required
string

File ID of the file you want a download URL for

Responses

Response samples

Content type
application/json
{
  • "url": "string"
}

reports

Report tracking

Report list

Authorizations:
Authorization

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Report details

Authorizations:
Authorization
path Parameters
id
required
string

Report ID of the report you want to fetch details for

Responses

Response samples

Content type
application/json
{
  • "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  • "name": "string",
  • "settings": { },
  • "nodes": [
    ]
}

Report signals

Get signals for a report by ID, including how many of each signal were found in the report

Authorizations:
Authorization
path Parameters
id
required
string

Report ID of the report you want to fetch signals for

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Report stats

Get stats for a report by ID, including total, new, updated and unchanged entities

Authorizations:
Authorization
path Parameters
id
required
string

Report ID of the report you want to fetch stats for

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Report preview

Fetch first 10 leads of a report, good for confirming if the report is setup correctly.

Authorizations:
Authorization
path Parameters
id
required
string

Report ID of the report you want to preview entities for

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Report results

Fetch entities from the latest report run, search, sort and page through all results.

Authorizations:
Authorization
path Parameters
id
required
string

Report ID of the report you want to fetch entities for

query Parameters
offset
integer

Offset for pagination, default is 0

limit
integer

Limit for pagination, default is 10, max is 100

filter
object

Filter set for the entity results, stringified JSON array [{"field":"status","operator":"=","value":"new"}] would show all new results. Domain fields can be accessed as field with . splits (e.g. "addresses.state") Valid operators ('=','!=','<','>','<=','>=')

orderBy
object

Order set for the entity results, stringified JSON array [{"field":"status","direction":"DESC"}] Would sort by status string descending. Direction (ASC|DESC)

Responses

Response samples

Content type
application/json
[
  • {
    }
]

traits

Traits describe an entity in terms of characteristics or intents

Search traits

Fetch traits by entity type and query string. Traits describe an entity in terms of characteristics or intents.

Authorizations:
Authorization
query Parameters
entity_type
required
string

Entity type, either "person" or "business"

qry
required
string

Natural language query string to search for matching traits

domains
Array of strings

List of domains to search traits by ("intent", "demographics", etc.)

Responses

Response samples

Content type
application/json
[
  • {
    }
]

leads

Direct access to leads calls

Fetch leads

Various tools are available for finding and enriching leads, see the request body for details

Authorizations:
Authorization
Request Body schema: application/json
required
tool
required
string
email
string

Email of the entity to enrich

phone
string

Phone number of the entity to enrich

Responses

Request samples

Content type
application/json
Example
{
  • "tool": "entity_enrich",
  • "email": "string",
  • "phone": "string"
}

Response samples

Content type
application/json
[
  • {
    }
]