API docs

Sending a key

curl -H "Authorization: Bearer YOUR_API_KEY" "https://pressreleasefeed.org/api/v1/releases?per_page=10"

• A key that fails is an error. A wrong key returns 401 and a revoked key 403, never a silent fallback to the public answer.
• Keys stay out of URLs. On the JSON endpoints a ?key= parameter returns 400: send the header instead, so the key stays out of URLs and logs.
• A feed URL with a key is a secret. Treat any feed URL that contains ?key= as one.

The fields

• company is the issuing company: a newsroom’s own name, or the company a wire release names as its issuer. That is its SOURCE line on PR Newswire, Canada Newswire, ACN and JCN, its “Source:” line on Newsfile, its header on GlobeNewswire, or the name right after the Business Wire tag. It is null when no issuer was detected, never the wire’s name.
• companies lists the directory companies the release is linked to, as { "slug", "name" }, and is empty when there are none. The release’s first link comes first, the rest by name. It is not the companies=largest parameter, and it is not company, the issuer named in the release.
  • A release is linked to a company when the company’s name is in its headline, a contact-block email address or website at the bottom of the release uses the company’s domain, the wire’s own source field names the company, or it comes from the company’s own newsroom.
  • Notices from law firms about a company (a class action, an investigation, a lawsuit) are never linked to it. A release is one when its lead or its headline uses a class-action notice’s phrases, or when its headline is about investors, securities, a lawsuit or an investigation and it comes from a law firm (the wire’s source line) or names a plaintiff firm.
• url and image_url are null when the source gave anything other than an http(s) link.

Clean text

Titles, summaries and bodies come without newswire tags and wire boilerplate; url still links to the original release. This is what comes out:

• Tags. /PRNewswire/ (also with a suffix, such as /PRNewswire-FirstCall/) and /CNW/, (GLOBE NEWSWIRE), ( BUSINESS WIRE ), (ACN Newswire) (also (JCN Newswire) and (亞太商訊)), (ACCESSWIRE), and ACCESS Newswire’s tag between a dateline’s city and date: WEST PALM BEACH, FL / ACCESS Newswire / September 29, 2026 becomes WEST PALM BEACH, FL / September 29, 2026.
  • From a Newsfile dateline only Newsfile Corp. - inside the parentheses goes, and the date stays: (Newsfile Corp. - October 12, 2026) becomes (October 12, 2026).
• Boilerplate lines. PR Newswire’s “View original content…” link and its “Photo - …” and “Logo - …” links to mma.prnewswire.com; the “This is a paid press release. Contact the press release distributor directly with any inquiries.” notice; Newsfile’s “To view the source version of this press release, please visit …” link and its “Ready to Announce with Confidence? … Contact Us” promotion; and the ACN copyright line, Copyright <year> ACN Newswire. All rights reserved. www.acnnewswire.com (also in its JCN Newswire and 亞太商訊 forms).
• What stays. Other wire text stays as published: Business Wire’s “View source version on businesswire.com: …” link, GlobeNewswire’s photo lines, and a wire’s name in running text or in a URL.

Keyword search

• A search with q reports meta.total as null: counting the matches would mean scanning the whole archive. Paging still works.
• A keyword search that takes more than a few seconds (typically a rare word across the whole archive) returns 400. Narrow it with since, publisher, topic or language.

Which releases link to a company

• A release links to a company when its headline names the company, its contact block carries one of the company’s email or web domains, or the wire’s source line names it as the issuer.
• A name that is an everyday word (Target, Shell) counts in a headline only beside the full name or another signal.
• A law firm’s notice about a company (a class action, an investigation, a lawsuit) does not link it, though its headline names the company.

Where the directory comes from

The directory is compiled from SEC filings, Wikidata (CC0), stock-index membership and the S&P 500 constituents; it uses no Fortune or CompaniesMarketCap data. The service stores company names only: no list’s rank, order or revenue figure.

Countries and niches

• A company’s country is where it is run from: Medtronic, Eaton and Chubb are US companies, and Hong Kong is its own country.
• A company has one to three niches.

Which countries are where

• North America is the US, Canada and Bermuda (with Greenland and Saint Pierre and Miquelon).
• Latin America is Mexico, Central and South America and the Caribbean.
• The Middle East is the Gulf states, Iran, Iraq, Israel, Jordan and Lebanon (with Palestine, Syria and Yemen).
• Turkey, Russia and the Caucasus count as Europe, and Egypt counts as Africa.

What each item carries

• <dc:creator> is the issuing company (a newsroom’s own name for company newsrooms). A wire release without a detected issuer has no <dc:creator>.
• Each linked company gets one <category>, holding the company’s name, after the topic categories.
• companies=largest and the company filters work here too, with the same-company rule.
• Errors on /feed.xml, such as an invalid parameter, come back as JSON, like the rest of the API.