9fin News & Content API - v2

Get Headlines

Get news headlines, excluding any private items.

get
https://api.9fin.com/v2/news/headlines

Query Parameters

cursorAny Of

Opaque pagination cursor from a previous response’s next_cursor; omit for the first page.

Example: MjAyNi0wNy0xN1QwMTozNTozNC40ODo0MWY0OThhNy1jOTliLTQ5NmItOGViMi1lNzIzYjdlZDUzYTM=

Default:null

Variant 1string
limitinteger

Maximum number of headlines to return per page. It is possible to receive fewer than the requested number of items.

Default:50

>= 1<= 200

Example:50, 100, 200

content_tags__inAny Of

Comma-separated list of content tags to OR-filter on (maximum 5). Example: 9fin-All, 9fin-Primary

Show example of valid content tags
  • 9fin-9Questions
  • 9fin-ABS
  • 9fin-All
  • 9fin-Announcement
  • 9fin-Asset Based Finance
  • 9fin-Bankruptcy QuickTake
  • 9fin-Blessed to be Stressed
  • 9fin-Bond Legal QuickTake
  • 9fin-CLO
  • 9fin-CLO Primary
  • 9fin-Cloud 9fin
  • 9fin-Credit QuickTake
  • 9fin-Deal Predictions
  • 9fin-Deal Preview
  • 9fin-Distressed
  • 9fin-Distressed Pitch List
  • 9fin-Editorial
  • 9fin-Educational
  • 9fin-ESG
  • 9fin-ESG QuickTake
  • 9fin-Excess Spread
  • 9fin-Feature
  • 9fin-Frameworks
  • 9fin-Friday Workout
  • 9fin-Fundraising
  • 9fin-Investment Grade
  • 9fin-Legal Research
  • 9fin-Liability Management (LME)
  • 9fin-Loan Credit QuickTake
  • 9fin-Loan Legal QuickTake
  • 9fin-LP Wrap
  • 9fin-Morning Coffee
  • 9fin-Origination
  • 9fin-People Moves
  • 9fin-Primary
  • 9fin-Private Credit
  • 9fin-Restructuring QuickTake
  • 9fin-Secondary
  • 9fin-SRT
  • 9fin-Stressed QuickTake
  • 9fin-Sustainable Junk
  • 9fin-Taking the Credit
  • 9fin-The Default Notice
  • 9fin-Top of the Flops
  • 9fin-Trend Reports
  • 9fin-Under the hood
  • 9fin-Unicrunch
  • 9fin-Watching the Defectives
  • 9fin-Winding Up
  • 9fin-Wrap
  • ABF Deal Update
  • Calendar
  • CLO Deal Update
  • Deal
  • Deal Updates
  • ESG
  • Loan Radar News
  • New ABF Deal
  • New CLO Deal
  • News
  • Press Release
  • Ratings
  • Regulatory Filing
  • Results

Default:null

Variant 1string
source_typeAny Of

Filter by one of the following 9fin, third-party, all. Defaults to all if omitted.

9fin returns only 9fin-authored content, third-party returns content sourced from third parties, and all returns both.

Default:all

Variant 1string

Allowed values:9finthird-partyall

nf_ids__inAny Of

Comma-separated list of 9fin entity IDs to OR-filter on (maximum 10). An item is included if it references any of the supplied entitiy IDs.

Example: nf_ent_9be02202196b4567b40fcd412b14ccfe, nf_ent_300cf4bc9698484f880b4a678c8eccf5

Default:null

Variant 1string
entity_country_codeAny Of

Filter by the country code of the main entity, as a two-letter ISO 3166-1 alpha-2 code.

