ChatGPT custom GPT

You can build a custom GPT that searches your Trawley scraper's live data and answers in plain language. This needs no code: ChatGPT calls Trawley's hybrid search endpoint through a GPT Action.

Custom GPTs require a ChatGPT Plus, Team, or Enterprise plan. The steps below use the GPT Builder's Actions feature.

Steps

Get your scraper ID

Open your scraper in the dashboard. The ID is the last part of the URL, for example scr_8f2a1c9e.

Create a new GPT

In ChatGPT, go to Explore GPTs → Create, then open the Configure tab.

Add an Action

Under Actions, add a new action and paste the schema below, replacing the scraper ID with yours.

Test it

Ask your GPT something like "find 3 bed houses with a garden". It calls the action and answers from the live results.

The action schema

This OpenAPI schema describes the hybrid endpoint to ChatGPT. Replace scr_8f2a1c9e with your scraper ID.

yaml

openapi: 3.1.0
info:
  title: Trawley scraper search
  version: 1.0.0
servers:
  - url: https://api.trawley.ai
paths:
  /v1/scrapers/scr_8f2a1c9e/hybrid:
    get:
      operationId: searchListings
      summary: Search the scraper's results in natural language.
      parameters:
        - name: search
          in: query
          required: true
          description: A natural language query describing what to find.
          schema:
            type: string
        - name: take
          in: query
          required: false
          description: How many results to return.
          schema:
            type: integer
            default: 10
      responses:
        "200":
          description: Matching results.
          content:
            application/json:
              schema:
                type: object

The hybrid endpoint currently has no authentication, so anyone you share the GPT with can search that scraper's data. Only share GPTs for scrapers whose data you are comfortable exposing. See authentication for what is changing.

Give it instructions

In the GPT's Instructions, tell it how to behave:

text

You help people search live listings from acmehomes.co.uk. When asked about
properties, call the searchListings action with the user's request as the search
query. Summarise the results clearly, including price and location. If nothing
matches, say so.