Search by a sentence in any language

get/api/v1/search

Request

  • Base URL: https://petnecto.com
  • URL: https://petnecto.com/api/v1/search
  • Auth: none declared

Query parameters

qstring

What you want, in your own words, up to 200 characters

mode'smart' | 'hybrid' | 'keyword' | 'bm25'

hybrid (the default: words + meaning now, the AI reader fills its cache in the background), smart (also waits briefly for the AI reader), keyword (plain q= search), bm25 (plain BM25, every word required)

offstring

Comma list of chip ids to leave out, e.g. good_with:kids,size:Small

unknown'include'

include: also show pets whose listing does not say whether they are good with dogs/cats/kids (marked not_stated)

nearstring

A place if you did not put it in the sentence

countrystring

US, CA, TW

species'Dog' | 'Cat' | 'Rabbit' | 'Bird' | 'Horse' | 'Small pet' | 'Reptile' | 'Pig' | 'Barnyard'

Dog, Cat...

photo'good'

good: only pets with a good photo

pageinteger

Page, 1-100

limitinteger

Results per page, 1-50

lang'en' | 'es' | 'zh-Hant' | 'zh-Hans' | 'ko' | 'ja' | 'vi' | 'fr' | 'ar' | 'tl'

Language for names and text (else Accept-Language)

output'json' | 'md'

md for Markdown instead of JSON

Response

The answer as JSON (or Markdown with output=md)

object required

Changes

No recorded changes to this operation across all 1 revision of this API.