Catalog / Houston General Services Advertisements

Houston General Services Advertisements API

houstontx.gov

Read-only access to the City of Houston General Services public advertisement index, its recent-selection index entries, and linked PDF documents. The website exposes a static HTML index rather than a solicitation JSON feed; the API preserves the observed source identifiers and retrieves detail documents over HTTP. The source does not publish structured award/selection-result fields, so dates and agency values may be null or page-level where the source does not provide them.

  • Business
  • houston
  • public-procurement
  • solicitations
  • advertisements
4 endpointsDocs updated

Endpoint health

Loading verification…

Connect your agent

Connect through MCP so your agent can find this API, read its docs, and call its endpoints.

Setup guide

Add the server from your terminal.

Claude Code · terminal
claude mcp add --transport http agent-data https://agent-data.motie.dev/mcp

In Claude Code, run /mcp, select agent-data, then Authenticate. Sign in to your agent-data account in the browser.

Then ask your agent to use the Houston General Services Advertisements API for your task.

Call it over HTTP

Get an API key

Sign up free, generate an API key, and set it as AGENT_DATA_API_KEY in your environment. Your first 100 calls each month are free.

List Houston General Services advertisements and selection entries

Optional parameters 4

Case-insensitive agency text filter.

Case-insensitive source section/status filter, such as ADVERTISEMENTS or RECENT SELECTIONS.

ISO-8601 date or datetime. The source supplies a page-level last-updated timestamp.

Opaque continuation cursor returned in next_cursor.

View call pricing
cURL · Solicitations
curl --request GET --get 'https://3kpkg0jfvk.execute-api.us-east-2.amazonaws.com/prod/4c5bae76-2e1a-4aca-975e-cf58a25b6619/solicitations' \
  --header "Authorization: Bearer $AGENT_DATA_API_KEY"

Endpoints

Inputs and response fields for every endpoint in this API.

GETSolicitations/solicitations

List Houston General Services advertisements and selection entries

Input

agencyOptionalQuery · string | null

Case-insensitive agency text filter.

Example: City of Houston General Services Department

statusOptionalQuery · string | null

Case-insensitive source section/status filter, such as ADVERTISEMENTS or RECENT SELECTIONS.

Example: RECENT SELECTIONS

updated_sinceOptionalQuery · string | null

ISO-8601 date or datetime. The source supplies a page-level last-updated timestamp.

Example: 2025-01-01

cursorOptionalQuery · string | null

Opaque continuation cursor returned in next_cursor.

Response

items?object[]
items[].titlestring
items[].agencystring
items[].due_at?string | null
items[].source_url?string, default: https://www.houstontx.gov/generalservices/advertisements.html
items[].status_rawstring
items[].updated_at?string | null
items[].notice_typestring
items[].observed_atstring
items[].published_at?string | null
items[].source_as_ofstring
items[].attachment_urls?string[]
items[].solicitation_idstring
next_cursor?string | null
observed_atstring
source_as_ofstring

Fields marked ? are optional.

For the next page, pass next_cursor from the response as cursor. Leave it empty on the first call.

GETSolicitations by solicitation id/solicitations/{solicitation_id}

Get one Houston General Services solicitation entry

Input

solicitation_idRequiredPath · string

Source identifier from the list response.

Example: cloverlandpark

Response

solicitationobject
solicitation.titlestring
solicitation.agencystring
solicitation.due_at?string | null
solicitation.source_url?string, default: https://www.houstontx.gov/generalservices/advertisements.html
solicitation.status_rawstring
solicitation.updated_at?string | null
solicitation.notice_typestring
solicitation.observed_atstring
solicitation.published_at?string | null
solicitation.source_as_ofstring
solicitation.attachment_urls?string[]
solicitation.solicitation_idstring

Fields marked ? are optional.

GETSolicitations by solicitation id amendments/solicitations/{solicitation_id}/amendments

List amendments linked to one solicitation

Input

solicitation_idRequiredPath · string

Source identifier from the list response.

Example: harveymcd

Response

items?object[]
items[].urlstring
items[].labelstring
items[].source_url?string, default: https://www.houstontx.gov/generalservices/advertisements.html
items[].observed_atstring
items[].content_type?string, default: application/pdf
observed_atstring
source_as_ofstring
solicitation_idstring

Fields marked ? are optional.

GETSolicitations by solicitation id attachments/solicitations/{solicitation_id}/attachments

List all PDF documents linked to one solicitation

Input

solicitation_idRequiredPath · string

Source identifier from the list response.

Example: harveymcd

Response

items?object[]
items[].urlstring
items[].labelstring
items[].source_url?string, default: https://www.houstontx.gov/generalservices/advertisements.html
items[].observed_atstring
items[].content_type?string, default: application/pdf
observed_atstring
source_as_ofstring
solicitation_idstring

Fields marked ? are optional.

Don’t see the endpoint you need?

Ask agent-data to add an endpoint or return more fields. Extensions are free and keep existing endpoints working.