Show all accepted codes
  • AD — Andorra
  • AE — United Arab Emirates
  • AF — Afghanistan
  • AG — Antigua and Barbuda
  • AI — Anguilla
  • AL — Albania
  • AM — Armenia
  • AO — Angola
  • AQ — Antarctica
  • AR — Argentina
  • AS — American Samoa
  • AT — Austria
  • AU — Australia
  • AW — Aruba
  • AX — Åland Islands
  • AZ — Azerbaijan
  • BA — Bosnia and Herzegovina
  • BB — Barbados
  • BD — Bangladesh
  • BE — Belgium
  • BF — Burkina Faso
  • BG — Bulgaria
  • BH — Bahrain
  • BI — Burundi
  • BJ — Benin
  • BL — Saint Barthélemy
  • BM — Bermuda
  • BN — Brunei Darussalam
  • BO — Bolivia, Plurinational State of
  • BQ — Bonaire, Sint Eustatius and Saba
  • BR — Brazil
  • BS — Bahamas
  • BT — Bhutan
  • BV — Bouvet Island
  • BW — Botswana
  • BY — Belarus
  • BZ — Belize
  • CA — Canada
  • CC — Cocos (Keeling) Islands
  • CD — Congo, The Democratic Republic of the
  • CF — Central African Republic
  • CG — Congo
  • CH — Switzerland
  • CI — Côte d’Ivoire
  • CK — Cook Islands
  • CL — Chile
  • CM — Cameroon
  • CN — China
  • CO — Colombia
  • CR — Costa Rica
  • CU — Cuba
  • CV — Cabo Verde
  • CW — Curaçao
  • CX — Christmas Island
  • CY — Cyprus
  • CZ — Czechia
  • DE — Germany
  • DJ — Djibouti
  • DK — Denmark
  • DM — Dominica
  • DO — Dominican Republic
  • DZ — Algeria
  • EC — Ecuador
  • EE — Estonia
  • EG — Egypt
  • EH — Western Sahara
  • ER — Eritrea
  • ES — Spain
  • ET — Ethiopia
  • FI — Finland
  • FJ — Fiji
  • FK — Falkland Islands (Malvinas)
  • FM — Micronesia, Federated States of
  • FO — Faroe Islands
  • FR — France
  • GA — Gabon
  • GB — United Kingdom
  • GD — Grenada
  • GE — Georgia
  • GF — French Guiana
  • GG — Guernsey
  • GH — Ghana
  • GI — Gibraltar
  • GL — Greenland
  • GM — Gambia
  • GN — Guinea
  • GP — Guadeloupe
  • GQ — Equatorial Guinea
  • GR — Greece
  • GS — South Georgia and the South Sandwich Islands
  • GT — Guatemala
  • GU — Guam
  • GW — Guinea-Bissau
  • GY — Guyana
  • HK — Hong Kong
  • HM — Heard Island and McDonald Islands
  • HN — Honduras
  • HR — Croatia
  • HT — Haiti
  • HU — Hungary
  • ID — Indonesia
  • IE — Ireland
  • IL — Israel
  • IM — Isle of Man
  • IN — India
  • IO — British Indian Ocean Territory
  • IQ — Iraq
  • IR — Iran, Islamic Republic of
  • IS — Iceland
  • IT — Italy
  • JE — Jersey
  • JM — Jamaica
  • JO — Jordan
  • JP — Japan
  • KE — Kenya
  • KG — Kyrgyzstan
  • KH — Cambodia
  • KI — Kiribati
  • KM — Comoros
  • KN — Saint Kitts and Nevis
  • KP — Korea, Democratic People’s Republic of
  • KR — Korea, Republic of
  • KW — Kuwait
  • KY — Cayman Islands
  • KZ — Kazakhstan
  • LA — Lao People’s Democratic Republic
  • LB — Lebanon
  • LC — Saint Lucia
  • LI — Liechtenstein
  • LK — Sri Lanka
  • LR — Liberia
  • LS — Lesotho
  • LT — Lithuania
  • LU — Luxembourg
  • LV — Latvia
  • LY — Libya
  • MA — Morocco
  • MC — Monaco
  • MD — Moldova, Republic of
  • ME — Montenegro
  • MF — Saint Martin (French part)
  • MG — Madagascar
  • MH — Marshall Islands
  • MK — North Macedonia
  • ML — Mali
  • MM — Myanmar
  • MN — Mongolia
  • MO — Macao
  • MP — Northern Mariana Islands
  • MQ — Martinique
  • MR — Mauritania
  • MS — Montserrat
  • MT — Malta
  • MU — Mauritius
  • MV — Maldives
  • MW — Malawi
  • MX — Mexico
  • MY — Malaysia
  • MZ — Mozambique
  • NA — Namibia
  • NC — New Caledonia
  • NE — Niger
  • NF — Norfolk Island
  • NG — Nigeria
  • NI — Nicaragua
  • NL — Netherlands
  • NO — Norway
  • NP — Nepal
  • NR — Nauru
  • NU — Niue
  • NZ — New Zealand
  • OM — Oman
  • PA — Panama
  • PE — Peru
  • PF — French Polynesia
  • PG — Papua New Guinea
  • PH — Philippines
  • PK — Pakistan
  • PL — Poland
  • PM — Saint Pierre and Miquelon
  • PN — Pitcairn
  • PR — Puerto Rico
  • PS — Palestine, State of
  • PT — Portugal
  • PW — Palau
  • PY — Paraguay
  • QA — Qatar
  • RE — Réunion
  • RO — Romania
  • RS — Serbia
  • RU — Russian Federation
  • RW — Rwanda
  • SA — Saudi Arabia
  • SB — Solomon Islands
  • SC — Seychelles
  • SD — Sudan
  • SE — Sweden
  • SG — Singapore
  • SH — Saint Helena, Ascension and Tristan da Cunha
  • SI — Slovenia
  • SJ — Svalbard and Jan Mayen
  • SK — Slovakia
  • SL — Sierra Leone
  • SM — San Marino
  • SN — Senegal
  • SO — Somalia
  • SR — Suriname
  • SS — South Sudan
  • ST — Sao Tome and Principe
  • SV — El Salvador
  • SX — Sint Maarten (Dutch part)
  • SY — Syrian Arab Republic
  • SZ — Eswatini
  • TC — Turks and Caicos Islands
  • TD — Chad
  • TF — French Southern Territories
  • TG — Togo
  • TH — Thailand
  • TJ — Tajikistan
  • TK — Tokelau
  • TL — Timor-Leste
  • TM — Turkmenistan
  • TN — Tunisia
  • TO — Tonga
  • TR — Türkiye
  • TT — Trinidad and Tobago
  • TV — Tuvalu
  • TW — Taiwan, Province of China
  • TZ — Tanzania, United Republic of
  • UA — Ukraine
  • UG — Uganda
  • UM — United States Minor Outlying Islands
  • US — United States
  • UY — Uruguay
  • UZ — Uzbekistan
  • VA — Holy See (Vatican City State)
  • VC — Saint Vincent and the Grenadines
  • VE — Venezuela, Bolivarian Republic of
  • VG — Virgin Islands, British
  • VI — Virgin Islands, U.S.
  • VN — Viet Nam
  • VU — Vanuatu
  • WF — Wallis and Futuna
  • WS — Samoa
  • YE — Yemen
  • YT — Mayotte
  • ZA — South Africa
  • ZM — Zambia
  • ZW — Zimbabwe

