> ## Documentation Index
> Fetch the complete documentation index at: https://newscatcherinc-docs.mintlify.site/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Enumerated parameters

> Allowed values for API parameters with a fixed set of options

## Language (`lang` and `not_lang`)

The `lang` and `not_lang` parameters accept two-letter ISO 639-1 language codes.

### Commonly used language codes

| Code | Language         |
| ---- | ---------------- |
| ar   | Arabic           |
| cn   | Chinese (China)  |
| de   | German           |
| en   | English          |
| es   | Spanish          |
| fr   | French           |
| it   | Italian          |
| ja   | Japanese         |
| pt   | Portuguese       |
| tw   | Chinese (Taiwan) |
| uk   | Ukrainian        |

<Warning>
  We distinguish Chinese (China) and Chinese (Taiwan) languages, using `cn` and
  `tw`, respectively. This is the only difference between our codes and the ISO
  639-1 standard.
</Warning>

### Supported language codes

We support 123 languages:

```
af,am,an,ar,as,av,az,ba,be,bg,bh,bn,bo,br,bs,ca,ce,co,cs,cv,cy,da,de,dv,el,en,eo,es,et,eu,fa,fi,fr,fy,ga,gd,gl,gn,gu,gv,he,hi,hr,ht,hu,hy,ia,id,ie,io,is,it,ja,jv,ka,kk,km,kn,ko,ku,kv,kw,ky,la,lb,li,lo,lt,lv,mg,mk,ml,mn,mr,ms,mt,my,ne,nl,nn,no,oc,or,os,pa,pl,ps,pt,qu,rm,ro,ru,sa,sc,sd,sh,si,sk,sl,so,sq,sr,su,sv,sw,ta,te,tg,th,tk,tl,tr,tt,ug,uk,ur,uz,vi,vo,wa,yi,yo,cn,tw
```

For a description of supported language codes, see the
[ISO 639-1 code table](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes).

### Usage examples

GET requests:

* To search for articles in English: `lang=en`
* To search for articles in English and Spanish: `lang=en,es`
* To exclude articles in French: `not_lang=fr`

POST requests:

* To search for articles in English and Spanish:
  ```json theme={null}
  {
    "lang": ["en", "es"]
  }
  ```
* To exclude articles in French and German:
  ```json theme={null}
  {
    "not_lang": ["fr", "de"]
  }
  ```

## Country (`country` and `not_country`)

The `country` and `not_country` parameters accept two-letter ISO 3166-1 alpha-2
country codes.

### Commonly used country codes

| Code | Country        |
| ---- | -------------- |
| AU   | Australia      |
| BR   | Brazil         |
| CA   | Canada         |
| DE   | Germany        |
| FR   | France         |
| GB   | United Kingdom |
| IN   | India          |
| JP   | Japan          |
| UA   | Ukraine        |
| US   | United States  |

For a complete list of supported country codes, refer to the
[ISO 3166-1 alpha-2 code table](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2#Officially_assigned_code_elements).

### Usage examples

GET requests:

* To search for articles from the United States: `country=US`
* To search for articles from the United States and United Kingdom:
  `country=US,GB`
* To exclude articles from Canada: `not_country=CA`

POST requests:

* To search for articles from the United States and United Kingdom:
  ```json theme={null}
  {
    "country": ["US", "GB"]
  }
  ```
* To exclude articles from Canada and Australia:
  ```json theme={null}
  {
    "not_country": ["CA", "AU"]
  }
  ```

## News Type (`news_type`)

The `news_type` parameter filters results based on the type of news source. It
accepts one or more of the following values:

* Tech News and Updates
* Sports News and Blogs
* News and Blogs
* E-commerce and Product Information
* Educational News
* Press Releases
* Corporate News
* Gaming News and Blogs
* Entertainment and Media News
* Health and Medical News
* Government and Municipal News
* Real Estate News
* Automotive News and Blogs
* News Aggregators
* Fashion and Lifestyle
* Local News and Community Events
* Music and Radio
* Reviews
* Blogs and Magazines
* Political News
* Non-Profit and Organization News
* Event News
* General News Outlets
* Gambling News
* Travel and Lifestyle
* Finance and Investment
* Specific News Type
* Pure News Outlet
* Corporate News Section
* Other

### Usage examples

GET requests:

* To search for tech news: `news_type=Tech News and Updates`
* To search for both general news and tech news:
  `news_type=General News Outlets,Tech News and Updates`

POST requests:

* To search for tech news and sports news:
  ```json theme={null}
  {
    "news_type": ["Tech News and Updates", "Sports News and Blogs"]
  }
  ```