News API Documentation

Collect data from different source of news sites and channels, the FCS delivering news data from worldwide in any sector and in different language.

API Request Credit Usage

Maximum 100 records return per request in any language, it will count 1 credit per request. If you set "force_update=1" then it will count 2 credit. If you set "spin=1" then it will count 5 credit.

    • Request count only when response code is {200} and return some record.
    • If API endpoints that return an error or empty responses are not count in request.
    • You can login in your dashboard to check your usage.
    • Credit refresh each month of your billing date.
Your Plan

You're not logged in.

Get Your API Key

Parameters

Parameters Details
access_key API_KEY
find

You needs to add some words to search news. The "find" parameter will search in news title, description and content. If words contain anywhere in news, it will return that news.

Default: none
Values: EUR/USD, trump, world war 3, Nasdaq Stocks... etc, any word

    • Surround keyword in quotes "your words" for exact match.

    • Must word appear in news then add +before words.
      e.g when i search (china cricket) then if any word exist in news it will return that news, but i need news that contain china+cricket {both words} then i will pass parameter like (+china +cricket) -> without brackets

    • Must not appear in news then add -before words.
      e.g Today is Trump birthday, i need all news about him, but not about his birthday, then parameter value (trump -birthday) -> without brackets

find_title

If you set your search keywords in "find_title" parameter then it will only search news that contain these words only in news Title.
Enter 1 parameter at a time (Find or Find_title), if "Find" exits in parameter then "find_title" will ignore


Note: Rules Same as "Find" parameter.

from (Optional)

When you access history news API and you are looking for any historical data from a specific date, you need to specify date between from/to date by using (from,to) parameter

Default: none
Format: YYYY-MM-DD E.g: 2018-01-01
OR: YYYY-MM-DDTHour:Min E.g: 2018-01-01T12:30

to (Optional)

When you access news history API, It is required with "From" Parameter

Default: none
Format: YYYY-MM-DD E.g: 2018-01-01
OR: YYYY-MM-DDTHour:Min E.g: 2018-01-01T12:30


Note: When you not set FROM and TO parameters, then it will return latest 100 News.

language (Optional)

You can set language parameter, so API only return all news in your specfied language.

Default: en
Valid Values: ar {Arabic}, de {German}, en {English}, es {Spanish}, fr {French}, it {italian}, nl {Dutch}, pt {Portuguese}, ru {Russian} OR all {all languages}

sortby (Optional) Return news by sort

Default: latest
Valid Values: latest, popular, match

latest: return latest news by date.
popular: return famous news first based on source.
match: return most match words in news first.

force_update (Optional)

We update all news on each keywords after every 4 hours, but if you need latest news every time, then you can set "force_update=1" in parameters, but it will charge 1 extra credit in request count.

Default: 0
Valid Values: 0, 1

spin (Optional)

You can spin news title and description to new sentence, to get unique text.
e.g: Title : "I like when you talk with me", Spin Title: "i really like when you speak with me"


Default: 0
Valid Values: 0, 1

Note: When you set spin parameter then "force_update" parameter is not required, it will always give you latest news, Spin count 3 credit per request.

output (Optional)

Set your API response format.

Default: json
Valid Values: json, jsonp, object, xml, serialize and array

News List

Latest:

Return all Latest news by date that contain words "EUR/USD".

https://fcsapi.com/api-v3/news/news?find=EUR/USD&access_key=API_KEY
Popular:

Return all popular news first by source popularity that contain words "investment" (استثمارin Arabic) search all news in arabic language.

https://fcsapi.com/api-v3/news/news?find=استثمار&sortby=popular&language=ar&access_key=API_KEY
Most Match:

Return most matched words first, and search in News title only.

https://fcsapi.com/api-v3/news/news?find_title=america stock&sortby=match&access_key=API_KEY
From Specific Date:

Return all news sort by date ASC that contain words "America Market".

https://fcsapi.com/api-v3/news/news?find=America Market&from=2025-03-23T16:14:22&to=2025-03-24T16:14:22&access_key=API_KEY
Response Attributes:

After you request on API, It would give you the response in JSON format which you can change, it is up to your need. Moreover, We have characterized our FCS API response in the form of different index keys (id, name, symbol, and decimals) concerning the different popular currencies which you can use according to your requirements.

status: boolean

The status of this request's response.

code: integer

The code of this request's response.

msg: string

The massage of this request's response.

response: array

Access all data related to news through this API.

info: array
server_time: string

A result of server time.

credit_count: integer

Total credit count API.

Response Object
{
  "status": true,
  "code": 200,
  "msg": "Successfully",
  "response": [
    {
      "source": "https:\/\/biztoc.com\/x\/be2baf85ec99d21d",
      "author": "barrons.com",
      "title": "Prospect of Higher-For-Longer...",
      "description": "The U.S. dollar firmed across..."
      "publishedAt": "2024-04-30T09:42:04Z",
      "content": "The U.S. dollar firmed across...",
      "image": "https:\/\/c.biztoc.com\/p\/be2baf85ec99d21d\/s.webp",
      "site": "Biztoc.com"
    }
  ],
  "info": {
      "server_time": "2023-09-06 21:53:51 UTC",
      "credit_count": 1
  }
}