---
updatedAt: 2025-05-08T22:31:54.000Z
agentTools:
  projectIndex: https://api.rebuildingsociety.com/llms.txt
---

# /News

Search for news stories. The service shall return the latest news stories.

Search for news stories.\
The service shall return the latest news stories.

* When using apikey, endpoint will not try to look for authorization header.
* When using authorization header, bearer token should be of type client\_credentials.

## Description

**Definition:** A search for news stories.

## Parameters

<Table align={["left","left"]}>
  <thead>
    <tr>
      <th>
        Parameter
      </th>

      <th>
        Definition
      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>
        news\_id
      </td>

      <td>
        The id of the news story. If no id is supplied then all news stories are returned
      </td>
    </tr>

    <tr>
      <td>
        max\_results
      </td>

      <td>
        The number of stories to return (most recent first)
      </td>
    </tr>

    <tr>
      <td>
        apikey
      </td>

      <td>
        API access key supplied by Rebuilding Society
      </td>
    </tr>
  </tbody>
</Table>

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "api-settings",
    "version": "1.0"
  },
  "servers": [
    {
      "url": "https://www.rebuildingsociety.com/api"
    }
  ],
  "security": [
    {}
  ],
  "paths": {
    "/rs/News": {
      "get": {
        "summary": "/News",
        "description": "Search for news stories. The service shall return the latest news stories.",
        "operationId": "news",
        "parameters": [
          {
            "name": "apikey",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "news_id",
            "in": "query",
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "max_results",
            "in": "query",
            "description": "[0 – 100], 0 = UNLIMITED",
            "schema": {
              "type": "integer",
              "format": "int32",
              "default": 0
            }
          },
          {
            "name": "Authorization",
            "in": "header",
            "description": "bearer <access_token>",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "200",
            "content": {
              "application/json": {
                "examples": {
                  "status: ok": {
                    "value": "{\n\tstatus\t:\tok\n\tnews[0..*] {\n\t\tid\t:\t669\n\t\ttitle\t:\tNew API available\n\t\texcerpt\t:\tNew API available for rebuilding society …\n\t\tcontents\t:\tsome content\n\t\turl\t:\thttp://some.url.com\n\t\tslug\t:\tnew_api_avaialable\n\t\tstatus\t:\tPublished\n\t\tdate\t:\t2014-08-21 13:59:38\n\t}\n}"
                  }
                }
              }
            }
          },
          "400": {
            "description": "400",
            "content": {
              "application/json": {
                "examples": {
                  "status: error": {
                    "value": "//Invalid HTTP request type\n{\n    \"status\": \"error\",\n    \"error\": \"This method should use HTTP GET request\"\n}\n\n//Invalid (non-numeric) news_id\n{\n    \"status\": \"error\",\n    \"error\": \"news_id must be an integer\"\n}\n\n//News with requested id not found\n{\n    \"status\": \"error\",\n    \"error\": \"Not found.\"\n}"
                  }
                }
              }
            }
          }
        },
        "deprecated": false
      }
    }
  },
  "x-readme": {
    "headers": [],
    "explorer-enabled": true,
    "proxy-enabled": true
  },
  "x-readme-fauxas": true
}
```