Frequently Asked
Questions
Everything about the API, the plans, and your account, in one place. If you don't find your answer here, contact us.
Getting started
https://gnews.io/api/v4/search?q=AI&lang=en&apikey=YOUR_API_KEY, and read the JSON response. To build requests without writing code, use the API Playground in your dashboard. Every parameter is described in the documentation. /api/v4/search) finds articles by keyword, with search operators, language and country filters, a date range, sorting, and pagination. The Top Headlines endpoint (/api/v4/top-headlines) returns the current top headlines of a category: general, world, nation, business, technology, entertainment, sports, science, or health. Plans and free trial
Billing and subscription
- Go to the Change Plan page from Plan & Billing.
- Pick the plan and the billing frequency.
- Check how the change is billed, then confirm.
The new limits will apply as soon as you confirm. A yearly plan can't go back to monthly billing. On the Free plan, pick a plan on the Compare Plans page and complete the checkout.
- Go to Plan & Billing.
- Click Cancel subscription.
- Choose a reason, then confirm.
You'll keep your plan until the end of your billing period. After that, your account will move to the Free plan. Until your billing period ends, Resume subscription on the same page undoes the cancellation, and so does changing your plan. If you cancel before the trial ends, you won't be charged.
News data and coverage
from and to parameters. The Free plan covers the last 30 days: older articles are left out, and the response says how many. See Article Availability in the documentation. content holds the full text of the article. On the Free plan, it's cut to 250 characters. On any plan, add truncate=content to get the shorter version. source object (name, home page URL, and, on the Search endpoint, country), so you can filter or group articles on your side. nullable, for example nullable=description,image. totalArticles counts every article that matched your request. The response holds one page of them. Raise max up to the limit of your plan (up to 100 on paid plans, 10 on the Free plan) and step through the pages with page. Pagination stops at 1,000 articles, so narrow the query or the date range to go further. Using the API
apikey query parameter or the X-Api-Key header. On a server, prefer the header, which keeps the API key out of URLs and server logs. A missing or malformed API key returns a 400 error. A well-formed API key that doesn't match any account returns a 401 error. See Authentication in the documentation. q takes at most 200 characters, with exact phrases, parentheses, and the AND, OR, and NOT operators. A space works as AND. OR has higher precedence than AND, so add parentheses when you mix them. URL-encode the query. On the Search endpoint, in sets the fields searched. See Query Syntax in the documentation. 400: The API key is missing or malformed, or theqparameter is missing, too long, or has a syntax error.401: The API key is well-formed but doesn't match any account.403: The account's email address isn't verified, or the daily quota is used up.404: The endpoint doesn't exist, or the request doesn't use GET.429: Too many requests per second: 10 on paid plans, 1 on the Free plan.500: An unexpected problem on our side.503: A temporary problem on our side.
Every message is listed in Error Handling, in the documentation.
403 error until the quota resets at 00:00 UTC. Unused requests don't carry over to the next day. Follow your usage on the dashboard, and upgrade when you need a higher daily quota. 429 error. Space out your requests, and retry after a short wait with exponential backoff. localhost, so browsers block requests from a deployed website. An API key in front-end code is visible to anyone, so on a public website, call the API from your backend. Libraries and integrations
pip install langchain-gnews gives LangChain and LangGraph agents two tools: news search with historical data since 2020, and top headlines by category and country. It uses your API key. See the LangChain page in the documentation. Account and support
- If you have a subscription, cancel it on Plan & Billing and wait until it ends.
- On the Account page, click Delete account.
- Type DELETE, then confirm.
Deleting your account is permanent. Once it's deleted, any request you send to the API will return a 401 error. Your account data will be erased, apart from the records the Privacy Policy lists, such as invoices.
Students and education
- Sign up for free.
- Fill in the application form with the email address of your GNews API account. An institutional email address makes the review faster.
- Describe your project or research, your institution, and your role.
We review each request by hand and email you to let you know whether it's approved or not.
Switching from another news API
totalArticles and an articles array where each article holds its text (title, description, content), its URL and image, its publication date and language, and its source. Most migrations swap the base URL, rename a few query parameters, and remap those fields. The documentation and the official SDKs cover the rest. Google News API
Didn't find your answer?
On the Contact page, you can send us a message or start a chat.
Contact us
Ready to build
with GNews API?
Get your API key and make your first request in minutes.