IntroductionAuthenticationPaginationRate Limit

Search endpoints

Job Search POSTCompany Search POSTTechnographics POST

Account endpoints

Get Credit Balance GETGet Credits Consumption GET

Other

List Datasets GETGenerate Dataset Credentials POST
TheirStack TheirStack Logo
DocumentationAPI ReferenceWebhooksDatasets
Datasets

Generate Dataset Credentials

Generate credentials to access datasets. By default the credentials are valid for 7 days.

POST
/v1/datasets/credentials

Authorization

Bearer
AuthorizationBearer <token>

In: header

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://api.theirstack.com/v1/datasets/credentials"
{
  "access_key_id": "a3f8b2c9d1e4f5a6b7c8d9e0f1a2b3c4",
  "secret_access_key": "7e9a2b4c6d8e0f1a3b5c7d9e1f3a5b7c9d1e3f5a",
  "session_token": "ZXlKaGJHY2lPaUpTVXpJMU5pSXNJblI1Y0NJNklrcFhWQ0o5LmV5SmlkV05yWlhRa",
  "expiration": "2025-01-15T14:30:00Z",
  "storage": {
    "bucket_name": "datasets",
    "endpoint_url": "https://example-datasets-url.com",
    "prefixes": [
      "jobs/daily"
    ]
  }
}
{
  "request_id": null,
  "error": {
    "code": "E-001",
    "title": "Not allowed exception",
    "description": "string"
  }
}
{
  "request_id": null,
  "error": {
    "code": "E-001",
    "title": "Not allowed exception",
    "description": "string"
  }
}
{
  "request_id": null,
  "error": {
    "code": "E-001",
    "title": "Not allowed exception",
    "description": "string"
  }
}
{
  "request_id": null,
  "error": {
    "code": "E-001",
    "title": "Not allowed exception",
    "description": "string"
  }
}

How is this guide?

Last updated on

List Datasets GET

Get all the datasets available for your team. Datasets are updated daily. Use this endpoint to get the latest dataset url.

Get Request Count GET

Get the number of request done per day

curl -X POST "https://api.theirstack.com/v1/datasets/credentials"