# Social Fetch API - Bing endpoints # Base URL: https://api.socialfetch.dev # Auth: x-api-key header (sfk_...) # Full catalog: https://www.socialfetch.dev/llms-endpoints.txt | JSON: https://www.socialfetch.dev/llms.json # Docs hub: https://www.socialfetch.dev/docs/api | OpenAPI: https://www.socialfetch.dev/openapi.json 4 documented Bing operations. Do not invent paths - only the routes below (and their linked markdown pages) are supported. ## GET /v1/bing/search Search Bing Credit cost: 1 credit. Failed requests are free. Auth: API key or x402 payment (no key needed for payment) Docs: https://www.socialfetch.dev/docs/api/v1/bing/search/get.mdx SDK: client.bing.searchWeb({ query: "marathon training plan" }) Parameters: - query (required, string) - What to search for, e.g. `marathon training plan`. Bing often answers a search with operators such as `site:` only in a reduced layout that ignores them; such a search fails with `query_unreadable` and is not charged. - time (optional, string, enum: day | week | month) - Only results from the past `day`, `week` or `month`. Default: any time. - cursor (optional, string) - Pass `page.nextCursor` from the previous response to get the next page. - country (optional, string) - Two-letter country code of the results' market, e.g. `GB` or `DE`. Default: `US`. - language (optional, string) - Two-letter language code for a country with several, e.g. `fr` with `CH`. Default: the market's first language. Pagination: send query `cursor` from prior `data.page.nextCursor`; stop when `data.page.hasMore` is false. Outcome field: `data.lookupStatus` in `found`, `not_found` curl "https://api.socialfetch.dev/v1/bing/search?query=best%20hiking%20boots" \ -H "x-api-key: YOUR_API_KEY" ## GET /v1/bing/rank Check a site's Bing rank Credit cost: 1 credit. Failed requests are free. Auth: API key or x402 payment (no key needed for payment) Docs: https://www.socialfetch.dev/docs/api/v1/bing/rank/get.mdx SDK: client.bing.checkRank({ query: "marathon training plan", domain: "halhigdon.com" }) Parameters: - query (required, string) - The search to rank in, e.g. `marathon training plan`. - domain (required, string) - The site to find, e.g. `halhigdon.com`. A URL is accepted and reduced to its host; `www.` and subdomains match too. - depth (optional, integer) - How many results to check, 10 to 100. Default: 50. - time (optional, string, enum: day | week | month) - Only results from the past `day`, `week` or `month`. Default: any time. - country (optional, string) - Two-letter country code of the results' market, e.g. `GB` or `DE`. Default: `US`. - language (optional, string) - Two-letter language code for a country with several, e.g. `fr` with `CH`. Default: the market's first language. Outcome field: `data.lookupStatus` in `found`, `not_found` curl "https://api.socialfetch.dev/v1/bing/rank?query=marathon%20training%20plan&domain=halhigdon.com" \ -H "x-api-key: YOUR_API_KEY" ## GET /v1/bing/videos Search Bing Videos Credit cost: 1 credit. Failed requests are free. Auth: API key or x402 payment (no key needed for payment) Docs: https://www.socialfetch.dev/docs/api/v1/bing/videos/get.mdx SDK: client.bing.searchVideos({ query: "marathon training plan" }) Parameters: - query (required, string) - What to search videos for, e.g. `marathon training plan`. - time (optional, string, enum: day | week | month) - Only videos published in the past `day`, `week` or `month`. Default: any time. - cursor (optional, string) - Pass `page.nextCursor` from the previous response to get the next page. - country (optional, string) - Two-letter country code of the results' market, e.g. `GB` or `DE`. Default: `US`. - language (optional, string) - Two-letter language code for a country with several, e.g. `fr` with `CH`. Default: the market's first language. Pagination: send query `cursor` from prior `data.page.nextCursor`; stop when `data.page.hasMore` is false. Outcome field: `data.lookupStatus` in `found`, `not_found` curl "https://api.socialfetch.dev/v1/bing/videos?query=marathon%20training%20plan" \ -H "x-api-key: YOUR_API_KEY" ## GET /v1/bing/search/suggest List Bing search suggestions Credit cost: 1 credit. Failed requests are free. Auth: API key or x402 payment (no key needed for payment) Docs: https://www.socialfetch.dev/docs/api/v1/bing/search/suggest/get.mdx SDK: client.bing.suggestSearches({ query: "marat" }) Parameters: - query (required, string) - The start of a search to complete, e.g. `marat`. - country (optional, string) - Two-letter country code of the results' market, e.g. `GB` or `DE`. Default: `US`. - language (optional, string) - Two-letter language code for a country with several, e.g. `fr` with `CH`. Default: the market's first language. Outcome field: `data.lookupStatus` in `found`, `not_found` curl "https://api.socialfetch.dev/v1/bing/search/suggest?query=marat" \ -H "x-api-key: YOUR_API_KEY"