Use the Datadog HTTP API to programmatically access the Datadog platform. The Datadog API uses resource-oriented URLs, uses status codes to indicate the success or failure of requests and returns JSON from all requests.
To get started on the Datadog HTTP API, use the following flow to determine which endpoints you need and checkout our Datadog Postman collection.
Note: cURL code examples assume usage of BASH and GNU coreutils. On macOS you can install coreutils via the Homebrew package manager:
brew install coreutils
Before you can use the API to send or view data, you need to install the Datadog Agent. The Datadog Agent is software that runs on your hosts. It collects events and metrics from hosts and sends them to Datadog, where you can analyze your monitoring and performance data.
Once you have the Datadog Agent set up, use the API to begin to send integrations data to Datadog. With some additional setup of the Agent, you can also use the API to send Synthetics, Logs and Traces to Datadog.
Available intgrations endpoints:
Use these endpoints to post and fetch data to and from other parts of the Datadog platform:
Once you are sending data to Datadog, you can use the API to programatically build data visualizations:
You can also use the Datadog API to programatically manage your account:
Some of the API endpoints are rate limited. Once you exceed a certain number of requests in a certain time period an error is returned.
Headers are returned for rate limited API endpoints so you can know how close you are to your limit. If you exceed your limit, review these headers to determine when you are able to try again.
Rate limits can be increased from defaults by contacting the Datadog support team.
Regarding API rate limit policy:
100per hour per organization.
1000per aggregate per day per organization. An aggregate is a group of similar events.
600per hour per organization. This can be extended on demand.
300per hour per organization. This can be extended on demand.
60per hour per organization. This can be extended on demand.
6000per minute per organization. This can be extended on demand.
|Rate Limit Headers||Description|
|number of requests allowed in a time period.|
|length of time in seconds for resets (calendar aligned).|
|number of allowed requests left in current time period.|
|time in seconds until next reset.|