Default:null

Variant 1string

<= 2 characters

industries__inAny Of

Comma-separated list of industries to OR-filter on (maximum 5). An item is included if it references any of the supplied industries.

Example: Banks, Software & Services

Show all accepted industries
  • Aerospace / Defense
  • Alcoholic Beverage
  • Apparel
  • Automotive Manufacturer
  • Automotive Supplier
  • Banks
  • Chemical
  • Commercial & Professional Services
  • Communications Infrastructure
  • Construction and Engineering
  • Construction Materials
  • Consumer Durables
  • Consumer Services
  • Diversified Financials
  • Diversified Technology
  • Electric Utilities and Power
  • Energy, Oilfield Services
  • Energy, Oil & Gas
  • Environmental Services and Waste Management Cos.
  • Equipment Rental
  • Food Products
  • Gaming
  • Health Care Equipment & Services
  • Homebuilding And Property Development
  • Hotels, Resorts & Cruise Lines
  • Independent Power and Renewable Electricity Producers
  • Insurance
  • Manufacturing
  • Media Industry
  • Mining
  • Multi-Utilities and Power
  • Packaging
  • Paper and Forest Products
  • Pharmaceuticals, Biotechnology & Life Sciences
  • Protein and Agriculture
  • REITs and Other Commercial Property Firms
  • Restaurants
  • Retailing
  • Soft Beverage
  • Software & Services
  • Steel
  • Telecommunications
  • Transportation and Logistics
  • Water Utilities

Default:null

Variant 1string
regionAny Of

Filter by the coverage region (case-insensitive).

Default:null

Variant 1string

Allowed values:APACCEEMEALATAMNorth AmericaUSEuropeWestern Europe

sinceAny Of

Only return headlines published at or after this instant. ISO 8601 datetime; if a date-only value is supplied, it is interpreted as midnight UTC. If no timezone is provided, UTC is assumed.

Examples: 2026-01-01T00:00:00Z, 2026-01-01T15:35:45, 2026-01-01

Default:null

Variant 1string(date-time)
untilAny Of

Only return headlines published at or before this instant. ISO 8601 datetime; if a date-only value is supplied, it is interpreted as midnight UTC. If no timezone is provided, UTC is assumed. Must be strictly after since when both are supplied.

Examples: 2026-02-03T00:00:00Z, 2026-01-01T15:35:45, 2026-01-01

Default:null

Variant 1string(date-time)

Response

application/json

Successful Response

GetHeadlinesResponse

itemsarray[object]required
Show Child Parameters
next_cursorAny Of

Opaque cursor for fetching the next page. Pass it back unchanged as the cursor query parameter on the next request. null when this is the last page.

Example:MjAyNi0wMS0xNVQxNDozMjowMCswMDowMDozZmE4NWY2NC01NzE3LTQ1NjItYjNmYy0yYzk2M2Y2NmFmYTY=

Variant 1string
get/v2/news/headlines
 
application/json