Ready Signal API Documentation

Instructions on how to use Ready Signal API. Location of API end points, how to get access tokens, how to call API.

Ready Signal API

The Ready Signal API is designed to let you retrieve the processed data from one of your Signals.

Production Endpoint: https://app.readysignal.com/api/

1. Get an Access Token

To access the Ready Signal API, you have to get an access token and send it through your request’s authorization header.

Login to the Ready Signal portal, access the detail page of your Signal or create a new Signal if you don’t have one.

Scroll the page down to the API Credentials section, and use the button next to the Access Token to copy your token.

That’s it. You will use that token to authenticate your next requests.

2. GET My Signals

To get the list of your signals.

RequestGET /signals
HeadersAcceptapplication/json
AuthorizationBearer {token}
Request
GET /api/signals HTTP/1.1Host: app.readysignal.comContent-Type: application/jsonAccept: application/jsonAuthorization: Bearer eyJ0eXAiOiJKV1QiLCI1N…bGciOiJSUzI1Nmqhi6A
Response
{
   “data”: [
       {
           “id”: 48,
           “name”: “My Signal Name”,
           “description”: “The description of my signal.”,
           “desired_geo_grain”: “State”,
           “desired_time_grain”: “Week”,
           “start_at”: “01/26/2020”,
           “end_at”: “05/31/2020”,
           “created_at”: “06/03/2020”,
           “updated_at”: “06/03/2020”,
           “deleted_at”: null,
           “company”: {
               “id”: 1024,
               “name”: “Ready Signal Team”,
               “plan_id”: 1,
               “plan_value_id”: 1,
               “subscription_status”: “active”,
               “created_at”: “2020-05-11 18:39:24”,
               “updated_at”: “2020-05-11 18:40:22”,
               “need_listining_webhook”: 0
           },
           “user”: {
               “id”: 1015,
               “company_id”: 1024,
               “name”: “Marco Tanaka”,
               “email”: “marco@example.com”,
               “type”: “owner”,
               “created_at”: “2020-05-11 18:39:24”,
               “updated_at”: “2020-05-11 18:39:24”
           },
           “industry”: {
               “id”: 2,
               “name”: “CPG”,
               “created_at”: “2020-04-10 23:21:39”,
               “updated_at”: “2020-04-10 23:21:39”
           },
           “analysis_type”: {
               “id”: 3,
               “name”: “Classification”,
               “created_at”: “2020-04-10 23:21:45”,
               “updated_at”: “2020-04-10 23:21:45”
           },
           “output”: {
               “json”: “https://app.readysignal.com/api/signals/48/output?format=json”
           },
           “links”: {
               “self”: “https://app.readysignal.com/signal/48/manage”,
               “manage”: “https://app.readysignal.com/signal/48/manage
           }
       }
  ],
}

3. GET My Signals Detail

To get the detail of the specified signal.

RequestGET /signals/{Signal_ID}/
HeadersAcceptapplication/json
AuthorizationBearer {token}
Request
GET /api/signals/48 HTTP/1.1Host: app.readysignal.comContent-Type: application/jsonAccept: application/jsonAuthorization: Bearer eyJ0eXAiOiJKV1QiLCI1N…bGciOiJSUzI1Nmqhi6A
Response
{
   “data”: {
       “id”: 48,
       “name”: “My Signal Name”,
       “description”: “The description of my signal.”,
       “desired_geo_grain”: “State”,
       “desired_time_grain”: “Week”,
       “start_at”: “01/26/2020”,
       “end_at”: “05/31/2020”,
       “created_at”: “06/03/2020”,
       “updated_at”: “06/03/2020”,
       “deleted_at”: null,
       “company”: {
           “id”: 1024,
           “name”: “Ready Signal Team”,
           “plan_id”: 1,
           “plan_value_id”: 1,
           “subscription_status”: “active”,
           “created_at”: “2020-05-11 18:39:24”,
           “updated_at”: “2020-05-11 18:40:22”,
           “need_listining_webhook”: 0
       },
       “user”: {
           “id”: 1015,
           “company_id”: 1024,
           “name”: “Marco Tanaka”,
           “email”: “marco@example.com”,
           “email_verified_at”: null,
           “type”: “owner”,
           “created_at”: “2020-05-11 18:39:24”,
           “updated_at”: “2020-05-11 18:39:24”
       },
       “industry”: {
           “id”: 2,
           “name”: “CPG”,
           “created_at”: “2020-04-10 23:21:39”,
           “updated_at”: “2020-04-10 23:21:39”
       },
       “analysis_type”: {
           “id”: 3,
           “name”: “Classification”,
           “created_at”: “2020-04-10 23:21:45”,
           “updated_at”: “2020-04-10 23:21:45”
       },
       “output”: {
           “json”: “https://app.readysignal.com/api/signals/48/output?format=json”
       },
       “links”: {
           “self”: “https://app.readysignal.com/signal/48/manage”,
           “manage”: “https://app.readysignal.com/signal/48/manage”
       }
   }
}

4. GET My Signal Output

To get the output of the specified signal.

The resulting data is paginated every 1000 records. You can use the “page” query string to get data from other pages. You can also see other pagination metadata on the JSON payload.

RequestGET /signals/{Signal_ID}/output
Query StringsPageInteger | Optional | The number of the pagination page
HeadersAcceptapplication/json
AuthorizationBearer {token}
Request
GET /api/signals/48/output?page=1 HTTP/1.1Host: app.readysignal.comContent-Type: application/jsonAccept: application/jsonAuthorization: Bearer eyJ0eXAiOiJKV1QiLCI1N…bGciOiJSUzI1Nmqhi6A
Response
{
       “current_page”: 1,
       “data”: [
       {
             “start”: “2020-01-26”,
             “end”: “2020-02-01”,
             “state”: “Alabama”,
             “population-rural”: “1957932.00000000000000000000”
       },
       {
             “start”: “2020-01-26”,
             “end”: “2020-02-01”,
             “state”: “Alaska”,
             “population-rural”: “241338.00000000000000000000”
       },
       {…},
       {
             “start”: “2020-05-24”,
             “end”: “2020-05-30”,
             “state”: “Puerto Rico”,
             “population-rural”: “232533.00000000000000000000”
       }
       ],
       “first_page_url”: “https://app.readysignal.com/api/signals/48/output?page=1”,
       “from”: 1,
       “last_page”: 1,
       “last_page_url”: “https://app.readysignal.com/api/signals/48/output?page=1”,
       “next_page_url”: null,
       “path”: “https://app.readysignal.com/api/signals/48/output”,
       “per_page”: 1000,
       “prev_page_url”: null,
       “to”: 936,
       “total”: 936
}

Take the next step

SIGN UP FREE