Skip to main content

Documentation Index

Fetch the complete documentation index at: https://newscatcherinc-docs.mintlify.dev/docs/llms.txt

Use this file to discover all available pages before exploring further.

News API translates and indexes non-English articles to English, so you can:
  • Search using English keywords even when the original content is in another language
  • Find named entities (people, organizations, locations) using English names across all languages
  • Retrieve English translations alongside original content in API responses
Translation fields are available for articles published from March 12, 2025, onward, and require an NLP plan or higher.

​
Before you begin

Make sure you have the following:
  • An active News API key with NLP plan or higher
  • The Newscatcher SDK installed, or cURL for quick testing

​
Search parameters

Use search_in to target translated fields in your query, and include_translation_fields to return translated content in responses.

​
search_in options for translations

Use the search_in parameter to include translated content in your search:
OptionDescription
title_translatedSearch only in translated titles
content_translatedSearch only in translated content
summary_translatedSearch only in translated summaries
title_content_translatedSearch in both translated titles and content
You can specify a maximum of two options in search_in. To search both original and translated content, combine them: 
"search_in": "title_content,title_content_translated"

​
Translation fields in responses

Set include_translation_fields: true to receive translated content in responses. The following fields appear in each article:
FieldDescription
title_translated_enEnglish translation of the article title
content_translated_enEnglish translation of the article content
nlp.translation_summaryBrief summary of the English translation
nlp.translation_ner_PERPerson entities extracted from the translation
nlp.translation_ner_ORGOrganization entities extracted from the translation
nlp.translation_ner_LOCLocation entities extracted from the translation
nlp.translation_ner_MISCMiscellaneous entities extracted from the translation
Original content NER fields (ner_PER, ner_ORG, ner_LOC, ner_MISC) and translation NER fields (translation_ner_*) are returned together when include_nlp_data is true.

​
Use cases

These examples show how to combine translation search with entity filters and country targeting to cover global news effectively.

​
Comprehensive multilingual coverage

Search original and translated content simultaneously for maximum global coverage. Omitting lang returns results across all languages. 
{
  "q": "\"climate change\" OR \"global warming\"",
  "search_in": "title_content,title_content_translated",
  "exclude_duplicates": true
}

​
Tracking international organizations across languages

Find articles about international organizations using standardized English entity names, regardless of how the organization is named in the source language. For example, "European Union" matches “Union européenne” in French and “Unión Europea” in Spanish. 
{
  "q": "policy OR regulation",
  "ORG_entity_name": "\"European Union\" OR \"European Commission\"",
  "search_in": "title_content,title_content_translated",
  "countries": ["FR", "DE", "IT", "ES", "NL"],
  "include_nlp_data": true,
  "include_translation_fields": true
}

​
Global trade policy monitoring

Combine multiple entity types with location filtering to monitor trade events across languages: 
{
  "q": "tariffs OR trade OR duties OR imports",
  "ORG_entity_name": "\"White House\" OR \"Commerce Department\"",
  "LOC_entity_name": "\"United States\" OR \"Washington\"",
  "search_in": "title_content,title_content_translated",
  "countries": ["FR", "DE", "IT", "ES", "CA", "MX", "BR", "IN"],
  "include_nlp_data": true,
  "include_translation_fields": true,
  "from_": "7d"
}

​
Best practices

  • Start with a basic keyword search in title_content,title_content_translated before adding entity filters and complex query logic.
  • Use official English names in quotes for organizations and locations, and combine with boolean operators for flexible matching.
  • Use the countries parameter to focus on specific regions rather than searching globally.
  • When translation accuracy is critical, verify important findings against the original-language content.

​
See also