pornsieve::redtube Namespace Reference

Namespace for the RedTube API. More...

Functions
vector< string >	get_categories ()
	Get a list of categories from RedTube. More...
vector< string >	get_tags ()
	Get a list of tags from RedTube. More...
search_result	search (media_type type, string_view query, const vector< string_view > &tags={}, string_view category={}, result_order order_by=result_order::none, std::uint32_t page=1)
	Search RedTube. More...

Detailed Description

Namespace for the RedTube API.

Since

0.1.0

Function Documentation

get_categories()

vector< string > pornsieve::redtube::get_categories

(

)

Get a list of categories from RedTube.

Note

According to the API documentation, a search can specify 1 category as string. However, some category names are used 2 times (for example: categories→Amateur and categories_gay→Amateur). 🤷

Exceptions

pornsieve::CURLException	Thrown on libcurl errors.
std::runtime_exception	Thrown if libcurl failed to initialize.
nlohmann::detail::type_error	Thrown if the format of the JSON is different than expected.

Returns

Category names without ID. Names are not unique.

Since

0.1.0

{
    try
    {
        cw::CURLWrapper curl;
        configure_curl(curl.get_curl_easy_handle());
 
        const string url{
            format("{:s}&data=redtube.Categories.getCategoriesList", base_url)};
        const auto answer{curl.make_http_request(cw::http_method::GET, url)};
        if (answer)
        {
            vector<string> categories;
            // Supercategories are "categories" and "categories_gay" ATM.
            for (const auto &supercategory : nlohmann::json::parse(answer.body))
            {
                for (const auto &category : supercategory)
                {
                    categories.emplace_back(category["category"]);
                }
            }
            return categories;
        }
        throw HTTPException{answer.status};
    }
    catch (const cw::CURLException &e)
    {
        throw pornsieve::CURLException(e.error_code, e.error_message);
    }
}

get_tags()

vector< string > pornsieve::redtube::get_tags

(

)

Get a list of tags from RedTube.

Exceptions

pornsieve::CURLException	Thrown on libcurl errors.
std::runtime_exception	Thrown if libcurl failed to initialize.
nlohmann::detail::type_error	Thrown if the format of the JSON is different than expected.

Returns

Tag names.

Since

0.1.0

{
    try
    {
        cw::CURLWrapper curl;
        configure_curl(curl.get_curl_easy_handle());
 
        const auto answer{
            curl.make_http_request(cw::http_method::GET,
                                   format("{:s}&data=redtube.Tags.getTagList",
                                          base_url))};
        if (answer)
        {
            vector<string> tags;
            const auto json{nlohmann::json::parse(answer.body)};
            for (const auto &tag : json.front()["tags"])
            {
                tags.emplace_back(tag["tag"]["tag_name"]);
            }
            return tags;
        }
        throw HTTPException{answer.status};
    }
    catch (const cw::CURLException &e)
    {
        throw pornsieve::CURLException(e.error_code, e.error_message);
    }
}

search()

search_result pornsieve::redtube::search	(	media_type	type,
		string_view	query,
		const vector< string_view > &	tags = {},
		string_view	category = {},
		result_order	order_by = result_order::none,
		std::uint32_t	page = 1
	)

Search RedTube.

Note

The search seems to be completely broken. The results are highly inaccurate.

Parameters

type	Accepted values: video.
query	Matching seems to be very fuzzy, to the point where it is unusable.
tags	Does not really change the result count. Does not seem to influence the result ordering. 😕
category	Only some categories work, some return always 0 results. If the specified category does not exist, it returns 0 results.
order_by	Accepted values: none, newest, mostviewed, rating, popular_week, popular_month.
page	Return this page of results.

Exceptions

pornsieve::CURLException	Thrown on libcurl errors.
std::runtime_exception	Thrown if libcurl failed to initialize.
nlohmann::detail::type_error	Thrown if the format of the JSON is different than expected.
std::logic_error	Thrown if the ordering algorithm or media type is not supported.

Since

0.1.0

{
    if (type != media_type::video)
    {
        throw std::logic_error{"Media type not supported"};
    }
 
    try
    {
        cw::CURLWrapper curl;
        configure_curl(curl.get_curl_easy_handle());
 
        string tags_maybe;
        for (const auto &tag : tags)
        {
            tags_maybe += format("&tags[]={:s}", curl.escape_url(tag));
        }
 
        const string category_maybe{
            [&category, &curl]
            {
                if (!category.empty())
                {
                    return format("&category={:s}", curl.escape_url(category));
                }
                return string{};
            }()};
 
        const string order_by_maybe{
            [order_by]
            {
                switch (order_by)
                {
                case result_order::none:
                {
                    return "";
                    break;
                }
                case result_order::newest:
                {
                    return "&ordering=newest";
                    break;
                }
                case result_order::mostviewed:
                {
                    return "&ordering=mostviewed";
                    break;
                }
                case result_order::rating:
                {
                    return "&ordering=rating";
                    break;
                }
                case result_order::popular_week:
                {
                    return "&ordering=rating&period=weekly";
                    break;
                }
                case result_order::popular_month:
                {
                    return "&ordering=rating&period=monthly";
                    break;
                }
                default:
                {
                    throw std::logic_error{"Ordering algorithm not supported"};
                    break;
                }
                }
            }()};
 
        const string url{format("{:s}&data=redtube.Videos.searchVideos"
                                "&search={:s}{:s}{:s}{:s}&page={:d}",
                                base_url, curl.escape_url(query), tags_maybe,
                                category_maybe, order_by_maybe, page)};
        const auto answer{curl.make_http_request(cw::http_method::GET, url)};
        if (answer)
        {
            search_result result;
            result.original_data = answer.body;
            const auto json{nlohmann::json::parse(answer.body)};
            result.count = json.front()["count"];
 
            for (const auto &item_json : json.front()["videos"])
            {
                search_result::item item;
                const auto &video{item_json["video"]};
 
                item.title = video["title"];
                item.url = video["url"];
                item.duration = string_to_duration(
                    video["duration"].get<string>());
                item.tags = json_to_vector(video["tags"].dump(), "tag_name");
                item.thumbnails = json_to_vector(video["thumbs"].dump(), "src");
                if (video["rating"].is_string())
                { // If it is not a string, it is 0.
                    item.rating = std::stof(video["rating"].get<string>());
                }
                item.views = video["views"];
                item.date = string_to_timepoint(
                    video["publish_date"].get<string>());
 
                result.items.emplace_back(item);
            }
            return result;
        }
        throw HTTPException{answer.status};
    }
    catch (const cw::CURLException &e)
    {
        throw pornsieve::CURLException(e.error_code, e.error_message);
    }
}