CURLINFO_CONTENT_TYPE(3)

CURLINFO_CONTENT_TYPE3

Content-type of response

Usage

#include <curl/curl.h>
CURLcode curl_easy_getinfo(CURL *handle, CURLINFO_CONTENT_TYPE, char **ct);

Overview

Pass a pointer to a char pointer to receive the content-type of the downloaded object. This is the value read from the Content-Type: field. If you get NULL, it means that the server did not send a valid Content-Type header or that the protocol used does not support this.

The ct pointer is NULL or points to private memory. You must not free it. It gets freed automatically when you call curl_easy_cleanup(3) on the corresponding curl handle.

The modern way to get this header from a response is to instead use the curl_easy_header(3) function.

Protocols

This functionality affects http only

Examples

int main(void)
{
  CURL *curl = curl_easy_init();
  if(curl) {
    CURLcode result;
    curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
    result = curl_easy_perform(curl);
    if(result == CURLE_OK) {
      /* extract the content-type */
      char *ct = NULL;
      result = curl_easy_getinfo(curl, CURLINFO_CONTENT_TYPE, &ct);
      if(!result && ct) {
        printf("Content-Type: %s\n", ct);
      }
    }
    curl_easy_cleanup(curl);
  }
}

Return value

curl_easy_getinfo(3) returns a CURLcode indicating success or error.

CURLE_OK (0) means everything was OK, non-zero means an error occurred, see libcurl-errors(3).

Releases

6 releases since Debian 9 (Stretch); the text changed 5 times.

  1. 9
  2. 10
  3. 11
  4. 12
  5. 13
  6. Arch

Availability

Added in curl 7.9.4

From curl 8.23.0-1 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.