# info.summary
Read-only catalog of projects, jobs, and long threads from X.

# info.description
Best X Builds is a human-curated directory. This API lists builds, founder-posted jobs, and long threads. There is no authentication, no write surface, and no webhooks. Tweet text is not included; each item points at the original post URL.

# info.license.name
Catalog data is editorial; code is MIT on GitHub

# tags[].description
Roles posted by a person or company on X.

# paths./api/v1/builds.get.description
Returns a page of Best X Builds catalog entries, newest first. Optional q filters by title, description, tags, or creator.

# paths./api/v1/builds.get.parameters[].description
Case-insensitive substring match on title, description, tags, and creator/company.

# paths./api/v1/builds/{slug}.get.description
Returns a single Best X Builds catalog entry.

# paths./api/v1/jobs.get.description
Returns roles posted by a person or company on X, newest first. Aggregator listings are not in this catalog.

# paths./api/v1/jobs.get.parameters[].description
Case-insensitive substring match on title, description, tags, and creator/company.

# paths./api/v1/jobs/{slug}.get.description
Returns a single role. Apply on the original post, not through this API.

# paths./api/v1/jobs/{slug}.get.parameters[].description
Stable slug, as used on /jobs/role/{slug}.

# paths./api/v1/reads.get.description
Returns curated long threads and essays from X, newest first.

# paths./api/v1/reads.get.parameters[].description
Case-insensitive substring match on title, description, tags, and creator/company.

# paths./api/v1/search.get.description
Runs the same substring filter across all three catalogs and returns a small slice of each. Use list endpoints for pagination.

# paths./api/v1/search.get.parameters[].description
Approximate total items across the three lists. Default 15, maximum 45.

# paths./api/v1/tags.get.description
Returns every tag currently used on a build, with how many builds carry it.