@codybrom/denim/src/api/lookupProfile.ts

A Deno/TypeScript library for the Threads API

import { THREADS_API_BASE_URL } from "../constants.ts";
import type { PublicProfile } from "../types.ts";
import { getAPI } from "../utils/getAPI.ts";

const DEFAULT_FIELDS = [
	"username",
	"name",
	"profile_picture_url",
	"biography",
	"is_verified",
	"follower_count",
	"likes_count",
	"quotes_count",
	"replies_count",
	"reposts_count",
	"views_count",
];

/**
 * Looks up a public Threads profile by username.
 *
 * @param accessToken - The access token for authentication
 * @param username - The exact username to look up
 * @param fields - Optional array of fields to return
 * @returns A Promise that resolves to the PublicProfile object
 * @throws Will throw an error if the API request fails
 */
export async function lookupProfile(
	accessToken: string,
	username: string,
	fields?: string[],
): Promise<PublicProfile> {
	const api = getAPI();
	if (api) {
		return api.lookupProfile(accessToken, username, fields);
	}

	const fieldList = (fields ?? DEFAULT_FIELDS).join(",");
	const url = new URL(`${THREADS_API_BASE_URL}/profile_lookup`);
	url.searchParams.append("username", username);
	url.searchParams.append("fields", fieldList);
	url.searchParams.append("access_token", accessToken);

	const response = await fetch(url.toString());
	if (!response.ok) {
		const errorBody = await response.text();
		throw new Error(
			`Failed to look up profile (${response.status}): ${errorBody}`,
		);
	}

	return await response.json();
}