CURLINFO_CONTENT_TYPE(3) Introduction to Library Functions

NAME

CURLINFO_CONTENT_TYPE - Content-Type of response

SYNOPSIS

#include <curl/curl.h>

CURLcode curl_easy_getinfo(CURL *handle, CURLINFO_CONTENT_TYPE, char **ct);

DESCRIPTION

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

EXAMPLE

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) {
/* 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);
}
}

AVAILABILITY

Added in curl 7.9.4

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).

SEE ALSO

CURLOPT_HEADERFUNCTION(3), curl_easy_getinfo(3), curl_easy_header(3),
curl_easy_setopt(3)

libcurl 2026-01-08 CURLINFO_CONTENT_TYPE(3)