Petco Love Integration

[trevorskaggs]

Current understanding is that we will need to upload a picture and latitude/longitude. PL currently takes in street/cross, but we can skip this step.

Example POST: https://api.lost2.petcolove.org/pets/search/lost/image?latitude=34.0617823&longitude=-118.556865&range=50&limit=24&offset=0&species=dog&imageUrl=https%3A%2F%2Fd1xo1ei89o6wi.cloudfront.net%2Fpending%2Ffea89957-3165-4679-b268-c7d3020cac71.jpeg%3Fwidth%3D240%26height%3D240%26quality%3D60%26format%3Djpeg&showConfidence=true&includeExternalPosts=true

Example Results:

{
pets: [
{
pet: {
pet_entity_id: 100316781,
name: "<DOG_NAME>",
created_at: "2025-02-15T12:44:35.151Z",
photos: {
photo_1: "photos/pet/100316781/13cf8c30-4634-4ee4-abe5-2118a21cfc0a.jpeg"
},
owner_details: {
name: "<OWNER_NAME>",
owner_type: "user",
owner_entity_id: 1422503
},
lost_or_found_at: "2025-02-10T08:00:00.000Z",
lost_or_found: "lost"
},
distance: 21.779310301458967,
confidence: 2.278212
},
{
pet: {
pet_entity_id: 98786026,
name: "<DOG_NAME>",
created_at: "2025-02-06T23:48:07.376Z",
photos: {
photo_1: "photos/pet/98786026/7da6ff47-29db-49cb-a9b8-517c70989c58.jpeg",
photo_2: "photos/pet/98786026/df4faa5c-33b3-40a2-927d-eb0f016c706b.jpeg",
photo_3: "photos/pet/98786026/b8913503-f790-47cb-a7cd-234b4845d223.jpeg"
},
owner_details: {
name: "<OWNER_NAME>",
owner_type: "user",
owner_entity_id: 1415342
},
lost_or_found_at: "2025-02-05T08:00:00.000Z",
lost_or_found: "lost"
},
distance: 21.265310157705645,
confidence: 2.195226
},
{
pet: {
pet_entity_id: 100501361,
name: "<DOG_NAME>",
created_at: "2025-02-16T13:07:48.103Z",
photos: {
photo_1: "photos/pet/100501361/e0e04de4-1471-4428-9c43-aa861d286e5b.jpeg",
photo_2: "photos/pet/100501361/61f1c8f5-f7fe-4acd-98f0-99f7d6f8fe01.jpeg"
},
owner_details: {
name: "<OWNER_NAME>",
owner_type: "user",
owner_entity_id: 1423389
},
lost_or_found_at: "2024-08-13T07:00:00.000Z",
lost_or_found: "lost"
},
distance: 14.64890455415071,
confidence: 2.1884584
},
{
pet: {
pet_entity_id: 99706916,
name: "<DOG_NAME> ",
created_at: "2025-02-12T04:39:28.174Z",
photos: {
photo_1: "photos/pet/99706916/af247b7b-4339-447a-99ed-d66d58e51503.jpeg"
},
owner_details: {
name: "<OWNER_NAME>",
owner_type: "user",
owner_entity_id: 1255238
},
lost_or_found_at: "2025-02-09T08:00:00.000Z",
lost_or_found: "lost"
},
distance: 29.11135568844254,
confidence: 2.175781
}
],
options: {
offset: 0,
limit: 24
}
}

Open Questions:

• What is the confidence range?
• Can the API use external images?
• [ ]