​

research prtimes

orc research prtimes searches PR TIMES releases and follows categories or companies to retrieve release text, reactions and public materials. Start with map, then follow company and release IDs from search results.

Authenticate the CLI and select an accessible Workspace. Use --workspace to set the scope for this call.

Search published releases.

List releases for a discovered business categories ID. Find valid IDs through map.

One-based source page number. Prefer pagination.next_url for subsequent requests so filters are preserved.

Type: number. Optional.

Set true to include original source fields in each list item. false returns the smaller normalized summary. This query parameter is the literal string true or false.; enum: true|false

Type: string. Optional.

Child category id from the selected business category in map.business_categories. Omit it to request the parent category.

Type: string. Optional.

List releases for a discovered channels ID. Find valid IDs through map.

One-based source page number. Prefer pagination.next_url for subsequent requests so filters are preserved.

Type: number. Optional.

Set true to include original source fields in each list item. false returns the smaller normalized summary. This query parameter is the literal string true or false.; enum: true|false

Type: string. Optional.

Retrieve a public company profile using its company ID, rather than its name or URL.

List releases published by the selected company. Reuse the discovered company ID and keep it unchanged when continuing.

Number of company releases to skip. The upstream page size is fixed at 10. Use pagination.next_url instead of assuming the next offset.; (use "null" or "reset" to clear)

Type: number. Optional.

Set true to include original source fields in each list item. false returns the smaller normalized summary. This query parameter is the literal string true or false.; enum: true|false

Type: string. Optional.

Retrieve release text, reactions, classification and links to images and attachments using company and release IDs.

List releases for a discovered company categories ID. Find valid IDs through map.

One-based source page number. Prefer pagination.next_url for subsequent requests so filters are preserved.

Type: number. Optional.

Set true to include original source fields in each list item. false returns the smaller normalized summary. This query parameter is the literal string true or false.; enum: true|false

Type: string. Optional.

Discover popular PR TIMES keywords for release searches. Counts do not measure search demand.

Discover categories and release-list entry points. Use the returned IDs in category-specific list commands.

List releases for a discovered prefectures ID. Find valid IDs through map.

One-based source page number. Prefer pagination.next_url for subsequent requests so filters are preserved.

Type: number. Optional.

Set true to include original source fields in each list item. false returns the smaller normalized summary. This query parameter is the literal string true or false.; enum: true|false

Type: string. Optional.

Location relationship from map.location_types, such as headquarters or event venue. Applies only to prefecture collections. Omit it for no additional location-type filter.; (use "null" or "reset" to clear)

Type: number. Optional.

Read the current native ranking selected by --type. PR TIMES controls its window and update timing; this does not establish historical popularity.

Native PR TIMES ranking selector. PR TIMES controls each time window and ordering; names do not imply a fixed duration guaranteed by Orchestor.; enum: hot|now|daily|weekly|monthly

Type: string. Optional.

Set true to include original source fields in each list item. false returns the smaller normalized summary. This query parameter is the literal string true or false.; enum: true|false

Type: string. Optional.

List releases for a discovered release types ID. Find valid IDs through map.

One-based source page number. Prefer pagination.next_url for subsequent requests so filters are preserved.

Type: number. Optional.

Set true to include original source fields in each list item. false returns the smaller normalized summary. This query parameter is the literal string true or false.; enum: true|false

Type: string. Optional.

Retrieve newly published releases in source order. Use their company and release IDs to inspect details.

Set true to include original source fields in each list item. false returns the smaller normalized summary. This query parameter is the literal string true or false.; enum: true|false

Type: string. Optional.

Search PR TIMES using --q. Follow company and release IDs from the results to retrieve individual releases.

One-based source page number. Prefer pagination.next_url for subsequent requests so filters are preserved.

Type: number. Optional.

Set true to include original source fields in each list item. false returns the smaller normalized summary. This query parameter is the literal string true or false.; enum: true|false

Type: string. Optional.

Keyword or phrase passed to native PR TIMES search. Leading and trailing whitespace is removed. URL-encode the value.; max 200 chars

Type: string. Required.

Read the current weekly ranking.

Retrieve details for a discovered release.

List calls retrieve one source page. Follow the query values in pagination.next_url using the corresponding flags, keeping filters unchanged. Unknown continuation does not establish completeness. Automatic traversal with --page-all is unavailable.

With --json, the full API response is retained inside the CLI data envelope. Records are in data.data, continuation in data.pagination, and provenance in data.source. --raw removes the CLI envelope; --field data selects API data. Missing and null values do not mean zero.

Search discovers releases. For each release to compare, pass company.id and release_id to companies releases get; no enrichment flag is needed. Detail includes engagement.like_count with its own source.observed_at, release_type, keyword_links, linked business_categories, images with URLs, reference_url, materials_url, public attachments, and share_links.

Likes count PR TIMES actions, not unique people or Facebook reactions. The separate like-count request must succeed; failure is an error, never zero. facebook_like_count is numeric only when PR TIMES supplies it, otherwise null. Facebook, X and LINE share links are not reaction counts. Material and attachment URLs are links, not downloaded files or proof of reuse rights.

Ranking rows include one-based rank. Retain ranking_type and source.observed_at. A current window cannot establish historical popularity, and raw likes across releases of different ages are not directly comparable. Observed reactions do not establish why a release succeeded.

API keys require read scope. Provider credentials are managed by the server.

The following global options can be used with orc research prtimes:

For details and examples, see global options.