[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"api-page:neper-news-api":3},{"status":4,"api":5,"seo":207},"success",{"blocked":6,"description":7,"about":8,"stats":9,"name":11,"title":12,"slug":13,"logo":14,"created_at":15,"agent":16,"user":28,"endpoint_groups":31,"faqs":126,"features":154,"periodic_plans":155,"payasyougo_plans":206},false,"Query current news by country and optional section. GET or POST. Returns headlines, articles, and summaries.","# News by Country and Section\n\nThis API returns current news documents by country code and optional section. One call can return a single section or every section for that country.\n\n## Authentication\n\nSubscribe on the pricing page, then send your JoJ API key on every request:\n\nX-JoJAPI-Key: YOUR_API_KEY\n\nAuthorization: Bearer YOUR_API_KEY also works. Do not put the key in the URL or JSON body. The gateway validates the key before the request reaches this API.\n\n## Parameters\n\ncountry (required): en, ko, au, nz, it, ja, gb, fr, de, in.\n\nsection (optional): omit it to receive all sections for that country.\n\nCommon sections: top, BUSINESS, ENTERTAINMENT, SPORTS, WORLD, HEALTH.\n\nit, ko, ja, fr, de use SCITECH.\nen, au, nz, gb, in use SCIENCE and TECHNOLOGY.\n\nTOP is treated as top. Multiple sections on GET: BUSINESS,SPORTS. On POST you may send a JSON array.\n\n## Calling the API\n\nGET example:\n\nGET /queryNews?country=ko&section=top\n\nPOST body example:\n\n{\"country\":\"en\",\"section\":[\"top\",\"BUSINESS\"]}\n\nInvalid country or section returns HTTP 400 with errorCode INVALID_REQUEST and the allowed values in message.\n\n## Response\n\nSuccess (HTTP 200):\n\n```json\n{\n  \"status\": \"success\",\n  \"message\": \"Request successful\",\n  \"data\": {\n    \"country\": \"ko\",\n    \"sections\": [\"top\"],\n    \"count\": 1,\n    \"items\": [\n      {\n        \"docId\": \"kotop\",\n        \"code\": \"ko\",\n        \"id\": \"top\",\n        \"updatedAt\": 1757116800000,\n        \"news\": [\n          {\n            \"title\": { \"_text\": \"Headline\" },\n            \"link\": { \"_text\": \"https://example.com/article\" },\n            \"url\": \"https://example.com/article\",\n            \"img\": \"https://example.com/image.jpg\",\n            \"content\": \"Article body\",\n            \"summary\": \"One-sentence summary\",\n            \"section\": \"top\"\n          }\n        ]\n      }\n    ]\n  }\n}",{"score":10},"2.39","Neper News","Neper News API","neper-news-api","https://cdn.jojapi.com/api/a0aae4d1-74fe-450b-995c-628d15e9ebe3","2026-09-06 00:18:29",{"enabled":17,"closed":18,"request_enabled":17,"catalog_url":19,"discovery_url":20,"directory_url":21,"rails":22,"networks":25,"docs":27},true,null,"https://neper-news-api.jojapi.net/_jojapi/agent/plans","https://neper-news-api.jojapi.net/.well-known/x402","https://agents.jojapi.net/apis/neper-news-api",[23,24],"x402","mpp",[26],"eip155:8453","https://docs.jojapi.com/consumers/agents",{"nick":29,"name":30,"verified":6,"website":18},"david","David",[32],{"endpoints":33,"name":125,"description":41,"ungrouped":6},[34,103],{"blocked":6,"hidden":6,"agent_price":35,"credits":18,"flexible_credits_description":18,"consumptions":36,"description":43,"method":44,"name":45,"url_path":46,"root_url":47,"parameters":48,"responses":79,"result_stats":97},0.01,[37],{"name":38,"slug":39,"cost":40,"label":41,"avg":42},"Request API","request-api","1","",1,"Returns News collection documents for the given country. Omit section to get every section for that country. Multiple sections can be passed as a comma-separated list.","GET","Query news by country and section","/queryNews","https://neper-news-api.jojapi.net",{"url":49,"header":70,"post":76,"body":77,"path":78},[50,66],{"key":51,"example":52,"schema":18,"example_disabled":6,"example_type":53,"value_type":54,"enum_values":55,"default_value":41,"required":17,"name":41,"description":65},"country","ko","string","enum",[56,52,57,58,59,60,61,62,63,64],"en","au","nz","it","ja","gb","fr","de","in","Country / language code.",{"key":67,"example":68,"schema":18,"example_disabled":6,"example_type":53,"value_type":53,"enum_values":18,"default_value":41,"required":6,"name":41,"description":69},"section","top","Section id. Omit to return all sections. Comma-separated for multiple. TOP is normalized to top. it/ko/ja/fr/de use SCITECH; other countries use SCIENCE and TECHNOLOGY.",[71],{"key":72,"is_auth":17,"example":73,"example_disabled":17,"example_type":53,"name":74,"description":73,"required":17,"always_error":75},"X-JoJAPI-Key","You must log in to get API key","JoJ API Key","Please log in to get API key",[],[],[],[80,89],{"status":81,"status_code":82,"description":83,"schema":84,"examples":85,"example":88},"200",200,"News documents for the requested country and section(s).","{\"type\":\"object\",\"properties\":{\"status\":{\"type\":\"string\",\"example\":\"success\"},\"message\":{\"type\":\"string\",\"example\":\"Request successful\"},\"data\":{\"type\":\"object\",\"properties\":{\"country\":{\"type\":\"string\",\"example\":\"ko\"},\"sections\":{\"type\":\"array\",\"items\":{\"type\":\"string\"},\"description\":\"Requested sections. Empty array means all sections were returned.\"},\"count\":{\"type\":\"integer\",\"example\":1},\"items\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"docId\":{\"type\":\"string\",\"example\":\"kotop\"},\"code\":{\"type\":\"string\",\"example\":\"ko\"},\"id\":{\"type\":\"string\",\"example\":\"top\"},\"updatedAt\":{\"type\":\"integer\",\"format\":\"int64\"},\"news\":{\"type\":\"array\",\"items\":{\"type\":\"object\",\"properties\":{\"title\":{\"type\":\"object\",\"properties\":{\"_text\":{\"type\":\"string\"}}},\"link\":{\"type\":\"object\",\"properties\":{\"_text\":{\"type\":\"string\"}}},\"description\":{\"type\":\"object\",\"properties\":{\"_text\":{\"type\":\"string\"}}},\"url\":{\"type\":\"string\"},\"img\":{\"type\":\"string\"},\"content\":{\"type\":\"string\"},\"faviconUrl\":{\"type\":\"string\"},\"summary\":{\"type\":\"string\"},\"section\":{\"type\":\"string\"}},\"additionalProperties\":true}}}}}}}}}",[86],{"name":87,"summary":41,"description":41,"example":88},"default","{\"status\":\"success\",\"message\":\"Request successful\",\"data\":{\"country\":\"ko\",\"sections\":[\"top\"],\"count\":1,\"items\":[{\"docId\":\"kotop\",\"code\":\"ko\",\"id\":\"top\",\"updatedAt\":1757116800000,\"news\":[{\"title\":{\"_text\":\"Headline\"},\"link\":{\"_text\":\"https:\\/\\/news.google.com\\/...\"},\"description\":{\"_text\":\"Short description\"},\"url\":\"https:\\/\\/example.com\\/article\",\"img\":\"https:\\/\\/example.com\\/image.jpg\",\"content\":\"Article body\",\"faviconUrl\":\"https:\\/\\/example.com\\/favicon.ico\",\"summary\":\"One-sentence summary\",\"section\":\"top\"}]}]}}",{"status":90,"status_code":91,"description":92,"schema":93,"examples":94,"example":96},"400",400,"Invalid country or section.","{\"type\":\"object\",\"properties\":{\"status\":{\"type\":\"string\",\"example\":\"error\"},\"errorCode\":{\"type\":\"string\",\"example\":\"INVALID_REQUEST\"},\"message\":{\"type\":\"string\"}}}",[95],{"name":87,"summary":41,"description":41,"example":96},"{\"status\":\"error\",\"errorCode\":\"INVALID_REQUEST\",\"message\":\"country is required\"}",{"x2":98,"x3":99,"x4":100,"x5":99,"uptime":101,"avg_latency":102,"avg_credits":99},"80.00","0.00","20.00","100.00","2,595",{"blocked":6,"hidden":6,"agent_price":35,"credits":18,"flexible_credits_description":18,"consumptions":104,"description":106,"method":107,"name":108,"url_path":46,"root_url":47,"parameters":109,"responses":120,"result_stats":18},[105],{"name":38,"slug":39,"cost":40,"label":41,"avg":18},"Same as GET. section may be a string, comma-separated string, or array.","POST","Query news by country and section (POST)",{"url":110,"header":111,"post":113,"body":114,"path":119},[],[112],{"key":72,"is_auth":17,"example":73,"example_disabled":17,"example_type":53,"name":74,"description":73,"required":17,"always_error":75},[],[115],{"key":18,"example":116,"schema":117,"example_disabled":6,"example_type":53,"value_type":53,"enum_values":18,"default_value":41,"required":6,"name":18,"description":118},"{\"country\":\"en\",\"section\":[\"top\",\"BUSINESS\"]}","{\"type\":\"object\",\"required\":[\"country\"],\"properties\":{\"country\":{\"type\":\"string\",\"enum\":[\"en\",\"ko\",\"au\",\"nz\",\"it\",\"ja\",\"gb\",\"fr\",\"de\",\"in\"]},\"section\":{\"oneOf\":[{\"type\":\"string\"},{\"type\":\"array\",\"items\":{\"type\":\"string\"}}]}}}","''",[],[121,123],{"status":81,"status_code":82,"description":83,"schema":84,"examples":122,"example":41},[],{"status":90,"status_code":91,"description":92,"schema":93,"examples":124,"example":41},[],"News",[127,130,133,136,139,142,145,148,151],{"question":128,"answer":129},"How do I authenticate with this API?","Subscribe to a plan on this API pricing page, then send your JoJ API key on every request.\n\nUse this header: X-JoJAPI-Key: YOUR_API_KEY\n\nThese also work: Authorization: Bearer YOUR_API_KEY Authorization: YOUR_API_KEY\n\nThe gateway checks the key and removes it before forwarding. Do not put the key in the URL or in the JSON body.",{"question":131,"answer":132},"Which countries are supported?","The country parameter is required. Use a lowercase code: en, ko, au, nz, it, ja, gb, fr, de, in.\n\nExamples: en is USA, ko is Korea, gb is United Kingdom, ja is Japan.",{"question":134,"answer":135},"How do I choose a news section?","The section parameter is optional. If you omit it, you get all sections for that country.\n\nCommon values: top, BUSINESS, ENTERTAINMENT, SPORTS, WORLD, HEALTH.\n\nFor it, ko, ja, fr, de use SCITECH. For en, au, nz, gb, in use SCIENCE and TECHNOLOGY.\n\nTOP is treated as top. For several sections on GET, use a comma list such as BUSINESS,SPORTS. On POST you may send a JSON array.",{"question":137,"answer":138},"How do I call the API? GET or POST?","Both GET and POST work. Use the gateway URL shown on this API page.\n\nGET example: GET /queryNews?country=ko&section=top\n\nPOST example body: {\"country\":\"en\",\"section\":[\"top\",\"BUSINESS\"]}\n\nIf country or section is invalid, the API returns HTTP 400. The JSON has errorCode INVALID_REQUEST and the allowed values in message.",{"question":140,"answer":141},"What does a successful response look like?","A success response has status success and a data object.\n\ndata.country is the country you requested. data.sections is the section list you requested. An empty list means every section was returned. data.count is how many News documents were returned. data.items is the document list. Each item has docId, code, id, updatedAt, and news.\n\nnews is the article array. Typical fields: title, link, url, img, content, summary, section. title and link may look like an object with a _text field.\n\nUsage for that call is also in gateway response headers for the Request API object.",{"question":143,"answer":144},"Why is summary empty for some articles?","AI summaries are filled for de, en, and ko. Other countries return summary as an empty string.\n\nsummary can also be empty when the source page had no usable article body.",{"question":146,"answer":147},"How often is the news updated?","The News collection is synced about every 5 minutes. updatedAt on each document is a Unix timestamp in milliseconds.",{"question":149,"answer":150},"How is usage billed and what are the quotas?","This API bills the Request API object (request-api). One successful request costs 1 unit, even if you omit section and receive every section for a country.\n\nFixed monthly quotas, unused units do not carry over: Free: 150 per month 10 USD: 5,000 per month 29 USD: 20,000 per month 79 USD: 80,000 per month\n\nRate limits are on the pricing page for each plan. HTTP 5xx and gateway-generated errors do not consume quota.",{"question":152,"answer":153},"What do 401, 402 and 400 mean?","401 means the JoJ API key is missing or invalid, or you have no active subscription. Subscribe on the pricing page and send X-JoJAPI-Key.\n\n402 is billing. quota_exceeded means the Request API quota is used up. not_included means the plan does not cover that object. insufficient_balance means the pay-as-you-go wallet is empty.\n\n400 from this API (not the gateway) means country or section is invalid. Check that country is present, that it is one of en, ko, au, nz, it, ja, gb, fr, de, in, and that the section is valid for that country. For example, SCIENCE is not used with ko (use SCITECH). SCITECH is not used with en (use SCIENCE or TECHNOLOGY).\n\nGateway-made errors include the header X-Jojapi-Gateway-Response: true.",[],[156,173,184,195],{"type":157,"slug":158,"blocked":6,"period":159,"currency":160,"pricing":161,"rate_limit":165,"objects":167,"name":171,"display_name":171,"features":172},"periodic","50hcbmowz0aknwvebpemdazp","1 MONTH","usd",{"price":162,"credits":162,"past_due_timeout_num":163,"past_due_timeout_type":164},0,3,"DAY",{"max_requests":42,"time_window":166},3600,[168],{"id":169,"name":38,"slug":39,"quota":170,"tiers":18},"n525d9e46",150,"BASIC",[],{"type":157,"slug":174,"blocked":6,"period":159,"currency":160,"pricing":175,"rate_limit":177,"objects":179,"name":182,"display_name":182,"features":183},"tdsg8olzt5bd93x34uu000zp",{"price":176,"credits":162,"past_due_timeout_num":163,"past_due_timeout_type":164},10,{"max_requests":178,"time_window":166},6,[180],{"id":169,"name":38,"slug":39,"quota":181,"tiers":18},5000,"PRO",[],{"type":157,"slug":185,"blocked":6,"period":159,"currency":160,"pricing":186,"rate_limit":188,"objects":190,"name":193,"display_name":193,"features":194},"1n2ikm7c62p2xsbr3hsyqdd3",{"price":187,"credits":162,"past_due_timeout_num":163,"past_due_timeout_type":164},29,{"max_requests":189,"time_window":166},30,[191],{"id":169,"name":38,"slug":39,"quota":192,"tiers":18},20000,"ULTRA",[],{"type":157,"slug":196,"blocked":6,"period":159,"currency":160,"pricing":197,"rate_limit":199,"objects":201,"name":204,"display_name":204,"features":205},"9xa03wcou86yhs84glpyku3a",{"price":198,"credits":162,"past_due_timeout_num":163,"past_due_timeout_type":164},79,{"max_requests":42,"time_window":200},60,[202],{"id":169,"name":38,"slug":39,"quota":203,"tiers":18},80000,"MEGA",[],[],{"canonical":208,"page_title":209,"meta":210},"https://jojapi.com/hub/api/neper-news-api","Neper News API Documentation & Playground - JoJ API",{"description":7,"keywords":211},"API,API Documentation,API Playground,Plans & Pricing,Neper News,david"]