Datasets API

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
// 1. Create a dataset request
const response = await fetch('https://rebrowser.net/api/datasets/requests/create', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    apiKey: 'YOUR_API_KEY',
    datasetSlug: 'iheart',
    entitySlug: 'stations',
    format: 'json',
    page: null,         // null = export all pages; omit or set number for single page
    allowPurchase: true,
  }),
})
const { datasetRequestId } = await response.json()

// 2. Poll for completion
let status
do {
  await new Promise(r => setTimeout(r, 5000))
  const statusRes = await fetch(
    `https://rebrowser.net/api/datasets/requests/${datasetRequestId}?apiKey=YOUR_API_KEY`
  )
  status = await statusRes.json()
} while (status.status === 'pending' || status.status === 'processing')

// 3. Download the data
const dataRes = await fetch(status.downloadUrl + '&apiKey=YOUR_API_KEY')
const rows = await dataRes.json()
console.log(rows)

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
{
  "success": true,
  "meta": {
    "datasetSlug": "iheart",
    "entitySlug": "stations",
    "format": "json",
    "totalRows": 15420,
    "ownedRows": 1000,
    "freeRows": 5000,
    "unownedRows": 9420,
    "estimatedCost": 47.10,
    "hasFreeAccess": true
  },
  "message": "Set allowPurchase: true to purchase 9,420 missing rows for $47.10 and create the export request.",
  "rows": [
    {
      "stationId": "1234",
      "name": "Station Name",
      "premiumField": "**HIDDEN**"  // Premium fields show this value if plan doesn't include premium access
    }
  ]
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
{
  "success": true,
  "meta": {
    "datasetSlug": "iheart",
    "entitySlug": "stations",
    "format": "json",
    "totalRows": 15420,
    "ownedRows": 1000,
    "freeRows": 5000,
    "unownedRows": 9420,
    "estimatedCost": 47.10
  },
  "datasetRequestId": "507f1f77bcf86cd799439011",
  "status": "pending",
  "message": "Dataset request created. Poll GET /api/datasets/requests/507f1f77bcf86cd799439011 for status."
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
{
  "success": true,
  "requestId": "507f1f77bcf86cd799439011",
  "status": "success",
  "datasetSlug": "iheart",
  "entitySlug": "stations",
  "format": "json",
  "page": null,
  "estimatedRows": 15420,
  "estimatedCost": 47.10,
  "createdAt": "2026-02-05T10:30:00Z",
  "updatedAt": "2026-02-05T10:32:15Z",
  "completedAt": "2026-02-05T10:32:15Z",
  "rowCount": 15420,
  "expiresAt": "2026-02-12T10:32:15Z",
  "downloadUrl": "/api/datasets/requests/.../download?format=json",
  "downloadUrls": {
    "json": "/api/datasets/requests/.../download?format=json",
    "jsonl": "/api/datasets/requests/.../download?format=jsonl",
    "csv": "/api/datasets/requests/.../download?format=csv",
    "parquet": "/api/datasets/requests/.../download?format=parquet"
  }
}

1
2
3
4
[
  {"stationId":"1234","name":"KIIS-FM","market":"Los Angeles","genres":["Pop","Top 40"]},
  {"stationId":"5678","name":"KROQ-FM","market":"Los Angeles","genres":["Alternative","Rock"]}
]

1
2
{"stationId":"1234","name":"KIIS-FM","market":"Los Angeles","genres":["Pop","Top 40"]}
{"stationId":"5678","name":"KROQ-FM","market":"Los Angeles","genres":["Alternative","Rock"]}

1
2
3
4
5
6
7
billableRows = Math.ceil(unownedRows / 50) * 50
totalCost = (billableRows / 1000) * ratePer1kRows

// Examples:
// 1 row → 50 billable rows
// 51 rows → 100 billable rows
// 235 rows → 250 billable rows

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
const response = await fetch('https://rebrowser.net/api/datasets/requests/create', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    apiKey: 'YOUR_API_KEY',
    datasetSlug: 'iheart',
    entitySlug: 'stations',
    format: 'json',
    page: null,  // null = all pages, 1/2/3... = specific page
    viewSettings: {
      filters: {
        conjunction: 'and',
        rules: [
          { type: 'rule', field: 'market', operator: 'is', value: 'Los Angeles' },
          { type: 'rule', field: 'genres', operator: 'contains', value: 'Pop' },
        ],
      },
      sort: {
        field: 'cume',
        dir: 'DESC',
      },
      pageSize: 100,
    },
    allowPurchase: true,
  }),
})

1
2
3
4
{
  "success": false,
  "error": "Detailed error message"
}