GraphQL quickstart

1. Query a known place

Send an HTTP POST with JSON. No authentication is required.

curl -sS 'https://evendo.com/api/locationSearchGraphQL' \
  -H 'Content-Type: application/json' \
  --data '{"query":"query { node(id: \"27799\") { id title node_type country_code } }"}'

The response is a standard GraphQL JSON result (data on success, or errors when the server reports a GraphQL failure). Do not rely on specific application error codes; they are not documented yet.

2. Find places under a city

query MadridAttractions {
  descendantsOf(ancestorId: "27799", nodeType: "Attractions", first: 10) {
    edges {
      cursor
      node { id title node_type category rating rating_votes address }
    }
    pageInfo { hasNextPage endCursor }
  }
}

Before publishing production SDKs, confirm argument enums and validation against the live schema.

3. Score-ranked discovery

query MadridHighlights {
  descendantsOf(
    ancestorId: "27799"
    nodeType: "Attractions"
    place_score_gte: 80
    orderBy: { field: PLACE_SCORE, direction: DESC }
    first: 10
  ) {
    edges { node { id title place_score rating rating_votes } }
    pageInfo { hasNextPage endCursor }
  }
}

Evendo Place Score uses a 0–100 scale, with higher scores ranking better.

4. Use the language of your choice

Copy the dependency-free Python example or JavaScript example into your project. Both use POST JSON and handle GraphQL errors without requiring an SDK.

5. Production basics

Keep your queries scoped and paginated; treat optional fields as nullable; sanitize description HTML; and retry transient failures safely. For 429 or other throttling, honor Retry-After if present, but do not assume a specific published GraphQL rate-limit policy.